privy_ruby 0.1.0 → 0.3.0

data/lib/privy/resources/intents.rb

@@ -2,6 +2,7 @@
 
 module Privy
   module Resources
+    # Operations related to authorization intents for wallet actions
     class Intents
       # List intents for an app. Returns a paginated list of intents with their current
       # status and details.
@@ -56,7 +57,7 @@ module Privy
       #
       # @param action [Symbol, Privy::Models::PolicyAction] Body param: The action to take when a policy rule matches.
       #
-      # @param conditions [Array<Privy::Models::EthereumTransactionCondition, Privy::Models::EthereumCalldataCondition, Privy::Models::EthereumTypedDataDomainCondition, Privy::Models::EthereumTypedDataMessageCondition, Privy::Models::Ethereum7702AuthorizationCondition, Privy::Models::TempoTransactionCondition, Privy::Models::SolanaProgramInstructionCondition, Privy::Models::SolanaSystemProgramInstructionCondition, Privy::Models::SolanaTokenProgramInstructionCondition, Privy::Models::SystemCondition, Privy::Models::TronTransactionCondition, Privy::Models::TronCalldataCondition, Privy::Models::SuiTransactionCommandCondition, Privy::Models::SuiTransferObjectsCommandCondition, Privy::Models::ActionRequestBodyCondition, Privy::Models::AggregationCondition>] Body param
+      # @param conditions [Array<Privy::Models::EthereumTransactionCondition, Privy::Models::EthereumCalldataCondition, Privy::Models::EthereumTypedDataDomainCondition, Privy::Models::EthereumTypedDataMessageCondition, Privy::Models::Ethereum7702AuthorizationCondition, Privy::Models::TempoTransactionCondition, Privy::Models::SolanaProgramInstructionCondition, Privy::Models::SolanaSystemProgramInstructionCondition, Privy::Models::SolanaTokenProgramInstructionCondition, Privy::Models::SystemCondition, Privy::Models::TronTransactionCondition, Privy::Models::TronCalldataCondition, Privy::Models::SuiTransactionCommandCondition, Privy::Models::SuiTransferObjectsCommandCondition, Privy::Models::ActionRequestBodyCondition, Privy::Models::AggregationCondition, Privy::Models::MessageSigningCondition>] Body param
       #
       # @param method_ [Symbol, Privy::Models::PolicyMethod] Body param: Method the rule applies to.
       #
@@ -147,7 +148,7 @@ module Privy
       #
       # @param wallet_id [String] Path param: ID of the wallet.
       #
-      # @param wallet_rpc_request_body [Privy::Models::EthereumSignTransactionRpcInput, Privy::Models::EthereumSendTransactionRpcInput, Privy::Models::EthereumPersonalSignRpcInput, Privy::Models::EthereumSignTypedDataRpcInput, Privy::Models::EthereumSecp256k1SignRpcInput, Privy::Models::EthereumSign7702AuthorizationRpcInput, Privy::Models::EthereumSignUserOperationRpcInput, Privy::Models::EthereumSendCallsRpcInput, Privy::Models::SolanaSignTransactionRpcInput, Privy::Models::SolanaSignAndSendTransactionRpcInput, Privy::Models::SolanaSignMessageRpcInput, Privy::Models::SparkTransferRpcInput, Privy::Models::SparkGetBalanceRpcInput, Privy::Models::SparkTransferTokensRpcInput, Privy::Models::SparkGetStaticDepositAddressRpcInput, Privy::Models::SparkGetClaimStaticDepositQuoteRpcInput, Privy::Models::SparkClaimStaticDepositRpcInput, Privy::Models::SparkCreateLightningInvoiceRpcInput, Privy::Models::SparkPayLightningInvoiceRpcInput, Privy::Models::SparkSignMessageWithIdentityKeyRpcInput, Privy::Models::ExportPrivateKeyRpcInput, Privy::Models::ExportSeedPhraseRpcInput] Body param: Request body for wallet RPC operations, discriminated by method.
+      # @param wallet_rpc_request_body [Privy::Models::EthereumSignTransactionRpcInput, Privy::Models::EthereumSendTransactionRpcInput, Privy::Models::EthereumPersonalSignRpcInput, Privy::Models::EthereumSignTypedDataRpcInput, Privy::Models::EthereumSecp256k1SignRpcInput, Privy::Models::EthereumSign7702AuthorizationRpcInput, Privy::Models::EthereumSignUserOperationRpcInput, Privy::Models::EthereumSendCallsRpcInput, Privy::Models::SolanaSignTransactionRpcInput, Privy::Models::SolanaSignAndSendTransactionRpcInput, Privy::Models::SolanaSignMessageRpcInput, Privy::Models::SparkTransferRpcInput, Privy::Models::SparkGetBalanceRpcInput, Privy::Models::SparkTransferTokensRpcInput, Privy::Models::SparkGetStaticDepositAddressRpcInput, Privy::Models::SparkGetClaimStaticDepositQuoteRpcInput, Privy::Models::SparkClaimStaticDepositRpcInput, Privy::Models::SparkCreateLightningInvoiceRpcInput, Privy::Models::SparkPayLightningInvoiceRpcInput, Privy::Models::SparkSignMessageWithIdentityKeyRpcInput, Privy::Models::TronSignTransactionRpcInput, Privy::Models::TronSendTransactionRpcInput, Privy::Models::ExportPrivateKeyRpcInput, Privy::Models::ExportSeedPhraseRpcInput] Body param: Request body for wallet RPC operations, discriminated by method.
       #
       # @param privy_request_expiry [String] Header param: Request expiry. Value is a Unix timestamp in milliseconds represen
       #
