privy_ruby 0.3.0 → 0.5.0

data/rbi/privy/models/wallets/aave_vault_details.rbi

@@ -0,0 +1,165 @@
+# typed: strong
+
+module Privy
+  module Models
+    module Wallets
+      class AaveVaultDetails < Privy::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Privy::Wallets::AaveVaultDetails, Privy::Internal::AnyHash)
+          end
+
+        # Vault identifier.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # EVM address of the vault admin wallet.
+        sig { returns(String) }
+        attr_accessor :admin_wallet_address
+
+        # Privy wallet ID of the vault admin.
+        sig { returns(String) }
+        attr_accessor :admin_wallet_id
+
+        # Annual percentage yield earned by the app from fee wrapper fees, in basis
+        # points.
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :app_apy
+
+        # Asset metadata for an earn vault position.
+        sig { returns(Privy::Wallets::EarnAsset) }
+        attr_reader :asset
+
+        sig { params(asset: Privy::Wallets::EarnAsset::OrHash).void }
+        attr_writer :asset
+
+        # Fees available to collect, in smallest unit of the underlying asset.
+        sig { returns(String) }
+        attr_accessor :available_fees
+
+        # Available liquidity in USD.
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :available_liquidity_usd
+
+        # CAIP-2 chain identifier (e.g. "eip155:8453").
+        sig { returns(String) }
+        attr_accessor :caip2
+
+        # Human-readable vault name from the yield provider.
+        sig { returns(String) }
+        attr_accessor :name
+
+        sig { returns(Privy::Wallets::AaveVaultDetails::Provider::OrSymbol) }
+        attr_accessor :provider
+
+        # Total value locked in USD.
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :tvl_usd
+
+        # Annual percentage yield available to the user, after fees and excluding rewards,
+        # in basis points (e.g. 500 for 5%). 1 basis point = 0.01%.
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :user_apy
+
+        # Onchain vault contract address.
+        sig { returns(String) }
+        attr_accessor :vault_address
+
+        # Vault details for an Aave earn vault, including fee visibility.
+        sig do
+          params(
+            id: String,
+            admin_wallet_address: String,
+            admin_wallet_id: String,
+            app_apy: T.nilable(Float),
+            asset: Privy::Wallets::EarnAsset::OrHash,
+            available_fees: String,
+            available_liquidity_usd: T.nilable(Float),
+            caip2: String,
+            name: String,
+            provider: Privy::Wallets::AaveVaultDetails::Provider::OrSymbol,
+            tvl_usd: T.nilable(Float),
+            user_apy: T.nilable(Float),
+            vault_address: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Vault identifier.
+          id:,
+          # EVM address of the vault admin wallet.
+          admin_wallet_address:,
+          # Privy wallet ID of the vault admin.
+          admin_wallet_id:,
+          # Annual percentage yield earned by the app from fee wrapper fees, in basis
+          # points.
+          app_apy:,
+          # Asset metadata for an earn vault position.
+          asset:,
+          # Fees available to collect, in smallest unit of the underlying asset.
+          available_fees:,
+          # Available liquidity in USD.
+          available_liquidity_usd:,
+          # CAIP-2 chain identifier (e.g. "eip155:8453").
+          caip2:,
+          # Human-readable vault name from the yield provider.
+          name:,
+          provider:,
+          # Total value locked in USD.
+          tvl_usd:,
+          # Annual percentage yield available to the user, after fees and excluding rewards,
+          # in basis points (e.g. 500 for 5%). 1 basis point = 0.01%.
+          user_apy:,
+          # Onchain vault contract address.
+          vault_address:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              admin_wallet_address: String,
+              admin_wallet_id: String,
+              app_apy: T.nilable(Float),
+              asset: Privy::Wallets::EarnAsset,
+              available_fees: String,
+              available_liquidity_usd: T.nilable(Float),
+              caip2: String,
+              name: String,
+              provider: Privy::Wallets::AaveVaultDetails::Provider::OrSymbol,
+              tvl_usd: T.nilable(Float),
+              user_apy: T.nilable(Float),
+              vault_address: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module Provider
+          extend Privy::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Privy::Wallets::AaveVaultDetails::Provider)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          AAVE =
+            T.let(
+              :aave,
+              Privy::Wallets::AaveVaultDetails::Provider::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[Privy::Wallets::AaveVaultDetails::Provider::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/wallets/balance_get_params.rbi

@@ -238,6 +238,8 @@ module Privy
             T.let(:avax, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
           POL =
             T.let(:pol, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
+          BNB =
+            T.let(:bnb, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
           USDT =
             T.let(:usdt, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
           EURC =
@@ -246,6 +248,8 @@ module Privy
             T.let(:usdb, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
           SOL =
             T.let(:sol, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
+          TRX =
+            T.let(:trx, Privy::Wallets::BalanceGetParams::Asset::TaggedSymbol)
 
           WalletAssetArray =
             T.let(

data/rbi/privy/models/wallets/balance_get_response.rbi

@@ -161,6 +161,11 @@ module Privy
                 :pol,
                 Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::TaggedSymbol
               )
+            BNB =
+              T.let(
+                :bnb,
+                Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::TaggedSymbol
+              )
             USDT =
               T.let(
                 :usdt,
@@ -181,6 +186,11 @@ module Privy
                 :sol,
                 Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::TaggedSymbol
               )
+            TRX =
+              T.let(
+                :trx,
+                Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::TaggedSymbol
+              )
           end
         end
       end

data/rbi/privy/models/wallets/earn_fee_collect_action_response.rbi

@@ -0,0 +1,236 @@
+# typed: strong
+
+module Privy
+  module Models
+    module Wallets
+      class EarnFeeCollectActionResponse < Privy::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Privy::Wallets::EarnFeeCollectActionResponse,
+              Privy::Internal::AnyHash
+            )
+          end
+
+        # The ID of the wallet action.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Underlying asset token address.
+        sig { returns(String) }
+        attr_accessor :asset_address
+
+        # CAIP-2 chain identifier.
+        sig { returns(String) }
+        attr_accessor :caip2
+
+        # ISO 8601 timestamp of when the wallet action was created.
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # Base-unit amount of fees collected (e.g. "1500000"). Populated after on-chain
+        # confirmation.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :raw_amount
+
+        # Status of a wallet action.
+        sig { returns(Privy::Wallets::WalletActionStatus::TaggedSymbol) }
+        attr_accessor :status
+
+        sig do
+          returns(
+            Privy::Wallets::EarnFeeCollectActionResponse::Type::TaggedSymbol
+          )
+        end
+        attr_accessor :type
+
+        # ERC-4626 vault contract address.
+        sig { returns(String) }
+        attr_accessor :vault_address
+
+        # The vault ID.
+        sig { returns(String) }
+        attr_accessor :vault_id
+
+        # The ID of the wallet involved in the action.
+        sig { returns(String) }
+        attr_accessor :wallet_id
+
+        # Human-readable decimal amount of fees collected (e.g. "1.5"). Omitted when the
+        # token is not in the asset registry. Null while the action is pending; populated
+        # after on-chain confirmation.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :amount
+
+        # Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in
+        # the asset registry.
+        sig { returns(T.nilable(String)) }
+        attr_reader :asset
+
+        sig { params(asset: String).void }
+        attr_writer :asset
+
+        # Number of decimals for the underlying asset (e.g. 6 for USDC, 18 for ETH). Only
+        # present when the token is known in the asset registry.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :decimals
+
+        sig { params(decimals: Integer).void }
+        attr_writer :decimals
+
+        # A description of why a wallet action (or a step within a wallet action) failed.
+        sig { returns(T.nilable(Privy::Wallets::FailureReason)) }
+        attr_reader :failure_reason
+
+        sig do
+          params(failure_reason: Privy::Wallets::FailureReason::OrHash).void
+        end
+        attr_writer :failure_reason
+
+        # The steps of the wallet action. Only returned if `?include=steps` is provided.
+        sig do
+          returns(
+            T.nilable(T::Array[Privy::Wallets::WalletActionStep::Variants])
+          )
+        end
+        attr_reader :steps
+
+        sig do
+          params(
+            steps:
+              T::Array[
+                T.any(
+                  Privy::Wallets::EvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::EvmUserOperationWalletActionStep::OrHash,
+                  Privy::Wallets::SvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::TvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::ExternalTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::CustodianTransactionWalletActionStep::OrHash
+                )
+              ]
+          ).void
+        end
+        attr_writer :steps
+
+        # Response for an earn fee collect action.
+        sig do
+          params(
+            id: String,
+            asset_address: String,
+            caip2: String,
+            created_at: Time,
+            raw_amount: T.nilable(String),
+            status: Privy::Wallets::WalletActionStatus::OrSymbol,
+            type: Privy::Wallets::EarnFeeCollectActionResponse::Type::OrSymbol,
+            vault_address: String,
+            vault_id: String,
+            wallet_id: String,
+            amount: T.nilable(String),
+            asset: String,
+            decimals: Integer,
+            failure_reason: Privy::Wallets::FailureReason::OrHash,
+            steps:
+              T::Array[
+                T.any(
+                  Privy::Wallets::EvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::EvmUserOperationWalletActionStep::OrHash,
+                  Privy::Wallets::SvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::TvmTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::ExternalTransactionWalletActionStep::OrHash,
+                  Privy::Wallets::CustodianTransactionWalletActionStep::OrHash
+                )
+              ]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The ID of the wallet action.
+          id:,
+          # Underlying asset token address.
+          asset_address:,
+          # CAIP-2 chain identifier.
+          caip2:,
+          # ISO 8601 timestamp of when the wallet action was created.
+          created_at:,
+          # Base-unit amount of fees collected (e.g. "1500000"). Populated after on-chain
+          # confirmation.
+          raw_amount:,
+          # Status of a wallet action.
+          status:,
+          type:,
+          # ERC-4626 vault contract address.
+          vault_address:,
+          # The vault ID.
+          vault_id:,
+          # The ID of the wallet involved in the action.
+          wallet_id:,
+          # Human-readable decimal amount of fees collected (e.g. "1.5"). Omitted when the
+          # token is not in the asset registry. Null while the action is pending; populated
+          # after on-chain confirmation.
+          amount: nil,
+          # Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in
+          # the asset registry.
+          asset: nil,
+          # Number of decimals for the underlying asset (e.g. 6 for USDC, 18 for ETH). Only
+          # present when the token is known in the asset registry.
+          decimals: nil,
+          # A description of why a wallet action (or a step within a wallet action) failed.
+          failure_reason: nil,
+          # The steps of the wallet action. Only returned if `?include=steps` is provided.
+          steps: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              asset_address: String,
+              caip2: String,
+              created_at: Time,
+              raw_amount: T.nilable(String),
+              status: Privy::Wallets::WalletActionStatus::TaggedSymbol,
+              type:
+                Privy::Wallets::EarnFeeCollectActionResponse::Type::TaggedSymbol,
+              vault_address: String,
+              vault_id: String,
+              wallet_id: String,
+              amount: T.nilable(String),
+              asset: String,
+              decimals: Integer,
+              failure_reason: Privy::Wallets::FailureReason,
+              steps: T::Array[Privy::Wallets::WalletActionStep::Variants]
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module Type
+          extend Privy::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Privy::Wallets::EarnFeeCollectActionResponse::Type)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          EARN_FEE_COLLECT =
+            T.let(
+              :earn_fee_collect,
+              Privy::Wallets::EarnFeeCollectActionResponse::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Privy::Wallets::EarnFeeCollectActionResponse::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/wallets/earn_fee_collect_request_body.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module Privy
+  module Models
+    module Wallets
+      class EarnFeeCollectRequestBody < Privy::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Privy::Wallets::EarnFeeCollectRequestBody,
+              Privy::Internal::AnyHash
+            )
+          end
+
+        # The ID of the vault to collect fees from.
+        sig { returns(String) }
+        attr_accessor :vault_id
+
+        # Input for collecting accumulated fees from an Aave vault.
+        sig { params(vault_id: String).returns(T.attached_class) }
+        def self.new(
+          # The ID of the vault to collect fees from.
+          vault_id:
+        )
+        end
+
+        sig { override.returns({ vault_id: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/privy/models/wallets/ethereum_earn_provider.rbi

@@ -14,6 +14,7 @@ module Privy
         MORPHO =
           T.let(:morpho, Privy::Wallets::EthereumEarnProvider::TaggedSymbol)
         AAVE = T.let(:aave, Privy::Wallets::EthereumEarnProvider::TaggedSymbol)
+        VEDA = T.let(:veda, Privy::Wallets::EthereumEarnProvider::TaggedSymbol)
 
         sig do
           override.returns(

data/rbi/privy/models/wallets/ethereum_earn_vault_details_response.rbi

@@ -3,118 +3,26 @@
 module Privy
   module Models
     module Wallets
-      class EthereumEarnVaultDetailsResponse < Privy::Internal::Type::BaseModel
-        OrHash =
+      # Detailed vault information including current APY, liquidity, and asset metadata.
+      # Discriminated on provider.
+      module EthereumEarnVaultDetailsResponse
+        extend Privy::Internal::Type::Union
+
+        Variants =
           T.type_alias do
             T.any(
-              Privy::Wallets::EthereumEarnVaultDetailsResponse,
-              Privy::Internal::AnyHash
+              Privy::Wallets::AaveVaultDetails,
+              Privy::Wallets::MorphoVaultDetails,
+              Privy::Wallets::VedaVaultDetails
             )
           end
 
-        # Vault identifier.
-        sig { returns(String) }
-        attr_accessor :id
-
-        # Annual percentage yield earned by the app from fee wrapper fees, in basis
-        # points.
-        sig { returns(T.nilable(Float)) }
-        attr_accessor :app_apy
-
-        # Asset metadata for an earn vault position.
-        sig { returns(Privy::Wallets::EarnAsset) }
-        attr_reader :asset
-
-        sig { params(asset: Privy::Wallets::EarnAsset::OrHash).void }
-        attr_writer :asset
-
-        # Available liquidity in USD.
-        sig { returns(T.nilable(Float)) }
-        attr_accessor :available_liquidity_usd
-
-        # CAIP-2 chain identifier (e.g. "eip155:8453").
-        sig { returns(String) }
-        attr_accessor :caip2
-
-        # Human-readable vault name from the yield provider.
-        sig { returns(String) }
-        attr_accessor :name
-
-        # Supported earn provider protocols.
-        sig { returns(Privy::Wallets::EthereumEarnProvider::OrSymbol) }
-        attr_accessor :provider
-
-        # Total value locked in USD.
-        sig { returns(T.nilable(Float)) }
-        attr_accessor :tvl_usd
-
-        # Current annual percentage yield in basis points (e.g. 500 for 5%). 1 basis point
-        # = 0.01%.
-        sig { returns(T.nilable(Float)) }
-        attr_accessor :user_apy
-
-        # Onchain vault contract address.
-        sig { returns(String) }
-        attr_accessor :vault_address
-
-        # Detailed vault information including current APY, liquidity, and asset metadata.
-        sig do
-          params(
-            id: String,
-            app_apy: T.nilable(Float),
-            asset: Privy::Wallets::EarnAsset::OrHash,
-            available_liquidity_usd: T.nilable(Float),
-            caip2: String,
-            name: String,
-            provider: Privy::Wallets::EthereumEarnProvider::OrSymbol,
-            tvl_usd: T.nilable(Float),
-            user_apy: T.nilable(Float),
-            vault_address: String
-          ).returns(T.attached_class)
-        end
-        def self.new(
-          # Vault identifier.
-          id:,
-          # Annual percentage yield earned by the app from fee wrapper fees, in basis
-          # points.
-          app_apy:,
-          # Asset metadata for an earn vault position.
-          asset:,
-          # Available liquidity in USD.
-          available_liquidity_usd:,
-          # CAIP-2 chain identifier (e.g. "eip155:8453").
-          caip2:,
-          # Human-readable vault name from the yield provider.
-          name:,
-          # Supported earn provider protocols.
-          provider:,
-          # Total value locked in USD.
-          tvl_usd:,
-          # Current annual percentage yield in basis points (e.g. 500 for 5%). 1 basis point
-          # = 0.01%.
-          user_apy:,
-          # Onchain vault contract address.
-          vault_address:
-        )
-        end
-
         sig do
           override.returns(
-            {
-              id: String,
-              app_apy: T.nilable(Float),
-              asset: Privy::Wallets::EarnAsset,
-              available_liquidity_usd: T.nilable(Float),
-              caip2: String,
-              name: String,
-              provider: Privy::Wallets::EthereumEarnProvider::OrSymbol,
-              tvl_usd: T.nilable(Float),
-              user_apy: T.nilable(Float),
-              vault_address: String
-            }
+            T::Array[Privy::Wallets::EthereumEarnVaultDetailsResponse::Variants]
           )
         end
-        def to_hash
+        def self.variants
         end
       end
     end

data/rbi/privy/models/wallets/list_wallet_actions_response.rbi

@@ -20,7 +20,8 @@ module Privy
                 Privy::Wallets::TransferActionResponse,
                 Privy::Wallets::EarnDepositActionResponse,
                 Privy::Wallets::EarnWithdrawActionResponse,
-                Privy::Wallets::EarnIncentiveClaimActionResponse
+                Privy::Wallets::EarnIncentiveClaimActionResponse,
+                Privy::Wallets::EarnFeeCollectActionResponse
               )
             ]
           )
@@ -40,7 +41,8 @@ module Privy
                   Privy::Wallets::TransferActionResponse::OrHash,
                   Privy::Wallets::EarnDepositActionResponse::OrHash,
                   Privy::Wallets::EarnWithdrawActionResponse::OrHash,
-                  Privy::Wallets::EarnIncentiveClaimActionResponse::OrHash
+                  Privy::Wallets::EarnIncentiveClaimActionResponse::OrHash,
+                  Privy::Wallets::EarnFeeCollectActionResponse::OrHash
                 )
               ],
             next_cursor: T.nilable(String)
@@ -59,7 +61,8 @@ module Privy
                     Privy::Wallets::TransferActionResponse,
                     Privy::Wallets::EarnDepositActionResponse,
                     Privy::Wallets::EarnWithdrawActionResponse,
-                    Privy::Wallets::EarnIncentiveClaimActionResponse
+                    Privy::Wallets::EarnIncentiveClaimActionResponse,
+                    Privy::Wallets::EarnFeeCollectActionResponse
                   )
                 ],
               next_cursor: T.nilable(String)