privy_ruby 0.1.0 → 0.3.0

data/rbi/privy/models/ethereum_yield_claim_response.rbi

@@ -24,8 +24,8 @@ module Privy
       sig { returns(T::Array[Privy::EthereumYieldClaimReward]) }
       attr_accessor :rewards
 
-      # The current status of the claim transaction.
-      sig { returns(Privy::EthereumYieldClaimResponse::Status::OrSymbol) }
+      # Status of a blockchain transaction submitted by Privy.
+      sig { returns(Privy::BlockchainTransactionStatus::OrSymbol) }
       attr_accessor :status
 
       # Unix timestamp of when the claim was last updated, in milliseconds.
@@ -39,7 +39,7 @@ module Privy
           caip2: String,
           created_at: Float,
           rewards: T::Array[Privy::EthereumYieldClaimReward::OrHash],
-          status: Privy::EthereumYieldClaimResponse::Status::OrSymbol,
+          status: Privy::BlockchainTransactionStatus::OrSymbol,
           updated_at: Float
         ).returns(T.attached_class)
       end
@@ -52,7 +52,7 @@ module Privy
         created_at:,
         # List of reward tokens claimed.
         rewards:,
-        # The current status of the claim transaction.
+        # Status of a blockchain transaction submitted by Privy.
         status:,
         # Unix timestamp of when the claim was last updated, in milliseconds.
         updated_at:
@@ -66,73 +66,13 @@ module Privy
             caip2: String,
             created_at: Float,
             rewards: T::Array[Privy::EthereumYieldClaimReward],
-            status: Privy::EthereumYieldClaimResponse::Status::OrSymbol,
+            status: Privy::BlockchainTransactionStatus::OrSymbol,
             updated_at: Float
           }
         )
       end
       def to_hash
       end
-
-      # The current status of the claim transaction.
-      module Status
-        extend Privy::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Privy::EthereumYieldClaimResponse::Status)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        BROADCASTED =
-          T.let(
-            :broadcasted,
-            Privy::EthereumYieldClaimResponse::Status::TaggedSymbol
-          )
-        CONFIRMED =
-          T.let(
-            :confirmed,
-            Privy::EthereumYieldClaimResponse::Status::TaggedSymbol
-          )
-        EXECUTION_REVERTED =
-          T.let(
-            :execution_reverted,
-            Privy::EthereumYieldClaimResponse::Status::TaggedSymbol
-          )
-        FAILED =
-          T.let(
-            :failed,
-            Privy::EthereumYieldClaimResponse::Status::TaggedSymbol
-          )
-        REPLACED =
-          T.let(
-            :replaced,
-            Privy::EthereumYieldClaimResponse::Status::TaggedSymbol
-          )
-        FINALIZED =
-          T.let(
-            :finalized,
-            Privy::EthereumYieldClaimResponse::Status::TaggedSymbol
-          )
-        PROVIDER_ERROR =
-          T.let(
-            :provider_error,
-            Privy::EthereumYieldClaimResponse::Status::TaggedSymbol
-          )
-        PENDING =
-          T.let(
-            :pending,
-            Privy::EthereumYieldClaimResponse::Status::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[Privy::EthereumYieldClaimResponse::Status::TaggedSymbol]
-          )
-        end
-        def self.values
-        end
-      end
     end
   end
 end

data/rbi/privy/models/ethereum_yield_position_response.rbi

@@ -8,12 +8,11 @@ module Privy
           T.any(Privy::EthereumYieldPositionResponse, Privy::Internal::AnyHash)
         end
 
-      sig { returns(Privy::EthereumYieldPositionResponse::Asset) }
+      # The underlying token of a vault position.
+      sig { returns(Privy::VaultAsset) }
       attr_reader :asset
 
-      sig do
-        params(asset: Privy::EthereumYieldPositionResponse::Asset::OrHash).void
-      end
+      sig { params(asset: Privy::VaultAsset::OrHash).void }
       attr_writer :asset
 
       # Current asset value in the vault (realtime from ERC4626), in smallest unit.