@@ -174,7 +175,7 @@ module Privy
       # Create an intent to execute a token transfer via a wallet. The intent must be
       # authorized by either the wallet owner or signers before it can be executed.
       #
-      # @overload transfer(wallet_id, destination:, source:, amount_type: nil, fee_configuration: nil, slippage_bps: nil, privy_request_expiry: nil, request_options: {})
+      # @overload transfer(wallet_id, destination:, source:, amount: nil, amount_type: nil, fee_configuration: nil, slippage_bps: nil, privy_request_expiry: nil, request_options: {})
       #
       # @param wallet_id [String] Path param: ID of the wallet.
       #
@@ -182,11 +183,13 @@ module Privy
       #
       # @param source [Privy::Models::NamedTokenTransferSource, Privy::Models::CustomTokenTransferSource] Body param: The source asset, amount, and chain for a token transfer. Specify ei
       #
+      # @param amount [String] Body param: Amount as a decimal string in the token's standard unit (e.g. "1.5"
+      #
       # @param amount_type [Symbol, Privy::Models::AmountType] Body param: Whether the amount refers to the input token or output token.
       #
       # @param fee_configuration [Privy::Models::FeeConfiguration] Body param: Total fees assessed on a transfer, in BPS
       #
-      # @param slippage_bps [Integer] Body param: Maximum allowed slippage in basis points (1 bps = 0.01%).
+      # @param slippage_bps [Integer] Body param: Maximum allowed slippage in basis points (1 bps = 0.01%). Only appli
       #
       # @param privy_request_expiry [String] Header param: Request expiry. Value is a Unix timestamp in milliseconds represen
       #
@@ -300,7 +303,7 @@ module Privy
       #
       # @param action [Symbol, Privy::Models::PolicyAction] Body param: The action to take when a policy rule matches.
       #
-      # @param conditions [Array<Privy::Models::EthereumTransactionCondition, Privy::Models::EthereumCalldataCondition, Privy::Models::EthereumTypedDataDomainCondition, Privy::Models::EthereumTypedDataMessageCondition, Privy::Models::Ethereum7702AuthorizationCondition, Privy::Models::TempoTransactionCondition, Privy::Models::SolanaProgramInstructionCondition, Privy::Models::SolanaSystemProgramInstructionCondition, Privy::Models::SolanaTokenProgramInstructionCondition, Privy::Models::SystemCondition, Privy::Models::TronTransactionCondition, Privy::Models::TronCalldataCondition, Privy::Models::SuiTransactionCommandCondition, Privy::Models::SuiTransferObjectsCommandCondition, Privy::Models::ActionRequestBodyCondition, Privy::Models::AggregationCondition>] Body param
+      # @param conditions [Array<Privy::Models::EthereumTransactionCondition, Privy::Models::EthereumCalldataCondition, Privy::Models::EthereumTypedDataDomainCondition, Privy::Models::EthereumTypedDataMessageCondition, Privy::Models::Ethereum7702AuthorizationCondition, Privy::Models::TempoTransactionCondition, Privy::Models::SolanaProgramInstructionCondition, Privy::Models::SolanaSystemProgramInstructionCondition, Privy::Models::SolanaTokenProgramInstructionCondition, Privy::Models::SystemCondition, Privy::Models::TronTransactionCondition, Privy::Models::TronCalldataCondition, Privy::Models::SuiTransactionCommandCondition, Privy::Models::SuiTransferObjectsCommandCondition, Privy::Models::ActionRequestBodyCondition, Privy::Models::AggregationCondition, Privy::Models::MessageSigningCondition>] Body param
       #
       # @param method_ [Symbol, Privy::Models::PolicyMethod] Body param: Method the rule applies to.
       #

data/lib/privy/resources/policies.rb

@@ -129,7 +129,7 @@ module Privy
       #
       # @param action [Symbol, Privy::Models::PolicyAction] Body param: The action to take when a policy rule matches.
       #
-      # @param conditions [Array<Privy::Models::EthereumTransactionCondition, Privy::Models::EthereumCalldataCondition, Privy::Models::EthereumTypedDataDomainCondition, Privy::Models::EthereumTypedDataMessageCondition, Privy::Models::Ethereum7702AuthorizationCondition, Privy::Models::TempoTransactionCondition, Privy::Models::SolanaProgramInstructionCondition, Privy::Models::SolanaSystemProgramInstructionCondition, Privy::Models::SolanaTokenProgramInstructionCondition, Privy::Models::SystemCondition, Privy::Models::TronTransactionCondition, Privy::Models::TronCalldataCondition, Privy::Models::SuiTransactionCommandCondition, Privy::Models::SuiTransferObjectsCommandCondition, Privy::Models::ActionRequestBodyCondition, Privy::Models::AggregationCondition>] Body param
+      # @param conditions [Array<Privy::Models::EthereumTransactionCondition, Privy::Models::EthereumCalldataCondition, Privy::Models::EthereumTypedDataDomainCondition, Privy::Models::EthereumTypedDataMessageCondition, Privy::Models::Ethereum7702AuthorizationCondition, Privy::Models::TempoTransactionCondition, Privy::Models::SolanaProgramInstructionCondition, Privy::Models::SolanaSystemProgramInstructionCondition, Privy::Models::SolanaTokenProgramInstructionCondition, Privy::Models::SystemCondition, Privy::Models::TronTransactionCondition, Privy::Models::TronCalldataCondition, Privy::Models::SuiTransactionCommandCondition, Privy::Models::SuiTransferObjectsCommandCondition, Privy::Models::ActionRequestBodyCondition, Privy::Models::AggregationCondition, Privy::Models::MessageSigningCondition>] Body param
       #
       # @param method_ [Symbol, Privy::Models::PolicyMethod] Body param: Method the rule applies to.
       #
