privy_ruby 0.2.0 → 0.3.0

data/rbi/privy/models/captcha_provider.rbi

@@ -0,0 +1,20 @@
+# typed: strong
+
+module Privy
+  module Models
+    # The captcha provider enabled for an app.
+    module CaptchaProvider
+      extend Privy::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Privy::CaptchaProvider) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      TURNSTILE = T.let(:turnstile, Privy::CaptchaProvider::TaggedSymbol)
+      HCAPTCHA = T.let(:hcaptcha, Privy::CaptchaProvider::TaggedSymbol)
+
+      sig { override.returns(T::Array[Privy::CaptchaProvider::TaggedSymbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/privy/models/chain_testnet_mode.rbi

@@ -0,0 +1,20 @@
+# typed: strong
+
+module Privy
+  module Models
+    # When set to true, returns balances from testnet chains instead of mainnets.
+    module ChainTestnetMode
+      extend Privy::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Privy::ChainTestnetMode) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      TRUE = T.let(:true, Privy::ChainTestnetMode::TaggedSymbol)
+      FALSE = T.let(:false, Privy::ChainTestnetMode::TaggedSymbol)
+
+      sig { override.returns(T::Array[Privy::ChainTestnetMode::TaggedSymbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/privy/models/client_session_update_action.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Privy
+  module Models
+    # Instructs the client on how to handle tokens received from a session response.
+    module ClientSessionUpdateAction
+      extend Privy::Internal::Type::Enum
+
+      TaggedSymbol =
+        T.type_alias { T.all(Symbol, Privy::ClientSessionUpdateAction) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      SET = T.let(:set, Privy::ClientSessionUpdateAction::TaggedSymbol)
+      IGNORE = T.let(:ignore, Privy::ClientSessionUpdateAction::TaggedSymbol)
+      CLEAR = T.let(:clear, Privy::ClientSessionUpdateAction::TaggedSymbol)
+
+      sig do
+        override.returns(
+          T::Array[Privy::ClientSessionUpdateAction::TaggedSymbol]
+        )
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/privy/models/condition_operator.rbi

@@ -17,6 +17,9 @@ module Privy
       IN = T.let(:in, Privy::ConditionOperator::TaggedSymbol)
       IN_CONDITION_SET =
         T.let(:in_condition_set, Privy::ConditionOperator::TaggedSymbol)
+      CONTAINS = T.let(:contains, Privy::ConditionOperator::TaggedSymbol)
+      STARTS_WITH = T.let(:starts_with, Privy::ConditionOperator::TaggedSymbol)
+      ENDS_WITH = T.let(:ends_with, Privy::ConditionOperator::TaggedSymbol)
 
       sig { override.returns(T::Array[Privy::ConditionOperator::TaggedSymbol]) }
       def self.values

data/rbi/privy/models/condition_set.rbi

@@ -20,7 +20,7 @@ module Privy
       attr_accessor :name
 
       # A unique identifier for a key quorum.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :owner_id
 
       # A condition set for grouping related condition values.
@@ -29,7 +29,7 @@ module Privy
           id: String,
           created_at: Float,
           name: String,
-          owner_id: String
+          owner_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -47,7 +47,12 @@ module Privy
 
       sig do
         override.returns(
-          { id: String, created_at: Float, name: String, owner_id: String }
+          {
+            id: String,
+            created_at: Float,
+            name: String,
+            owner_id: T.nilable(String)
+          }
         )
       end
       def to_hash

data/rbi/privy/models/condition_set_request_body.rbi

@@ -26,8 +26,8 @@ module Privy
       sig { returns(T.nilable(String)) }
       attr_accessor :owner_id
 
-      # Request body for creating a condition set. Exactly one of `owner` or `owner_id`
-      # is required.
+      # Request body for creating a condition set. Optionally provide `owner` or
+      # `owner_id` (but not both) to specify ownership.
       sig do
         params(
           name: String,

data/rbi/privy/models/create_link_auth_intent_input.rbi

@@ -14,12 +14,32 @@ module Privy
       sig { params(email: String).void }
       attr_writer :email
 
+      # 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 creating a Link auth intent to initiate Stripe onramp authentication.
-      sig { params(email: String).returns(T.attached_class) }
-      def self.new(email: nil)
+      sig do
+        params(
+          email: String,
+          environment: Privy::FiatOnrampEnvironment::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        email: nil,
+        # Whether to use the sandbox or production environment for fiat onramp.
+        environment: nil
+      )
       end
 
-      sig { override.returns({ email: String }) }
+      sig do
+        override.returns(
+          { email: String, environment: Privy::FiatOnrampEnvironment::OrSymbol }
+        )
+      end
       def to_hash
       end
     end

data/rbi/privy/models/create_stripe_onramp_session_response.rbi

@@ -18,19 +18,13 @@ module Privy
       attr_accessor :session_id
 
       # Transaction details returned from a Stripe onramp session.
-      sig do
-        returns(
-          T.nilable(
-            Privy::CreateStripeOnrampSessionResponse::TransactionDetails
-          )
-        )
-      end
+      sig { returns(T.nilable(Privy::OnrampSessionTransactionDetails)) }
       attr_reader :transaction_details
 
       sig do
         params(
           transaction_details:
-            Privy::CreateStripeOnrampSessionResponse::TransactionDetails::OrHash
+            T.nilable(Privy::OnrampSessionTransactionDetails::OrHash)
         ).void
       end
       attr_writer :transaction_details
@@ -41,7 +35,7 @@ module Privy
           id: String,
           session_id: String,
           transaction_details:
-            Privy::CreateStripeOnrampSessionResponse::TransactionDetails::OrHash
+            T.nilable(Privy::OnrampSessionTransactionDetails::OrHash)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -58,31 +52,12 @@ module Privy
             id: String,
             session_id: String,
             transaction_details:
-              Privy::CreateStripeOnrampSessionResponse::TransactionDetails
+              T.nilable(Privy::OnrampSessionTransactionDetails)
           }
         )
       end
       def to_hash
       end
-
-      class TransactionDetails < Privy::Models::OnrampSessionTransactionDetails
-        OrHash =
-          T.type_alias do
-            T.any(
-              Privy::CreateStripeOnrampSessionResponse::TransactionDetails,
-              Privy::Internal::AnyHash
-            )
-          end
-
-        # Transaction details returned from a Stripe onramp session.
-        sig { returns(T.attached_class) }
-        def self.new
-        end
-
-        sig { override.returns({}) }
-        def to_hash
-        end
-      end
     end
   end
 end

data/rbi/privy/models/custodial_wallet.rbi

@@ -23,6 +23,7 @@ module Privy
       sig { params(custody: Privy::WalletCustodian::OrHash).void }
       attr_writer :custody
 
+      # A unique identifier for a key quorum.
       sig { returns(T.nilable(String)) }
       attr_accessor :owner_id
 
@@ -64,6 +65,7 @@ module Privy
         chain_type:,
         # Information about the custodian managing this wallet.
         custody:,
+        # A unique identifier for a key quorum.
         owner_id:,
         # Additional signers for the wallet.
         additional_signers: nil,

data/rbi/privy/models/custom_token_transfer_source.rbi

@@ -9,8 +9,8 @@ module Privy
         end
 
       # Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
-      # USDC, "0.01" for 0.01 ETH). Not in the smallest on-chain unit (wei, lamports,
-      # etc.). Maximum 100 characters.
+      # USDC, "0.01" for 0.01 ETH). For exact_input, specifies the amount to send. Not
+      # in the smallest on-chain unit (wei, lamports, etc.). Maximum 100 characters.
       sig { returns(String) }
       attr_accessor :amount
 
@@ -34,8 +34,8 @@ module Privy
       end
       def self.new(
         # Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
-        # USDC, "0.01" for 0.01 ETH). Not in the smallest on-chain unit (wei, lamports,
-        # etc.). Maximum 100 characters.
+        # USDC, "0.01" for 0.01 ETH). For exact_input, specifies the amount to send. Not
+        # in the smallest on-chain unit (wei, lamports, etc.). Maximum 100 characters.
         amount:,
         # The token contract address (EVM) or mint address (Solana) of the asset to
         # transfer.

data/rbi/privy/models/encrypted_authorization_key.rbi

@@ -0,0 +1,89 @@
+# typed: strong
+
+module Privy
+  module Models
+    class EncryptedAuthorizationKey < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::EncryptedAuthorizationKey, Privy::Internal::AnyHash)
+        end
+
+      # The encrypted authorization key corresponding to the user's current
+      # authentication session.
+      sig { returns(String) }
+      attr_accessor :ciphertext
+
+      # Base64-encoded ephemeral public key used in the HPKE encryption process.
+      # Required for decryption.
+      sig { returns(String) }
+      attr_accessor :encapsulated_key
+
+      # The encryption type used. Currently only supports HPKE.
+      sig do
+        returns(Privy::EncryptedAuthorizationKey::EncryptionType::TaggedSymbol)
+      end
+      attr_accessor :encryption_type
+
+      # HPKE-encrypted authorization key with encapsulated key and ciphertext.
+      sig do
+        params(
+          ciphertext: String,
+          encapsulated_key: String,
+          encryption_type:
+            Privy::EncryptedAuthorizationKey::EncryptionType::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The encrypted authorization key corresponding to the user's current
+        # authentication session.
+        ciphertext:,
+        # Base64-encoded ephemeral public key used in the HPKE encryption process.
+        # Required for decryption.
+        encapsulated_key:,
+        # The encryption type used. Currently only supports HPKE.
+        encryption_type:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            ciphertext: String,
+            encapsulated_key: String,
+            encryption_type:
+              Privy::EncryptedAuthorizationKey::EncryptionType::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The encryption type used. Currently only supports HPKE.
+      module EncryptionType
+        extend Privy::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Privy::EncryptedAuthorizationKey::EncryptionType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        HPKE =
+          T.let(
+            :HPKE,
+            Privy::EncryptedAuthorizationKey::EncryptionType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Privy::EncryptedAuthorizationKey::EncryptionType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/encrypted_bound_authenticate_response.rbi

@@ -0,0 +1,66 @@
+# typed: strong
+
+module Privy
+  module Models
+    class EncryptedBoundAuthenticateResponse < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Privy::EncryptedBoundAuthenticateResponse,
+            Privy::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T::Array[Privy::UserSigningKeyBinding]) }
+      attr_accessor :bindings
+
+      # HPKE-encrypted authorization key with encapsulated key and ciphertext.
+      sig { returns(Privy::EncryptedAuthorizationKey) }
+      attr_reader :encrypted_authorization_key
+
+      sig do
+        params(
+          encrypted_authorization_key: Privy::EncryptedAuthorizationKey::OrHash
+        ).void
+      end
+      attr_writer :encrypted_authorization_key
+
+      sig { returns(Float) }
+      attr_accessor :expires_at
+
+      sig { returns(T::Array[Privy::Wallet]) }
+      attr_accessor :wallets
+
+      # Encrypted response from bound wallet authentication, with bindings.
+      sig do
+        params(
+          bindings: T::Array[Privy::UserSigningKeyBinding::OrHash],
+          encrypted_authorization_key: Privy::EncryptedAuthorizationKey::OrHash,
+          expires_at: Float,
+          wallets: T::Array[Privy::Wallet::OrHash]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        bindings:,
+        # HPKE-encrypted authorization key with encapsulated key and ciphertext.
+        encrypted_authorization_key:,
+        expires_at:,
+        wallets:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            bindings: T::Array[Privy::UserSigningKeyBinding],
+            encrypted_authorization_key: Privy::EncryptedAuthorizationKey,
+            expires_at: Float,
+            wallets: T::Array[Privy::Wallet]
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/encrypted_wallet_authenticate_response.rbi

@@ -0,0 +1,63 @@
+# typed: strong
+
+module Privy
+  module Models
+    class EncryptedWalletAuthenticateResponse < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Privy::EncryptedWalletAuthenticateResponse,
+            Privy::Internal::AnyHash
+          )
+        end
+
+      # HPKE-encrypted authorization key with encapsulated key and ciphertext.
+      sig { returns(Privy::EncryptedAuthorizationKey) }
+      attr_reader :encrypted_authorization_key
+
+      sig do
+        params(
+          encrypted_authorization_key: Privy::EncryptedAuthorizationKey::OrHash
+        ).void
+      end
+      attr_writer :encrypted_authorization_key
+
+      # The expiration time of the authorization key in milliseconds since the epoch.
+      sig { returns(Float) }
+      attr_accessor :expires_at
+
+      sig { returns(T::Array[Privy::Wallet]) }
+      attr_accessor :wallets
+
+      # The response from authenticating a wallet with HPKE encryption, containing an
+      # encrypted authorization key and wallet data.
+      sig do
+        params(
+          encrypted_authorization_key: Privy::EncryptedAuthorizationKey::OrHash,
+          expires_at: Float,
+          wallets: T::Array[Privy::Wallet::OrHash]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # HPKE-encrypted authorization key with encapsulated key and ciphertext.
+        encrypted_authorization_key:,
+        # The expiration time of the authorization key in milliseconds since the epoch.
+        expires_at:,
+        wallets:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            encrypted_authorization_key: Privy::EncryptedAuthorizationKey,
+            expires_at: Float,
+            wallets: T::Array[Privy::Wallet]
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/ethereum_personal_sign_rpc_input.rbi

@@ -26,6 +26,13 @@ module Privy
       sig { params(address: String).void }
       attr_writer :address
 
+      # A valid CAIP-2 chain ID (e.g. 'eip155:1').
+      sig { returns(T.nilable(String)) }
+      attr_reader :caip2
+
+      sig { params(caip2: String).void }
+      attr_writer :caip2
+
       sig do
         returns(
           T.nilable(Privy::EthereumPersonalSignRpcInput::ChainType::OrSymbol)
@@ -40,6 +47,14 @@ module Privy
       end
       attr_writer :chain_type
 
+      # Options controlling signature production for personal_sign and
+      # eth_signTypedData_v4.
+      sig { returns(T.nilable(Privy::SignatureOptions)) }
+      attr_reader :signature_options
+
+      sig { params(signature_options: Privy::SignatureOptions::OrHash).void }
+      attr_writer :signature_options
+
       sig { returns(T.nilable(String)) }
       attr_reader :wallet_id
 
@@ -52,7 +67,9 @@ module Privy
           method_: Privy::EthereumPersonalSignRpcInput::Method::OrSymbol,
           params: Privy::EthereumPersonalSignRpcInputParams::OrHash,
           address: String,
+          caip2: String,
           chain_type: Privy::EthereumPersonalSignRpcInput::ChainType::OrSymbol,
+          signature_options: Privy::SignatureOptions::OrHash,
           wallet_id: String
         ).returns(T.attached_class)
       end
@@ -61,7 +78,12 @@ module Privy
         # Parameters for the EVM `personal_sign` RPC.
         params:,
         address: nil,
+        # A valid CAIP-2 chain ID (e.g. 'eip155:1').
+        caip2: nil,
         chain_type: nil,
+        # Options controlling signature production for personal_sign and
+        # eth_signTypedData_v4.
+        signature_options: nil,
         wallet_id: nil
       )
       end
@@ -72,8 +94,10 @@ module Privy
             method_: Privy::EthereumPersonalSignRpcInput::Method::OrSymbol,
             params: Privy::EthereumPersonalSignRpcInputParams,
             address: String,
+            caip2: String,
             chain_type:
               Privy::EthereumPersonalSignRpcInput::ChainType::OrSymbol,
+            signature_options: Privy::SignatureOptions,
             wallet_id: String
           }
         )

data/rbi/privy/models/ethereum_sign_typed_data_rpc_input.rbi

@@ -26,6 +26,13 @@ module Privy
       sig { params(address: String).void }
       attr_writer :address
 
+      # A valid CAIP-2 chain ID (e.g. 'eip155:1').
+      sig { returns(T.nilable(String)) }
+      attr_reader :caip2
+
+      sig { params(caip2: String).void }
+      attr_writer :caip2
+
       sig do
         returns(
           T.nilable(Privy::EthereumSignTypedDataRpcInput::ChainType::OrSymbol)
@@ -40,6 +47,14 @@ module Privy
       end
       attr_writer :chain_type
 
+      # Options controlling signature production for personal_sign and
+      # eth_signTypedData_v4.
+      sig { returns(T.nilable(Privy::SignatureOptions)) }
+      attr_reader :signature_options
+
+      sig { params(signature_options: Privy::SignatureOptions::OrHash).void }
+      attr_writer :signature_options
+
       sig { returns(T.nilable(String)) }
       attr_reader :wallet_id
 
@@ -53,7 +68,9 @@ module Privy
           method_: Privy::EthereumSignTypedDataRpcInput::Method::OrSymbol,
           params: Privy::EthereumSignTypedDataRpcInputParams::OrHash,
           address: String,
+          caip2: String,
           chain_type: Privy::EthereumSignTypedDataRpcInput::ChainType::OrSymbol,
+          signature_options: Privy::SignatureOptions::OrHash,
           wallet_id: String
         ).returns(T.attached_class)
       end
@@ -62,7 +79,12 @@ module Privy
         # Parameters for the EVM `eth_signTypedData_v4` RPC.
         params:,
         address: nil,
+        # A valid CAIP-2 chain ID (e.g. 'eip155:1').
+        caip2: nil,
         chain_type: nil,
+        # Options controlling signature production for personal_sign and
+        # eth_signTypedData_v4.
+        signature_options: nil,
         wallet_id: nil
       )
       end
@@ -73,8 +95,10 @@ module Privy
             method_: Privy::EthereumSignTypedDataRpcInput::Method::OrSymbol,
             params: Privy::EthereumSignTypedDataRpcInputParams,
             address: String,
+            caip2: String,
             chain_type:
               Privy::EthereumSignTypedDataRpcInput::ChainType::OrSymbol,
+            signature_options: Privy::SignatureOptions,
             wallet_id: String
           }
         )

