privy_ruby 0.1.0 → 0.3.0

data/lib/privy/models/wallets/balance_get_response.rb

@@ -21,9 +21,10 @@ module Privy
           required :asset, union: -> { Privy::Models::Wallets::BalanceGetResponse::Balance::Asset }
 
           # @!attribute chain
+          #   Supported blockchain network names for wallet balance and transaction queries.
           #
-          #   @return [Symbol, Privy::Models::Wallets::BalanceGetResponse::Balance::Chain]
-          required :chain, enum: -> { Privy::Models::Wallets::BalanceGetResponse::Balance::Chain }
+          #   @return [Symbol, Privy::Models::WalletAssetChainNameInput]
+          required :chain, enum: -> { Privy::WalletAssetChainNameInput }
 
           # @!attribute display_values
           #
@@ -42,9 +43,13 @@ module Privy
 
           # @!method initialize(asset:, chain:, display_values:, raw_value:, raw_value_decimals:)
           #   @param asset [Symbol, String, Privy::Models::Wallets::BalanceGetResponse::Balance::Asset]
-          #   @param chain [Symbol, Privy::Models::Wallets::BalanceGetResponse::Balance::Chain]
+          #
+          #   @param chain [Symbol, Privy::Models::WalletAssetChainNameInput] Supported blockchain network names for wallet balance and transaction queries.
+          #
           #   @param display_values [Hash{Symbol=>String}]
+          #
           #   @param raw_value [String]
+          #
           #   @param raw_value_decimals [Float]
 
           # @see Privy::Models::Wallets::BalanceGetResponse::Balance#asset
@@ -57,6 +62,8 @@ module Privy
 
             variant const: -> { Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::ETH }
 
+            variant const: -> { Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::AVAX }
+
             variant const: -> { Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::POL }
 
             variant const: -> { Privy::Models::Wallets::BalanceGetResponse::Balance::Asset::USDT }
@@ -81,6 +88,7 @@ module Privy
             USDC = :usdc
             USDC_E = :"usdc.e"
             ETH = :eth
+            AVAX = :avax
             POL = :pol
             USDT = :usdt
             EURC = :eurc
@@ -89,32 +97,6 @@ module Privy
 
             # @!endgroup
           end
-
-          # @see Privy::Models::Wallets::BalanceGetResponse::Balance#chain
-          module Chain
-            extend Privy::Internal::Type::Enum
-
-            ETHEREUM = :ethereum
-            ARBITRUM = :arbitrum
-            BASE = :base
-            TEMPO = :tempo
-            LINEA = :linea
-            OPTIMISM = :optimism
-            POLYGON = :polygon
-            SOLANA = :solana
-            ZKSYNC_ERA = :zksync_era
-            SEPOLIA = :sepolia
-            ARBITRUM_SEPOLIA = :arbitrum_sepolia
-            BASE_SEPOLIA = :base_sepolia
-            LINEA_TESTNET = :linea_testnet
-            OPTIMISM_SEPOLIA = :optimism_sepolia
-            POLYGON_AMOY = :polygon_amoy
-            SOLANA_DEVNET = :solana_devnet
-            SOLANA_TESTNET = :solana_testnet
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
         end
       end
     end

