privy_ruby 0.0.2 → 0.2.0

data/rbi/privy/models/stripe_onramp_checkout_response.rbi

@@ -0,0 +1,51 @@
+# typed: strong
+
+module Privy
+  module Models
+    class StripeOnrampCheckoutResponse < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::StripeOnrampCheckoutResponse, Privy::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :client_secret
+
+      # Transaction details from checkout.
+      sig { returns(T.nilable(Privy::StripeTransactionDetails)) }
+      attr_reader :transaction_details
+
+      sig do
+        params(
+          transaction_details: Privy::StripeTransactionDetails::OrHash
+        ).void
+      end
+      attr_writer :transaction_details
+
+      # Checkout confirmation with client secret.
+      sig do
+        params(
+          client_secret: String,
+          transaction_details: Privy::StripeTransactionDetails::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        client_secret:,
+        # Transaction details from checkout.
+        transaction_details: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            client_secret: String,
+            transaction_details: Privy::StripeTransactionDetails
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/stripe_onramp_session_status.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Privy
+  module Models
+    # The state of the user's Stripe onramp session.
+    module StripeOnrampSessionStatus
+      extend Privy::Internal::Type::Enum
+
+      TaggedSymbol =
+        T.type_alias { T.all(Symbol, Privy::StripeOnrampSessionStatus) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      ACTIVE = T.let(:active, Privy::StripeOnrampSessionStatus::TaggedSymbol)
+      EXPIRED = T.let(:expired, Privy::StripeOnrampSessionStatus::TaggedSymbol)
+      NONE = T.let(:none, Privy::StripeOnrampSessionStatus::TaggedSymbol)
+
+      sig do
+        override.returns(
+          T::Array[Privy::StripeOnrampSessionStatus::TaggedSymbol]
+        )
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/privy/models/stripe_payment_token.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Privy
+  module Models
+    class StripePaymentToken < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::StripePaymentToken, Privy::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig { returns(String) }
+      attr_accessor :type
+
+      # A saved payment token.
+      sig { params(id: String, type: String).returns(T.attached_class) }
+      def self.new(id:, type:)
+      end
+
+      sig { override.returns({ id: String, type: String }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/stripe_quote.rbi

@@ -0,0 +1,22 @@
+# typed: strong
+
+module Privy
+  module Models
+    class StripeQuote < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Privy::StripeQuote, Privy::Internal::AnyHash) }
+
+      sig { returns(Float) }
+      attr_accessor :expires_at
+
+      # A refreshed quote.
+      sig { params(expires_at: Float).returns(T.attached_class) }
+      def self.new(expires_at:)
+      end
+
+      sig { override.returns({ expires_at: Float }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/stripe_transaction_details.rbi

@@ -0,0 +1,24 @@
+# typed: strong
+
+module Privy
+  module Models
+    class StripeTransactionDetails < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::StripeTransactionDetails, Privy::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :last_error
+
+      # Transaction details from checkout.
+      sig { params(last_error: T.nilable(String)).returns(T.attached_class) }
+      def self.new(last_error: nil)
+      end
+
+      sig { override.returns({ last_error: T.nilable(String) }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/stripe_verification.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Privy
+  module Models
+    class StripeVerification < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::StripeVerification, Privy::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :name
+
+      sig { returns(String) }
+      attr_accessor :status
+
+      # A verification entry on a CryptoCustomer.
+      sig { params(name: String, status: String).returns(T.attached_class) }
+      def self.new(name:, status:)
+      end
+
+      sig { override.returns({ name: String, status: String }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/swap_action_response.rbi

@@ -37,16 +37,49 @@ module Privy
       attr_accessor :output_token
 
       # Status of a wallet action.
-      sig { returns(Privy::WalletActionStatus::OrSymbol) }
+      sig { returns(Privy::WalletActionStatus::TaggedSymbol) }
       attr_accessor :status
 
-      sig { returns(Privy::SwapActionResponse::Type::OrSymbol) }
+      sig { returns(Privy::SwapActionResponse::Type::TaggedSymbol) }
       attr_accessor :type
 
       # The ID of the wallet involved in the action.
       sig { returns(String) }
       attr_accessor :wallet_id
 
+      # Destination chain CAIP-2 identifier. 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 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
@@ -54,21 +87,34 @@ module Privy
       sig { params(failure_reason: Privy::FailureReason::OrHash).void }
       attr_writer :failure_reason
 
-      # The steps of the wallet action. Only returned if `?include=steps` is provided.
+      # Actual fees paid for the swap. Populated after on-chain confirmation.
+      sig { returns(T.nilable(T::Array[Privy::FeeLineItem::Variants])) }
+      attr_reader :fees
+
       sig do
-        returns(
-          T.nilable(
+        params(
+          fees:
             T::Array[
               T.any(
-                Privy::EvmTransactionWalletActionStep,
-                Privy::EvmUserOperationWalletActionStep,
-                Privy::SvmTransactionWalletActionStep,
-                Privy::ExternalTransactionWalletActionStep
+                Privy::RelayerFee::OrHash,
+                Privy::PrivyFee::OrHash,
+                Privy::DeveloperFee::OrHash
               )
             ]
-          )
-        )
+        ).void
       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
+
+      # The steps of the wallet action. Only returned if `?include=steps` is provided.
+      sig { returns(T.nilable(T::Array[Privy::WalletActionStep::Variants])) }
       attr_reader :steps
 
       sig do
@@ -99,7 +145,26 @@ module Privy
           status: Privy::WalletActionStatus::OrSymbol,
           type: Privy::SwapActionResponse::Type::OrSymbol,
           wallet_id: String,
+          destination_caip2: 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[
+              T.any(
+                Privy::RelayerFee::OrHash,
+                Privy::PrivyFee::OrHash,
+                Privy::DeveloperFee::OrHash
+              )
+            ],
+          gas: Privy::Gas::OrHash,
           steps:
             T::Array[
               T.any(
@@ -131,8 +196,20 @@ module Privy
         type:,
         # The ID of the wallet involved in the action.
         wallet_id:,
+        # Destination chain CAIP-2 identifier. Present for cross-chain swaps.
+        destination_caip2: 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,
+        # Actual fees paid for the swap. 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,
         # The steps of the wallet action. Only returned if `?include=steps` is provided.
         steps: nil
       )
@@ -148,19 +225,16 @@ module Privy
             input_token: String,
             output_amount: T.nilable(String),
             output_token: String,
-            status: Privy::WalletActionStatus::OrSymbol,
-            type: Privy::SwapActionResponse::Type::OrSymbol,
+            status: Privy::WalletActionStatus::TaggedSymbol,
+            type: Privy::SwapActionResponse::Type::TaggedSymbol,
             wallet_id: String,
+            destination_caip2: String,
+            estimated_fees: T::Array[Privy::FeeLineItem::Variants],
+            estimated_gas: Privy::Gas,
             failure_reason: Privy::FailureReason,
-            steps:
-              T::Array[
-                T.any(
-                  Privy::EvmTransactionWalletActionStep,
-                  Privy::EvmUserOperationWalletActionStep,
-                  Privy::SvmTransactionWalletActionStep,
-                  Privy::ExternalTransactionWalletActionStep
-                )
-              ]
+            fees: T::Array[Privy::FeeLineItem::Variants],
+            gas: Privy::Gas,
+            steps: T::Array[Privy::WalletActionStep::Variants]
           }
         )
       end

data/rbi/privy/models/swap_destination.rbi

@@ -10,28 +10,47 @@ module Privy
       sig { returns(String) }
       attr_accessor :asset_address
 
-      # CAIP-2 chain identifier for the destination. Must match source chain —
-      # cross-chain swaps are not yet supported. Defaults to source chain if omitted.
+      # CAIP-2 chain identifier for the destination. Defaults to source chain if
+      # omitted. Specify a different chain for cross-chain swaps.
       sig { returns(T.nilable(String)) }
       attr_reader :caip2
 
       sig { params(caip2: String).void }
       attr_writer :caip2
 
+      # Address to receive the output tokens. Defaults to the swapping wallet address.
+      # Required when swapping between different chain types (e.g. EVM to Solana).
+      sig { returns(T.nilable(String)) }
+      attr_reader :destination_address
+
+      sig { params(destination_address: String).void }
+      attr_writer :destination_address
+
       # The output side of a swap execution request.
       sig do
-        params(asset_address: String, caip2: String).returns(T.attached_class)
+        params(
+          asset_address: String,
+          caip2: String,
+          destination_address: String
+        ).returns(T.attached_class)
       end
       def self.new(
         # Token contract address to buy, or "native" for the chain's native token.
         asset_address:,
-        # CAIP-2 chain identifier for the destination. Must match source chain —
-        # cross-chain swaps are not yet supported. Defaults to source chain if omitted.
-        caip2: nil
+        # CAIP-2 chain identifier for the destination. Defaults to source chain if
+        # omitted. Specify a different chain for cross-chain swaps.
+        caip2: nil,
+        # Address to receive the output tokens. Defaults to the swapping wallet address.
+        # Required when swapping between different chain types (e.g. EVM to Solana).
+        destination_address: nil
       )
       end
 
-      sig { override.returns({ asset_address: String, caip2: String }) }
+      sig do
+        override.returns(
+          { asset_address: String, caip2: String, destination_address: String }
+        )
+      end
       def to_hash
       end
     end

data/rbi/privy/models/swap_quote_destination.rbi

@@ -12,28 +12,51 @@ module Privy
       sig { returns(String) }
       attr_accessor :asset_address
 
-      # CAIP-2 chain identifier for the destination. Must match source chain —
-      # cross-chain swaps are not yet supported. Defaults to source chain if omitted.
+      # CAIP-2 chain identifier for the destination. Defaults to source chain if
+      # omitted. Will result in a cross-chain swap if source and destination chains
+      # differ.
       sig { returns(T.nilable(String)) }
       attr_reader :caip2
 
       sig { params(caip2: String).void }
       attr_writer :caip2
 
+      # Address to receive the output tokens. Defaults to the swapping wallet address.
+      # Required when swapping between chains with different address types (e.g. EVM to
+      # Solana).
+      sig { returns(T.nilable(String)) }
+      attr_reader :destination_address
+
+      sig { params(destination_address: String).void }
+      attr_writer :destination_address
+
       # The output side of a swap quote request.
       sig do
-        params(asset_address: String, caip2: String).returns(T.attached_class)
+        params(
+          asset_address: String,
+          caip2: String,
+          destination_address: String
+        ).returns(T.attached_class)
       end
       def self.new(
         # Token contract address to buy, or "native" for the chain's native token.
         asset_address:,
-        # CAIP-2 chain identifier for the destination. Must match source chain —
-        # cross-chain swaps are not yet supported. Defaults to source chain if omitted.
-        caip2: nil
+        # CAIP-2 chain identifier for the destination. Defaults to source chain if
+        # omitted. Will result in a cross-chain swap if source and destination chains
+        # differ.
+        caip2: nil,
+        # Address to receive the output tokens. Defaults to the swapping wallet address.
+        # Required when swapping between chains with different address types (e.g. EVM to
+        # Solana).
+        destination_address: nil
       )
       end
 
-      sig { override.returns({ asset_address: String, caip2: String }) }
+      sig do
+        override.returns(
+          { asset_address: String, caip2: String, destination_address: String }
+        )
+      end
       def to_hash
       end
     end

data/rbi/privy/models/swap_quote_request_body.rbi

@@ -33,12 +33,19 @@ module Privy
       sig { params(amount_type: Privy::AmountType::OrSymbol).void }
       attr_writer :amount_type
 
+      # Total fees assessed on a transfer, in BPS
+      sig { returns(T.nilable(Privy::FeeConfiguration)) }
+      attr_reader :fee_configuration
+
+      sig { params(fee_configuration: Privy::FeeConfiguration::OrHash).void }
+      attr_writer :fee_configuration
+
       # 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.
@@ -48,7 +55,8 @@ module Privy
           destination: Privy::SwapQuoteDestination::OrHash,
           source: Privy::SwapSource::OrHash,
           amount_type: Privy::AmountType::OrSymbol,
-          slippage_bps: Float
+          fee_configuration: Privy::FeeConfiguration::OrHash,
+          slippage_bps: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -60,6 +68,8 @@ module Privy
         source:,
         # 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 slippage tolerance in basis points (e.g., 50 for 0.5%). If omitted,
         # auto-slippage is used.
         slippage_bps: nil
@@ -73,7 +83,8 @@ module Privy
             destination: Privy::SwapQuoteDestination,
             source: Privy::SwapSource,
             amount_type: Privy::AmountType::OrSymbol,
-            slippage_bps: Float
+            fee_configuration: Privy::FeeConfiguration,
+            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,6 +37,46 @@ module Privy
       sig { returns(String) }
       attr_accessor :output_token
 
+      # Destination chain CAIP-2 identifier 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 for the swap. Only present for cross-chain swaps.
+      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
+
+      # Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
+      sig { returns(T.nilable(Float)) }
+      attr_reader :expires_at
+
+      sig { params(expires_at: Float).void }
+      attr_writer :expires_at
+
       # Pricing data for a token swap.
       sig do
         params(
@@ -45,7 +86,18 @@ module Privy
           input_amount: String,
           input_token: String,
           minimum_output_amount: String,
-          output_token: String
+          output_token: String,
+          destination_caip2: String,
+          estimated_fees:
+            T::Array[
+              T.any(
+                Privy::RelayerFee::OrHash,
+                Privy::PrivyFee::OrHash,
+                Privy::DeveloperFee::OrHash
+              )
+            ],
+          estimated_gas: Privy::Gas::OrHash,
+          expires_at: Float
         ).returns(T.attached_class)
       end
       def self.new(
@@ -53,7 +105,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:,
@@ -62,7 +115,16 @@ module Privy
         # Minimum output amount accounting for slippage, in base units.
         minimum_output_amount:,
         # Token address being bought.
-        output_token:
+        output_token:,
+        # Destination chain CAIP-2 identifier for cross-chain swaps.
+        destination_caip2: nil,
+        # Estimated fees for the swap. Only present for cross-chain swaps.
+        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,
+        # Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
+        expires_at: nil
       )
       end
 
@@ -75,7 +137,11 @@ module Privy
             input_amount: String,
             input_token: String,
             minimum_output_amount: String,
-            output_token: String
+            output_token: String,
+            destination_caip2: String,
+            estimated_fees: T::Array[Privy::FeeLineItem::Variants],
+            estimated_gas: Privy::Gas,
+            expires_at: Float
           }
         )
       end

data/rbi/privy/models/swap_request_body.rbi

@@ -31,11 +31,18 @@ module Privy
       sig { params(amount_type: Privy::AmountType::OrSymbol).void }
       attr_writer :amount_type
 
+      # Total fees assessed on a transfer, in BPS
+      sig { returns(T.nilable(Privy::FeeConfiguration)) }
+      attr_reader :fee_configuration
+
+      sig { params(fee_configuration: Privy::FeeConfiguration::OrHash).void }
+      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.
@@ -45,7 +52,8 @@ module Privy
           destination: Privy::SwapDestination::OrHash,
           source: Privy::SwapSource::OrHash,
           amount_type: Privy::AmountType::OrSymbol,
-          slippage_bps: Float
+          fee_configuration: Privy::FeeConfiguration::OrHash,
+          slippage_bps: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -57,6 +65,8 @@ module Privy
         source:,
         # 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 slippage tolerance in basis points (e.g., 50 for 0.5%).
         slippage_bps: nil
       )
@@ -69,7 +79,8 @@ module Privy
             destination: Privy::SwapDestination,
             source: Privy::SwapSource,
             amount_type: Privy::AmountType::OrSymbol,
-            slippage_bps: Float
+            fee_configuration: Privy::FeeConfiguration,
+            slippage_bps: Integer
           }
         )
       end