privy_ruby 0.2.0 → 0.3.0

data/rbi/privy/models/wallets/list_wallet_actions_response.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module Privy
+  module Models
+    module Wallets
+      class ListWalletActionsResponse < Privy::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Privy::Wallets::ListWalletActionsResponse,
+              Privy::Internal::AnyHash
+            )
+          end
+
+        sig do
+          returns(
+            T::Array[
+              T.any(
+                Privy::Wallets::SwapActionResponse,
+                Privy::Wallets::TransferActionResponse,
+                Privy::Wallets::EarnDepositActionResponse,
+                Privy::Wallets::EarnWithdrawActionResponse,
+                Privy::Wallets::EarnIncentiveClaimActionResponse
+              )
+            ]
+          )
+        end
+        attr_accessor :data
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :next_cursor
+
+        # Paginated list of wallet actions.
+        sig do
+          params(
+            data:
+              T::Array[
+                T.any(
+                  Privy::Wallets::SwapActionResponse::OrHash,
+                  Privy::Wallets::TransferActionResponse::OrHash,
+                  Privy::Wallets::EarnDepositActionResponse::OrHash,
+                  Privy::Wallets::EarnWithdrawActionResponse::OrHash,
+                  Privy::Wallets::EarnIncentiveClaimActionResponse::OrHash
+                )
+              ],
+            next_cursor: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(data:, next_cursor:)
+        end
+
+        sig do
+          override.returns(
+            {
+              data:
+                T::Array[
+                  T.any(
+                    Privy::Wallets::SwapActionResponse,
+                    Privy::Wallets::TransferActionResponse,
+                    Privy::Wallets::EarnDepositActionResponse,
+                    Privy::Wallets::EarnWithdrawActionResponse,
+                    Privy::Wallets::EarnIncentiveClaimActionResponse
+                  )
+                ],
+              next_cursor: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/wallets/svm_transaction_wallet_action_step.rbi

@@ -0,0 +1,137 @@
+# typed: strong
+
+module Privy
+  module Models
+    module Wallets
+      class SvmTransactionWalletActionStep < Privy::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Privy::Wallets::SvmTransactionWalletActionStep,
+              Privy::Internal::AnyHash
+            )
+          end
+
+        # CAIP-2 chain identifier for the Solana network.
+        sig { returns(String) }
+        attr_accessor :caip2
+
+        # Status of an SVM step in a wallet action.
+        sig { returns(Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol) }
+        attr_accessor :status
+
+        # The Solana transaction signature (base58-encoded). Null until broadcast.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :transaction_signature
+
+        sig do
+          returns(
+            Privy::Wallets::SvmTransactionWalletActionStep::Type::TaggedSymbol
+          )
+        end
+        attr_accessor :type
+
+        # A description of why a wallet action (or a step within a wallet action) failed.
+        sig { returns(T.nilable(Privy::Wallets::FailureReason)) }
+        attr_reader :failure_reason
+
+        sig do
+          params(failure_reason: Privy::Wallets::FailureReason::OrHash).void
+        end
+        attr_writer :failure_reason
+
+        # Whether this step has reached on-chain finality. Absent until finality is
+        # confirmed.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :finalized
+
+        sig { params(finalized: T::Boolean).void }
+        attr_writer :finalized
+
+        # Amount charged in USD for gas sponsorship on this step.
+        sig { returns(T.nilable(String)) }
+        attr_reader :gas_credits_charged_usd
+
+        sig { params(gas_credits_charged_usd: String).void }
+        attr_writer :gas_credits_charged_usd
+
+        # A wallet action step consisting of an SVM (Solana) transaction.
+        sig do
+          params(
+            caip2: String,
+            status: Privy::Wallets::SvmWalletActionStepStatus::OrSymbol,
+            transaction_signature: T.nilable(String),
+            type:
+              Privy::Wallets::SvmTransactionWalletActionStep::Type::OrSymbol,
+            failure_reason: Privy::Wallets::FailureReason::OrHash,
+            finalized: T::Boolean,
+            gas_credits_charged_usd: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # CAIP-2 chain identifier for the Solana network.
+          caip2:,
+          # Status of an SVM step in a wallet action.
+          status:,
+          # The Solana transaction signature (base58-encoded). Null until broadcast.
+          transaction_signature:,
+          type:,
+          # A description of why a wallet action (or a step within a wallet action) failed.
+          failure_reason: nil,
+          # Whether this step has reached on-chain finality. Absent until finality is
+          # confirmed.
+          finalized: nil,
+          # Amount charged in USD for gas sponsorship on this step.
+          gas_credits_charged_usd: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              caip2: String,
+              status: Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol,
+              transaction_signature: T.nilable(String),
+              type:
+                Privy::Wallets::SvmTransactionWalletActionStep::Type::TaggedSymbol,
+              failure_reason: Privy::Wallets::FailureReason,
+              finalized: T::Boolean,
+              gas_credits_charged_usd: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module Type
+          extend Privy::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Privy::Wallets::SvmTransactionWalletActionStep::Type
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SVM_TRANSACTION =
+            T.let(
+              :svm_transaction,
+              Privy::Wallets::SvmTransactionWalletActionStep::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Privy::Wallets::SvmTransactionWalletActionStep::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/wallets/svm_wallet_action_step_status.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module Privy
+  module Models
+    module Wallets
+      # Status of an SVM step in a wallet action.
+      module SvmWalletActionStepStatus
+        extend Privy::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Privy::Wallets::SvmWalletActionStepStatus)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PREPARING =
+          T.let(
+            :preparing,
+            Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol
+          )
+        QUEUED =
+          T.let(
+            :queued,
+            Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol
+          )
+        PENDING =
+          T.let(
+            :pending,
+            Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol
+          )
+        CONFIRMED =
+          T.let(
+            :confirmed,
+            Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol
+          )
+        REJECTED =
+          T.let(
+            :rejected,
+            Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol
+          )
+        REVERTED =
+          T.let(
+            :reverted,
+            Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol
+          )
+        FAILED =
+          T.let(
+            :failed,
+            Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Privy::Wallets::SvmWalletActionStepStatus::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/wallets/swap_action_response.rbi

@@ -0,0 +1,273 @@
+# typed: strong
+
+module Privy
+  module Models
+    module Wallets
+      class SwapActionResponse < Privy::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Privy::Wallets::SwapActionResponse, Privy::Internal::AnyHash)
+          end
+
+        # The ID of the wallet action.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # CAIP-2 chain identifier for the swap.
+        sig { returns(String) }
+        attr_accessor :caip2
+
+        # ISO 8601 timestamp of when the wallet action was created.
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # Exact base-unit amount of input token. Populated after on-chain confirmation.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :input_amount
+
+        # Token address or "native" for the token being sold.
+        sig { returns(String) }
+        attr_accessor :input_token
+
+        # Exact base-unit amount of output token. Populated after on-chain confirmation.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :output_amount
+
+        # Token address or "native" for the token being bought.
+        sig { returns(String) }
+        attr_accessor :output_token
+
+        # Status of a wallet action.
+        sig { returns(Privy::Wallets::WalletActionStatus::TaggedSymbol) }
+        attr_accessor :status
+
+        sig { returns(Privy::Wallets::SwapActionResponse::Type::TaggedSymbol) }
+        attr_accessor :type
+
+        # The ID of the wallet involved in the action.
+        sig { returns(String) }
+        attr_accessor :wallet_id
+
+        # Recipient address on the destination chain. Present for cross-chain swaps. May
+        # differ from the source wallet address when swapping between 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
+
+        # 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. Only present for cross-chain
+        # swaps. Populated after on-chain confirmation.
+        sig { returns(T.nilable(T::Array[Privy::FeeLineItem::Variants])) }
+        attr_accessor :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: T.nilable(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::Wallets::FailureReason)) }
+        attr_reader :failure_reason
+
+        sig do
+          params(failure_reason: Privy::Wallets::FailureReason::OrHash).void
+        end
+        attr_writer :failure_reason
+
+        # Actual fees paid for the swap. Populated after on-chain confirmation. Only
+        # present for cross-chain swaps.
+        sig { returns(T.nilable(T::Array[Privy::FeeLineItem::Variants])) }
+        attr_accessor :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: T.nilable(Privy::Gas::OrHash)).void }
+        attr_writer :gas
+
+        # The steps of the wallet action. Only returned if `?include=steps` is provided.
+        sig do
+          returns(
+            T.nilable(T::Array[Privy::Wallets::WalletActionStep::Variants])
+          )
+        end
+        attr_reader :steps
+
+        sig do
+          params(
+            steps:
+              T::Array[
+                T.any(
+                  Privy::Wallets::EvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::EvmUserOperationWalletActionStep::OrHash,
+                  Privy::Wallets::SvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::TvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::ExternalTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::CustodianTransactionWalletActionStep::OrHash
+                )
+              ]
+          ).void
+        end
+        attr_writer :steps
+
+        # Response for a swap action.
+        sig do
+          params(
+            id: String,
+            caip2: String,
+            created_at: Time,
+            input_amount: T.nilable(String),
+            input_token: String,
+            output_amount: T.nilable(String),
+            output_token: String,
+            status: Privy::Wallets::WalletActionStatus::OrSymbol,
+            type: Privy::Wallets::SwapActionResponse::Type::OrSymbol,
+            wallet_id: String,
+            destination_address: String,
+            destination_caip2: String,
+            estimated_fees:
+              T.nilable(
+                T::Array[
+                  T.any(
+                    Privy::RelayerFee::OrHash,
+                    Privy::PrivyFee::OrHash,
+                    Privy::DeveloperFee::OrHash
+                  )
+                ]
+              ),
+            estimated_gas: T.nilable(Privy::Gas::OrHash),
+            failure_reason: Privy::Wallets::FailureReason::OrHash,
+            fees:
+              T.nilable(
+                T::Array[
+                  T.any(
+                    Privy::RelayerFee::OrHash,
+                    Privy::PrivyFee::OrHash,
+                    Privy::DeveloperFee::OrHash
+                  )
+                ]
+              ),
+            gas: T.nilable(Privy::Gas::OrHash),
+            steps:
+              T::Array[
+                T.any(
+                  Privy::Wallets::EvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::EvmUserOperationWalletActionStep::OrHash,
+                  Privy::Wallets::SvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::TvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::ExternalTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::CustodianTransactionWalletActionStep::OrHash
+                )
+              ]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The ID of the wallet action.
+          id:,
+          # CAIP-2 chain identifier for the swap.
+          caip2:,
+          # ISO 8601 timestamp of when the wallet action was created.
+          created_at:,
+          # Exact base-unit amount of input token. Populated after on-chain confirmation.
+          input_amount:,
+          # Token address or "native" for the token being sold.
+          input_token:,
+          # Exact base-unit amount of output token. Populated after on-chain confirmation.
+          output_amount:,
+          # Token address or "native" for the token being bought.
+          output_token:,
+          # Status of a wallet action.
+          status:,
+          type:,
+          # The ID of the wallet involved in the action.
+          wallet_id:,
+          # Recipient address on the destination chain. Present for cross-chain swaps. May
+          # differ from the source wallet address when swapping between chain types (e.g.
+          # EVM to Solana).
+          destination_address: nil,
+          # Destination chain CAIP-2 identifier. Present for cross-chain swaps.
+          destination_caip2: nil,
+          # Estimated fee breakdown from the provider quote. Only present for cross-chain
+          # swaps. Populated after on-chain confirmation.
+          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. Only
+          # present for cross-chain swaps.
+          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
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              caip2: String,
+              created_at: Time,
+              input_amount: T.nilable(String),
+              input_token: String,
+              output_amount: T.nilable(String),
+              output_token: String,
+              status: Privy::Wallets::WalletActionStatus::TaggedSymbol,
+              type: Privy::Wallets::SwapActionResponse::Type::TaggedSymbol,
+              wallet_id: String,
+              destination_address: String,
+              destination_caip2: String,
+              estimated_fees: T.nilable(T::Array[Privy::FeeLineItem::Variants]),
+              estimated_gas: T.nilable(Privy::Gas),
+              failure_reason: Privy::Wallets::FailureReason,
+              fees: T.nilable(T::Array[Privy::FeeLineItem::Variants]),
+              gas: T.nilable(Privy::Gas),
+              steps: T::Array[Privy::Wallets::WalletActionStep::Variants]
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module Type
+          extend Privy::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Privy::Wallets::SwapActionResponse::Type)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SWAP =
+            T.let(:swap, Privy::Wallets::SwapActionResponse::Type::TaggedSymbol)
+
+          sig do
+            override.returns(
+              T::Array[Privy::Wallets::SwapActionResponse::Type::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -32,11 +32,20 @@ module Privy
         sig { params(privy_idempotency_key: String).void }
         attr_writer :privy_idempotency_key
 
+        # Request expiry. Value is a Unix timestamp in milliseconds representing the
+        # deadline by which the request must be processed.
+        sig { returns(T.nilable(String)) }
+        attr_reader :privy_request_expiry
+
+        sig { params(privy_request_expiry: String).void }
+        attr_writer :privy_request_expiry
+
         sig do
           params(
             wallet_id: String,
             privy_authorization_signature: String,
             privy_idempotency_key: String,
+            privy_request_expiry: String,
             request_options: Privy::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -49,6 +58,9 @@ module Privy
           # Idempotency keys ensure API requests are executed only once within a 24-hour
           # window.
           privy_idempotency_key: nil,
+          # Request expiry. Value is a Unix timestamp in milliseconds representing the
+          # deadline by which the request must be processed.
+          privy_request_expiry: nil,
           request_options: {}
         )
         end
@@ -59,6 +71,7 @@ module Privy
               wallet_id: String,
               privy_authorization_signature: String,
               privy_idempotency_key: String,
+              privy_request_expiry: String,
               request_options: Privy::RequestOptions
             }
           )

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

