privy_ruby 0.1.0 → 0.2.0

data/rbi/privy/models/bridge_sandbox_fiat_virtual_account_request.rbi

@@ -11,6 +11,7 @@ module Privy
           )
         end
 
+      # The destination chain, asset, and address for a virtual account transfer.
       sig { returns(Privy::BridgeFiatVirtualAccountDestination) }
       attr_reader :destination
 
@@ -28,6 +29,7 @@ module Privy
       end
       attr_accessor :provider
 
+      # The source fiat currency configuration for a virtual account.
       sig { returns(Privy::BridgeFiatVirtualAccountSource) }
       attr_reader :source
 
@@ -43,7 +45,13 @@ module Privy
           source: Privy::BridgeFiatVirtualAccountSource::OrHash
         ).returns(T.attached_class)
       end
-      def self.new(destination:, provider:, source:)
+      def self.new(
+        # The destination chain, asset, and address for a virtual account transfer.
+        destination:,
+        provider:,
+        # The source fiat currency configuration for a virtual account.
+        source:
+      )
       end
 
       sig do

data/rbi/privy/models/bridge_sandbox_fiat_virtual_account_response.rbi

@@ -25,6 +25,7 @@ module Privy
       end
       attr_accessor :deposit_instructions
 
+      # The destination chain, asset, and address for a virtual account transfer.
       sig { returns(Privy::BridgeFiatVirtualAccountDestination) }
       attr_reader :destination
 
@@ -65,6 +66,7 @@ module Privy
       def self.new(
         # The deposit instructions for a virtual account.
         deposit_instructions:,
+        # The destination chain, asset, and address for a virtual account transfer.
         destination:,
         provider:,
         status:

data/rbi/privy/models/bridge_source_asset.rbi

@@ -2,6 +2,7 @@
 
 module Privy
   module Models
+    # Supported source fiat currencies for virtual account deposits.
     module BridgeSourceAsset
       extend Privy::Internal::Type::Enum
 

data/rbi/privy/models/create_stripe_onramp_session_response.rbi

@@ -17,14 +17,72 @@ module Privy
       sig { returns(String) }
       attr_accessor :session_id
 
+      # Transaction details returned from a Stripe onramp session.
+      sig do
+        returns(
+          T.nilable(
+            Privy::CreateStripeOnrampSessionResponse::TransactionDetails
+          )
+        )
+      end
+      attr_reader :transaction_details
+
+      sig do
+        params(
+          transaction_details:
+            Privy::CreateStripeOnrampSessionResponse::TransactionDetails::OrHash
+        ).void
+      end
+      attr_writer :transaction_details
+
       # The created onramp session.
-      sig { params(id: String, session_id: String).returns(T.attached_class) }
-      def self.new(id:, session_id:)
+      sig do
+        params(
+          id: String,
+          session_id: String,
+          transaction_details:
+            Privy::CreateStripeOnrampSessionResponse::TransactionDetails::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        session_id:,
+        # Transaction details returned from a Stripe onramp session.
+        transaction_details: nil
+      )
       end
 
-      sig { override.returns({ id: String, session_id: String }) }
+      sig do
+        override.returns(
+          {
+            id: String,
+            session_id: String,
+            transaction_details:
+              Privy::CreateStripeOnrampSessionResponse::TransactionDetails
+          }
+        )
+      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/device_verify_action.rbi

@@ -0,0 +1,22 @@
+# typed: strong
+
+module Privy
+  module Models
+    # The action to take on the device authorization request.
+    module DeviceVerifyAction
+      extend Privy::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Privy::DeviceVerifyAction) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      APPROVE = T.let(:approve, Privy::DeviceVerifyAction::TaggedSymbol)
+      DENY = T.let(:deny, Privy::DeviceVerifyAction::TaggedSymbol)
+
+      sig do
+        override.returns(T::Array[Privy::DeviceVerifyAction::TaggedSymbol])
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/privy/models/device_verify_request_body.rbi