@@ -256,7 +256,7 @@ module Privy
       #
       # @param action [Symbol, Privy::Models::PolicyAction] Body param: The action to take when a policy rule matches.
       #
-      # @param conditions [Array<Privy::Models::EthereumTransactionCondition, Privy::Models::EthereumCalldataCondition, Privy::Models::EthereumTypedDataDomainCondition, Privy::Models::EthereumTypedDataMessageCondition, Privy::Models::Ethereum7702AuthorizationCondition, Privy::Models::TempoTransactionCondition, Privy::Models::SolanaProgramInstructionCondition, Privy::Models::SolanaSystemProgramInstructionCondition, Privy::Models::SolanaTokenProgramInstructionCondition, Privy::Models::SystemCondition, Privy::Models::TronTransactionCondition, Privy::Models::TronCalldataCondition, Privy::Models::SuiTransactionCommandCondition, Privy::Models::SuiTransferObjectsCommandCondition, Privy::Models::ActionRequestBodyCondition, Privy::Models::AggregationCondition>] Body param
+      # @param conditions [Array<Privy::Models::EthereumTransactionCondition, Privy::Models::EthereumCalldataCondition, Privy::Models::EthereumTypedDataDomainCondition, Privy::Models::EthereumTypedDataMessageCondition, Privy::Models::Ethereum7702AuthorizationCondition, Privy::Models::TempoTransactionCondition, Privy::Models::SolanaProgramInstructionCondition, Privy::Models::SolanaSystemProgramInstructionCondition, Privy::Models::SolanaTokenProgramInstructionCondition, Privy::Models::SystemCondition, Privy::Models::TronTransactionCondition, Privy::Models::TronCalldataCondition, Privy::Models::SuiTransactionCommandCondition, Privy::Models::SuiTransferObjectsCommandCondition, Privy::Models::ActionRequestBodyCondition, Privy::Models::AggregationCondition, Privy::Models::MessageSigningCondition>] Body param
       #
       # @param method_ [Symbol, Privy::Models::PolicyMethod] Body param: Method the rule applies to.
       #

data/lib/privy/resources/wallets/actions.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Privy
+  module Resources
+    class Wallets
+      # Operations related to wallet actions
+      class Actions
+        # Some parameter documentations has been truncated, see
+        # {Privy::Models::Wallets::ActionGetParams} for more details.
+        #
+        # Get the current status of a wallet action by its ID. Use `?include=steps` to
+        # include step-level details.
+        #
+        # @overload get(action_id, wallet_id:, include: nil, privy_authorization_signature: nil, request_options: {})
+        #
+        # @param action_id [String] Path param: ID of the wallet action.
+        #
+        # @param wallet_id [String] Path param: ID of the wallet.
+        #
+        # @param include [Symbol, Privy::Models::Wallets::WalletActionInclude] Query param: Expandable relations to include on a wallet action response.
+        #
+        # @param privy_authorization_signature [String] Header param: Request authorization signature. If multiple signatures are requir
+        #
+        # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Privy::Models::Wallets::SwapActionResponse, Privy::Models::Wallets::TransferActionResponse, Privy::Models::Wallets::EarnDepositActionResponse, Privy::Models::Wallets::EarnWithdrawActionResponse, Privy::Models::Wallets::EarnIncentiveClaimActionResponse]
+        #
+        # @see Privy::Models::Wallets::ActionGetParams
+        def get(action_id, params)
+          query_params = [:include]
+          parsed, options = Privy::Wallets::ActionGetParams.dump_request(params)
+          query = Privy::Internal::Util.encode_query_params(parsed.slice(*query_params))
+          wallet_id =
+            parsed.delete(:wallet_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["v1/wallets/%1$s/actions/%2$s", wallet_id, action_id],
+            query: query,
+            headers: parsed.except(*query_params).transform_keys(
+              privy_authorization_signature: "privy-authorization-signature"
+            ),
+            model: Privy::Wallets::WalletActionResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Privy::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/privy/resources/wallets/balance.rb

@@ -10,7 +10,7 @@ module Privy
         #
         # Get the balance of a wallet by wallet ID.
         #
-        # @overload get(wallet_id, token: nil, asset: nil, chain: nil, include_currency: nil, request_options: {})
+        # @overload get(wallet_id, token: nil, asset: nil, chain: nil, include_archived: nil, include_currency: nil, request_options: {})
         #
         # @param wallet_id [String] ID of the wallet.
         #
@@ -18,7 +18,9 @@ module Privy
         #
         # @param asset [Symbol, Array<Symbol, Privy::Models::WalletAsset>, Privy::Models::Wallets::BalanceGetParams::Asset] Named asset(s) to query (e.g. `eth`, `usdc`). Use together with `chain` to scope
         #
-        # @param chain [Symbol, Array<Symbol, Privy::Models::Wallets::BalanceGetParams::Chain::UnionMember1>, Privy::Models::Wallets::BalanceGetParams::Chain] Chain(s) to query named assets on (e.g. `base`, `ethereum`). Use together with `
+        # @param chain [Symbol, Privy::Models::WalletAssetChainNameInput, Array<Symbol, Privy::Models::WalletAssetChainNameInput>] Chain(s) to query named assets on (e.g. `base`, `ethereum`). Use together with `
+        #
+        # @param include_archived [Boolean] Include archived wallets in lookup. Defaults to false.
         #
         # @param include_currency [Symbol, Privy::Models::Wallets::BalanceGetParams::IncludeCurrency] If set, balances are converted to the specified fiat currency. Not supported whe
         #

data/lib/privy/resources/wallets/earn/ethereum/incentive.rb

@@ -26,7 +26,7 @@ module Privy
             #
             # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [Privy::Models::EarnIncentiveClaimActionResponse]
+            # @return [Privy::Models::Wallets::EarnIncentiveClaimActionResponse]
             #
             # @see Privy::Models::Wallets::Earn::Ethereum::IncentiveClaimParams
             def _claim(wallet_id, params)
@@ -42,7 +42,7 @@ module Privy
                 path: ["v1/wallets/%1$s/earn/ethereum/incentive/claim", wallet_id],
                 headers: parsed.slice(*header_params.keys).transform_keys(header_params),
                 body: parsed.except(*header_params.keys),
-                model: Privy::EarnIncentiveClaimActionResponse,
+                model: Privy::Wallets::EarnIncentiveClaimActionResponse,
                 options: options
               )
             end

