privy_ruby 0.1.0 → 0.3.0

data/rbi/privy/client.rbi

@@ -46,6 +46,7 @@ module Privy
     sig { returns(Privy::Resources::KeyQuorums) }
     attr_reader :key_quorums
 
+    # Operations related to authorization intents for wallet actions
     sig { returns(Privy::Resources::Intents) }
     attr_reader :intents
 
@@ -71,6 +72,9 @@ module Privy
     sig { returns(Privy::Resources::ClientAuth) }
     attr_reader :client_auth
 
+    sig { returns(Privy::Resources::Shared) }
+    attr_reader :shared
+
     sig { returns(Privy::Resources::Onramps) }
     attr_reader :onramps
 
@@ -83,15 +87,9 @@ module Privy
     sig { returns(Privy::Resources::CrossApp) }
     attr_reader :cross_app
 
-    sig { returns(Privy::Resources::Shared) }
-    attr_reader :shared
-
     sig { returns(Privy::Resources::OAuth) }
     attr_reader :oauth
 
-    sig { returns(Privy::Resources::WalletActions) }
-    attr_reader :wallet_actions
-
     sig { returns(Privy::Resources::Yield) }
     attr_reader :yield_
 

data/rbi/privy/models/access_list_entry.rbi

@@ -0,0 +1,31 @@
+# typed: strong
+
+module Privy
+  module Models
+    class AccessListEntry < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Privy::AccessListEntry, Privy::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :address
+
+      sig { returns(T::Array[String]) }
+      attr_accessor :storage_keys
+
+      # An entry in an EIP-2930 access list, specifying an address and its storage keys.
+      sig do
+        params(address: String, storage_keys: T::Array[String]).returns(
+          T.attached_class
+        )
+      end
+      def self.new(address:, storage_keys:)
+      end
+
+      sig do
+        override.returns({ address: String, storage_keys: T::Array[String] })
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/account_balance_params.rbi

@@ -9,23 +9,17 @@ module Privy
         end
 
       # When set to true, returns balances from testnet chains instead of mainnets.
-      sig do
-        returns(T.nilable(Privy::AccountBalanceParams::TestnetMode::OrSymbol))
-      end
+      sig { returns(T.nilable(Privy::ChainTestnetMode::OrSymbol)) }
       attr_reader :testnet_mode
 
-      sig do
-        params(
-          testnet_mode: Privy::AccountBalanceParams::TestnetMode::OrSymbol
-        ).void
-      end
+      sig { params(testnet_mode: Privy::ChainTestnetMode::OrSymbol).void }
       attr_writer :testnet_mode
 
       # Query parameters for the account balance endpoint.
       sig do
-        params(
-          testnet_mode: Privy::AccountBalanceParams::TestnetMode::OrSymbol
-        ).returns(T.attached_class)
+        params(testnet_mode: Privy::ChainTestnetMode::OrSymbol).returns(
+          T.attached_class
+        )
       end
       def self.new(
         # When set to true, returns balances from testnet chains instead of mainnets.
@@ -34,36 +28,10 @@ module Privy
       end
 
       sig do
-        override.returns(
-          { testnet_mode: Privy::AccountBalanceParams::TestnetMode::OrSymbol }
-        )
+        override.returns({ testnet_mode: Privy::ChainTestnetMode::OrSymbol })
       end
       def to_hash
       end
-
-      # When set to true, returns balances from testnet chains instead of mainnets.
-      module TestnetMode
-        extend Privy::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Privy::AccountBalanceParams::TestnetMode)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        TRUE =
-          T.let(:true, Privy::AccountBalanceParams::TestnetMode::TaggedSymbol)
-        FALSE =
-          T.let(:false, Privy::AccountBalanceParams::TestnetMode::TaggedSymbol)
-
-        sig do
-          override.returns(
-            T::Array[Privy::AccountBalanceParams::TestnetMode::TaggedSymbol]
-          )
-        end
-        def self.values
-        end
-      end
     end
   end
 end

