privy_ruby 0.1.0 → 0.2.0

data/rbi/privy/models/oauth_token_device_code_request_body.rbi

@@ -0,0 +1,78 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OAuthTokenDeviceCodeRequestBody < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Privy::OAuthTokenDeviceCodeRequestBody,
+            Privy::Internal::AnyHash
+          )
+        end
+
+      # The device code received from the device authorization endpoint.
+      sig { returns(String) }
+      attr_accessor :device_code
+
+      sig do
+        returns(Privy::OAuthTokenDeviceCodeRequestBody::GrantType::OrSymbol)
+      end
+      attr_accessor :grant_type
+
+      # Request body for the urn:ietf:params:oauth:grant-type:device_code grant type
+      # (RFC 8628). Used by CLI clients to poll for authorization.
+      sig do
+        params(
+          device_code: String,
+          grant_type:
+            Privy::OAuthTokenDeviceCodeRequestBody::GrantType::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The device code received from the device authorization endpoint.
+        device_code:,
+        grant_type:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            device_code: String,
+            grant_type:
+              Privy::OAuthTokenDeviceCodeRequestBody::GrantType::OrSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module GrantType
+        extend Privy::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Privy::OAuthTokenDeviceCodeRequestBody::GrantType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        URN_IETF_PARAMS_OAUTH_GRANT_TYPE_DEVICE_CODE =
+          T.let(
+            :"urn:ietf:params:oauth:grant-type:device_code",
+            Privy::OAuthTokenDeviceCodeRequestBody::GrantType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Privy::OAuthTokenDeviceCodeRequestBody::GrantType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/oauth_token_grant_type.rbi

@@ -0,0 +1,29 @@
+# typed: strong
+
+module Privy
+  module Models
+    # The OAuth grant type for the token request.
+    module OAuthTokenGrantType
+      extend Privy::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Privy::OAuthTokenGrantType) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      AUTHORIZATION_CODE =
+        T.let(:authorization_code, Privy::OAuthTokenGrantType::TaggedSymbol)
+      URN_IETF_PARAMS_OAUTH_GRANT_TYPE_DEVICE_CODE =
+        T.let(
+          :"urn:ietf:params:oauth:grant-type:device_code",
+          Privy::OAuthTokenGrantType::TaggedSymbol
+        )
+      REFRESH_TOKEN =
+        T.let(:refresh_token, Privy::OAuthTokenGrantType::TaggedSymbol)
+
+      sig do
+        override.returns(T::Array[Privy::OAuthTokenGrantType::TaggedSymbol])
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/privy/models/oauth_token_refresh_token_request_body.rbi

@@ -0,0 +1,78 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OAuthTokenRefreshTokenRequestBody < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Privy::OAuthTokenRefreshTokenRequestBody,
+            Privy::Internal::AnyHash
+          )
+        end
+
+      sig do
+        returns(Privy::OAuthTokenRefreshTokenRequestBody::GrantType::OrSymbol)
+      end
+      attr_accessor :grant_type
+
+      # The refresh token to exchange for a new access token.
+      sig { returns(String) }
+      attr_accessor :refresh_token
+
+      # Request body for the refresh_token grant type. Rotates the refresh token and
+      # issues a new access token.
+      sig do
+        params(
+          grant_type:
+            Privy::OAuthTokenRefreshTokenRequestBody::GrantType::OrSymbol,
+          refresh_token: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        grant_type:,
+        # The refresh token to exchange for a new access token.
+        refresh_token:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            grant_type:
+              Privy::OAuthTokenRefreshTokenRequestBody::GrantType::OrSymbol,
+            refresh_token: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module GrantType
+        extend Privy::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Privy::OAuthTokenRefreshTokenRequestBody::GrantType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        REFRESH_TOKEN =
+          T.let(
+            :refresh_token,
+            Privy::OAuthTokenRefreshTokenRequestBody::GrantType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Privy::OAuthTokenRefreshTokenRequestBody::GrantType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/oauth_token_request_body.rbi

@@ -0,0 +1,23 @@
+# typed: strong
+
+module Privy
+  module Models
+    # Request body for the OAuth token endpoint, discriminated by grant_type.
+    module OAuthTokenRequestBody
+      extend Privy::Internal::Type::Union
+
+      Variants =
+        T.type_alias do
+          T.any(
+            Privy::OAuthTokenAuthorizationCodeRequestBody,
+            Privy::OAuthTokenDeviceCodeRequestBody,
+            Privy::OAuthTokenRefreshTokenRequestBody
+          )
+        end
+
+      sig { override.returns(T::Array[Privy::OAuthTokenRequestBody::Variants]) }
+      def self.variants
+      end
+    end
+  end
+end

data/rbi/privy/models/oauth_token_success_response.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OAuthTokenSuccessResponse < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::OAuthTokenSuccessResponse, Privy::Internal::AnyHash)
+        end
+
+      # The issued access token.
+      sig { returns(String) }
+      attr_accessor :access_token
+
+      # The type of token issued.
+      sig { returns(Privy::OAuthTokenSuccessResponse::TokenType::OrSymbol) }
+      attr_accessor :token_type
+
+      # The lifetime in seconds of the access token.
+      sig { returns(T.nilable(Float)) }
+      attr_reader :expires_in
+
+      sig { params(expires_in: Float).void }
+      attr_writer :expires_in
+
+      # A refresh token for obtaining new access tokens. Issued for device_code and
+      # refresh_token grants.
+      sig { returns(T.nilable(String)) }
+      attr_reader :refresh_token
+
+      sig { params(refresh_token: String).void }
+      attr_writer :refresh_token
+
+      # Successful token response per RFC 6749 Section 5.1.
+      sig do
+        params(
+          access_token: String,
+          token_type: Privy::OAuthTokenSuccessResponse::TokenType::OrSymbol,
+          expires_in: Float,
+          refresh_token: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The issued access token.
+        access_token:,
+        # The type of token issued.
+        token_type:,
+        # The lifetime in seconds of the access token.
+        expires_in: nil,
+        # A refresh token for obtaining new access tokens. Issued for device_code and
+        # refresh_token grants.
+        refresh_token: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            access_token: String,
+            token_type: Privy::OAuthTokenSuccessResponse::TokenType::OrSymbol,
+            expires_in: Float,
+            refresh_token: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The type of token issued.
+      module TokenType
+        extend Privy::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Privy::OAuthTokenSuccessResponse::TokenType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        BEARER =
+          T.let(
+            :Bearer,
+            Privy::OAuthTokenSuccessResponse::TokenType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Privy::OAuthTokenSuccessResponse::TokenType::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/onramp_session_fees.rbi

@@ -0,0 +1,39 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OnrampSessionFees < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::OnrampSessionFees, Privy::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :network_fee_amount
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :transaction_fee_amount
+
+      # Fee breakdown for a Stripe onramp transaction.
+      sig do
+        params(
+          network_fee_amount: T.nilable(String),
+          transaction_fee_amount: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(network_fee_amount:, transaction_fee_amount:)
+      end
+
+      sig do
+        override.returns(
+          {
+            network_fee_amount: T.nilable(String),
+            transaction_fee_amount: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/onramp_session_transaction_details.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module Privy
+  module Models
+    class OnrampSessionTransactionDetails < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Privy::OnrampSessionTransactionDetails,
+            Privy::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :destination_amount
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :destination_currency
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :destination_network
+
+      # Fee breakdown for a Stripe onramp transaction.
+      sig { returns(Privy::OnrampSessionTransactionDetails::Fees) }
+      attr_reader :fees
+
+      sig do
+        params(fees: Privy::OnrampSessionTransactionDetails::Fees::OrHash).void
+      end
+      attr_writer :fees
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :source_amount
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :source_currency
+
+      # Transaction details returned from a Stripe onramp session.
+      sig do
+        params(
+          destination_amount: T.nilable(String),
+          destination_currency: T.nilable(String),
+          destination_network: T.nilable(String),
+          fees: Privy::OnrampSessionTransactionDetails::Fees::OrHash,
+          source_amount: T.nilable(String),
+          source_currency: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        destination_amount:,
+        destination_currency:,
+        destination_network:,
+        # Fee breakdown for a Stripe onramp transaction.
+        fees:,
+        source_amount:,
+        source_currency:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            destination_amount: T.nilable(String),
+            destination_currency: T.nilable(String),
+            destination_network: T.nilable(String),
+            fees: Privy::OnrampSessionTransactionDetails::Fees,
+            source_amount: T.nilable(String),
+            source_currency: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Fees < Privy::Models::OnrampSessionFees
+        OrHash =
+          T.type_alias do
+            T.any(
+              Privy::OnrampSessionTransactionDetails::Fees,
+              Privy::Internal::AnyHash
+            )
+          end
+
+        # Fee breakdown for a Stripe onramp transaction.
+        sig { returns(T.attached_class) }
+        def self.new
+        end
+
+        sig { override.returns({}) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/solana_address.rbi

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

data/rbi/privy/models/swap_action_response.rbi

@@ -54,6 +54,32 @@ module Privy
       sig { params(destination_caip2: String).void }
       attr_writer :destination_caip2
 
+      # Estimated fee breakdown from the provider quote.
+      sig { returns(T.nilable(T::Array[Privy::FeeLineItem::Variants])) }
+      attr_reader :estimated_fees
+
+      sig do
+        params(
+          estimated_fees:
+            T::Array[
+              T.any(
+                Privy::RelayerFee::OrHash,
+                Privy::PrivyFee::OrHash,
+                Privy::DeveloperFee::OrHash
+              )
+            ]
+        ).void
+      end
+      attr_writer :estimated_fees
+
+      # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+      # human-readable decimal string, plus the gas token symbol.
+      sig { returns(T.nilable(Privy::Gas)) }
+      attr_reader :estimated_gas
+
+      sig { params(estimated_gas: Privy::Gas::OrHash).void }
+      attr_writer :estimated_gas
+
       # A description of why a wallet action (or a step within a wallet action) failed.
       sig { returns(T.nilable(Privy::FailureReason)) }
       attr_reader :failure_reason
@@ -61,6 +87,32 @@ module Privy
       sig { params(failure_reason: Privy::FailureReason::OrHash).void }
       attr_writer :failure_reason
 
+      # Actual fees paid for the swap. Populated after on-chain confirmation.
+      sig { returns(T.nilable(T::Array[Privy::FeeLineItem::Variants])) }
+      attr_reader :fees
+
+      sig do
+        params(
+          fees:
+            T::Array[
+              T.any(
+                Privy::RelayerFee::OrHash,
+                Privy::PrivyFee::OrHash,
+                Privy::DeveloperFee::OrHash
+              )
+            ]
+        ).void
+      end
+      attr_writer :fees
+
+      # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+      # human-readable decimal string, plus the gas token symbol.
+      sig { returns(T.nilable(Privy::Gas)) }
+      attr_reader :gas
+
+      sig { params(gas: Privy::Gas::OrHash).void }
+      attr_writer :gas
+
       # The steps of the wallet action. Only returned if `?include=steps` is provided.
       sig { returns(T.nilable(T::Array[Privy::WalletActionStep::Variants])) }
       attr_reader :steps
@@ -94,7 +146,25 @@ module Privy
           type: Privy::SwapActionResponse::Type::OrSymbol,
           wallet_id: String,
           destination_caip2: String,
+          estimated_fees:
+            T::Array[
+              T.any(
+                Privy::RelayerFee::OrHash,
+                Privy::PrivyFee::OrHash,
+                Privy::DeveloperFee::OrHash
+              )
+            ],
+          estimated_gas: Privy::Gas::OrHash,
           failure_reason: Privy::FailureReason::OrHash,
+          fees:
+            T::Array[
+              T.any(
+                Privy::RelayerFee::OrHash,
+                Privy::PrivyFee::OrHash,
+                Privy::DeveloperFee::OrHash
+              )
+            ],
+          gas: Privy::Gas::OrHash,
           steps:
             T::Array[
               T.any(
@@ -128,8 +198,18 @@ module Privy
         wallet_id:,
         # Destination chain CAIP-2 identifier. Present for cross-chain swaps.
         destination_caip2: nil,
+        # Estimated fee breakdown from the provider quote.
+        estimated_fees: nil,
+        # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+        # human-readable decimal string, plus the gas token symbol.
+        estimated_gas: nil,
         # A description of why a wallet action (or a step within a wallet action) failed.
         failure_reason: nil,
+        # Actual fees paid for the swap. Populated after on-chain confirmation.
+        fees: nil,
+        # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+        # human-readable decimal string, plus the gas token symbol.
+        gas: nil,
         # The steps of the wallet action. Only returned if `?include=steps` is provided.
         steps: nil
       )
@@ -149,7 +229,11 @@ module Privy
             type: Privy::SwapActionResponse::Type::TaggedSymbol,
             wallet_id: String,
             destination_caip2: String,
+            estimated_fees: T::Array[Privy::FeeLineItem::Variants],
+            estimated_gas: Privy::Gas,
             failure_reason: Privy::FailureReason,
+            fees: T::Array[Privy::FeeLineItem::Variants],
+            gas: Privy::Gas,
             steps: T::Array[Privy::WalletActionStep::Variants]
           }
         )

data/rbi/privy/models/swap_quote_request_body.rbi

@@ -42,10 +42,10 @@ module Privy
 
       # Maximum slippage tolerance in basis points (e.g., 50 for 0.5%). If omitted,
       # auto-slippage is used.
-      sig { returns(T.nilable(Float)) }
+      sig { returns(T.nilable(Integer)) }
       attr_reader :slippage_bps
 
-      sig { params(slippage_bps: Float).void }
+      sig { params(slippage_bps: Integer).void }
       attr_writer :slippage_bps
 
       # Input for requesting a token swap quote.
@@ -56,7 +56,7 @@ module Privy
           source: Privy::SwapSource::OrHash,
           amount_type: Privy::AmountType::OrSymbol,
           fee_configuration: Privy::FeeConfiguration::OrHash,
-          slippage_bps: Float
+          slippage_bps: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -84,7 +84,7 @@ module Privy
             source: Privy::SwapSource,
             amount_type: Privy::AmountType::OrSymbol,
             fee_configuration: Privy::FeeConfiguration,
-            slippage_bps: Float
+            slippage_bps: Integer
           }
         )
       end

data/rbi/privy/models/swap_quote_response.rbi

@@ -16,7 +16,8 @@ module Privy
       sig { returns(String) }
       attr_accessor :est_output_amount
 
-      # Estimated gas cost in base units of the native token.
+      # Estimated gas cost in base units of the native token. @deprecated For
+      # cross-chain swaps, use estimated_gas instead.
       sig { returns(String) }
       attr_accessor :gas_estimate
 
@@ -43,7 +44,7 @@ module Privy
       sig { params(destination_caip2: String).void }
       attr_writer :destination_caip2
 
-      # Estimated fees in USD.
+      # Estimated fees for the swap. Only present for cross-chain swaps.
       sig { returns(T.nilable(T::Array[Privy::FeeLineItem::Variants])) }
       attr_reader :estimated_fees
 
@@ -61,6 +62,14 @@ module Privy
       end
       attr_writer :estimated_fees
 
+      # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+      # human-readable decimal string, plus the gas token symbol.
+      sig { returns(T.nilable(Privy::Gas)) }
+      attr_reader :estimated_gas
+
+      sig { params(estimated_gas: Privy::Gas::OrHash).void }
+      attr_writer :estimated_gas
+
       # Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
       sig { returns(T.nilable(Float)) }
       attr_reader :expires_at
@@ -87,6 +96,7 @@ module Privy
                 Privy::DeveloperFee::OrHash
               )
             ],
+          estimated_gas: Privy::Gas::OrHash,
           expires_at: Float
         ).returns(T.attached_class)
       end
@@ -95,7 +105,8 @@ module Privy
         caip2:,
         # Estimated amount of output token in base units.
         est_output_amount:,
-        # Estimated gas cost in base units of the native token.
+        # Estimated gas cost in base units of the native token. @deprecated For
+        # cross-chain swaps, use estimated_gas instead.
         gas_estimate:,
         # Amount of input token in base units.
         input_amount:,
@@ -107,8 +118,11 @@ module Privy
         output_token:,
         # Destination chain CAIP-2 identifier for cross-chain swaps.
         destination_caip2: nil,
-        # Estimated fees in USD.
+        # Estimated fees for the swap. Only present for cross-chain swaps.
         estimated_fees: nil,
+        # Gas cost for a blockchain action. Includes both raw base-unit amount and a
+        # human-readable decimal string, plus the gas token symbol.
+        estimated_gas: nil,
         # Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
         expires_at: nil
       )
@@ -126,6 +140,7 @@ module Privy
             output_token: String,
             destination_caip2: String,
             estimated_fees: T::Array[Privy::FeeLineItem::Variants],
+            estimated_gas: Privy::Gas,
             expires_at: Float
           }
         )

data/rbi/privy/models/swap_request_body.rbi

@@ -39,10 +39,10 @@ module Privy
       attr_writer :fee_configuration
 
       # Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
-      sig { returns(T.nilable(Float)) }
+      sig { returns(T.nilable(Integer)) }
       attr_reader :slippage_bps
 
-      sig { params(slippage_bps: Float).void }
+      sig { params(slippage_bps: Integer).void }
       attr_writer :slippage_bps
 
       # Input for executing a token swap.
@@ -53,7 +53,7 @@ module Privy
           source: Privy::SwapSource::OrHash,
           amount_type: Privy::AmountType::OrSymbol,
           fee_configuration: Privy::FeeConfiguration::OrHash,
-          slippage_bps: Float
+          slippage_bps: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -80,7 +80,7 @@ module Privy
             source: Privy::SwapSource,
             amount_type: Privy::AmountType::OrSymbol,
             fee_configuration: Privy::FeeConfiguration,
-            slippage_bps: Float
+            slippage_bps: Integer
           }
         )
       end