data/lib/privy/models/wallets/custodian_transaction_wallet_action_step.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      class CustodianTransactionWalletActionStep < Privy::Internal::Type::BaseModel
+        # @!attribute custodian
+        #   Identifier of the custodian executing this transaction (e.g. "bridge").
+        #
+        #   @return [String]
+        required :custodian, String
+
+        # @!attribute status
+        #   Status of a custodian transaction step in a wallet action.
+        #
+        #   @return [Symbol, Privy::Models::Wallets::CustodianTransactionWalletActionStepStatus]
+        required :status, enum: -> { Privy::Wallets::CustodianTransactionWalletActionStepStatus }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, Privy::Models::Wallets::CustodianTransactionWalletActionStep::Type]
+        required :type, enum: -> { Privy::Wallets::CustodianTransactionWalletActionStep::Type }
+
+        # @!attribute failure_reason
+        #   A description of why a wallet action (or a step within a wallet action) failed.
+        #
+        #   @return [Privy::Models::Wallets::FailureReason, nil]
+        optional :failure_reason, -> { Privy::Wallets::FailureReason }
+
+        # @!method initialize(custodian:, status:, type:, failure_reason: nil)
+        #   A wallet action step representing a transaction executed by a custodian (e.g.
+        #   Bridge).
+        #
+        #   @param custodian [String] Identifier of the custodian executing this transaction (e.g. "bridge").
+        #
+        #   @param status [Symbol, Privy::Models::Wallets::CustodianTransactionWalletActionStepStatus] Status of a custodian transaction step in a wallet action.
+        #
+        #   @param type [Symbol, Privy::Models::Wallets::CustodianTransactionWalletActionStep::Type]
+        #
+        #   @param failure_reason [Privy::Models::Wallets::FailureReason] A description of why a wallet action (or a step within a wallet action) failed.
+
+        # @see Privy::Models::Wallets::CustodianTransactionWalletActionStep#type
+        module Type
+          extend Privy::Internal::Type::Enum
+
+          CUSTODIAN_TRANSACTION = :custodian_transaction
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/privy/models/wallets/custodian_transaction_wallet_action_step_status.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      # Status of a custodian transaction step in a wallet action.
+      module CustodianTransactionWalletActionStepStatus
+        extend Privy::Internal::Type::Enum
+
+        PREPARING = :preparing
+        QUEUED = :queued
+        CUSTODIAN_REVIEWING = :custodian_reviewing
+        PENDING = :pending
+        CONFIRMED = :confirmed
+        REJECTED = :rejected
+        FAILED = :failed
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/wallets/earn/ethereum/incentive_claim_params.rb

@@ -6,7 +6,7 @@ module Privy
       module Earn
         module Ethereum
           # @see Privy::Resources::Wallets::Earn::Ethereum::Incentive#_claim
-          class IncentiveClaimParams < Privy::Models::EarnIncentiveClaimRequestBody
+          class IncentiveClaimParams < Privy::Models::Wallets::EarnIncentiveClaimRequestBody
             extend Privy::Internal::Type::RequestParameters::Converter
             include Privy::Internal::Type::RequestParameters
 

data/lib/privy/models/wallets/earn/ethereum_deposit_params.rb

@@ -5,7 +5,7 @@ module Privy
     module Wallets
       module Earn
         # @see Privy::Resources::Wallets::Earn::Ethereum#_deposit
-        class EthereumDepositParams < Privy::Models::EarnDepositRequestBody
+        class EthereumDepositParams < Privy::Models::Wallets::EarnDepositRequestBody
           extend Privy::Internal::Type::RequestParameters::Converter
           include Privy::Internal::Type::RequestParameters
 

data/lib/privy/models/wallets/earn/ethereum_withdraw_params.rb

@@ -5,7 +5,7 @@ module Privy
     module Wallets
       module Earn
         # @see Privy::Resources::Wallets::Earn::Ethereum#_withdraw
-        class EthereumWithdrawParams < Privy::Models::EarnWithdrawRequestBody
+        class EthereumWithdrawParams < Privy::Models::Wallets::EarnWithdrawRequestBody
           extend Privy::Internal::Type::RequestParameters::Converter
           include Privy::Internal::Type::RequestParameters
 

data/lib/privy/models/wallets/earn_asset.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      class EarnAsset < Privy::Internal::Type::BaseModel
+        # @!attribute address
+        #   Token contract address.
+        #
+        #   @return [String]
+        required :address, String
+
+        # @!attribute decimals
+        #   Number of decimals for the asset (e.g. 6 for USDC).
+        #
+        #   @return [Integer]
+        required :decimals, Integer
+
+        # @!attribute symbol
+        #   Lowercase token symbol (e.g. "usdc").
+        #
+        #   @return [String]
+        required :symbol, String
+
+        # @!method initialize(address:, decimals:, symbol:)
+        #   Asset metadata for an earn vault position.
+        #
+        #   @param address [String] Token contract address.
+        #
+        #   @param decimals [Integer] Number of decimals for the asset (e.g. 6 for USDC).
+        #
+        #   @param symbol [String] Lowercase token symbol (e.g. "usdc").
+      end
+    end
+  end
+end