data/rbi/privy/models/advanced_swap_platform_fee.rbi

@@ -0,0 +1,44 @@
+# typed: strong
+
+module Privy
+  module Models
+    class AdvancedSwapPlatformFee < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::AdvancedSwapPlatformFee, Privy::Internal::AnyHash)
+        end
+
+      # Token the fee was taken from (output token in v1).
+      sig { returns(String) }
+      attr_accessor :token
+
+      # Fee amount in the smallest unit of the fee token.
+      sig { returns(String) }
+      attr_accessor :amount
+
+      # Fee in basis points.
+      sig { returns(Integer) }
+      attr_accessor :bps
+
+      # Platform fee collected on a swap.
+      sig do
+        params(token: String, amount: String, bps: Integer).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        # Token the fee was taken from (output token in v1).
+        token:,
+        # Fee amount in the smallest unit of the fee token.
+        amount:,
+        # Fee in basis points.
+        bps:
+      )
+      end
+
+      sig { override.returns({ token: String, amount: String, bps: Integer }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/advanced_swap_request_body.rbi

@@ -0,0 +1,177 @@
+# typed: strong
+
+module Privy
+  module Models
+    class AdvancedSwapRequestBody < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::AdvancedSwapRequestBody, Privy::Internal::AnyHash)
+        end
+
+      # Amount in the smallest unit of the input token (e.g. lamports for SOL).
+      sig { returns(String) }
+      attr_accessor :amount
+
+      # Input token address (base58 mint address).
+      sig { returns(String) }
+      attr_accessor :input_token
+
+      # Output token address (base58 mint address).
+      sig { returns(String) }
+      attr_accessor :output_token
+
+      # CAIP-2 chain identifier. Defaults to Solana mainnet.
+      sig { returns(T.nilable(String)) }
+      attr_reader :caip2
+
+      sig { params(caip2: String).void }
+      attr_writer :caip2
+
+      # When true, skip transaction submission (quote + sign only). The signed
+      # transaction is still returned.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :dry_run
+
+      sig { params(dry_run: T::Boolean).void }
+      attr_writer :dry_run
+
+      # Token account (base58) to receive the platform fee. Must exist on-chain for the
+      # output token.
+      sig { returns(T.nilable(String)) }
+      attr_reader :fee_recipient
+
+      sig { params(fee_recipient: String).void }
+      attr_writer :fee_recipient
+
+      # Platform fee in basis points, taken from the output token. Requires
+      # fee_recipient when > 0.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :platform_fee_bps
+
+      sig { params(platform_fee_bps: Integer).void }
+      attr_writer :platform_fee_bps
+
+      # Max slippage tolerance in basis points (0-10000), or "auto" for
+      # provider-determined. Defaults to "auto".
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              Integer,
+              Privy::AdvancedSwapRequestBody::SlippageBps::OrSymbol
+            )
+          )
+        )
+      end
+      attr_reader :slippage_bps
+
+      sig do
+        params(
+          slippage_bps:
+            T.any(
+              Integer,
+              Privy::AdvancedSwapRequestBody::SlippageBps::OrSymbol
+            )
+        ).void
+      end
+      attr_writer :slippage_bps
+
+      # Request body for initiating a synchronous Solana token swap through an embedded
+      # wallet.
+      sig do
+        params(
+          amount: String,
+          input_token: String,
+          output_token: String,
+          caip2: String,
+          dry_run: T::Boolean,
+          fee_recipient: String,
+          platform_fee_bps: Integer,
+          slippage_bps:
+            T.any(
+              Integer,
+              Privy::AdvancedSwapRequestBody::SlippageBps::OrSymbol
+            )
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Amount in the smallest unit of the input token (e.g. lamports for SOL).
+        amount:,
+        # Input token address (base58 mint address).
+        input_token:,
+        # Output token address (base58 mint address).
+        output_token:,
+        # CAIP-2 chain identifier. Defaults to Solana mainnet.
+        caip2: nil,
+        # When true, skip transaction submission (quote + sign only). The signed
+        # transaction is still returned.
+        dry_run: nil,
+        # Token account (base58) to receive the platform fee. Must exist on-chain for the
+        # output token.
+        fee_recipient: nil,
+        # Platform fee in basis points, taken from the output token. Requires
+        # fee_recipient when > 0.
+        platform_fee_bps: nil,
+        # Max slippage tolerance in basis points (0-10000), or "auto" for
+        # provider-determined. Defaults to "auto".
+        slippage_bps: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            amount: String,
+            input_token: String,
+            output_token: String,
+            caip2: String,
+            dry_run: T::Boolean,
+            fee_recipient: String,
+            platform_fee_bps: Integer,
+            slippage_bps:
+              T.any(
+                Integer,
+                Privy::AdvancedSwapRequestBody::SlippageBps::OrSymbol
+              )
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Max slippage tolerance in basis points (0-10000), or "auto" for
+      # provider-determined. Defaults to "auto".
+      module SlippageBps
+        extend Privy::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Integer,
+              Privy::AdvancedSwapRequestBody::SlippageBps::TaggedSymbol
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[Privy::AdvancedSwapRequestBody::SlippageBps::Variants]
+          )
+        end
+        def self.variants
+        end
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Privy::AdvancedSwapRequestBody::SlippageBps)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AUTO =
+          T.let(
+            :auto,
+            Privy::AdvancedSwapRequestBody::SlippageBps::TaggedSymbol
+          )
+      end
+    end
+  end
+end

