privy_ruby 0.1.0 → 0.3.0

data/rbi/privy/models/swap_quote_request_body.rbi

@@ -42,10 +42,10 @@ module Privy
 
       # Maximum slippage tolerance in basis points (e.g., 50 for 0.5%). If omitted,
       # auto-slippage is used.
-      sig { returns(T.nilable(Float)) }
+      sig { returns(T.nilable(Integer)) }
       attr_reader :slippage_bps
 
-      sig { params(slippage_bps: Float).void }
+      sig { params(slippage_bps: Integer).void }
       attr_writer :slippage_bps
 
       # Input for requesting a token swap quote.
@@ -56,7 +56,7 @@ module Privy
           source: Privy::SwapSource::OrHash,
           amount_type: Privy::AmountType::OrSymbol,
           fee_configuration: Privy::FeeConfiguration::OrHash,
-          slippage_bps: Float
+          slippage_bps: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -84,7 +84,7 @@ module Privy
             source: Privy::SwapSource,
             amount_type: Privy::AmountType::OrSymbol,
             fee_configuration: Privy::FeeConfiguration,
-            slippage_bps: Float
+            slippage_bps: Integer
           }
         )
       end

data/rbi/privy/models/swap_quote_response.rbi

@@ -16,7 +16,8 @@ module Privy
       sig { returns(String) }
       attr_accessor :est_output_amount
 
-      # Estimated gas cost in base units of the native token.
+      # Estimated gas cost in base units of the native token. @deprecated For
+      # cross-chain swaps, use estimated_gas instead.
       sig { returns(String) }
       attr_accessor :gas_estimate
 
@@ -36,14 +37,15 @@ module Privy
       sig { returns(String) }
       attr_accessor :output_token
 
-      # Destination chain CAIP-2 identifier for cross-chain swaps.
+      # Destination chain CAIP-2 identifier for cross-chain swaps. Only present for
+      # cross-chain swaps.
       sig { returns(T.nilable(String)) }
       attr_reader :destination_caip2
 
       sig { params(destination_caip2: String).void }
       attr_writer :destination_caip2
 
-      # Estimated fees in USD.
+      # Estimated fees for the swap. Only present for cross-chain swaps.
       sig { returns(T.nilable(T::Array[Privy::FeeLineItem::Variants])) }
       attr_reader :estimated_fees
 
@@ -61,7 +63,15 @@ module Privy
       end
       attr_writer :estimated_fees
 
-      # Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
+      # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+      # human-readable decimal string, plus the gas token symbol.
+      sig { returns(T.nilable(Privy::Gas)) }
+      attr_reader :estimated_gas
+
+      sig { params(estimated_gas: Privy::Gas::OrHash).void }
+      attr_writer :estimated_gas
+
+      # Quote expiry as Unix timestamp (seconds). Only present for cross-chain quotes.
       sig { returns(T.nilable(Float)) }
       attr_reader :expires_at
 
@@ -87,6 +97,7 @@ module Privy
                 Privy::DeveloperFee::OrHash
               )
             ],
+          estimated_gas: Privy::Gas::OrHash,
           expires_at: Float
         ).returns(T.attached_class)
       end
@@ -95,7 +106,8 @@ module Privy
         caip2:,
         # Estimated amount of output token in base units.
         est_output_amount:,
-        # Estimated gas cost in base units of the native token.
+        # Estimated gas cost in base units of the native token. @deprecated For
+        # cross-chain swaps, use estimated_gas instead.
         gas_estimate:,
         # Amount of input token in base units.
         input_amount:,
@@ -105,11 +117,15 @@ module Privy
         minimum_output_amount:,
         # Token address being bought.
         output_token:,
-        # Destination chain CAIP-2 identifier for cross-chain swaps.
+        # Destination chain CAIP-2 identifier for cross-chain swaps. Only present for
+        # cross-chain swaps.
         destination_caip2: nil,
-        # Estimated fees in USD.
+        # Estimated fees for the swap. Only present for cross-chain swaps.
         estimated_fees: nil,
-        # Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
+        # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+        # human-readable decimal string, plus the gas token symbol.
+        estimated_gas: nil,
+        # Quote expiry as Unix timestamp (seconds). Only present for cross-chain quotes.
         expires_at: nil
       )
       end
