privy_ruby 0.0.2 → 0.2.0

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/transfer_action_response.rbi

@@ -57,6 +57,32 @@ module Privy
       sig { params(destination_chain: String).void }
       attr_writer :destination_chain
 
+      # Estimated fee breakdown from the provider quote.
+      sig { returns(T.nilable(T::Array[Privy::FeeLineItem::Variants])) }
+      attr_reader :estimated_fees
+
+      sig do
+        params(
+          estimated_fees:
+            T::Array[
+              T.any(
+                Privy::RelayerFee::OrHash,
+                Privy::PrivyFee::OrHash,
+                Privy::DeveloperFee::OrHash
+              )
+            ]
+        ).void
+      end
+      attr_writer :estimated_fees
+
+      # 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
+
       # A description of why a wallet action (or a step within a wallet action) failed.
       sig { returns(T.nilable(Privy::FailureReason)) }
       attr_reader :failure_reason
@@ -64,7 +90,7 @@ module Privy
       sig { params(failure_reason: Privy::FailureReason::OrHash).void }
       attr_writer :failure_reason
 
-      # Fees paid for the transfer.
+      # Actual fees paid for the transfer. Populated after on-chain confirmation.
       sig { returns(T.nilable(T::Array[Privy::FeeLineItem::Variants])) }
       attr_reader :fees
 
@@ -82,6 +108,14 @@ module Privy
       end
       attr_writer :fees
 
+      # 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 :gas
+
+      sig { params(gas: Privy::Gas::OrHash).void }
+      attr_writer :gas
+
       # Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output
       # cross-chain transfers until the source amount is determined.
       sig { returns(T.nilable(String)) }
@@ -146,6 +180,15 @@ module Privy
           destination_amount: String,
           destination_asset: String,
           destination_chain: String,
+          estimated_fees:
+            T::Array[
+              T.any(
+                Privy::RelayerFee::OrHash,
+                Privy::PrivyFee::OrHash,
+                Privy::DeveloperFee::OrHash
+              )
+            ],
+          estimated_gas: Privy::Gas::OrHash,
           failure_reason: Privy::FailureReason::OrHash,
           fees:
             T::Array[
@@ -155,6 +198,7 @@ module Privy
                 Privy::DeveloperFee::OrHash
               )
             ],
+          gas: Privy::Gas::OrHash,
           source_amount: String,
           source_asset: String,
           source_asset_address: String,
@@ -191,10 +235,18 @@ module Privy
         destination_asset: nil,
         # Destination chain for cross-chain transfers. Omitted for same-chain transfers.
         destination_chain: nil,
+        # Estimated fee breakdown from the provider quote.
+        estimated_fees: 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,
         # A description of why a wallet action (or a step within a wallet action) failed.
         failure_reason: nil,
-        # Fees paid for the transfer.
+        # Actual fees paid for the transfer. Populated after on-chain confirmation.
         fees: nil,
+        # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+        # human-readable decimal string, plus the gas token symbol.
+        gas: nil,
         # Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output
         # cross-chain transfers until the source amount is determined.
         source_amount: nil,
@@ -225,8 +277,11 @@ module Privy
             destination_amount: String,
             destination_asset: String,
             destination_chain: String,
+            estimated_fees: T::Array[Privy::FeeLineItem::Variants],
+            estimated_gas: Privy::Gas,
             failure_reason: Privy::FailureReason,
             fees: T::Array[Privy::FeeLineItem::Variants],
+            gas: Privy::Gas,
             source_amount: String,
             source_asset: String,
             source_asset_address: String,

data/rbi/privy/models/transfer_quote_request_body.rbi

@@ -42,7 +42,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
 
@@ -75,7 +76,8 @@ module Privy
         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

data/rbi/privy/models/transfer_quote_response.rbi