@@ -24,10 +24,19 @@ module Privy
         sig { params(privy_authorization_signature: String).void }
         attr_writer :privy_authorization_signature
 
+        # Request expiry. Value is a Unix timestamp in milliseconds representing the
+        # deadline by which the request must be processed.
+        sig { returns(T.nilable(String)) }
+        attr_reader :privy_request_expiry
+
+        sig { params(privy_request_expiry: String).void }
+        attr_writer :privy_request_expiry
+
         sig do
           params(
             wallet_id: String,
             privy_authorization_signature: String,
+            privy_request_expiry: String,
             request_options: Privy::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -37,6 +46,9 @@ module Privy
           # Request authorization signature. If multiple signatures are required, they
           # should be comma separated.
           privy_authorization_signature: nil,
+          # Request expiry. Value is a Unix timestamp in milliseconds representing the
+          # deadline by which the request must be processed.
+          privy_request_expiry: nil,
           request_options: {}
         )
         end
@@ -46,6 +58,7 @@ module Privy
             {
               wallet_id: String,
               privy_authorization_signature: String,
+              privy_request_expiry: String,
               request_options: Privy::RequestOptions
             }
           )

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

@@ -69,6 +69,13 @@ module Privy
         sig { params(cursor: String).void }
         attr_writer :cursor
 
+        # Include archived wallets in lookup. Defaults to false.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :include_archived
+
+        sig { params(include_archived: T::Boolean).void }
+        attr_writer :include_archived
+
         sig { returns(T.nilable(Float)) }
         attr_accessor :limit
 
@@ -89,6 +96,7 @@ module Privy
                 T::Array[Privy::WalletAsset::OrSymbol]
               ),
             cursor: String,
+            include_archived: T::Boolean,
             limit: T.nilable(Float),
             tx_hash: String,
             request_options: Privy::RequestOptions::OrHash
@@ -105,6 +113,8 @@ module Privy
           # `token`.
           asset: nil,
           cursor: nil,
+          # Include archived wallets in lookup. Defaults to false.
+          include_archived: nil,
           limit: nil,
           tx_hash: nil,
           request_options: {}
@@ -123,6 +133,7 @@ module Privy
                   T::Array[Privy::WalletAsset::OrSymbol]
                 ),
               cursor: String,
+              include_archived: T::Boolean,
               limit: T.nilable(Float),
               tx_hash: String,
               request_options: Privy::RequestOptions