data/lib/privy/resources/wallets/earn/ethereum.rb

@@ -33,7 +33,7 @@ module Privy
           #
           # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Privy::Models::EarnDepositActionResponse]
+          # @return [Privy::Models::Wallets::EarnDepositActionResponse]
           #
           # @see Privy::Models::Wallets::Earn::EthereumDepositParams
           def _deposit(wallet_id, params)
@@ -49,7 +49,7 @@ module Privy
               path: ["v1/wallets/%1$s/earn/ethereum/deposit", wallet_id],
               headers: parsed.slice(*header_params.keys).transform_keys(header_params),
               body: parsed.except(*header_params.keys),
-              model: Privy::EarnDepositActionResponse,
+              model: Privy::Wallets::EarnDepositActionResponse,
               options: options
             )
           end
@@ -77,7 +77,7 @@ module Privy
           #
           # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Privy::Models::EarnWithdrawActionResponse]
+          # @return [Privy::Models::Wallets::EarnWithdrawActionResponse]
           #
           # @see Privy::Models::Wallets::Earn::EthereumWithdrawParams
           def _withdraw(wallet_id, params)
@@ -93,7 +93,7 @@ module Privy
               path: ["v1/wallets/%1$s/earn/ethereum/withdraw", wallet_id],
               headers: parsed.slice(*header_params.keys).transform_keys(header_params),
               body: parsed.except(*header_params.keys),
-              model: Privy::EarnWithdrawActionResponse,
+              model: Privy::Wallets::EarnWithdrawActionResponse,
               options: options
             )
           end

data/lib/privy/resources/wallets/swap.rb

@@ -10,7 +10,7 @@ module Privy
         #
         # Execute a token swap within a wallet.
         #
-        # @overload execute(wallet_id, base_amount:, destination:, source:, amount_type: nil, fee_configuration: nil, slippage_bps: nil, privy_authorization_signature: nil, privy_idempotency_key: nil, request_options: {})
+        # @overload execute(wallet_id, base_amount:, destination:, source:, amount_type: nil, fee_configuration: nil, slippage_bps: nil, privy_authorization_signature: nil, privy_idempotency_key: nil, privy_request_expiry: nil, request_options: {})
         #
         # @param wallet_id [String] Path param: ID of the wallet.
         #
@@ -24,15 +24,17 @@ module Privy
         #
         # @param fee_configuration [Privy::Models::FeeConfiguration] Body param: Total fees assessed on a transfer, in BPS
         #
-        # @param slippage_bps [Float] Body param: Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
+        # @param slippage_bps [Integer] Body param: Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
         #
         # @param privy_authorization_signature [String] Header param: Request authorization signature. If multiple signatures are requir
         #
         # @param privy_idempotency_key [String] Header param: Idempotency keys ensure API requests are executed only once within
         #
+        # @param privy_request_expiry [String] Header param: Request expiry. Value is a Unix timestamp in milliseconds represen
+        #
         # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Privy::Models::SwapActionResponse]
+        # @return [Privy::Models::Wallets::SwapActionResponse]
         #
         # @see Privy::Models::Wallets::SwapExecuteParams
         def execute(wallet_id, params)
@@ -40,14 +42,15 @@ module Privy
           header_params =
             {
               privy_authorization_signature: "privy-authorization-signature",
-              privy_idempotency_key: "privy-idempotency-key"
+              privy_idempotency_key: "privy-idempotency-key",
+              privy_request_expiry: "privy-request-expiry"
             }
           @client.request(
             method: :post,
             path: ["v1/wallets/%1$s/swap", wallet_id],
             headers: parsed.slice(*header_params.keys).transform_keys(header_params),
             body: parsed.except(*header_params.keys),
-            model: Privy::SwapActionResponse,
+            model: Privy::Wallets::SwapActionResponse,
             options: options
           )
         end
@@ -57,7 +60,7 @@ module Privy
         #
         # Get a price quote for swapping tokens within a wallet.
         #
-        # @overload quote(wallet_id, base_amount:, destination:, source:, amount_type: nil, fee_configuration: nil, slippage_bps: nil, privy_authorization_signature: nil, request_options: {})
+        # @overload quote(wallet_id, base_amount:, destination:, source:, amount_type: nil, fee_configuration: nil, slippage_bps: nil, privy_authorization_signature: nil, privy_request_expiry: nil, request_options: {})
         #
         # @param wallet_id [String] Path param: ID of the wallet.
         #
@@ -71,10 +74,12 @@ module Privy
         #
         # @param fee_configuration [Privy::Models::FeeConfiguration] Body param: Total fees assessed on a transfer, in BPS
         #
-        # @param slippage_bps [Float] Body param: Maximum slippage tolerance in basis points (e.g., 50 for 0.5%). If o
+        # @param slippage_bps [Integer] Body param: Maximum slippage tolerance in basis points (e.g., 50 for 0.5%). If o
         #
         # @param privy_authorization_signature [String] Header param: Request authorization signature. If multiple signatures are requir
         #
