privy_ruby 0.0.2 → 0.1.0

data/rbi/privy/models/stripe_crypto_customer_none.rbi

@@ -0,0 +1,53 @@
+# typed: strong
+
+module Privy
+  module Models
+    class StripeCryptoCustomerNone < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::StripeCryptoCustomerNone, Privy::Internal::AnyHash)
+        end
+
+      sig { returns(Privy::StripeCryptoCustomerNone::Status::OrSymbol) }
+      attr_accessor :status
+
+      # No onramp session. User must authenticate via Link.
+      sig do
+        params(
+          status: Privy::StripeCryptoCustomerNone::Status::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(status:)
+      end
+
+      sig do
+        override.returns(
+          { status: Privy::StripeCryptoCustomerNone::Status::OrSymbol }
+        )
+      end
+      def to_hash
+      end
+
+      module Status
+        extend Privy::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Privy::StripeCryptoCustomerNone::Status)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        NONE =
+          T.let(:none, Privy::StripeCryptoCustomerNone::Status::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Privy::StripeCryptoCustomerNone::Status::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

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,23 @@ 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
+
       # 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
@@ -55,20 +62,7 @@ module Privy
       attr_writer :failure_reason
 
       # The steps of the wallet action. Only returned if `?include=steps` is provided.
-      sig do
-        returns(
-          T.nilable(
-            T::Array[
-              T.any(
-                Privy::EvmTransactionWalletActionStep,
-                Privy::EvmUserOperationWalletActionStep,
-                Privy::SvmTransactionWalletActionStep,
-                Privy::ExternalTransactionWalletActionStep
-              )
-            ]
-          )
-        )
-      end
+      sig { returns(T.nilable(T::Array[Privy::WalletActionStep::Variants])) }
       attr_reader :steps
 
       sig do
@@ -99,6 +93,7 @@ module Privy
           status: Privy::WalletActionStatus::OrSymbol,
           type: Privy::SwapActionResponse::Type::OrSymbol,
           wallet_id: String,
+          destination_caip2: String,
           failure_reason: Privy::FailureReason::OrHash,
           steps:
             T::Array[
@@ -131,6 +126,8 @@ 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,
         # A description of why a wallet action (or a step within a wallet action) failed.
         failure_reason: nil,
         # The steps of the wallet action. Only returned if `?include=steps` is provided.
@@ -148,19 +145,12 @@ 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,
             failure_reason: Privy::FailureReason,
-            steps:
-              T::Array[
-                T.any(
-                  Privy::EvmTransactionWalletActionStep,
-                  Privy::EvmUserOperationWalletActionStep,
-                  Privy::SvmTransactionWalletActionStep,
-                  Privy::ExternalTransactionWalletActionStep
-                )
-              ]
+            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,6 +33,13 @@ 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)) }
@@ -48,6 +55,7 @@ module Privy
           destination: Privy::SwapQuoteDestination::OrHash,
           source: Privy::SwapSource::OrHash,
           amount_type: Privy::AmountType::OrSymbol,
+          fee_configuration: Privy::FeeConfiguration::OrHash,
           slippage_bps: Float
         ).returns(T.attached_class)
       end
@@ -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,6 +83,7 @@ module Privy
             destination: Privy::SwapQuoteDestination,
             source: Privy::SwapSource,
             amount_type: Privy::AmountType::OrSymbol,
+            fee_configuration: Privy::FeeConfiguration,
             slippage_bps: Float
           }
         )

data/rbi/privy/models/swap_quote_response.rbi

@@ -36,6 +36,38 @@ 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 in USD.
+      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
+
+      # 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 +77,17 @@ 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
+              )
+            ],
+          expires_at: Float
         ).returns(T.attached_class)
       end
       def self.new(
@@ -62,7 +104,13 @@ 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 in USD.
+        estimated_fees: nil,
+        # Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
+        expires_at: nil
       )
       end
 
@@ -75,7 +123,10 @@ 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],
+            expires_at: Float
           }
         )
       end

data/rbi/privy/models/swap_request_body.rbi

@@ -31,6 +31,13 @@ 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)) }
       attr_reader :slippage_bps
@@ -45,6 +52,7 @@ module Privy
           destination: Privy::SwapDestination::OrHash,
           source: Privy::SwapSource::OrHash,
           amount_type: Privy::AmountType::OrSymbol,
+          fee_configuration: Privy::FeeConfiguration::OrHash,
           slippage_bps: Float
         ).returns(T.attached_class)
       end
@@ -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,6 +79,7 @@ module Privy
             destination: Privy::SwapDestination,
             source: Privy::SwapSource,
             amount_type: Privy::AmountType::OrSymbol,
+            fee_configuration: Privy::FeeConfiguration,
             slippage_bps: Float
           }
         )

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