@@ -126,6 +142,7 @@ module Privy
             output_token: String,
             destination_caip2: String,
             estimated_fees: T::Array[Privy::FeeLineItem::Variants],
+            estimated_gas: Privy::Gas,
             expires_at: Float
           }
         )

data/rbi/privy/models/swap_request_body.rbi

@@ -39,10 +39,10 @@ module Privy
       attr_writer :fee_configuration
 
       # Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
-      sig { returns(T.nilable(Float)) }
+      sig { returns(T.nilable(Integer)) }
       attr_reader :slippage_bps
 
-      sig { params(slippage_bps: Float).void }
+      sig { params(slippage_bps: Integer).void }
       attr_writer :slippage_bps
 
       # Input for executing a token swap.
@@ -53,7 +53,7 @@ module Privy
           source: Privy::SwapSource::OrHash,
           amount_type: Privy::AmountType::OrSymbol,
           fee_configuration: Privy::FeeConfiguration::OrHash,
-          slippage_bps: Float
+          slippage_bps: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -80,7 +80,7 @@ module Privy
             source: Privy::SwapSource,
             amount_type: Privy::AmountType::OrSymbol,
             fee_configuration: Privy::FeeConfiguration,
-            slippage_bps: Float
+            slippage_bps: Integer
           }
         )
       end

data/rbi/privy/models/swap_submission_status.rbi

@@ -0,0 +1,24 @@
+# typed: strong
+
+module Privy
+  module Models
+    # "accepted" if the network has acknowledged the transaction, "rejected" if the
+    # network refused it, "skipped" if dry_run was set. Not an onchain confirmation.
+    module SwapSubmissionStatus
+      extend Privy::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Privy::SwapSubmissionStatus) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      ACCEPTED = T.let(:accepted, Privy::SwapSubmissionStatus::TaggedSymbol)
+      REJECTED = T.let(:rejected, Privy::SwapSubmissionStatus::TaggedSymbol)
+      SKIPPED = T.let(:skipped, Privy::SwapSubmissionStatus::TaggedSymbol)
+
+      sig do
+        override.returns(T::Array[Privy::SwapSubmissionStatus::TaggedSymbol])
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/privy/models/test_account.rbi

@@ -24,6 +24,9 @@ module Privy
       sig { returns(String) }
       attr_accessor :updated_at
 
+      sig { returns(T.nilable(String)) }
+      attr_accessor :name
+
       # A test account for an app.
       sig do
         params(
@@ -32,7 +35,8 @@ module Privy
           email: String,
           otp_code: String,
           phone_number: String,
-          updated_at: String
+          updated_at: String,
+          name: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -41,7 +45,8 @@ module Privy
         email:,
         otp_code:,
         phone_number:,
-        updated_at:
+        updated_at:,
+        name: nil
       )
       end
 
@@ -53,7 +58,8 @@ module Privy
             email: String,
             otp_code: String,
             phone_number: String,
-            updated_at: String
+            updated_at: String,
+            name: T.nilable(String)
           }
         )
       end

data/rbi/privy/models/token_identifier.rbi

@@ -0,0 +1,7 @@
+# typed: strong
+
+module Privy
+  module Models
+    TokenIdentifier = String
+  end
+end

data/rbi/privy/models/token_transfer_destination.rbi

@@ -8,7 +8,7 @@ module Privy
           T.any(Privy::TokenTransferDestination, Privy::Internal::AnyHash)
         end
 
-      # Recipient address (hex for EVM, base58 for Solana)
+      # Recipient address (hex for EVM, base58 for Solana, base58check for Tron)
       sig { returns(String) }
       attr_accessor :address
 