+        # @param privy_request_expiry [String] Header param: Request expiry. Value is a Unix timestamp in milliseconds represen
+        #
         # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Privy::Models::SwapQuoteResponse]
@@ -82,7 +87,11 @@ module Privy
         # @see Privy::Models::Wallets::SwapQuoteParams
         def quote(wallet_id, params)
           parsed, options = Privy::Wallets::SwapQuoteParams.dump_request(params)
-          header_params = {privy_authorization_signature: "privy-authorization-signature"}
+          header_params =
+            {
+              privy_authorization_signature: "privy-authorization-signature",
+              privy_request_expiry: "privy-request-expiry"
+            }
           @client.request(
             method: :post,
             path: ["v1/wallets/%1$s/swap/quote", wallet_id],

data/lib/privy/resources/wallets/transactions.rb

@@ -10,7 +10,7 @@ module Privy
         #
         # Get incoming and outgoing transactions of a wallet by wallet ID.
         #
-        # @overload get(wallet_id, chain:, token: nil, asset: nil, cursor: nil, limit: nil, tx_hash: nil, request_options: {})
+        # @overload get(wallet_id, chain:, token: nil, asset: nil, cursor: nil, include_archived: nil, limit: nil, tx_hash: nil, request_options: {})
         #
         # @param wallet_id [String] ID of the wallet.
         #
@@ -22,6 +22,8 @@ module Privy
         #
         # @param cursor [String]
         #
+        # @param include_archived [Boolean] Include archived wallets in lookup. Defaults to false.
+        #
         # @param limit [Float, nil]
         #
         # @param tx_hash [String]

data/lib/privy/resources/wallets.rb

@@ -3,6 +3,10 @@
 module Privy
   module Resources
     class Wallets
+      # Operations related to wallet actions
+      # @return [Privy::Resources::Wallets::Actions]
+      attr_reader :actions
+
       # @return [Privy::Resources::Wallets::Earn]
       attr_reader :earn
 
@@ -109,7 +113,9 @@ module Privy
       #
       # Get all wallets in your app.
       #
-      # @overload list(authorization_key: nil, chain_type: nil, cursor: nil, external_id: nil, limit: nil, user_id: nil, request_options: {})
+      # @overload list(address: nil, authorization_key: nil, chain_type: nil, cursor: nil, external_id: nil, include_archived: nil, limit: nil, user_id: nil, request_options: {})
+      #
+      # @param address [String] A blockchain wallet address. Ethereum addresses are normalized to EIP-55 checksu
       #
       # @param authorization_key [String] Filter wallets by authorization public key. Returns wallets owned by key quorums
       #
@@ -119,6 +125,8 @@ module Privy
       #
       # @param external_id [String] Filter wallets by external ID.
       #
+      # @param include_archived [Boolean] Include archived wallets in lookup. Defaults to false.
+      #
       # @param limit [Float, nil]
       #
       # @param user_id [String] Filter wallets by user ID. Cannot be used together with authorization_key.
@@ -205,7 +213,7 @@ module Privy
       #
       # Transfer tokens from a wallet to a destination address.
       #
-      # @overload _transfer(wallet_id, destination:, source:, amount_type: nil, fee_configuration: nil, slippage_bps: nil, privy_authorization_signature: nil, privy_idempotency_key: nil, privy_request_expiry: nil, request_options: {})
+      # @overload _transfer(wallet_id, destination:, source:, amount: nil, amount_type: nil, fee_configuration: nil, slippage_bps: nil, privy_authorization_signature: nil, privy_idempotency_key: nil, privy_request_expiry: nil, request_options: {})
       #
       # @param wallet_id [String] Path param: ID of the wallet.
       #
@@ -213,11 +221,13 @@ module Privy
       #
       # @param source [Privy::Models::NamedTokenTransferSource, Privy::Models::CustomTokenTransferSource] Body param: The source asset, amount, and chain for a token transfer. Specify ei
       #
+      # @param amount [String] Body param: Amount as a decimal string in the token's standard unit (e.g. "1.5"
+      #
       # @param amount_type [Symbol, Privy::Models::AmountType] Body param: Whether the amount refers to the input token or output token.
       #
       # @param fee_configuration [Privy::Models::FeeConfiguration] Body param: Total fees assessed on a transfer, in BPS
       #
-      # @param slippage_bps [Integer] Body param: Maximum allowed slippage in basis points (1 bps = 0.01%).
+      # @param slippage_bps [Integer] Body param: Maximum allowed slippage in basis points (1 bps = 0.01%). Only appli
       #
       # @param privy_authorization_signature [String] Header param: Request authorization signature. If multiple signatures are requir
       #
@@ -227,7 +237,7 @@ module Privy
       #
       # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Privy::Models::TransferActionResponse]
+      # @return [Privy::Models::Wallets::TransferActionResponse]
       #
       # @see Privy::Models::WalletTransferParams
       def _transfer(wallet_id, params)
@@ -243,11 +253,33 @@ module Privy
           path: ["v1/wallets/%1$s/transfer", wallet_id],
           headers: parsed.slice(*header_params.keys).transform_keys(header_params),
           body: parsed.except(*header_params.keys),
-          model: Privy::TransferActionResponse,
+          model: Privy::Wallets::TransferActionResponse,
           options: options
         )
       end
 
+      # Archives a wallet, preventing it from being used in any write or signing
+      # operations. Archived wallets are hidden from list endpoints by default. Returns
+      # 404 if the wallet does not exist or is already archived.
+      #
+      # @overload archive(wallet_id, request_options: {})
+      #
+      # @param wallet_id [String] ID of the wallet.
+      #
+      # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Privy::Models::Wallet]
+      #
+      # @see Privy::Models::WalletArchiveParams
+      def archive(wallet_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["v1/wallets/%1$s/archive", wallet_id],
+          model: Privy::Wallet,
+          options: params[:request_options]
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Privy::Models::WalletAuthenticateWithJwtParams} for more details.
       #