data/lib/privy/models/wallets/earn_deposit_action_response.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      class EarnDepositActionResponse < Privy::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the wallet action.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute asset_address
+        #   Underlying asset token address.
+        #
+        #   @return [String]
+        required :asset_address, String
+
+        # @!attribute caip2
+        #   CAIP-2 chain identifier.
+        #
+        #   @return [String]
+        required :caip2, String
+
+        # @!attribute created_at
+        #   ISO 8601 timestamp of when the wallet action was created.
+        #
+        #   @return [Time]
+        required :created_at, Time
+
+        # @!attribute raw_amount
+        #   Base-unit amount of asset deposited (e.g. "1500000").
+        #
+        #   @return [String]
+        required :raw_amount, String
+
+        # @!attribute share_amount
+        #   Vault shares received in base units. Populated after on-chain confirmation.
+        #
+        #   @return [String, nil]
+        required :share_amount, String, nil?: true
+
+        # @!attribute status
+        #   Status of a wallet action.
+        #
+        #   @return [Symbol, Privy::Models::Wallets::WalletActionStatus]
+        required :status, enum: -> { Privy::Wallets::WalletActionStatus }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, Privy::Models::Wallets::EarnDepositActionResponse::Type]
+        required :type, enum: -> { Privy::Wallets::EarnDepositActionResponse::Type }
+
+        # @!attribute vault_address
+        #   ERC-4626 vault contract address.
+        #
+        #   @return [String]
+        required :vault_address, String
+
+        # @!attribute vault_id
+        #   The vault ID.
+        #
+        #   @return [String]
+        required :vault_id, String
+
+        # @!attribute wallet_id
+        #   The ID of the wallet involved in the action.
+        #
+        #   @return [String]
+        required :wallet_id, String
+
+        # @!attribute amount
+        #   Human-readable decimal amount of asset deposited (e.g. "1.5"). Only present when
+        #   the token is known in the asset registry.
+        #
+        #   @return [String, nil]
+        optional :amount, String
+
+        # @!attribute asset
+        #   Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in
+        #   the asset registry.
+        #
+        #   @return [String, nil]
+        optional :asset, String
+
+        # @!attribute decimals
+        #   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.
+        #
+        #   @return [Integer, nil]
+        optional :decimals, Integer
+
+        # @!attribute failure_reason
+        #   A description of why a wallet action (or a step within a wallet action) failed.
+        #
+        #   @return [Privy::Models::Wallets::FailureReason, nil]
+        optional :failure_reason, -> { Privy::Wallets::FailureReason }
+
+        # @!attribute steps
+        #   The steps of the wallet action. Only returned if `?include=steps` is provided.
+        #
+        #   @return [Array<Privy::Models::Wallets::EvmTransactionWalletActionStep, Privy::Models::Wallets::EvmUserOperationWalletActionStep, Privy::Models::Wallets::SvmTransactionWalletActionStep, Privy::Models::Wallets::TvmTransactionWalletActionStep, Privy::Models::Wallets::ExternalTransactionWalletActionStep, Privy::Models::Wallets::CustodianTransactionWalletActionStep>, nil]
+        optional :steps, -> { Privy::Internal::Type::ArrayOf[union: Privy::Wallets::WalletActionStep] }
+
+        # @!method initialize(id:, asset_address:, caip2:, created_at:, raw_amount:, share_amount:, status:, type:, vault_address:, vault_id:, wallet_id:, amount: nil, asset: nil, decimals: nil, failure_reason: nil, steps: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Privy::Models::Wallets::EarnDepositActionResponse} for more details.
+        #
+        #   Response for an earn deposit action.
+        #
+        #   @param id [String] The ID of the wallet action.
+        #
+        #   @param asset_address [String] Underlying asset token address.
+        #
+        #   @param caip2 [String] CAIP-2 chain identifier.
+        #
+        #   @param created_at [Time] ISO 8601 timestamp of when the wallet action was created.
+        #
+        #   @param raw_amount [String] Base-unit amount of asset deposited (e.g. "1500000").
+        #
+        #   @param share_amount [String, nil] Vault shares received in base units. Populated after on-chain confirmation.
+        #
+        #   @param status [Symbol, Privy::Models::Wallets::WalletActionStatus] Status of a wallet action.
+        #
+        #   @param type [Symbol, Privy::Models::Wallets::EarnDepositActionResponse::Type]
+        #
+        #   @param vault_address [String] ERC-4626 vault contract address.
+        #
+        #   @param vault_id [String] The vault ID.
+        #
+        #   @param wallet_id [String] The ID of the wallet involved in the action.
+        #
+        #   @param amount [String] Human-readable decimal amount of asset deposited (e.g. "1.5"). Only present when
+        #
+        #   @param asset [String] Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in t
+        #
+        #   @param decimals [Integer] Number of decimals for the underlying asset (e.g. 6 for USDC, 18 for ETH). Only
+        #
+        #   @param failure_reason [Privy::Models::Wallets::FailureReason] A description of why a wallet action (or a step within a wallet action) failed.
+        #
+        #   @param steps [Array<Privy::Models::Wallets::EvmTransactionWalletActionStep, Privy::Models::Wallets::EvmUserOperationWalletActionStep, Privy::Models::Wallets::SvmTransactionWalletActionStep, Privy::Models::Wallets::TvmTransactionWalletActionStep, Privy::Models::Wallets::ExternalTransactionWalletActionStep, Privy::Models::Wallets::CustodianTransactionWalletActionStep>] The steps of the wallet action. Only returned if `?include=steps` is provided.
+
+        # @see Privy::Models::Wallets::EarnDepositActionResponse#type
+        module Type
+          extend Privy::Internal::Type::Enum
+
+          EARN_DEPOSIT = :earn_deposit
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/privy/models/wallets/earn_deposit_request_body.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      class EarnDepositRequestBody < Privy::Internal::Type::BaseModel
+        # @!attribute vault_id
+        #   The ID of the vault to deposit into.
+        #
+        #   @return [String]
+        required :vault_id, String
+
+        # @!attribute amount
+        #   Human-readable decimal amount to deposit (e.g. "1.5" for 1.5 USDC). Exactly one
+        #   of `amount` or `raw_amount` must be provided.
+        #
+        #   @return [String, nil]
+        optional :amount, String
+
+        # @!attribute raw_amount
+        #   Amount in smallest unit to deposit (e.g. "1500000" for 1.5 USDC with 6
+        #   decimals). Exactly one of `amount` or `raw_amount` must be provided.
+        #
+        #   @return [String, nil]
+        optional :raw_amount, String
+
+        # @!method initialize(vault_id:, amount: nil, raw_amount: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Privy::Models::Wallets::EarnDepositRequestBody} for more details.
+        #
+        #   Input for depositing assets into an ERC-4626 vault. Exactly one of `amount` or
+        #   `raw_amount` must be provided.
+        #
+        #   @param vault_id [String] The ID of the vault to deposit into.
+        #
+        #   @param amount [String] Human-readable decimal amount to deposit (e.g. "1.5" for 1.5 USDC). Exactly one
+        #
+        #   @param raw_amount [String] Amount in smallest unit to deposit (e.g. "1500000" for 1.5 USDC with 6 decimals)
+      end
+    end
+  end
+end