data/rbi/privy/models/advanced_swap_response.rbi

@@ -0,0 +1,127 @@
+# typed: strong
+
+module Privy
+  module Models
+    class AdvancedSwapResponse < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::AdvancedSwapResponse, Privy::Internal::AnyHash)
+        end
+
+      # Input amount consumed (smallest unit).
+      sig { returns(String) }
+      attr_accessor :in_amount
+
+      # Input token address (base58).
+      sig { returns(String) }
+      attr_accessor :input_token
+
+      # Minimum output amount guaranteed by slippage tolerance (smallest unit).
+      sig { returns(String) }
+      attr_accessor :min_out_amount
+
+      # Expected output amount before slippage (smallest unit).
+      sig { returns(String) }
+      attr_accessor :out_amount
+
+      # Output token address (base58).
+      sig { returns(String) }
+      attr_accessor :output_token
+
+      # Which aggregator fulfilled the swap (e.g. "dflow").
+      sig { returns(String) }
+      attr_accessor :provider
+
+      # Fully signed transaction (base64). Callers can re-submit to any Solana RPC for
+      # redundancy.
+      sig { returns(String) }
+      attr_accessor :signed_transaction
+
+      # Slippage applied in basis points. Reflects the resolved value if "auto" was
+      # requested.
+      sig { returns(Integer) }
+      attr_accessor :slippage_bps
+
+      # "accepted" if the network has acknowledged the transaction, "rejected" if the
+      # network refused it, "skipped" if dry_run was set. Not an onchain confirmation.
+      sig { returns(Privy::SwapSubmissionStatus::OrSymbol) }
+      attr_accessor :submission_status
+
+      # Solana transaction signature (base58).
+      sig { returns(String) }
+      attr_accessor :transaction_hash
+
+      # Platform fee collected on a swap.
+      sig { returns(T.nilable(Privy::AdvancedSwapPlatformFee)) }
+      attr_reader :platform_fee
+
+      sig { params(platform_fee: Privy::AdvancedSwapPlatformFee::OrHash).void }
+      attr_writer :platform_fee
+
+      # Response from the synchronous Solana swap endpoint.
+      sig do
+        params(
+          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::SwapSubmissionStatus::OrSymbol,
+          transaction_hash: String,
+          platform_fee: Privy::AdvancedSwapPlatformFee::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Input amount consumed (smallest unit).
+        in_amount:,
+        # Input token address (base58).
+        input_token:,
+        # Minimum output amount guaranteed by slippage tolerance (smallest unit).
+        min_out_amount:,
+        # Expected output amount before slippage (smallest unit).
+        out_amount:,
+        # Output token address (base58).
+        output_token:,
+        # Which aggregator fulfilled the swap (e.g. "dflow").
+        provider:,
+        # Fully signed transaction (base64). Callers can re-submit to any Solana RPC for
+        # redundancy.
+        signed_transaction:,
+        # Slippage applied in basis points. Reflects the resolved value if "auto" was
+        # requested.
+        slippage_bps:,
+        # "accepted" if the network has acknowledged the transaction, "rejected" if the
+        # network refused it, "skipped" if dry_run was set. Not an onchain confirmation.
+        submission_status:,
+        # Solana transaction signature (base58).
+        transaction_hash:,
+        # Platform fee collected on a swap.
+        platform_fee: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            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::SwapSubmissionStatus::OrSymbol,
+            transaction_hash: String,
+            platform_fee: Privy::AdvancedSwapPlatformFee
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/privy/models/aggregation.rbi

@@ -34,7 +34,7 @@ module Privy
       sig { returns(T.nilable(String)) }
       attr_accessor :owner_id
 
-      # The time window configuration for an aggregation.
+      # A rolling time window defined by a duration in seconds.
       sig { returns(Privy::AggregationWindow) }
       attr_reader :window
 
@@ -62,7 +62,8 @@ module Privy
                 Privy::SuiTransactionCommandCondition,
                 Privy::SuiTransferObjectsCommandCondition,
                 Privy::ActionRequestBodyCondition,
-                Privy::AggregationCondition
+                Privy::AggregationCondition,
+                Privy::MessageSigningCondition
               )
             ]
           )