@@ -0,0 +1,44 @@
+# typed: strong
+
+module Privy
+  module Models
+    class DeviceVerifyRequestBody < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::DeviceVerifyRequestBody, Privy::Internal::AnyHash)
+        end
+
+      # The action to take on the device authorization request.
+      sig { returns(Privy::DeviceVerifyAction::OrSymbol) }
+      attr_accessor :action
+
+      # The user code displayed on the CLI device.
+      sig { returns(String) }
+      attr_accessor :user_code
+
+      # Request body for approving or denying a device authorization request. The user
+      # must be authenticated and belong to the target app.
+      sig do
+        params(
+          action: Privy::DeviceVerifyAction::OrSymbol,
+          user_code: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The action to take on the device authorization request.
+        action:,
+        # The user code displayed on the CLI device.
+        user_code:
+      )
+      end
+
+      sig do
+        override.returns(
+          { action: Privy::DeviceVerifyAction::OrSymbol, user_code: String }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/device_verify_response.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Privy
+  module Models
+    class DeviceVerifyResponse < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::DeviceVerifyResponse, Privy::Internal::AnyHash)
+        end
+
+      # Whether the action was processed successfully.
+      sig { returns(T::Boolean) }
+      attr_accessor :success
+
+      # Response indicating the device authorization action was processed.
+      sig { params(success: T::Boolean).returns(T.attached_class) }
+      def self.new(
+        # Whether the action was processed successfully.
+        success:
+      )
+      end
+
+      sig { override.returns({ success: T::Boolean }) }
+      def to_hash
+      end
+    end
+  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/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/hyperliquid_token_address.rbi

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

data/rbi/privy/models/linked_account_embedded_wallet.rbi

@@ -2,6 +2,7 @@
 
 module Privy
   module Models
+    # A linked embedded wallet account across all supported chain types.
     module LinkedAccountEmbeddedWallet
       extend Privy::Internal::Type::Union
 

data/rbi/privy/models/oauth_grant.rbi

@@ -0,0 +1,78 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OAuthGrant < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Privy::OAuthGrant, Privy::Internal::AnyHash) }
+
+      # The grant identifier.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # When the grant was first created.
+      sig { returns(Time) }
+      attr_accessor :created_at
+
+      # The OAuth grant type that created this grant.
+      sig { returns(Privy::OAuthGrant::GrantType::OrSymbol) }
+      attr_accessor :grant_type
+
+      # When the grant was last used (e.g. token refreshed).
+      sig { returns(Time) }
+      attr_accessor :last_used_at
+
+      # An active OAuth grant representing an authorized session.
+      sig do
+        params(
+          id: String,
+          created_at: Time,
+          grant_type: Privy::OAuthGrant::GrantType::OrSymbol,
+          last_used_at: Time
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The grant identifier.
+        id:,
+        # When the grant was first created.
+        created_at:,
+        # The OAuth grant type that created this grant.
+        grant_type:,
+        # When the grant was last used (e.g. token refreshed).
+        last_used_at:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created_at: Time,
+            grant_type: Privy::OAuthGrant::GrantType::OrSymbol,
+            last_used_at: Time
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The OAuth grant type that created this grant.
+      module GrantType
+        extend Privy::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Privy::OAuthGrant::GrantType) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DEVICE_CODE =
+          T.let(:device_code, Privy::OAuthGrant::GrantType::TaggedSymbol)
+
+        sig do
+          override.returns(T::Array[Privy::OAuthGrant::GrantType::TaggedSymbol])
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/oauth_grant_list_response.rbi