@@ -264,7 +296,7 @@ module Privy
       #
       # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Privy::Models::WalletAuthenticateWithJwtResponse::WithEncryption, Privy::Models::WalletAuthenticateWithJwtResponse::WithoutEncryption]
+      # @return [Privy::Models::EncryptedWalletAuthenticateResponse, Privy::Models::RawWalletAuthenticateResponse]
       #
       # @see Privy::Models::WalletAuthenticateWithJwtParams
       def authenticate_with_jwt(params)
@@ -278,6 +310,30 @@ module Privy
         )
       end
 
+      # Creates multiple wallets in a single request. Each wallet creation is
+      # independent; failures for one wallet do not affect others. Maximum batch size is
+      # 100 wallets.
+      #
+      # @overload create_batch(wallets:, request_options: {})
+      #
+      # @param wallets [Array<Privy::Models::WalletBatchItemInput>] Array of wallet creation requests. Minimum 1, maximum 100.
+      #
+      # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Privy::Models::WalletBatchCreateResponse]
+      #
+      # @see Privy::Models::WalletCreateBatchParams
+      def create_batch(params)
+        parsed, options = Privy::WalletCreateBatchParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/wallets/batch",
+          body: parsed,
+          model: Privy::WalletBatchCreateResponse,
+          options: options
+        )
+      end
+
       # @deprecated
       #
       # Create one or more wallets associated with a recovery user, so the user can
@@ -348,29 +404,39 @@ module Privy
 
       # Get a wallet by wallet ID.
       #
-      # @overload get(wallet_id, request_options: {})
+      # @overload get(wallet_id, include_archived: nil, request_options: {})
       #
       # @param wallet_id [String] ID of the wallet.
       #
+      # @param include_archived [Boolean] Include archived wallets in lookup. Defaults to false.
+      #
       # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Privy::Models::Wallet]
       #
       # @see Privy::Models::WalletGetParams
       def get(wallet_id, params = {})
+        parsed, options = Privy::WalletGetParams.dump_request(params)
+        query = Privy::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["v1/wallets/%1$s", wallet_id],
+          query: query,
           model: Privy::Wallet,
-          options: params[:request_options]
+          options: options
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Privy::Models::WalletGetWalletByAddressParams} for more details.
+      #
       # Look up a wallet by its blockchain address. Returns the wallet object if found.
       #
-      # @overload get_wallet_by_address(address:, request_options: {})
+      # @overload get_wallet_by_address(address:, include_archived: nil, request_options: {})
+      #
+      # @param address [String] A blockchain wallet address. Ethereum addresses are normalized to EIP-55 checksu
       #
-      # @param address [String] A blockchain wallet address (Ethereum or Solana).
+      # @param include_archived [Boolean] Include archived wallets in lookup. Defaults to false (archived wallets return 4
       #
       # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -437,7 +503,7 @@ module Privy
       #
       # @param wallet_id [String] Path param: ID of the wallet.
       #
-      # @param wallet_rpc_request_body [Privy::Models::EthereumSignTransactionRpcInput, Privy::Models::EthereumSendTransactionRpcInput, Privy::Models::EthereumPersonalSignRpcInput, Privy::Models::EthereumSignTypedDataRpcInput, Privy::Models::EthereumSecp256k1SignRpcInput, Privy::Models::EthereumSign7702AuthorizationRpcInput, Privy::Models::EthereumSignUserOperationRpcInput, Privy::Models::EthereumSendCallsRpcInput, Privy::Models::SolanaSignTransactionRpcInput, Privy::Models::SolanaSignAndSendTransactionRpcInput, Privy::Models::SolanaSignMessageRpcInput, Privy::Models::SparkTransferRpcInput, Privy::Models::SparkGetBalanceRpcInput, Privy::Models::SparkTransferTokensRpcInput, Privy::Models::SparkGetStaticDepositAddressRpcInput, Privy::Models::SparkGetClaimStaticDepositQuoteRpcInput, Privy::Models::SparkClaimStaticDepositRpcInput, Privy::Models::SparkCreateLightningInvoiceRpcInput, Privy::Models::SparkPayLightningInvoiceRpcInput, Privy::Models::SparkSignMessageWithIdentityKeyRpcInput, Privy::Models::ExportPrivateKeyRpcInput, Privy::Models::ExportSeedPhraseRpcInput] Body param: Request body for wallet RPC operations, discriminated by method.
+      # @param wallet_rpc_request_body [Privy::Models::EthereumSignTransactionRpcInput, Privy::Models::EthereumSendTransactionRpcInput, Privy::Models::EthereumPersonalSignRpcInput, Privy::Models::EthereumSignTypedDataRpcInput, Privy::Models::EthereumSecp256k1SignRpcInput, Privy::Models::EthereumSign7702AuthorizationRpcInput, Privy::Models::EthereumSignUserOperationRpcInput, Privy::Models::EthereumSendCallsRpcInput, Privy::Models::SolanaSignTransactionRpcInput, Privy::Models::SolanaSignAndSendTransactionRpcInput, Privy::Models::SolanaSignMessageRpcInput, Privy::Models::SparkTransferRpcInput, Privy::Models::SparkGetBalanceRpcInput, Privy::Models::SparkTransferTokensRpcInput, Privy::Models::SparkGetStaticDepositAddressRpcInput, Privy::Models::SparkGetClaimStaticDepositQuoteRpcInput, Privy::Models::SparkClaimStaticDepositRpcInput, Privy::Models::SparkCreateLightningInvoiceRpcInput, Privy::Models::SparkPayLightningInvoiceRpcInput, Privy::Models::SparkSignMessageWithIdentityKeyRpcInput, Privy::Models::TronSignTransactionRpcInput, Privy::Models::TronSendTransactionRpcInput, Privy::Models::ExportPrivateKeyRpcInput, Privy::Models::ExportSeedPhraseRpcInput] Body param: Request body for wallet RPC operations, discriminated by method.
       #
       # @param privy_authorization_signature [String] Header param: Request authorization signature. If multiple signatures are requir
       #