@@ -36,7 +36,7 @@ module Privy
         )
       end
       def self.new(
-        # Recipient address (hex for EVM, base58 for Solana)
+        # Recipient address (hex for EVM, base58 for Solana, base58check for Tron)
         address:,
         # The destination asset. Required for cross-asset transfers (e.g., source 'usdt'
         # to destination 'usdc').

data/rbi/privy/models/transaction.rbi

@@ -15,7 +15,8 @@ module Privy
       sig { returns(Float) }
       attr_accessor :created_at
 
-      sig { returns(Privy::Transaction::Status::TaggedSymbol) }
+      # Status of a blockchain transaction submitted by Privy.
+      sig { returns(Privy::BlockchainTransactionStatus::TaggedSymbol) }
       attr_accessor :status
 
       sig { returns(T.nilable(String)) }
@@ -45,7 +46,7 @@ module Privy
           id: String,
           caip2: String,
           created_at: Float,
-          status: Privy::Transaction::Status::OrSymbol,
+          status: Privy::BlockchainTransactionStatus::OrSymbol,
           transaction_hash: T.nilable(String),
           wallet_id: String,
           reference_id: T.nilable(String),
@@ -57,6 +58,7 @@ module Privy
         id:,
         caip2:,
         created_at:,
+        # Status of a blockchain transaction submitted by Privy.
         status:,
         transaction_hash:,
         wallet_id:,
@@ -72,7 +74,7 @@ module Privy
             id: String,
             caip2: String,
             created_at: Float,
-            status: Privy::Transaction::Status::TaggedSymbol,
+            status: Privy::BlockchainTransactionStatus::TaggedSymbol,
             transaction_hash: T.nilable(String),
             wallet_id: String,
             reference_id: T.nilable(String),
@@ -83,32 +85,6 @@ module Privy
       end
       def to_hash
       end
-
-      module Status
-        extend Privy::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias { T.all(Symbol, Privy::Transaction::Status) }
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        BROADCASTED =
-          T.let(:broadcasted, Privy::Transaction::Status::TaggedSymbol)
-        CONFIRMED = T.let(:confirmed, Privy::Transaction::Status::TaggedSymbol)
-        EXECUTION_REVERTED =
-          T.let(:execution_reverted, Privy::Transaction::Status::TaggedSymbol)
-        FAILED = T.let(:failed, Privy::Transaction::Status::TaggedSymbol)
-        REPLACED = T.let(:replaced, Privy::Transaction::Status::TaggedSymbol)
-        FINALIZED = T.let(:finalized, Privy::Transaction::Status::TaggedSymbol)
-        PROVIDER_ERROR =
-          T.let(:provider_error, Privy::Transaction::Status::TaggedSymbol)
-        PENDING = T.let(:pending, Privy::Transaction::Status::TaggedSymbol)
-
-        sig do
-          override.returns(T::Array[Privy::Transaction::Status::TaggedSymbol])
-        end
-        def self.values
-        end
-      end
     end
   end
 end

data/rbi/privy/models/transfer_quote_request_body.rbi

@@ -28,6 +28,15 @@ module Privy
       end
       attr_accessor :source
 
+      # Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
+      # USDC). For exact_input, the amount to send. For exact_output, the exact amount
+      # to receive. Takes precedence over source.amount when both are provided.
+      sig { returns(T.nilable(String)) }
+      attr_reader :amount
+
+      sig { params(amount: String).void }
+      attr_writer :amount
+
       # Whether the amount refers to the input token or output token.
       sig { returns(T.nilable(Privy::AmountType::OrSymbol)) }
       attr_reader :amount_type
@@ -42,7 +51,8 @@ module Privy
       sig { params(fee_configuration: Privy::FeeConfiguration::OrHash).void }
       attr_writer :fee_configuration
 
-      # Maximum allowed slippage in basis points (1 bps = 0.01%).
+      # Maximum allowed slippage in basis points (1 bps = 0.01%). Only applicable for
+      # cross-chain or cross-asset transfers; omit to use the provider default.
       sig { returns(T.nilable(Integer)) }
       attr_reader :slippage_bps
 
@@ -59,6 +69,7 @@ module Privy
               Privy::NamedTokenTransferSource::OrHash,
               Privy::CustomTokenTransferSource::OrHash
             ),
+          amount: String,
           amount_type: Privy::AmountType::OrSymbol,
           fee_configuration: Privy::FeeConfiguration::OrHash,
           slippage_bps: Integer
@@ -71,11 +82,16 @@ module Privy
         # The source asset, amount, and chain for a token transfer. Specify either `asset`
         # (named) or `asset_address` (custom), not both.
         source:,
