privy_ruby 0.2.0 → 0.3.0

data/rbi/privy/resources/policies.rbi

@@ -131,7 +131,8 @@ module Privy
                 Privy::SuiTransactionCommandCondition::OrHash,
                 Privy::SuiTransferObjectsCommandCondition::OrHash,
                 Privy::ActionRequestBodyCondition::OrHash,
-                Privy::AggregationCondition::OrHash
+                Privy::AggregationCondition::OrHash,
+                Privy::MessageSigningCondition::OrHash
               )
             ],
           method_: Privy::PolicyMethod::OrSymbol,
@@ -232,7 +233,8 @@ module Privy
                 Privy::SuiTransactionCommandCondition::OrHash,
                 Privy::SuiTransferObjectsCommandCondition::OrHash,
                 Privy::ActionRequestBodyCondition::OrHash,
-                Privy::AggregationCondition::OrHash
+                Privy::AggregationCondition::OrHash,
+                Privy::MessageSigningCondition::OrHash
               )
             ],
           method_: Privy::PolicyMethod::OrSymbol,

data/rbi/privy/resources/wallets/actions.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Privy
+  module Resources
+    class Wallets
+      # Operations related to wallet actions
+      class Actions
+        # Get the current status of a wallet action by its ID. Use `?include=steps` to
+        # include step-level details.
+        sig do
+          params(
+            action_id: String,
+            wallet_id: String,
+            include: Privy::Wallets::WalletActionInclude::OrSymbol,
+            privy_authorization_signature: String,
+            request_options: Privy::RequestOptions::OrHash
+          ).returns(Privy::Wallets::WalletActionResponse::Variants)
+        end
+        def get(
+          # Path param: ID of the wallet action.
+          action_id,
+          # Path param: ID of the wallet.
+          wallet_id:,
+          # Query param: Expandable relations to include on a wallet action response.
+          include: nil,
+          # Header param: Request authorization signature. If multiple signatures are
+          # required, they should be comma separated.
+          privy_authorization_signature: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Privy::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/privy/resources/wallets/balance.rbi

@@ -17,11 +17,10 @@ module Privy
               ),
             chain:
               T.any(
-                Privy::Wallets::BalanceGetParams::Chain::OrSymbol,
-                T::Array[
-                  Privy::Wallets::BalanceGetParams::Chain::UnionMember1::OrSymbol
-                ]
+                Privy::WalletAssetChainNameInput::OrSymbol,
+                T::Array[Privy::WalletAssetChainNameInput::OrSymbol]
               ),
+            include_archived: T::Boolean,
             include_currency:
               Privy::Wallets::BalanceGetParams::IncludeCurrency::OrSymbol,
             request_options: Privy::RequestOptions::OrHash
@@ -41,6 +40,8 @@ module Privy
           # Chain(s) to query named assets on (e.g. `base`, `ethereum`). Use together with
           # `asset`. Cannot be used with `token`.
           chain: nil,
+          # Include archived wallets in lookup. Defaults to false.
+          include_archived: nil,
           # If set, balances are converted to the specified fiat currency. Not supported
           # when `token` is provided.
           include_currency: nil,

data/rbi/privy/resources/wallets/earn/ethereum/incentive.rbi

@@ -16,7 +16,7 @@ module Privy
                 privy_idempotency_key: String,
                 privy_request_expiry: String,
                 request_options: Privy::RequestOptions::OrHash