@@ -53,6 +53,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(
@@ -72,7 +80,8 @@ 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(
@@ -89,7 +98,10 @@ module Privy
         # (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
 
@@ -108,7 +120,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

@@ -138,6 +138,11 @@ module Privy
             :eth,
             Privy::TransferReceivedTransactionDetail::Asset::TaggedSymbol
           )
+        AVAX =
+          T.let(
+            :avax,
+            Privy::TransferReceivedTransactionDetail::Asset::TaggedSymbol
+          )
         POL =
           T.let(
             :pol,
@@ -184,6 +189,11 @@ module Privy
             :arbitrum,
             Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
           )
+        AVALANCHE =
+          T.let(
+            :avalanche,
+            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
+          )
         BASE =
           T.let(
             :base,
@@ -229,6 +239,11 @@ module Privy
             :arbitrum_sepolia,
             Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
           )
+        AVALANCHE_FUJI =
+          T.let(
+            :avalanche_fuji,
+            Privy::TransferReceivedTransactionDetail::Chain::TaggedSymbol
+          )
         BASE_SEPOLIA =
           T.let(
             :base_sepolia,

data/rbi/privy/models/transfer_request_body.rbi

@@ -35,7 +35,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
 
@@ -67,7 +68,8 @@ module Privy
         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

data/rbi/privy/models/transfer_sent_transaction_detail.rbi

@@ -127,6 +127,11 @@ module Privy
           )
         ETH =
           T.let(:eth, Privy::TransferSentTransactionDetail::Asset::TaggedSymbol)
+        AVAX =
+          T.let(
+            :avax,
+            Privy::TransferSentTransactionDetail::Asset::TaggedSymbol
+          )
         POL =
           T.let(:pol, Privy::TransferSentTransactionDetail::Asset::TaggedSymbol)
         USDT =
@@ -167,6 +172,11 @@ module Privy
             :arbitrum,
             Privy::TransferSentTransactionDetail::Chain::TaggedSymbol
           )
+        AVALANCHE =
+          T.let(
+            :avalanche,
+            Privy::TransferSentTransactionDetail::Chain::TaggedSymbol
+          )
         BASE =
           T.let(
             :base,
@@ -212,6 +222,11 @@ module Privy
             :arbitrum_sepolia,
             Privy::TransferSentTransactionDetail::Chain::TaggedSymbol
           )
+        AVALANCHE_FUJI =
+          T.let(
+            :avalanche_fuji,
+            Privy::TransferSentTransactionDetail::Chain::TaggedSymbol
+          )
         BASE_SEPOLIA =
           T.let(
             :base_sepolia,

data/rbi/privy/models/tron_address.rbi

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

data/rbi/privy/models/wallet_asset.rbi

@@ -12,6 +12,7 @@ module Privy
       USDC = T.let(:usdc, Privy::WalletAsset::TaggedSymbol)
       USDC_E = T.let(:"usdc.e", Privy::WalletAsset::TaggedSymbol)
       ETH = T.let(:eth, Privy::WalletAsset::TaggedSymbol)
+      AVAX = T.let(:avax, Privy::WalletAsset::TaggedSymbol)
       POL = T.let(:pol, Privy::WalletAsset::TaggedSymbol)
       USDT = T.let(:usdt, Privy::WalletAsset::TaggedSymbol)
       EURC = T.let(:eurc, Privy::WalletAsset::TaggedSymbol)

data/rbi/privy/models/wallet_batch_create_response.rbi

@@ -9,16 +9,7 @@ module Privy
         end
 
       # Array of results for each wallet creation request, in the same order as input.
-      sig do
-        returns(
-          T::Array[
-            T.any(
-              Privy::WalletBatchCreateResult::WalletBatchCreateSuccess,
-              Privy::WalletBatchCreateResult::WalletBatchCreateFailure
-            )
-          ]
-        )
-      end
+      sig { returns(T::Array[Privy::WalletBatchCreateResult::Variants]) }
       attr_accessor :results
 
       # Response for a batch wallet creation request.
@@ -41,15 +32,7 @@ module Privy
 
       sig do
         override.returns(
-          {
-            results:
-              T::Array[
-                T.any(
-                  Privy::WalletBatchCreateResult::WalletBatchCreateSuccess,
-                  Privy::WalletBatchCreateResult::WalletBatchCreateFailure
-                )
-              ]
-          }
+          { results: T::Array[Privy::WalletBatchCreateResult::Variants] }
         )
       end
       def to_hash

data/rbi/privy/models/wallet_batch_create_result.rbi

@@ -29,7 +29,7 @@ module Privy
 
         sig do
           returns(
-            Privy::WalletBatchCreateResult::WalletBatchCreateSuccess::Success::OrBoolean
+            Privy::WalletBatchCreateResult::WalletBatchCreateSuccess::Success::TaggedBoolean
           )
         end
         attr_accessor :success
@@ -64,7 +64,7 @@ module Privy
             {
               index: Float,
               success:
-                Privy::WalletBatchCreateResult::WalletBatchCreateSuccess::Success::OrBoolean,
+                Privy::WalletBatchCreateResult::WalletBatchCreateSuccess::Success::TaggedBoolean,
               wallet: Privy::Wallet
             }
           )