@@ -90,7 +91,8 @@ module Privy
                 Privy::SuiTransactionCommandCondition::OrHash,
                 Privy::SuiTransferObjectsCommandCondition::OrHash,
                 Privy::ActionRequestBodyCondition::OrHash,
-                Privy::AggregationCondition::OrHash
+                Privy::AggregationCondition::OrHash,
+                Privy::MessageSigningCondition::OrHash
               )
             ]
         ).void
@@ -132,7 +134,8 @@ module Privy
                 Privy::SuiTransactionCommandCondition::OrHash,
                 Privy::SuiTransferObjectsCommandCondition::OrHash,
                 Privy::ActionRequestBodyCondition::OrHash,
-                Privy::AggregationCondition::OrHash
+                Privy::AggregationCondition::OrHash,
+                Privy::MessageSigningCondition::OrHash
               )
             ],
           group_by: T::Array[Privy::AggregationGroupBy::OrHash]
@@ -152,7 +155,7 @@ module Privy
         name:,
         # The key quorum ID of the owner of the aggregation.
         owner_id:,
-        # The time window configuration for an aggregation.
+        # A rolling time window defined by a duration in seconds.
         window:,
         # Optional conditions to filter events before aggregation.
         conditions: nil,
@@ -189,7 +192,8 @@ module Privy
                   Privy::SuiTransactionCommandCondition,
                   Privy::SuiTransferObjectsCommandCondition,
                   Privy::ActionRequestBodyCondition,
-                  Privy::AggregationCondition
+                  Privy::AggregationCondition,
+                  Privy::MessageSigningCondition
                 )
               ],
             group_by: T::Array[Privy::AggregationGroupBy]

data/rbi/privy/models/aggregation_input.rbi

@@ -24,7 +24,7 @@ module Privy
       sig { returns(String) }
       attr_accessor :name
 
-      # The time window configuration for an aggregation.
+      # A rolling time window defined by a duration in seconds.
       sig { returns(Privy::AggregationWindow) }
       attr_reader :window
 