-              ).returns(Privy::EarnIncentiveClaimActionResponse)
+              ).returns(Privy::Wallets::EarnIncentiveClaimActionResponse)
             end
             def _claim(
               # Path param: ID of the wallet.

data/rbi/privy/resources/wallets/earn/ethereum.rbi

@@ -21,7 +21,7 @@ module Privy
               privy_idempotency_key: String,
               privy_request_expiry: String,
               request_options: Privy::RequestOptions::OrHash
-            ).returns(Privy::EarnDepositActionResponse)
+            ).returns(Privy::Wallets::EarnDepositActionResponse)
           end
           def _deposit(
             # Path param: ID of the wallet.
@@ -58,7 +58,7 @@ module Privy
               privy_idempotency_key: String,
               privy_request_expiry: String,
               request_options: Privy::RequestOptions::OrHash
-            ).returns(Privy::EarnWithdrawActionResponse)
+            ).returns(Privy::Wallets::EarnWithdrawActionResponse)
           end
           def _withdraw(
             # Path param: ID of the wallet.

data/rbi/privy/resources/wallets/swap.rbi

@@ -17,8 +17,9 @@ module Privy
             slippage_bps: Integer,
             privy_authorization_signature: String,
             privy_idempotency_key: String,
+            privy_request_expiry: String,
             request_options: Privy::RequestOptions::OrHash
-          ).returns(Privy::SwapActionResponse)
+          ).returns(Privy::Wallets::SwapActionResponse)
         end
         def execute(
           # Path param: ID of the wallet.
@@ -42,6 +43,9 @@ module Privy
           # Header param: Idempotency keys ensure API requests are executed only once within
           # a 24-hour window.
           privy_idempotency_key: nil,
+          # Header param: 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
@@ -57,6 +61,7 @@ module Privy
             fee_configuration: Privy::FeeConfiguration::OrHash,
             slippage_bps: Integer,
             privy_authorization_signature: String,
+            privy_request_expiry: String,
             request_options: Privy::RequestOptions::OrHash
           ).returns(Privy::SwapQuoteResponse)
         end
@@ -80,6 +85,9 @@ module Privy
           # Header param: Request authorization signature. If multiple signatures are
           # required, they should be comma separated.
           privy_authorization_signature: nil,
+          # Header param: 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

data/rbi/privy/resources/wallets/transactions.rbi

@@ -17,6 +17,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
@@ -33,6 +34,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: {}

data/rbi/privy/resources/wallets.rbi

@@ -3,6 +3,10 @@
 module Privy
   module Resources
     class Wallets
+      # Operations related to wallet actions
+      sig { returns(Privy::Resources::Wallets::Actions) }
+      attr_reader :actions
+
       sig { returns(Privy::Resources::Wallets::Earn) }
       attr_reader :earn
 
@@ -115,16 +119,22 @@ module Privy
       # Get all wallets in your app.
       sig do
         params(
+          address: String,
           authorization_key: String,
           chain_type: Privy::WalletChainType::OrSymbol,
           cursor: String,
           external_id: String,
+          include_archived: T::Boolean,
           limit: T.nilable(Float),
           user_id: String,
           request_options: Privy::RequestOptions::OrHash
         ).returns(Privy::Internal::Cursor[Privy::Wallet])
       end
       def list(
+        # A blockchain wallet address. Ethereum addresses are normalized to EIP-55
+        # checksum format. Solana addresses are validated as base58. All other chain
+        # addresses (Stellar, Tron, Sui, Aptos, etc.) are accepted as-is.
+        address: nil,
         # Filter wallets by authorization public key. Returns wallets owned by key quorums
         # that include the specified P-256 public key (base64-encoded DER format). Cannot
         # be used together with user_id.
@@ -134,6 +144,8 @@ module Privy
         cursor: nil,
         # Filter wallets by external ID.
         external_id: nil,
+        # Include archived wallets in lookup. Defaults to false.
+        include_archived: nil,
         limit: nil,
         # Filter wallets by user ID. Cannot be used together with authorization_key.
         user_id: nil,
@@ -216,6 +228,7 @@ module Privy
               Privy::NamedTokenTransferSource::OrHash,
               Privy::CustomTokenTransferSource::OrHash
             ),
+          amount: String,
           amount_type: Privy::AmountType::OrSymbol,
           fee_configuration: Privy::FeeConfiguration::OrHash,
           slippage_bps: Integer,
@@ -223,7 +236,7 @@ module Privy
           privy_idempotency_key: String,
           privy_request_expiry: String,
           request_options: Privy::RequestOptions::OrHash
-        ).returns(Privy::TransferActionResponse)
+        ).returns(Privy::Wallets::TransferActionResponse)
       end
       def _transfer(
         # Path param: ID of the wallet.
@@ -234,6 +247,10 @@ module Privy
         # Body param: The source asset, amount, and chain for a token transfer. Specify
         # either `asset` (named) or `asset_address` (custom), not both.
         source:,
+        # Body param: Amount as a decimal string in the token's standard unit (e.g. "1.5"
+        # for 1.5 USDC). For exact_input, the amount to send. For exact_output, the exact
+        # amount to receive. Takes precedence over source.amount when both are provided.
+        amount: nil,
         # Body param: Whether the amount refers to the input token or output token.
         amount_type: nil,
         # Body param: Total fees assessed on a transfer, in BPS
@@ -255,6 +272,22 @@ module Privy
       )
       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.