data/lib/privy/models/wallets/earn_incentive_claim_action_response.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      class EarnIncentiveClaimActionResponse < Privy::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the wallet action.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute chain
+        #   EVM chain name (e.g. "base", "ethereum").
+        #
+        #   @return [String]
+        required :chain, String
+
+        # @!attribute created_at
+        #   ISO 8601 timestamp of when the wallet action was created.
+        #
+        #   @return [Time]
+        required :created_at, Time
+
+        # @!attribute rewards
+        #   Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+        #
+        #   @return [Array<Privy::Models::Wallets::EarnIncetiveClaimRewardEntry>, nil]
+        required :rewards,
+                 -> { Privy::Internal::Type::ArrayOf[Privy::Wallets::EarnIncetiveClaimRewardEntry] },
+                 nil?: true
+
+        # @!attribute status
+        #   Status of a wallet action.
+        #
+        #   @return [Symbol, Privy::Models::Wallets::WalletActionStatus]
+        required :status, enum: -> { Privy::Wallets::WalletActionStatus }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, Privy::Models::Wallets::EarnIncentiveClaimActionResponse::Type]
+        required :type, enum: -> { Privy::Wallets::EarnIncentiveClaimActionResponse::Type }
+
+        # @!attribute wallet_id
+        #   The ID of the wallet involved in the action.
+        #
+        #   @return [String]
+        required :wallet_id, String
+
+        # @!attribute failure_reason
+        #   A description of why a wallet action (or a step within a wallet action) failed.
+        #
+        #   @return [Privy::Models::Wallets::FailureReason, nil]
+        optional :failure_reason, -> { Privy::Wallets::FailureReason }
+
+        # @!attribute steps
+        #   The steps of the wallet action. Only returned if `?include=steps` is provided.
+        #
+        #   @return [Array<Privy::Models::Wallets::EvmTransactionWalletActionStep, Privy::Models::Wallets::EvmUserOperationWalletActionStep, Privy::Models::Wallets::SvmTransactionWalletActionStep, Privy::Models::Wallets::TvmTransactionWalletActionStep, Privy::Models::Wallets::ExternalTransactionWalletActionStep, Privy::Models::Wallets::CustodianTransactionWalletActionStep>, nil]
+        optional :steps, -> { Privy::Internal::Type::ArrayOf[union: Privy::Wallets::WalletActionStep] }
+
+        # @!method initialize(id:, chain:, created_at:, rewards:, status:, type:, wallet_id:, failure_reason: nil, steps: nil)
+        #   Response for an earn incentive claim action.
+        #
+        #   @param id [String] The ID of the wallet action.
+        #
+        #   @param chain [String] EVM chain name (e.g. "base", "ethereum").
+        #
+        #   @param created_at [Time] ISO 8601 timestamp of when the wallet action was created.
+        #
+        #   @param rewards [Array<Privy::Models::Wallets::EarnIncetiveClaimRewardEntry>, nil] Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+        #
+        #   @param status [Symbol, Privy::Models::Wallets::WalletActionStatus] Status of a wallet action.
+        #
+        #   @param type [Symbol, Privy::Models::Wallets::EarnIncentiveClaimActionResponse::Type]
+        #
+        #   @param wallet_id [String] The ID of the wallet involved in the action.
+        #
+        #   @param failure_reason [Privy::Models::Wallets::FailureReason] A description of why a wallet action (or a step within a wallet action) failed.
+        #
+        #   @param steps [Array<Privy::Models::Wallets::EvmTransactionWalletActionStep, Privy::Models::Wallets::EvmUserOperationWalletActionStep, Privy::Models::Wallets::SvmTransactionWalletActionStep, Privy::Models::Wallets::TvmTransactionWalletActionStep, Privy::Models::Wallets::ExternalTransactionWalletActionStep, Privy::Models::Wallets::CustodianTransactionWalletActionStep>] The steps of the wallet action. Only returned if `?include=steps` is provided.
+
+        # @see Privy::Models::Wallets::EarnIncentiveClaimActionResponse#type
+        module Type
+          extend Privy::Internal::Type::Enum
+
+          EARN_INCENTIVE_CLAIM = :earn_incentive_claim
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/privy/models/wallets/earn_incentive_claim_request_body.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      class EarnIncentiveClaimRequestBody < Privy::Internal::Type::BaseModel
+        # @!attribute chain
+        #   The blockchain network on which to perform the incentive claim. Supported chains
+        #   include: 'ethereum', 'base', 'arbitrum', 'polygon', 'solana', and more, along
+        #   with their respective testnets.
+        #
+        #   @return [String]
+        required :chain, String
+
+        # @!method initialize(chain:)
+        #   Some parameter documentations has been truncated, see
+        #   {Privy::Models::Wallets::EarnIncentiveClaimRequestBody} for more details.
+        #
+        #   Input for claiming incentive rewards.
+        #
+        #   @param chain [String] The blockchain network on which to perform the incentive claim. Supported chains
+      end
+    end
+  end
+end