@@ -447,7 +513,7 @@ module Privy
       #
       # @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Privy::Models::EthereumPersonalSignRpcResponse, Privy::Models::EthereumSignTypedDataRpcResponse, Privy::Models::EthereumSignTransactionRpcResponse, Privy::Models::EthereumSendTransactionRpcResponse, Privy::Models::EthereumSignUserOperationRpcResponse, Privy::Models::EthereumSign7702AuthorizationRpcResponse, Privy::Models::EthereumSecp256k1SignRpcResponse, Privy::Models::EthereumSendCallsRpcResponse, Privy::Models::SolanaSignMessageRpcResponse, Privy::Models::SolanaSignTransactionRpcResponse, Privy::Models::SolanaSignAndSendTransactionRpcResponse, Privy::Models::SparkTransferRpcResponse, Privy::Models::SparkGetBalanceRpcResponse, Privy::Models::SparkTransferTokensRpcResponse, Privy::Models::SparkGetStaticDepositAddressRpcResponse, Privy::Models::SparkGetClaimStaticDepositQuoteRpcResponse, Privy::Models::SparkClaimStaticDepositRpcResponse, Privy::Models::SparkCreateLightningInvoiceRpcResponse, Privy::Models::SparkPayLightningInvoiceRpcResponse, Privy::Models::SparkSignMessageWithIdentityKeyRpcResponse, Privy::Models::ExportPrivateKeyRpcResponse, Privy::Models::ExportSeedPhraseRpcResponse]
+      # @return [Privy::Models::EthereumPersonalSignRpcResponse, Privy::Models::EthereumSignTypedDataRpcResponse, Privy::Models::EthereumSignTransactionRpcResponse, Privy::Models::EthereumSendTransactionRpcResponse, Privy::Models::EthereumSignUserOperationRpcResponse, Privy::Models::EthereumSign7702AuthorizationRpcResponse, Privy::Models::EthereumSecp256k1SignRpcResponse, Privy::Models::EthereumSendCallsRpcResponse, Privy::Models::SolanaSignMessageRpcResponse, Privy::Models::SolanaSignTransactionRpcResponse, Privy::Models::SolanaSignAndSendTransactionRpcResponse, Privy::Models::SparkTransferRpcResponse, Privy::Models::SparkGetBalanceRpcResponse, Privy::Models::SparkTransferTokensRpcResponse, Privy::Models::SparkGetStaticDepositAddressRpcResponse, Privy::Models::SparkGetClaimStaticDepositQuoteRpcResponse, Privy::Models::SparkClaimStaticDepositRpcResponse, Privy::Models::SparkCreateLightningInvoiceRpcResponse, Privy::Models::SparkPayLightningInvoiceRpcResponse, Privy::Models::SparkSignMessageWithIdentityKeyRpcResponse, Privy::Models::TronSignTransactionRpcResponse, Privy::Models::TronSendTransactionRpcResponse, Privy::Models::ExportPrivateKeyRpcResponse, Privy::Models::ExportSeedPhraseRpcResponse]
       #
       # @see Privy::Models::WalletRpcParams
       def rpc(wallet_id, params)
@@ -471,6 +537,7 @@ module Privy
       # @param client [Privy::Client]
       def initialize(client:)
         @client = client
+        @actions = Privy::Resources::Wallets::Actions.new(client: client)
         @earn = Privy::Resources::Wallets::Earn.new(client: client)
         @transactions = Privy::Resources::Wallets::Transactions.new(client: client)
         @balance = Privy::Resources::Wallets::Balance.new(client: client)

data/lib/privy/resources/webhooks.rb

@@ -5,7 +5,7 @@ module Privy
     class Webhooks
       # @param payload [String] The raw webhook payload as a string
       #