@@ -52,7 +52,8 @@ module Privy
                 Privy::SuiTransactionCommandCondition,
                 Privy::SuiTransferObjectsCommandCondition,
                 Privy::ActionRequestBodyCondition,
-                Privy::AggregationCondition
+                Privy::AggregationCondition,
+                Privy::MessageSigningCondition
               )
             ]
           )
@@ -80,7 +81,8 @@ module Privy
                 Privy::SuiTransactionCommandCondition::OrHash,
                 Privy::SuiTransferObjectsCommandCondition::OrHash,
                 Privy::ActionRequestBodyCondition::OrHash,
-                Privy::AggregationCondition::OrHash
+                Privy::AggregationCondition::OrHash,
+                Privy::MessageSigningCondition::OrHash
               )
             ]
         ).void
@@ -133,7 +135,8 @@ module Privy
                 Privy::SuiTransactionCommandCondition::OrHash,
                 Privy::SuiTransferObjectsCommandCondition::OrHash,
                 Privy::ActionRequestBodyCondition::OrHash,
-                Privy::AggregationCondition::OrHash
+                Privy::AggregationCondition::OrHash,
+                Privy::MessageSigningCondition::OrHash
               )
             ],
           group_by: T::Array[Privy::AggregationGroupBy::OrHash],
@@ -155,7 +158,7 @@ module Privy
         metric:,
         # The name of the aggregation.
         name:,
-        # The time window configuration for an aggregation.
+        # A rolling time window defined by a duration in seconds.
         window:,
         # Optional conditions to filter events before aggregation.
         conditions: nil,
@@ -195,7 +198,8 @@ module Privy
                   Privy::SuiTransactionCommandCondition,
                   Privy::SuiTransferObjectsCommandCondition,
                   Privy::ActionRequestBodyCondition,
-                  Privy::AggregationCondition
+                  Privy::AggregationCondition,
+                  Privy::MessageSigningCondition
                 )
               ],
             group_by: T::Array[Privy::AggregationGroupBy],

data/rbi/privy/models/aggregation_window.rbi

@@ -15,7 +15,7 @@ module Privy
       sig { returns(Privy::AggregationWindow::Type::OrSymbol) }
       attr_accessor :type
 
-      # The time window configuration for an aggregation.
+      # A rolling time window defined by a duration in seconds.
       sig do
         params(
           seconds: Integer,

data/rbi/privy/models/analytics_event_input.rbi

@@ -12,10 +12,7 @@ module Privy
       attr_accessor :event_name
 
       sig { returns(T.nilable(String)) }
-      attr_reader :client_id
-
-      sig { params(client_id: String).void }
-      attr_writer :client_id
+      attr_accessor :client_id
 
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :payload
@@ -27,7 +24,7 @@ module Privy
       sig do
         params(
           event_name: String,
-          client_id: String,
+          client_id: T.nilable(String),
           payload: T::Hash[Symbol, T.anything]
         ).returns(T.attached_class)
       end
@@ -38,7 +35,7 @@ module Privy
         override.returns(
           {
             event_name: String,
-            client_id: String,
+            client_id: T.nilable(String),
             payload: T::Hash[Symbol, T.anything]
           }
         )

data/rbi/privy/models/app_allowlist_config.rbi

@@ -0,0 +1,49 @@
+# typed: strong
+
+module Privy
+  module Models
+    class AppAllowlistConfig < Privy::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Privy::AppAllowlistConfig, Privy::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :cta_link
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :cta_text
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :error_detail
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :error_title
+
+      # Configuration for the allowlist error page shown to users not on the allowlist.
+      sig do
+        params(
+          cta_link: T.nilable(String),
+          cta_text: T.nilable(String),
+          error_detail: T.nilable(String),
+          error_title: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(cta_link:, cta_text:, error_detail:, error_title:)
+      end
+
+      sig do
+        override.returns(
+          {
+            cta_link: T.nilable(String),
+            cta_text: T.nilable(String),
+            error_detail: T.nilable(String),
+            error_title: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end