+      sig do
+        params(
+          wallet_id: String,
+          request_options: Privy::RequestOptions::OrHash
+        ).returns(Privy::Wallet)
+      end
+      def archive(
+        # ID of the wallet.
+        wallet_id,
+        request_options: {}
+      )
+      end
+
       # Exchange a user JWT for a session key authorized to act on the user's wallets.
       # Returns the encrypted authorization key and the list of wallets it can access.
       sig do
@@ -356,12 +389,15 @@ module Privy
       sig do
         params(
           wallet_id: String,
+          include_archived: T::Boolean,
           request_options: Privy::RequestOptions::OrHash
         ).returns(Privy::Wallet)
       end
       def get(
         # ID of the wallet.
         wallet_id,
+        # Include archived wallets in lookup. Defaults to false.
+        include_archived: nil,
         request_options: {}
       )
       end
@@ -370,12 +406,18 @@ module Privy
       sig do
         params(
           address: String,
+          include_archived: T::Boolean,
           request_options: Privy::RequestOptions::OrHash
         ).returns(Privy::Wallet)
       end
       def get_wallet_by_address(
-        # A blockchain wallet address (Ethereum or Solana).
+        # A blockchain wallet address. Ethereum addresses are normalized to EIP-55
+        # checksum format. Solana addresses are validated as base58. All other chain
+        # addresses (Stellar, Tron, Sui, Aptos, etc.) are accepted as-is.
         address:,
+        # Include archived wallets in lookup. Defaults to false (archived wallets return
+        # 404).
+        include_archived: nil,
         request_options: {}
       )
       end
@@ -439,6 +481,8 @@ module Privy
               Privy::SparkCreateLightningInvoiceRpcInput::OrHash,
               Privy::SparkPayLightningInvoiceRpcInput::OrHash,
               Privy::SparkSignMessageWithIdentityKeyRpcInput::OrHash,
+              Privy::TronSignTransactionRpcInput::OrHash,
+              Privy::TronSendTransactionRpcInput::OrHash,
               Privy::ExportPrivateKeyRpcInput::OrHash,
               Privy::ExportSeedPhraseRpcInput::OrHash
             ),

data/rbi/privy/resources/webhooks.rbi

@@ -28,11 +28,13 @@ module Privy
             Privy::UserUpdatedAccountWebhookPayload,
             Privy::UserWalletCreatedWebhookPayload,
             Privy::UserOperationCompletedWebhookPayload,
+            Privy::WalletArchivedWebhookPayload,
             Privy::FundsDepositedWebhookPayload,
             Privy::FundsWithdrawnWebhookPayload,
             Privy::PrivateKeyExportWebhookPayload,
             Privy::WalletRecoveredWebhookPayload,
             Privy::WalletRecoverySetupWebhookPayload,
+            Privy::WalletRestoredWebhookPayload,
             Privy::WalletActionEarnDepositCreatedWebhookPayload,
             Privy::WalletActionEarnDepositFailedWebhookPayload,
             Privy::WalletActionEarnDepositRejectedWebhookPayload,

data/sig/privy/client.rbs

@@ -55,8 +55,6 @@ module Privy
 
     attr_reader oauth: Privy::Resources::OAuth
 
-    attr_reader wallet_actions: Privy::Resources::WalletActions
-
     attr_reader yield_: Privy::Resources::Yield
 
     attr_reader kraken_embed: Privy::Resources::KrakenEmbed

data/sig/privy/models/access_list_entry.rbs

@@ -0,0 +1,15 @@
+module Privy
+  module Models
+    type access_list_entry = { address: String, storage_keys: ::Array[String] }
+
+    class AccessListEntry < Privy::Internal::Type::BaseModel
+      attr_accessor address: String
+
+      attr_accessor storage_keys: ::Array[String]
+
+      def initialize: (address: String, storage_keys: ::Array[String]) -> void
+
+      def to_hash: -> { address: String, storage_keys: ::Array[String] }
+    end
+  end
+end

data/sig/privy/models/account_balance_params.rbs