@@ -35,7 +34,7 @@ module Privy
       # A user's position in a yield vault.
       sig do
         params(
-          asset: Privy::EthereumYieldPositionResponse::Asset::OrHash,
+          asset: Privy::VaultAsset::OrHash,
           assets_in_vault: String,
           shares_in_vault: String,
           total_deposited: String,
@@ -43,6 +42,7 @@ module Privy
         ).returns(T.attached_class)
       end
       def self.new(
+        # The underlying token of a vault position.
         asset:,
         # Current asset value in the vault (realtime from ERC4626), in smallest unit.
         assets_in_vault:,
@@ -58,7 +58,7 @@ module Privy
       sig do
         override.returns(
           {
-            asset: Privy::EthereumYieldPositionResponse::Asset,
+            asset: Privy::VaultAsset,
             assets_in_vault: String,
             shares_in_vault: String,
             total_deposited: String,
@@ -68,39 +68,6 @@ module Privy
       end
       def to_hash
       end
-
-      class Asset < Privy::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(
-              Privy::EthereumYieldPositionResponse::Asset,
-              Privy::Internal::AnyHash
-            )
-          end
-
-        # Token contract address.
-        sig { returns(String) }
-        attr_accessor :address
-
-        # Token symbol (e.g., "USDC").
-        sig { returns(String) }
-        attr_accessor :symbol
-
-        sig do
-          params(address: String, symbol: String).returns(T.attached_class)
-        end
-        def self.new(
-          # Token contract address.
-          address:,
-          # Token symbol (e.g., "USDC").
-          symbol:
-        )
-        end
-
-        sig { override.returns({ address: String, symbol: String }) }
-        def to_hash
-        end
-      end
     end
   end
 end

data/rbi/privy/models/ethereum_yield_positions_input.rbi

@@ -12,15 +12,30 @@ module Privy
       sig { returns(String) }
       attr_accessor :vault_id
 
+      # 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
+
       # Input for fetching yield positions.
-      sig { params(vault_id: String).returns(T.attached_class) }
+      sig do
+        params(vault_id: String, include_archived: T::Boolean).returns(
+          T.attached_class
+        )
+      end
       def self.new(
         # The vault ID to get position for.
-        vault_id:
+        vault_id:,
+        # Include archived wallets in lookup. Defaults to false.
+        include_archived: nil
       )
       end
 
-      sig { override.returns({ vault_id: String }) }
+      sig do
+        override.returns({ vault_id: String, include_archived: T::Boolean })
+      end
       def to_hash
       end
     end

data/rbi/privy/models/evm_address.rbi

@@ -0,0 +1,7 @@
+# typed: strong
+
+module Privy
+  module Models
+    EvmAddress = String
+  end
+end

data/rbi/privy/models/evm_checksum_address.rbi

@@ -0,0 +1,7 @@
+# typed: strong
+
+module Privy
+  module Models
+    EvmChecksumAddress = String
+  end
+end

data/rbi/privy/models/exchange_stripe_tokens_input.rbi

@@ -14,17 +14,37 @@ module Privy
       sig { returns(String) }
       attr_accessor :crypto_customer_id
 
+      # Whether to use the sandbox or production environment for fiat onramp.
+      sig { returns(T.nilable(Privy::FiatOnrampEnvironment::OrSymbol)) }
+      attr_reader :environment
+
+      sig { params(environment: Privy::FiatOnrampEnvironment::OrSymbol).void }
+      attr_writer :environment
+
       # Input for exchanging a Link auth intent for OAuth tokens.
       sig do
-        params(auth_intent_id: String, crypto_customer_id: String).returns(
-          T.attached_class
-        )
+        params(
+          auth_intent_id: String,
+          crypto_customer_id: String,
+          environment: Privy::FiatOnrampEnvironment::OrSymbol
+        ).returns(T.attached_class)
       end
-      def self.new(auth_intent_id:, crypto_customer_id:)
+      def self.new(
+        auth_intent_id:,
+        crypto_customer_id:,
+        # Whether to use the sandbox or production environment for fiat onramp.
+        environment: nil
+      )
       end
 
       sig do
-        override.returns({ auth_intent_id: String, crypto_customer_id: String })
+        override.returns(
+          {
+            auth_intent_id: String,
+            crypto_customer_id: String,
+            environment: Privy::FiatOnrampEnvironment::OrSymbol
+          }
+        )
       end
       def to_hash
       end

data/rbi/privy/models/fiat_onramp_destination.rbi

@@ -11,7 +11,9 @@ module Privy
       sig { returns(String) }
       attr_accessor :address
 
-      # Cryptocurrency symbol. Uppercase alphanumeric, 2-10 characters.
+      # Token identifier string. EVM-shaped 40-hex token addresses normalize to checksum
+      # case, 16-byte Hyperliquid token IDs normalize to lowercase, and all other
+      # identifiers pass through unchanged.
       sig { returns(String) }
       attr_accessor :asset
 
@@ -28,7 +30,9 @@ module Privy
       end
       def self.new(
         address:,
-        # Cryptocurrency symbol. Uppercase alphanumeric, 2-10 characters.
+        # Token identifier string. EVM-shaped 40-hex token addresses normalize to checksum
+        # case, 16-byte Hyperliquid token IDs normalize to lowercase, and all other
+        # identifiers pass through unchanged.
         asset:,
         # A CAIP-2 chain identifier in namespace:reference format (e.g. "eip155:1" for
         # Ethereum mainnet, "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" for Solana mainnet).

data/rbi/privy/models/fiat_onramp_quote.rbi

@@ -16,6 +16,12 @@ module Privy
       sig { returns(T.nilable(String)) }
       attr_accessor :destination_currency_code
 
+      sig { returns(T.nilable(String)) }
+      attr_reader :payment_method_category
+
+      sig { params(payment_method_category: String).void }
+      attr_writer :payment_method_category
+
       sig { returns(T.nilable(Float)) }
       attr_accessor :source_amount
 
@@ -25,15 +31,20 @@ module Privy
       sig { returns(T.nilable(String)) }
       attr_accessor :sub_provider
 
+      sig { returns(T.nilable(String)) }
+      attr_accessor :warning
+
       # A single fiat onramp quote from a provider.
       sig do
         params(
           payment_method: String,
           provider: Privy::FiatOnrampProvider::OrSymbol,
           destination_currency_code: T.nilable(String),
+          payment_method_category: String,
           source_amount: T.nilable(Float),
           source_currency_code: T.nilable(String),
-          sub_provider: T.nilable(String)
+          sub_provider: T.nilable(String),
+          warning: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -41,9 +52,11 @@ module Privy
         # The fiat onramp provider to use.
         provider:,
         destination_currency_code: nil,
+        payment_method_category: nil,
         source_amount: nil,
         source_currency_code: nil,
-        sub_provider: nil
+        sub_provider: nil,
+        warning: nil
       )
       end
 
@@ -53,9 +66,11 @@ module Privy
             payment_method: String,
             provider: Privy::FiatOnrampProvider::OrSymbol,
             destination_currency_code: T.nilable(String),
+            payment_method_category: String,
             source_amount: T.nilable(Float),
             source_currency_code: T.nilable(String),
-            sub_provider: T.nilable(String)
+            sub_provider: T.nilable(String),
+            warning: T.nilable(String)
           }
         )
       end

data/rbi/privy/models/funds_deposited_webhook_payload.rbi

@@ -16,12 +16,11 @@ module Privy
       sig { returns(Privy::WalletFundsAsset::Variants) }
       attr_accessor :asset
 
-      sig { returns(Privy::FundsDepositedWebhookPayload::Block) }
+      # Block metadata for a wallet transfer event.
+      sig { returns(Privy::BlockInfo) }
       attr_reader :block
 
-      sig do
-        params(block: Privy::FundsDepositedWebhookPayload::Block::OrHash).void
-      end
+      sig { params(block: Privy::BlockInfo::OrHash).void }
       attr_writer :block
 
       # The CAIP-2 chain identifier.
@@ -90,7 +89,7 @@ module Privy
               Privy::WalletFundsSplAsset::OrHash,
               Privy::WalletFundsSacAsset::OrHash
             ),
-          block: Privy::FundsDepositedWebhookPayload::Block::OrHash,
+          block: Privy::BlockInfo::OrHash,
           caip2: String,
           idempotency_key: String,
           recipient: String,
@@ -116,6 +115,7 @@ module Privy
         amount:,
         # An asset involved in a wallet transfer.
         asset:,
+        # Block metadata for a wallet transfer event.
         block:,
         # The CAIP-2 chain identifier.
         caip2:,
@@ -143,7 +143,7 @@ module Privy
           {
             amount: String,
             asset: Privy::WalletFundsAsset::Variants,
-            block: Privy::FundsDepositedWebhookPayload::Block,
+            block: Privy::BlockInfo,
             caip2: String,
             idempotency_key: String,
             recipient: String,
@@ -159,39 +159,6 @@ module Privy
       def to_hash
       end
 
-      class Block < Privy::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(
-              Privy::FundsDepositedWebhookPayload::Block,
-              Privy::Internal::AnyHash
-            )
-          end
-
-        # The block number.
-        sig { returns(Float) }
-        attr_accessor :number
-
-        # The block timestamp.
-        sig { returns(Float) }
-        attr_accessor :timestamp
-
-        sig do
-          params(number: Float, timestamp: Float).returns(T.attached_class)
-        end
-        def self.new(
-          # The block number.
-          number:,
-          # The block timestamp.
-          timestamp:
-        )
-        end
-
-        sig { override.returns({ number: Float, timestamp: Float }) }
-        def to_hash
-        end
-      end
-
       # The type of webhook event.
       module Type
         extend Privy::Internal::Type::Enum

data/rbi/privy/models/funds_withdrawn_webhook_payload.rbi

@@ -16,12 +16,11 @@ module Privy
       sig { returns(Privy::WalletFundsAsset::Variants) }
       attr_accessor :asset
 
-      sig { returns(Privy::FundsWithdrawnWebhookPayload::Block) }
+      # Block metadata for a wallet transfer event.
+      sig { returns(Privy::BlockInfo) }
       attr_reader :block
 
-      sig do
-        params(block: Privy::FundsWithdrawnWebhookPayload::Block::OrHash).void
-      end
+      sig { params(block: Privy::BlockInfo::OrHash).void }
       attr_writer :block
 
       # The CAIP-2 chain identifier.
@@ -70,7 +69,7 @@ module Privy
               Privy::WalletFundsSplAsset::OrHash,
               Privy::WalletFundsSacAsset::OrHash
             ),
-          block: Privy::FundsWithdrawnWebhookPayload::Block::OrHash,
+          block: Privy::BlockInfo::OrHash,
           caip2: String,
           idempotency_key: String,
           recipient: String,
@@ -86,6 +85,7 @@ module Privy
         amount:,
         # An asset involved in a wallet transfer.
         asset:,
+        # Block metadata for a wallet transfer event.
         block:,
         # The CAIP-2 chain identifier.
         caip2:,
@@ -111,7 +111,7 @@ module Privy
           {
             amount: String,
             asset: Privy::WalletFundsAsset::Variants,
-            block: Privy::FundsWithdrawnWebhookPayload::Block,
+            block: Privy::BlockInfo,
             caip2: String,
             idempotency_key: String,
             recipient: String,
@@ -126,39 +126,6 @@ module Privy
       def to_hash
       end
 
-      class Block < Privy::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(
-              Privy::FundsWithdrawnWebhookPayload::Block,
-              Privy::Internal::AnyHash
-            )
-          end
-
-        # The block number.
-        sig { returns(Float) }
-        attr_accessor :number
-
-        # The block timestamp.
-        sig { returns(Float) }
-        attr_accessor :timestamp
-
-        sig do
-          params(number: Float, timestamp: Float).returns(T.attached_class)
-        end
-        def self.new(
-          # The block number.
-          number:,
-          # The block timestamp.
-          timestamp:
-        )
-        end
-
-        sig { override.returns({ number: Float, timestamp: Float }) }
-        def to_hash
-        end
-      end
-
       # The type of webhook event.
       module Type
         extend Privy::Internal::Type::Enum

data/rbi/privy/models/gas.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Privy
+  module Models
+    class Gas < Privy::Internal::Type::BaseModel
+      OrHash = T.type_alias { T.any(Privy::Gas, Privy::Internal::AnyHash) }
+
+      # Gas cost in the gas token as a human-readable decimal string (e.g. "0.0001").
+      sig { returns(String) }
+      attr_accessor :amount
+
+      # Gas cost in the gas token's base units (e.g. wei).
+      sig { returns(String) }
+      attr_accessor :base_amount
+
+      # Gas token symbol (e.g. "ETH", "USDC").
+      sig { returns(String) }
+      attr_accessor :gas_asset
+
+      # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+      # human-readable decimal string, plus the gas token symbol.
+      sig do
+        params(amount: String, base_amount: String, gas_asset: String).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        # Gas cost in the gas token as a human-readable decimal string (e.g. "0.0001").
+        amount:,
+        # Gas cost in the gas token's base units (e.g. wei).
+        base_amount:,
+        # Gas token symbol (e.g. "ETH", "USDC").
+        gas_asset:
+      )
+      end
+
+      sig do
+        override.returns(
+          { amount: String, base_amount: String, gas_asset: String }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/get_by_wallet_address_request_body.rbi

@@ -8,19 +8,40 @@ module Privy
           T.any(Privy::GetByWalletAddressRequestBody, Privy::Internal::AnyHash)
         end
 
-      # 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.
       sig { returns(String) }
       attr_accessor :address
 
+      # Include archived wallets in lookup. Defaults to false (archived wallets return
+      # 404).
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :include_archived
+
+      sig { params(include_archived: T::Boolean).void }
+      attr_writer :include_archived
+
       # Request body for looking up a wallet by its blockchain address.
-      sig { params(address: String).returns(T.attached_class) }
+      sig do
+        params(address: String, include_archived: T::Boolean).returns(
+          T.attached_class
+        )
+      end
       def self.new(
-        # A blockchain wallet address (Ethereum or Solana).
-        address:
+        # 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
       )
       end
 
-      sig { override.returns({ address: String }) }
+      sig do
+        override.returns({ address: String, include_archived: T::Boolean })
+      end
       def to_hash
       end
     end

data/rbi/privy/models/get_fiat_onramp_quotes_response.rbi

@@ -8,6 +8,15 @@ module Privy
           T.any(Privy::GetFiatOnrampQuotesResponse, Privy::Internal::AnyHash)
         end
 
+      sig { returns(T.nilable(String)) }
+      attr_accessor :destination_currency_icon_url
+
+      sig { returns(String) }
+      attr_accessor :destination_currency_symbol
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :destination_network_icon_url
+
       sig { returns(T::Array[Privy::FiatOnrampQuote]) }
       attr_accessor :quotes
 
@@ -24,16 +33,28 @@ module Privy
       # The response containing fiat onramp quotes.
       sig do
         params(
+          destination_currency_icon_url: T.nilable(String),
+          destination_currency_symbol: String,
+          destination_network_icon_url: T.nilable(String),
           quotes: T::Array[Privy::FiatOnrampQuote::OrHash],
           provider_errors: T::Array[Privy::FiatOnrampProviderError::OrHash]
         ).returns(T.attached_class)
       end
-      def self.new(quotes:, provider_errors: nil)
+      def self.new(
+        destination_currency_icon_url:,
+        destination_currency_symbol:,
+        destination_network_icon_url:,
+        quotes:,
+        provider_errors: nil
+      )
       end
 
       sig do
         override.returns(
           {
+            destination_currency_icon_url: T.nilable(String),
+            destination_currency_symbol: String,
+            destination_network_icon_url: T.nilable(String),
             quotes: T::Array[Privy::FiatOnrampQuote],
             provider_errors: T::Array[Privy::FiatOnrampProviderError]
           }

data/rbi/privy/models/hd_init_input.rbi

@@ -10,8 +10,8 @@ module Privy
       sig { returns(String) }
       attr_accessor :address
 
-      # The chain type of the wallet to import. Currently supports `ethereum` and
-      # `solana`.
+      # The chain type of the wallet to import. Supports `ethereum`, `solana`,
+      # `stellar`, `tron`, `sui`, and `aptos`.
       sig { returns(Privy::WalletImportSupportedChains::OrSymbol) }
       attr_accessor :chain_type
 
@@ -40,8 +40,8 @@ module Privy
       def self.new(
         # The address of the wallet to import.
         address:,
-        # The chain type of the wallet to import. Currently supports `ethereum` and
-        # `solana`.
+        # The chain type of the wallet to import. Supports `ethereum`, `solana`,
+        # `stellar`, `tron`, `sui`, and `aptos`.
         chain_type:,
         # The encryption type of the wallet to import. Currently only supports `HPKE`.
         encryption_type:,