+        # Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
+        # USDC). For exact_input, the amount to send. For exact_output, the exact amount
+        # to receive. Takes precedence over source.amount when both are provided.
+        amount: nil,
         # Whether the amount refers to the input token or output token.
         amount_type: nil,
         # Total fees assessed on a transfer, in BPS
         fee_configuration: nil,
-        # Maximum allowed slippage in basis points (1 bps = 0.01%).
+        # Maximum allowed slippage in basis points (1 bps = 0.01%). Only applicable for
+        # cross-chain or cross-asset transfers; omit to use the provider default.
         slippage_bps: nil
       )
       end
@@ -89,6 +105,7 @@ module Privy
                 Privy::NamedTokenTransferSource,
                 Privy::CustomTokenTransferSource
               ),
+            amount: String,
             amount_type: Privy::AmountType::OrSymbol,
             fee_configuration: Privy::FeeConfiguration,
             slippage_bps: Integer

data/rbi/privy/models/transfer_quote_response.rbi

@@ -16,7 +16,7 @@ module Privy
       sig { params(destination: Privy::TokenTransferDestination::OrHash).void }
       attr_writer :destination
 
-      # Estimated fees in USD
+      # Estimated fees in USD for the transfer. Only present for cross-chain transfers.
       sig do
         returns(
           T::Array[
@@ -26,11 +26,18 @@ module Privy
       end
       attr_accessor :estimated_fees
 
-      # Estimated output amount in decimals
+      # Estimated input amount in decimals. For exact_input, this equals source.amount.
+      # For exact_output, this is the estimated amount the sender needs to provide.
+      sig { returns(String) }
+      attr_accessor :estimated_input_amount
+
+      # Estimated output amount in decimals. For exact_input, this is an estimate
+      # subject to slippage. For exact_output, this is the guaranteed exact amount to be
+      # received.
       sig { returns(String) }
       attr_accessor :estimated_output_amount
 
-      # Quote expiry as unix timestamp (seconds)
+      # Quote expiry as Unix timestamp (seconds).
       sig { returns(Float) }
       attr_accessor :expires_at
 
@@ -53,6 +60,14 @@ module Privy
       sig { params(amount_type: Privy::AmountType::OrSymbol).void }
       attr_writer :amount_type
 
+      # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+      # human-readable decimal string, plus the gas token symbol.
+      sig { returns(T.nilable(Privy::Gas)) }
+      attr_reader :estimated_gas
+
+      sig { params(estimated_gas: Privy::Gas::OrHash).void }
+      attr_writer :estimated_gas
+
       # Response containing a quote for a cross-asset or cross-chain (DADC) transfer.
       sig do
         params(
@@ -65,6 +80,7 @@ module Privy
                 Privy::DeveloperFee::OrHash
               )
             ],
+          estimated_input_amount: String,
           estimated_output_amount: String,
           expires_at: Float,
           source:
@@ -72,24 +88,33 @@ module Privy
               Privy::NamedTokenTransferSource::OrHash,
               Privy::CustomTokenTransferSource::OrHash
             ),
-          amount_type: Privy::AmountType::OrSymbol
+          amount_type: Privy::AmountType::OrSymbol,
+          estimated_gas: Privy::Gas::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
         # The destination address for a token transfer. Optionally specify a different
         # asset or chain for cross-asset or cross-chain transfers.
         destination:,
-        # Estimated fees in USD
+        # Estimated fees in USD for the transfer. Only present for cross-chain transfers.
         estimated_fees:,
-        # Estimated output amount in decimals
+        # Estimated input amount in decimals. For exact_input, this equals source.amount.
+        # For exact_output, this is the estimated amount the sender needs to provide.
+        estimated_input_amount:,
+        # Estimated output amount in decimals. For exact_input, this is an estimate
+        # subject to slippage. For exact_output, this is the guaranteed exact amount to be
+        # received.
         estimated_output_amount:,
-        # Quote expiry as unix timestamp (seconds)
+        # Quote expiry as Unix timestamp (seconds).
         expires_at:,
         # The source asset, amount, and chain for a token transfer. Specify either `asset`
         # (named) or `asset_address` (custom), not both.
         source:,
         # Whether the amount refers to the input token or output token.