data/lib/privy/models/wallets/earn_incentive_reward_entry.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      class EarnIncentiveRewardEntry < Privy::Internal::Type::BaseModel
+        # @!attribute amount_claimed
+        #   Total amount already claimed, in smallest unit.
+        #
+        #   @return [String]
+        required :amount_claimed, String
+
+        # @!attribute amount_unclaimed
+        #   Amount available to claim on-chain but not yet claimed, in smallest unit.
+        #
+        #   @return [String]
+        required :amount_unclaimed, String
+
+        # @!attribute token_address
+        #   Address of the reward token.
+        #
+        #   @return [String]
+        required :token_address, String
+
+        # @!attribute token_symbol
+        #   Symbol of the reward token (e.g. "MORPHO").
+        #
+        #   @return [String]
+        required :token_symbol, String
+
+        # @!attribute token_decimals
+        #   Number of decimals for the reward token.
+        #
+        #   @return [Integer, nil]
+        optional :token_decimals, Integer
+
+        # @!method initialize(amount_claimed:, amount_unclaimed:, token_address:, token_symbol:, token_decimals: nil)
+        #   A reward token with claimed and unclaimed amounts.
+        #
+        #   @param amount_claimed [String] Total amount already claimed, in smallest unit.
+        #
+        #   @param amount_unclaimed [String] Amount available to claim on-chain but not yet claimed, in smallest unit.
+        #
+        #   @param token_address [String] Address of the reward token.
+        #
+        #   @param token_symbol [String] Symbol of the reward token (e.g. "MORPHO").
+        #
+        #   @param token_decimals [Integer] Number of decimals for the reward token.
+      end
+    end
+  end
+end