@@ -1,33 +1,18 @@
 module Privy
   module Models
     type account_balance_params =
-      { testnet_mode: Privy::Models::AccountBalanceParams::testnet_mode }
+      { testnet_mode: Privy::Models::chain_testnet_mode }
 
     class AccountBalanceParams < Privy::Internal::Type::BaseModel
-      attr_reader testnet_mode: Privy::Models::AccountBalanceParams::testnet_mode?
+      attr_reader testnet_mode: Privy::Models::chain_testnet_mode?
 
       def testnet_mode=: (
-        Privy::Models::AccountBalanceParams::testnet_mode
-      ) -> Privy::Models::AccountBalanceParams::testnet_mode
+        Privy::Models::chain_testnet_mode
+      ) -> Privy::Models::chain_testnet_mode
 
-      def initialize: (
-        ?testnet_mode: Privy::Models::AccountBalanceParams::testnet_mode
-      ) -> void
+      def initialize: (?testnet_mode: Privy::Models::chain_testnet_mode) -> void
 
-      def to_hash: -> {
-        testnet_mode: Privy::Models::AccountBalanceParams::testnet_mode
-      }
-
-      type testnet_mode = :true | :false
-
-      module TestnetMode
-        extend Privy::Internal::Type::Enum
-
-        TRUE: :true
-        FALSE: :false
-
-        def self?.values: -> ::Array[Privy::Models::AccountBalanceParams::testnet_mode]
-      end
+      def to_hash: -> { testnet_mode: Privy::Models::chain_testnet_mode }
     end
   end
 end

data/sig/privy/models/advanced_swap_platform_fee.rbs

@@ -0,0 +1,18 @@
+module Privy
+  module Models
+    type advanced_swap_platform_fee =
+      { token: String, amount: String, bps: Integer }
+
+    class AdvancedSwapPlatformFee < Privy::Internal::Type::BaseModel
+      attr_accessor token: String
+
+      attr_accessor amount: String
+
+      attr_accessor bps: Integer
+
+      def initialize: (token: String, amount: String, bps: Integer) -> void
+
+      def to_hash: -> { token: String, amount: String, bps: Integer }
+    end
+  end
+end

data/sig/privy/models/advanced_swap_request_body.rbs

@@ -0,0 +1,77 @@
+module Privy
+  module Models
+    type advanced_swap_request_body =
+      {
+        amount: String,
+        input_token: String,
+        output_token: String,
+        :caip2 => String,
+        dry_run: bool,
+        fee_recipient: String,
+        platform_fee_bps: Integer,
+        slippage_bps: Privy::Models::AdvancedSwapRequestBody::slippage_bps
+      }
+
+    class AdvancedSwapRequestBody < Privy::Internal::Type::BaseModel
+      attr_accessor amount: String
+
+      attr_accessor input_token: String
+
+      attr_accessor output_token: String
+
+      attr_reader caip2: String?
+
+      def caip2=: (String) -> String
+
+      attr_reader dry_run: bool?
+
+      def dry_run=: (bool) -> bool
+
+      attr_reader fee_recipient: String?
+
+      def fee_recipient=: (String) -> String
+
+      attr_reader platform_fee_bps: Integer?
+
+      def platform_fee_bps=: (Integer) -> Integer
+
+      attr_reader slippage_bps: Privy::Models::AdvancedSwapRequestBody::slippage_bps?
+
+      def slippage_bps=: (
+        Privy::Models::AdvancedSwapRequestBody::slippage_bps
+      ) -> Privy::Models::AdvancedSwapRequestBody::slippage_bps
+
+      def initialize: (
+        amount: String,
+        input_token: String,
+        output_token: String,
+        ?caip2: String,
+        ?dry_run: bool,
+        ?fee_recipient: String,
+        ?platform_fee_bps: Integer,
+        ?slippage_bps: Privy::Models::AdvancedSwapRequestBody::slippage_bps
+      ) -> void
+
+      def to_hash: -> {
+        amount: String,
+        input_token: String,
+        output_token: String,
+        :caip2 => String,
+        dry_run: bool,
+        fee_recipient: String,
+        platform_fee_bps: Integer,
+        slippage_bps: Privy::Models::AdvancedSwapRequestBody::slippage_bps
+      }
+
+      type slippage_bps = Integer | :auto
+
+      module SlippageBps
+        extend Privy::Internal::Type::Union
+
+        def self?.variants: -> ::Array[Privy::Models::AdvancedSwapRequestBody::slippage_bps]
+
+        AUTO: :auto
+      end
+    end
+  end
+end