data/rbi/privy/models/ethereum_transaction_condition.rbi

@@ -8,7 +8,8 @@ module Privy
           T.any(Privy::EthereumTransactionCondition, Privy::Internal::AnyHash)
         end
 
-      sig { returns(Privy::EthereumTransactionCondition::Field::OrSymbol) }
+      # Ethereum transaction-level fields that can be referenced in a policy condition.
+      sig { returns(Privy::EthereumTransactionConditionField::OrSymbol) }
       attr_accessor :field
 
       sig do
@@ -29,7 +30,7 @@ module Privy
       # eth_sendTransaction request.
       sig do
         params(
-          field: Privy::EthereumTransactionCondition::Field::OrSymbol,
+          field: Privy::EthereumTransactionConditionField::OrSymbol,
           field_source:
             Privy::EthereumTransactionCondition::FieldSource::OrSymbol,
           operator: Privy::ConditionOperator::OrSymbol,
@@ -37,6 +38,7 @@ module Privy
         ).returns(T.attached_class)
       end
       def self.new(
+        # Ethereum transaction-level fields that can be referenced in a policy condition.
         field:,
         field_source:,
         # Operator to use for policy conditions.
@@ -50,7 +52,7 @@ module Privy
       sig do
         override.returns(
           {
-            field: Privy::EthereumTransactionCondition::Field::OrSymbol,
+            field: Privy::EthereumTransactionConditionField::OrSymbol,
             field_source:
               Privy::EthereumTransactionCondition::FieldSource::OrSymbol,
             operator: Privy::ConditionOperator::OrSymbol,
@@ -61,37 +63,6 @@ module Privy
       def to_hash
       end
 
-      module Field
-        extend Privy::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Privy::EthereumTransactionCondition::Field)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        TO =
-          T.let(:to, Privy::EthereumTransactionCondition::Field::TaggedSymbol)
-        VALUE =
-          T.let(
-            :value,
-            Privy::EthereumTransactionCondition::Field::TaggedSymbol
-          )
-        CHAIN_ID =
-          T.let(
-            :chain_id,
-            Privy::EthereumTransactionCondition::Field::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[Privy::EthereumTransactionCondition::Field::TaggedSymbol]
-          )
-        end
-        def self.values
-        end
-      end
-
       module FieldSource
         extend Privy::Internal::Type::Enum