data/lib/privy/models/wallets/earn_incentive_rewards_query.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      class EarnIncentiveRewardsQuery < Privy::Internal::Type::BaseModel
+        # @!attribute chain
+        #   Chain name to fetch rewards for (e.g. "base", "ethereum").
+        #
+        #   @return [String]
+        required :chain, String
+
+        # @!method initialize(chain:)
+        #   Query parameters for fetching incentive rewards.
+        #
+        #   @param chain [String] Chain name to fetch rewards for (e.g. "base", "ethereum").
+      end
+    end
+  end
+end

data/lib/privy/models/wallets/earn_incentive_rewards_response.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      class EarnIncentiveRewardsResponse < Privy::Internal::Type::BaseModel
+        # @!attribute rewards
+        #   Reward tokens with their claimed and unclaimed amounts.
+        #
+        #   @return [Array<Privy::Models::Wallets::EarnIncentiveRewardEntry>]
+        required :rewards, -> { Privy::Internal::Type::ArrayOf[Privy::Wallets::EarnIncentiveRewardEntry] }
+
+        # @!method initialize(rewards:)
+        #   All incentive rewards for a wallet, with claimed and unclaimed amounts per
+        #   token.
+        #
+        #   @param rewards [Array<Privy::Models::Wallets::EarnIncentiveRewardEntry>] Reward tokens with their claimed and unclaimed amounts.
+      end
+    end
+  end
+end