data/sig/privy/models/advanced_swap_response.rbs

@@ -0,0 +1,74 @@
+module Privy
+  module Models
+    type advanced_swap_response =
+      {
+        in_amount: String,
+        input_token: String,
+        min_out_amount: String,
+        out_amount: String,
+        output_token: String,
+        provider: String,
+        signed_transaction: String,
+        slippage_bps: Integer,
+        submission_status: Privy::Models::swap_submission_status,
+        transaction_hash: String,
+        platform_fee: Privy::AdvancedSwapPlatformFee
+      }
+
+    class AdvancedSwapResponse < Privy::Internal::Type::BaseModel
+      attr_accessor in_amount: String
+
+      attr_accessor input_token: String
+
+      attr_accessor min_out_amount: String
+
+      attr_accessor out_amount: String
+
+      attr_accessor output_token: String
+
+      attr_accessor provider: String
+
+      attr_accessor signed_transaction: String
+
+      attr_accessor slippage_bps: Integer
+
+      attr_accessor submission_status: Privy::Models::swap_submission_status
+
+      attr_accessor transaction_hash: String
+
+      attr_reader platform_fee: Privy::AdvancedSwapPlatformFee?
+
+      def platform_fee=: (
+        Privy::AdvancedSwapPlatformFee
+      ) -> Privy::AdvancedSwapPlatformFee
+
+      def initialize: (
+        in_amount: String,
+        input_token: String,
+        min_out_amount: String,
+        out_amount: String,
+        output_token: String,
+        provider: String,
+        signed_transaction: String,
+        slippage_bps: Integer,
+        submission_status: Privy::Models::swap_submission_status,
+        transaction_hash: String,
+        ?platform_fee: Privy::AdvancedSwapPlatformFee
+      ) -> void
+
+      def to_hash: -> {
+        in_amount: String,
+        input_token: String,
+        min_out_amount: String,
+        out_amount: String,
+        output_token: String,
+        provider: String,
+        signed_transaction: String,
+        slippage_bps: Integer,
+        submission_status: Privy::Models::swap_submission_status,
+        transaction_hash: String,
+        platform_fee: Privy::AdvancedSwapPlatformFee
+      }
+    end
+  end
+end

data/sig/privy/models/app_allowlist_config.rbs

@@ -0,0 +1,35 @@
+module Privy
+  module Models
+    type app_allowlist_config =
+      {
+        cta_link: String?,
+        cta_text: String?,
+        error_detail: String?,
+        error_title: String?
+      }
+
+    class AppAllowlistConfig < Privy::Internal::Type::BaseModel
+      attr_accessor cta_link: String?
+
+      attr_accessor cta_text: String?
+
+      attr_accessor error_detail: String?
+
+      attr_accessor error_title: String?
+
+      def initialize: (
+        cta_link: String?,
+        cta_text: String?,
+        error_detail: String?,
+        error_title: String?
+      ) -> void
+
+      def to_hash: -> {
+        cta_link: String?,
+        cta_text: String?,
+        error_detail: String?,
+        error_title: String?
+      }
+    end
+  end
+end

data/sig/privy/models/app_custom_oauth_provider.rbs

@@ -0,0 +1,35 @@
+module Privy
+  module Models
+    type app_custom_oauth_provider =
+      {
+        enabled: bool,
+        provider: String,
+        provider_display_name: String,
+        provider_icon_url: String
+      }
+
+    class AppCustomOAuthProvider < Privy::Internal::Type::BaseModel
+      attr_accessor enabled: bool
+
+      attr_accessor provider: String
+
+      attr_accessor provider_display_name: String
+
+      attr_accessor provider_icon_url: String
+
+      def initialize: (
+        enabled: bool,
+        provider: String,
+        provider_display_name: String,
+        provider_icon_url: String
+      ) -> void
+
+      def to_hash: -> {
+        enabled: bool,
+        provider: String,
+        provider_display_name: String,
+        provider_icon_url: String
+      }
+    end
+  end
+end