@@ -126,7 +126,7 @@ module Privy
 
         sig do
           returns(
-            Privy::WalletBatchCreateResult::WalletBatchCreateFailure::Success::OrBoolean
+            Privy::WalletBatchCreateResult::WalletBatchCreateFailure::Success::TaggedBoolean
           )
         end
         attr_accessor :success
@@ -160,7 +160,7 @@ module Privy
               error: String,
               index: Float,
               success:
-                Privy::WalletBatchCreateResult::WalletBatchCreateFailure::Success::OrBoolean
+                Privy::WalletBatchCreateResult::WalletBatchCreateFailure::Success::TaggedBoolean
             }
           )
         end

data/rbi/privy/models/wallet_create_batch_params.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Privy
+  module Models
+    class WalletCreateBatchParams < Privy::Models::WalletBatchCreateInput
+      extend Privy::Internal::Type::RequestParameters::Converter
+      include Privy::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Privy::WalletCreateBatchParams, Privy::Internal::AnyHash)
+        end
+
+      sig do
+        params(request_options: Privy::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: Privy::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/wallet_ethereum_asset.rbi

@@ -12,6 +12,7 @@ module Privy
       USDC = T.let(:usdc, Privy::WalletEthereumAsset::TaggedSymbol)
       USDC_E = T.let(:"usdc.e", Privy::WalletEthereumAsset::TaggedSymbol)
       ETH = T.let(:eth, Privy::WalletEthereumAsset::TaggedSymbol)
+      AVAX = T.let(:avax, Privy::WalletEthereumAsset::TaggedSymbol)
       POL = T.let(:pol, Privy::WalletEthereumAsset::TaggedSymbol)
       USDT = T.let(:usdt, Privy::WalletEthereumAsset::TaggedSymbol)
       EURC = T.let(:eurc, Privy::WalletEthereumAsset::TaggedSymbol)

data/rbi/privy/models/wallets/balance_get_params.rbi

@@ -231,6 +231,8 @@ module Privy
             )
           ETH =
             T.let(:eth, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
+          AVAX =
+            T.let(:avax, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
           POL =
             T.let(:pol, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
           USDT =
@@ -286,6 +288,11 @@ module Privy
                 :arbitrum,
                 Privy::Wallets::BalanceGetParams::Chain::UnionMember1::TaggedSymbol
               )
+            AVALANCHE =
+              T.let(
+                :avalanche,
+                Privy::Wallets::BalanceGetParams::Chain::UnionMember1::TaggedSymbol
+              )
             BASE =
               T.let(
                 :base,
@@ -331,6 +338,11 @@ module Privy
                 :arbitrum_sepolia,
                 Privy::Wallets::BalanceGetParams::Chain::UnionMember1::TaggedSymbol
               )
+            AVALANCHE_FUJI =
+              T.let(
+                :avalanche_fuji,
+                Privy::Wallets::BalanceGetParams::Chain::UnionMember1::TaggedSymbol
+              )
             BASE_SEPOLIA =
               T.let(
                 :base_sepolia,
@@ -397,6 +409,11 @@ module Privy
               :arbitrum,
               Privy::Wallets::BalanceGetParams::Chain::TaggedSymbol
             )
+          AVALANCHE =
+            T.let(
+              :avalanche,
+              Privy::Wallets::BalanceGetParams::Chain::TaggedSymbol
+            )
           BASE =
             T.let(:base, Privy::Wallets::BalanceGetParams::Chain::TaggedSymbol)
           TEMPO =
@@ -433,6 +450,11 @@ module Privy
               :arbitrum_sepolia,
               Privy::Wallets::BalanceGetParams::Chain::TaggedSymbol
             )
+          AVALANCHE_FUJI =
+            T.let(
+              :avalanche_fuji,
+              Privy::Wallets::BalanceGetParams::Chain::TaggedSymbol
+            )
           BASE_SEPOLIA =
             T.let(
               :base_sepolia,

data/rbi/privy/models/wallets/balance_get_response.rbi

@@ -155,6 +155,11 @@ module Privy
                 :eth,
                 Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::TaggedSymbol
               )
+            AVAX =
+              T.let(
+                :avax,
+                Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::TaggedSymbol
+              )
             POL =
               T.let(
                 :pol,
@@ -204,6 +209,11 @@ module Privy
                 :arbitrum,
                 Privy::Models::Wallets::BalanceGetResponse::Balance::Chain::TaggedSymbol
               )
+            AVALANCHE =
+              T.let(
+                :avalanche,
+                Privy::Models::Wallets::BalanceGetResponse::Balance::Chain::TaggedSymbol
+              )
             BASE =
               T.let(
                 :base,
@@ -249,6 +259,11 @@ module Privy
                 :arbitrum_sepolia,
                 Privy::Models::Wallets::BalanceGetResponse::Balance::Chain::TaggedSymbol
               )
+            AVALANCHE_FUJI =
+              T.let(
+                :avalanche_fuji,
+                Privy::Models::Wallets::BalanceGetResponse::Balance::Chain::TaggedSymbol
+              )
             BASE_SEPOLIA =
               T.let(
                 :base_sepolia,

data/rbi/privy/models/wallets/swap_execute_params.rbi

@@ -0,0 +1,71 @@
+# typed: strong
+
+module Privy
+  module Models
+    module Wallets
+      class SwapExecuteParams < Privy::Models::SwapRequestBody
+        extend Privy::Internal::Type::RequestParameters::Converter
+        include Privy::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(Privy::Wallets::SwapExecuteParams, Privy::Internal::AnyHash)
+          end
+
+        # ID of the wallet.
+        sig { returns(String) }
+        attr_accessor :wallet_id
+
+        # Request authorization signature. If multiple signatures are required, they
+        # should be comma separated.
+        sig { returns(T.nilable(String)) }
+        attr_reader :privy_authorization_signature
+
+        sig { params(privy_authorization_signature: String).void }
+        attr_writer :privy_authorization_signature
+
+        # Idempotency keys ensure API requests are executed only once within a 24-hour
+        # window.
+        sig { returns(T.nilable(String)) }
+        attr_reader :privy_idempotency_key
+
+        sig { params(privy_idempotency_key: String).void }
+        attr_writer :privy_idempotency_key
+
+        sig do
+          params(
+            wallet_id: String,
+            privy_authorization_signature: String,
+            privy_idempotency_key: String,
+            request_options: Privy::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # ID of the wallet.
+          wallet_id:,
+          # Request authorization signature. If multiple signatures are required, they
+          # should be comma separated.
+          privy_authorization_signature: nil,
+          # Idempotency keys ensure API requests are executed only once within a 24-hour
+          # window.
+          privy_idempotency_key: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              wallet_id: String,
+              privy_authorization_signature: String,
+              privy_idempotency_key: String,
+              request_options: Privy::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/wallets/swap_quote_params.rbi

@@ -0,0 +1,58 @@
+# typed: strong
+
+module Privy
+  module Models
+    module Wallets
+      class SwapQuoteParams < Privy::Models::SwapQuoteRequestBody
+        extend Privy::Internal::Type::RequestParameters::Converter
+        include Privy::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(Privy::Wallets::SwapQuoteParams, Privy::Internal::AnyHash)
+          end
+
+        # ID of the wallet.
+        sig { returns(String) }
+        attr_accessor :wallet_id
+
+        # Request authorization signature. If multiple signatures are required, they
+        # should be comma separated.
+        sig { returns(T.nilable(String)) }
+        attr_reader :privy_authorization_signature
+
+        sig { params(privy_authorization_signature: String).void }
+        attr_writer :privy_authorization_signature
+
+        sig do
+          params(
+            wallet_id: String,
+            privy_authorization_signature: String,
+            request_options: Privy::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # ID of the wallet.
+          wallet_id:,
+          # Request authorization signature. If multiple signatures are required, they
+          # should be comma separated.
+          privy_authorization_signature: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              wallet_id: String,
+              privy_authorization_signature: String,
+              request_options: Privy::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/wallets/transaction_get_params.rbi

@@ -262,6 +262,11 @@ module Privy
               :eth,
               Privy::Wallets::TransactionGetParams::Asset::TaggedSymbol
             )
+          AVAX =
+            T.let(
+              :avax,
+              Privy::Wallets::TransactionGetParams::Asset::TaggedSymbol
+            )
           POL =
             T.let(
               :pol,