@@ -0,0 +1,32 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OAuthGrantListResponse < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::OAuthGrantListResponse, Privy::Internal::AnyHash)
+        end
+
+      # Active grants.
+      sig { returns(T::Array[Privy::OAuthGrant]) }
+      attr_accessor :data
+
+      # List of active OAuth grants for the authenticated user.
+      sig do
+        params(data: T::Array[Privy::OAuthGrant::OrHash]).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        # Active grants.
+        data:
+      )
+      end
+
+      sig { override.returns({ data: T::Array[Privy::OAuthGrant] }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/oauth_grant_revoke_response.rbi

@@ -0,0 +1,58 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OAuthGrantRevokeResponse < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::OAuthGrantRevokeResponse, Privy::Internal::AnyHash)
+        end
+
+      # Whether the revocation was processed.
+      sig { returns(Privy::OAuthGrantRevokeResponse::Success::OrBoolean) }
+      attr_accessor :success
+
+      # Response from revoking an OAuth grant.
+      sig do
+        params(
+          success: Privy::OAuthGrantRevokeResponse::Success::OrBoolean
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Whether the revocation was processed.
+        success:
+      )
+      end
+
+      sig do
+        override.returns(
+          { success: Privy::OAuthGrantRevokeResponse::Success::OrBoolean }
+        )
+      end
+      def to_hash
+      end
+
+      # Whether the revocation was processed.
+      module Success
+        extend Privy::Internal::Type::Enum
+
+        TaggedBoolean =
+          T.type_alias do
+            T.all(T::Boolean, Privy::OAuthGrantRevokeResponse::Success)
+          end
+        OrBoolean = T.type_alias { T::Boolean }
+
+        TRUE =
+          T.let(true, Privy::OAuthGrantRevokeResponse::Success::TaggedBoolean)
+
+        sig do
+          override.returns(
+            T::Array[Privy::OAuthGrantRevokeResponse::Success::TaggedBoolean]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/oauth_token_authorization_code_request_body.rbi

@@ -0,0 +1,115 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OAuthTokenAuthorizationCodeRequestBody < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Privy::OAuthTokenAuthorizationCodeRequestBody,
+            Privy::Internal::AnyHash
+          )
+        end
+
+      # The authorization code received from the authorization endpoint.
+      sig { returns(String) }
+      attr_accessor :code
+
+      sig do
+        returns(
+          Privy::OAuthTokenAuthorizationCodeRequestBody::GrantType::OrSymbol
+        )
+      end
+      attr_accessor :grant_type
+
+      # The client ID. Alternative to Basic auth header.
+      sig { returns(T.nilable(String)) }
+      attr_reader :client_id
+
+      sig { params(client_id: String).void }
+      attr_writer :client_id
+
+      # The client secret. Alternative to Basic auth header.
+      sig { returns(T.nilable(String)) }
+      attr_reader :client_secret
+
+      sig { params(client_secret: String).void }
+      attr_writer :client_secret
+
+      # The redirect URI used in the authorization request.
+      sig { returns(T.nilable(String)) }
+      attr_reader :redirect_uri
+
+      sig { params(redirect_uri: String).void }
+      attr_writer :redirect_uri
+
+      # Request body for the authorization_code grant type.
+      sig do
+        params(
+          code: String,
+          grant_type:
+            Privy::OAuthTokenAuthorizationCodeRequestBody::GrantType::OrSymbol,
+          client_id: String,
+          client_secret: String,
+          redirect_uri: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The authorization code received from the authorization endpoint.
+        code:,
+        grant_type:,
+        # The client ID. Alternative to Basic auth header.
+        client_id: nil,
+        # The client secret. Alternative to Basic auth header.
+        client_secret: nil,
+        # The redirect URI used in the authorization request.
+        redirect_uri: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            code: String,
+            grant_type:
+              Privy::OAuthTokenAuthorizationCodeRequestBody::GrantType::OrSymbol,
+            client_id: String,
+            client_secret: String,
+            redirect_uri: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module GrantType
+        extend Privy::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Privy::OAuthTokenAuthorizationCodeRequestBody::GrantType
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AUTHORIZATION_CODE =
+          T.let(
+            :authorization_code,
+            Privy::OAuthTokenAuthorizationCodeRequestBody::GrantType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Privy::OAuthTokenAuthorizationCodeRequestBody::GrantType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/oauth_token_device_code_pending_error.rbi

@@ -0,0 +1,106 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OAuthTokenDeviceCodePendingError < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Privy::OAuthTokenDeviceCodePendingError,
+            Privy::Internal::AnyHash
+          )
+        end
+
+      # The error code indicating why the token request failed.
+      sig { returns(Privy::OAuthTokenDeviceCodePendingError::Error::OrSymbol) }
+      attr_accessor :error
+
+      # Human-readable description of the error.
+      sig { returns(T.nilable(String)) }
+      attr_reader :error_description
+
+      sig { params(error_description: String).void }
+      attr_writer :error_description
+
+      # The minimum polling interval in seconds.
+      sig { returns(T.nilable(Float)) }
+      attr_reader :interval
+
+      sig { params(interval: Float).void }
+      attr_writer :interval
+
+      # Error response returned while the device authorization is still pending (RFC
+      # 8628 Section 3.5).
+      sig do
+        params(
+          error: Privy::OAuthTokenDeviceCodePendingError::Error::OrSymbol,
+          error_description: String,
+          interval: Float
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The error code indicating why the token request failed.
+        error:,
+        # Human-readable description of the error.
+        error_description: nil,
+        # The minimum polling interval in seconds.
+        interval: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            error: Privy::OAuthTokenDeviceCodePendingError::Error::OrSymbol,
+            error_description: String,
+            interval: Float
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The error code indicating why the token request failed.
+      module Error
+        extend Privy::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Privy::OAuthTokenDeviceCodePendingError::Error)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AUTHORIZATION_PENDING =
+          T.let(
+            :authorization_pending,
+            Privy::OAuthTokenDeviceCodePendingError::Error::TaggedSymbol
+          )
+        SLOW_DOWN =
+          T.let(
+            :slow_down,
+            Privy::OAuthTokenDeviceCodePendingError::Error::TaggedSymbol
+          )
+        ACCESS_DENIED =
+          T.let(
+            :access_denied,
+            Privy::OAuthTokenDeviceCodePendingError::Error::TaggedSymbol
+          )
+        EXPIRED_TOKEN =
+          T.let(
+            :expired_token,
+            Privy::OAuthTokenDeviceCodePendingError::Error::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Privy::OAuthTokenDeviceCodePendingError::Error::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end