-        amount_type: nil
+        amount_type: nil,
+        # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+        # human-readable decimal string, plus the gas token symbol.
+        estimated_gas: nil
       )
       end
 
@@ -101,6 +126,7 @@ module Privy
               T::Array[
                 T.any(Privy::RelayerFee, Privy::PrivyFee, Privy::DeveloperFee)
               ],
+            estimated_input_amount: String,
             estimated_output_amount: String,
             expires_at: Float,
             source:
@@ -108,7 +134,8 @@ module Privy
                 Privy::NamedTokenTransferSource,
                 Privy::CustomTokenTransferSource
               ),
-            amount_type: Privy::AmountType::OrSymbol
+            amount_type: Privy::AmountType::OrSymbol,
+            estimated_gas: Privy::Gas
           }
         )
       end

data/rbi/privy/models/transfer_received_transaction_detail.rbi

@@ -14,9 +14,8 @@ module Privy
       sig { returns(Privy::TransferReceivedTransactionDetail::Asset::Variants) }
       attr_accessor :asset
 
-      sig do
-        returns(Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol)
-      end
+      # Supported blockchain network names for wallet balance and transaction queries.
+      sig { returns(Privy::WalletAssetChainNameInput::TaggedSymbol) }
       attr_accessor :chain
 
       sig { returns(T::Hash[Symbol, String]) }
@@ -53,7 +52,7 @@ module Privy
               Privy::TransferReceivedTransactionDetail::Asset::OrSymbol,
               String
             ),
-          chain: Privy::TransferReceivedTransactionDetail::Chain::OrSymbol,
+          chain: Privy::WalletAssetChainNameInput::OrSymbol,
           display_values: T::Hash[Symbol, String],
           raw_value: String,
           raw_value_decimals: Float,
@@ -66,6 +65,7 @@ module Privy
       end
       def self.new(
         asset:,
+        # Supported blockchain network names for wallet balance and transaction queries.
         chain:,
         display_values:,
         raw_value:,
@@ -82,8 +82,7 @@ module Privy
         override.returns(
           {
             asset: Privy::TransferReceivedTransactionDetail::Asset::Variants,
-            chain:
-              Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol,
+            chain: Privy::WalletAssetChainNameInput::TaggedSymbol,
             display_values: T::Hash[Symbol, String],
             raw_value: String,
             raw_value_decimals: Float,
@@ -138,6 +137,11 @@ module Privy
             :eth,
             Privy::TransferReceivedTransactionDetail::Asset::TaggedSymbol
           )
+        AVAX =
+          T.let(
+            :avax,
+            Privy::TransferReceivedTransactionDetail::Asset::TaggedSymbol
+          )
         POL =
           T.let(
             :pol,
@@ -165,112 +169,6 @@ module Privy
           )
       end
 
-      module Chain
-        extend Privy::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Privy::TransferReceivedTransactionDetail::Chain)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        ETHEREUM =
-          T.let(
-            :ethereum,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        ARBITRUM =
-          T.let(
-            :arbitrum,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        BASE =
-          T.let(
-            :base,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        TEMPO =
-          T.let(
-            :tempo,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        LINEA =
-          T.let(
-            :linea,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        OPTIMISM =
-          T.let(
-            :optimism,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        POLYGON =
-          T.let(
-            :polygon,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        SOLANA =
-          T.let(
-            :solana,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        ZKSYNC_ERA =
-          T.let(
-            :zksync_era,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        SEPOLIA =
-          T.let(
-            :sepolia,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        ARBITRUM_SEPOLIA =
-          T.let(
-            :arbitrum_sepolia,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        BASE_SEPOLIA =
-          T.let(
-            :base_sepolia,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        LINEA_TESTNET =
-          T.let(
-            :linea_testnet,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        OPTIMISM_SEPOLIA =
-          T.let(
-            :optimism_sepolia,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        POLYGON_AMOY =
-          T.let(
-            :polygon_amoy,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        SOLANA_DEVNET =
-          T.let(
-            :solana_devnet,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-        SOLANA_TESTNET =
-          T.let(
-            :solana_testnet,
-            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
-
       module Type
         extend Privy::Internal::Type::Enum