-      # @return [Privy::Models::IntentAuthorizedWebhookPayload, Privy::Models::IntentCreatedWebhookPayload, Privy::Models::IntentExecutedWebhookPayload, Privy::Models::IntentFailedWebhookPayload, Privy::Models::IntentRejectedWebhookPayload, Privy::Models::MfaDisabledWebhookPayload, Privy::Models::MfaEnabledWebhookPayload, Privy::Models::TransactionBroadcastedWebhookPayload, Privy::Models::TransactionConfirmedWebhookPayload, Privy::Models::TransactionExecutionRevertedWebhookPayload, Privy::Models::TransactionFailedWebhookPayload, Privy::Models::TransactionProviderErrorWebhookPayload, Privy::Models::TransactionReplacedWebhookPayload, Privy::Models::TransactionStillPendingWebhookPayload, Privy::Models::UserAuthenticatedWebhookPayload, Privy::Models::UserCreatedWebhookPayload, Privy::Models::UserLinkedAccountWebhookPayload, Privy::Models::UserTransferredAccountWebhookPayload, Privy::Models::UserUnlinkedAccountWebhookPayload, Privy::Models::UserUpdatedAccountWebhookPayload, Privy::Models::UserWalletCreatedWebhookPayload, Privy::Models::UserOperationCompletedWebhookPayload, Privy::Models::FundsDepositedWebhookPayload, Privy::Models::FundsWithdrawnWebhookPayload, Privy::Models::PrivateKeyExportWebhookPayload, Privy::Models::WalletRecoveredWebhookPayload, Privy::Models::WalletRecoverySetupWebhookPayload, Privy::Models::WalletActionEarnDepositCreatedWebhookPayload, Privy::Models::WalletActionEarnDepositFailedWebhookPayload, Privy::Models::WalletActionEarnDepositRejectedWebhookPayload, Privy::Models::WalletActionEarnDepositSucceededWebhookPayload, Privy::Models::WalletActionEarnIncentiveClaimCreatedWebhookPayload, Privy::Models::WalletActionEarnIncentiveClaimFailedWebhookPayload, Privy::Models::WalletActionEarnIncentiveClaimRejectedWebhookPayload, Privy::Models::WalletActionEarnIncentiveClaimSucceededWebhookPayload, Privy::Models::WalletActionEarnWithdrawCreatedWebhookPayload, Privy::Models::WalletActionEarnWithdrawFailedWebhookPayload, Privy::Models::WalletActionEarnWithdrawRejectedWebhookPayload, Privy::Models::WalletActionEarnWithdrawSucceededWebhookPayload, Privy::Models::WalletActionSwapCreatedWebhookPayload, Privy::Models::WalletActionSwapFailedWebhookPayload, Privy::Models::WalletActionSwapRejectedWebhookPayload, Privy::Models::WalletActionSwapSucceededWebhookPayload, Privy::Models::WalletActionTransferCreatedWebhookPayload, Privy::Models::WalletActionTransferFailedWebhookPayload, Privy::Models::WalletActionTransferRejectedWebhookPayload, Privy::Models::WalletActionTransferSucceededWebhookPayload, Privy::Models::YieldClaimConfirmedWebhookPayload, Privy::Models::YieldDepositConfirmedWebhookPayload, Privy::Models::YieldWithdrawConfirmedWebhookPayload]
+      # @return [Privy::Models::IntentAuthorizedWebhookPayload, Privy::Models::IntentCreatedWebhookPayload, Privy::Models::IntentExecutedWebhookPayload, Privy::Models::IntentFailedWebhookPayload, Privy::Models::IntentRejectedWebhookPayload, Privy::Models::MfaDisabledWebhookPayload, Privy::Models::MfaEnabledWebhookPayload, Privy::Models::TransactionBroadcastedWebhookPayload, Privy::Models::TransactionConfirmedWebhookPayload, Privy::Models::TransactionExecutionRevertedWebhookPayload, Privy::Models::TransactionFailedWebhookPayload, Privy::Models::TransactionProviderErrorWebhookPayload, Privy::Models::TransactionReplacedWebhookPayload, Privy::Models::TransactionStillPendingWebhookPayload, Privy::Models::UserAuthenticatedWebhookPayload, Privy::Models::UserCreatedWebhookPayload, Privy::Models::UserLinkedAccountWebhookPayload, Privy::Models::UserTransferredAccountWebhookPayload, Privy::Models::UserUnlinkedAccountWebhookPayload, Privy::Models::UserUpdatedAccountWebhookPayload, Privy::Models::UserWalletCreatedWebhookPayload, Privy::Models::UserOperationCompletedWebhookPayload, Privy::Models::WalletArchivedWebhookPayload, Privy::Models::FundsDepositedWebhookPayload, Privy::Models::FundsWithdrawnWebhookPayload, Privy::Models::PrivateKeyExportWebhookPayload, Privy::Models::WalletRecoveredWebhookPayload, Privy::Models::WalletRecoverySetupWebhookPayload, Privy::Models::WalletRestoredWebhookPayload, Privy::Models::WalletActionEarnDepositCreatedWebhookPayload, Privy::Models::WalletActionEarnDepositFailedWebhookPayload, Privy::Models::WalletActionEarnDepositRejectedWebhookPayload, Privy::Models::WalletActionEarnDepositSucceededWebhookPayload, Privy::Models::WalletActionEarnIncentiveClaimCreatedWebhookPayload, Privy::Models::WalletActionEarnIncentiveClaimFailedWebhookPayload, Privy::Models::WalletActionEarnIncentiveClaimRejectedWebhookPayload, Privy::Models::WalletActionEarnIncentiveClaimSucceededWebhookPayload, Privy::Models::WalletActionEarnWithdrawCreatedWebhookPayload, Privy::Models::WalletActionEarnWithdrawFailedWebhookPayload, Privy::Models::WalletActionEarnWithdrawRejectedWebhookPayload, Privy::Models::WalletActionEarnWithdrawSucceededWebhookPayload, Privy::Models::WalletActionSwapCreatedWebhookPayload, Privy::Models::WalletActionSwapFailedWebhookPayload, Privy::Models::WalletActionSwapRejectedWebhookPayload, Privy::Models::WalletActionSwapSucceededWebhookPayload, Privy::Models::WalletActionTransferCreatedWebhookPayload, Privy::Models::WalletActionTransferFailedWebhookPayload, Privy::Models::WalletActionTransferRejectedWebhookPayload, Privy::Models::WalletActionTransferSucceededWebhookPayload, Privy::Models::YieldClaimConfirmedWebhookPayload, Privy::Models::YieldDepositConfirmedWebhookPayload, Privy::Models::YieldWithdrawConfirmedWebhookPayload]
       def unsafe_unwrap(payload)
         parsed = JSON.parse(payload, symbolize_names: true)
         Privy::Internal::Type::Converter.coerce(Privy::Models::UnsafeUnwrapWebhookEvent, parsed)

data/lib/privy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Privy
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end