privy_ruby 0.0.2 → 0.1.0

data/lib/privy/models/stripe_payment_token.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class StripePaymentToken < Privy::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute type
+      #
+      #   @return [String]
+      required :type, String
+
+      # @!method initialize(id:, type:)
+      #   A saved payment token.
+      #
+      #   @param id [String]
+      #   @param type [String]
+    end
+  end
+end

data/lib/privy/models/stripe_quote.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class StripeQuote < Privy::Internal::Type::BaseModel
+      # @!attribute expires_at
+      #
+      #   @return [Float]
+      required :expires_at, Float
+
+      # @!method initialize(expires_at:)
+      #   A refreshed quote.
+      #
+      #   @param expires_at [Float]
+    end
+  end
+end

data/lib/privy/models/stripe_transaction_details.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class StripeTransactionDetails < Privy::Internal::Type::BaseModel
+      # @!attribute last_error
+      #
+      #   @return [String, nil]
+      optional :last_error, String, nil?: true
+
+      # @!method initialize(last_error: nil)
+      #   Transaction details from checkout.
+      #
+      #   @param last_error [String, nil]
+    end
+  end
+end

data/lib/privy/models/stripe_verification.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class StripeVerification < Privy::Internal::Type::BaseModel
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute status
+      #
+      #   @return [String]
+      required :status, String
+
+      # @!method initialize(name:, status:)
+      #   A verification entry on a CryptoCustomer.
+      #
+      #   @param name [String]
+      #   @param status [String]
+    end
+  end
+end

data/lib/privy/models/swap_action_response.rb

@@ -62,6 +62,12 @@ module Privy
       #   @return [String]
       required :wallet_id, String
 
+      # @!attribute destination_caip2
+      #   Destination chain CAIP-2 identifier. Present for cross-chain swaps.
+      #
+      #   @return [String, nil]
+      optional :destination_caip2, String
+
       # @!attribute failure_reason
       #   A description of why a wallet action (or a step within a wallet action) failed.
       #
@@ -74,7 +80,7 @@ module Privy
       #   @return [Array<Privy::Models::EvmTransactionWalletActionStep, Privy::Models::EvmUserOperationWalletActionStep, Privy::Models::SvmTransactionWalletActionStep, Privy::Models::ExternalTransactionWalletActionStep>, nil]
       optional :steps, -> { Privy::Internal::Type::ArrayOf[union: Privy::WalletActionStep] }
 
-      # @!method initialize(id:, caip2:, created_at:, input_amount:, input_token:, output_amount:, output_token:, status:, type:, wallet_id:, failure_reason: nil, steps: nil)
+      # @!method initialize(id:, caip2:, created_at:, input_amount:, input_token:, output_amount:, output_token:, status:, type:, wallet_id:, destination_caip2: nil, failure_reason: nil, steps: nil)
       #   Response for a swap action.
       #
       #   @param id [String] The ID of the wallet action.
@@ -97,6 +103,8 @@ module Privy
       #
       #   @param wallet_id [String] The ID of the wallet involved in the action.
       #
+      #   @param destination_caip2 [String] Destination chain CAIP-2 identifier. Present for cross-chain swaps.
+      #
       #   @param failure_reason [Privy::Models::FailureReason] A description of why a wallet action (or a step within a wallet action) failed.
       #
       #   @param steps [Array<Privy::Models::EvmTransactionWalletActionStep, Privy::Models::EvmUserOperationWalletActionStep, Privy::Models::SvmTransactionWalletActionStep, Privy::Models::ExternalTransactionWalletActionStep>] The steps of the wallet action. Only returned if `?include=steps` is provided.

data/lib/privy/models/swap_destination.rb

@@ -10,13 +10,20 @@ module Privy
       required :asset_address, String
 
       # @!attribute caip2
-      #   CAIP-2 chain identifier for the destination. Must match source chain —
-      #   cross-chain swaps are not yet supported. Defaults to source chain if omitted.
+      #   CAIP-2 chain identifier for the destination. Defaults to source chain if
+      #   omitted. Specify a different chain for cross-chain swaps.
       #
       #   @return [String, nil]
       optional :caip2, String
 
-      # @!method initialize(asset_address:, caip2: nil)
+      # @!attribute destination_address
+      #   Address to receive the output tokens. Defaults to the swapping wallet address.
+      #   Required when swapping between different chain types (e.g. EVM to Solana).
+      #
+      #   @return [String, nil]
+      optional :destination_address, String
+
+      # @!method initialize(asset_address:, caip2: nil, destination_address: nil)
       #   Some parameter documentations has been truncated, see
       #   {Privy::Models::SwapDestination} for more details.
       #
@@ -24,7 +31,9 @@ module Privy
       #
       #   @param asset_address [String] Token contract address to buy, or "native" for the chain's native token.
       #
-      #   @param caip2 [String] CAIP-2 chain identifier for the destination. Must match source chain — cross-cha
+      #   @param caip2 [String] CAIP-2 chain identifier for the destination. Defaults to source chain if omitted
+      #
+      #   @param destination_address [String] Address to receive the output tokens. Defaults to the swapping wallet address. R
     end
   end
 end

data/lib/privy/models/swap_quote_destination.rb

@@ -10,13 +10,22 @@ module Privy
       required :asset_address, String
 
       # @!attribute caip2
-      #   CAIP-2 chain identifier for the destination. Must match source chain —
-      #   cross-chain swaps are not yet supported. Defaults to source chain if omitted.
+      #   CAIP-2 chain identifier for the destination. Defaults to source chain if
+      #   omitted. Will result in a cross-chain swap if source and destination chains
+      #   differ.
       #
       #   @return [String, nil]
       optional :caip2, String
 
-      # @!method initialize(asset_address:, caip2: nil)
+      # @!attribute destination_address
+      #   Address to receive the output tokens. Defaults to the swapping wallet address.
+      #   Required when swapping between chains with different address types (e.g. EVM to
+      #   Solana).
+      #
+      #   @return [String, nil]
+      optional :destination_address, String
+
+      # @!method initialize(asset_address:, caip2: nil, destination_address: nil)
       #   Some parameter documentations has been truncated, see
       #   {Privy::Models::SwapQuoteDestination} for more details.
       #
@@ -24,7 +33,9 @@ module Privy
       #
       #   @param asset_address [String] Token contract address to buy, or "native" for the chain's native token.
       #
-      #   @param caip2 [String] CAIP-2 chain identifier for the destination. Must match source chain — cross-cha
+      #   @param caip2 [String] CAIP-2 chain identifier for the destination. Defaults to source chain if omitted
+      #
+      #   @param destination_address [String] Address to receive the output tokens. Defaults to the swapping wallet address. R
     end
   end
 end

data/lib/privy/models/swap_quote_request_body.rb

@@ -27,6 +27,12 @@ module Privy
       #   @return [Symbol, Privy::Models::AmountType, nil]
       optional :amount_type, enum: -> { Privy::AmountType }
 
+      # @!attribute fee_configuration
+      #   Total fees assessed on a transfer, in BPS
+      #
+      #   @return [Privy::Models::FeeConfiguration, nil]
+      optional :fee_configuration, -> { Privy::FeeConfiguration }
+
       # @!attribute slippage_bps
       #   Maximum slippage tolerance in basis points (e.g., 50 for 0.5%). If omitted,
       #   auto-slippage is used.
@@ -34,7 +40,7 @@ module Privy
       #   @return [Float, nil]
       optional :slippage_bps, Float
 
-      # @!method initialize(base_amount:, destination:, source:, amount_type: nil, slippage_bps: nil)
+      # @!method initialize(base_amount:, destination:, source:, amount_type: nil, fee_configuration: nil, slippage_bps: nil)
       #   Some parameter documentations has been truncated, see
       #   {Privy::Models::SwapQuoteRequestBody} for more details.
       #
@@ -48,6 +54,8 @@ module Privy
       #
       #   @param amount_type [Symbol, Privy::Models::AmountType] Whether the amount refers to the input token or output token.
       #
+      #   @param fee_configuration [Privy::Models::FeeConfiguration] Total fees assessed on a transfer, in BPS
+      #
       #   @param slippage_bps [Float] Maximum slippage tolerance in basis points (e.g., 50 for 0.5%). If omitted, auto
     end
   end

data/lib/privy/models/swap_quote_response.rb

@@ -45,7 +45,25 @@ module Privy
       #   @return [String]
       required :output_token, String
 
-      # @!method initialize(caip2:, est_output_amount:, gas_estimate:, input_amount:, input_token:, minimum_output_amount:, output_token:)
+      # @!attribute destination_caip2
+      #   Destination chain CAIP-2 identifier for cross-chain swaps.
+      #
+      #   @return [String, nil]
+      optional :destination_caip2, String
+
+      # @!attribute estimated_fees
+      #   Estimated fees in USD.
+      #
+      #   @return [Array<Privy::Models::RelayerFee, Privy::Models::PrivyFee, Privy::Models::DeveloperFee>, nil]
+      optional :estimated_fees, -> { Privy::Internal::Type::ArrayOf[union: Privy::FeeLineItem] }
+
+      # @!attribute expires_at
+      #   Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
+      #
+      #   @return [Float, nil]
+      optional :expires_at, Float
+
+      # @!method initialize(caip2:, est_output_amount:, gas_estimate:, input_amount:, input_token:, minimum_output_amount:, output_token:, destination_caip2: nil, estimated_fees: nil, expires_at: nil)
       #   Pricing data for a token swap.
       #
       #   @param caip2 [String] Chain identifier.
@@ -61,6 +79,12 @@ module Privy
       #   @param minimum_output_amount [String] Minimum output amount accounting for slippage, in base units.
       #
       #   @param output_token [String] Token address being bought.
+      #
+      #   @param destination_caip2 [String] Destination chain CAIP-2 identifier for cross-chain swaps.
+      #
+      #   @param estimated_fees [Array<Privy::Models::RelayerFee, Privy::Models::PrivyFee, Privy::Models::DeveloperFee>] Estimated fees in USD.
+      #
+      #   @param expires_at [Float] Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
     end
   end
 end

data/lib/privy/models/swap_request_body.rb

@@ -27,13 +27,19 @@ module Privy
       #   @return [Symbol, Privy::Models::AmountType, nil]
       optional :amount_type, enum: -> { Privy::AmountType }
 
+      # @!attribute fee_configuration
+      #   Total fees assessed on a transfer, in BPS
+      #
+      #   @return [Privy::Models::FeeConfiguration, nil]
+      optional :fee_configuration, -> { Privy::FeeConfiguration }
+
       # @!attribute slippage_bps
       #   Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
       #
       #   @return [Float, nil]
       optional :slippage_bps, Float
 
-      # @!method initialize(base_amount:, destination:, source:, amount_type: nil, slippage_bps: nil)
+      # @!method initialize(base_amount:, destination:, source:, amount_type: nil, fee_configuration: nil, slippage_bps: nil)
       #   Some parameter documentations has been truncated, see
       #   {Privy::Models::SwapRequestBody} for more details.
       #
@@ -47,6 +53,8 @@ module Privy
       #
       #   @param amount_type [Symbol, Privy::Models::AmountType] Whether the amount refers to the input token or output token.
       #
+      #   @param fee_configuration [Privy::Models::FeeConfiguration] Total fees assessed on a transfer, in BPS
+      #
       #   @param slippage_bps [Float] Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
     end
   end

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

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      # @see Privy::Resources::Wallets::Swap#execute
+      class SwapExecuteParams < Privy::Models::SwapRequestBody
+        extend Privy::Internal::Type::RequestParameters::Converter
+        include Privy::Internal::Type::RequestParameters
+
+        # @!attribute wallet_id
+        #   ID of the wallet.
+        #
+        #   @return [String]
+        required :wallet_id, String
+
+        # @!attribute privy_authorization_signature
+        #   Request authorization signature. If multiple signatures are required, they
+        #   should be comma separated.
+        #
+        #   @return [String, nil]
+        optional :privy_authorization_signature, String
+
+        # @!attribute privy_idempotency_key
+        #   Idempotency keys ensure API requests are executed only once within a 24-hour
+        #   window.
+        #
+        #   @return [String, nil]
+        optional :privy_idempotency_key, String
+
+        # @!method initialize(wallet_id:, privy_authorization_signature: nil, privy_idempotency_key: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Privy::Models::Wallets::SwapExecuteParams} for more details.
+        #
+        #   @param wallet_id [String] ID of the wallet.
+        #
+        #   @param privy_authorization_signature [String] Request authorization signature. If multiple signatures are required, they shoul
+        #
+        #   @param privy_idempotency_key [String] Idempotency keys ensure API requests are executed only once within a 24-hour win
+        #
+        #   @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    module Wallets
+      # @see Privy::Resources::Wallets::Swap#quote
+      class SwapQuoteParams < Privy::Models::SwapQuoteRequestBody
+        extend Privy::Internal::Type::RequestParameters::Converter
+        include Privy::Internal::Type::RequestParameters
+
+        # @!attribute wallet_id
+        #   ID of the wallet.
+        #
+        #   @return [String]
+        required :wallet_id, String
+
+        # @!attribute privy_authorization_signature
+        #   Request authorization signature. If multiple signatures are required, they
+        #   should be comma separated.
+        #
+        #   @return [String, nil]
+        optional :privy_authorization_signature, String
+
+        # @!method initialize(wallet_id:, privy_authorization_signature: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Privy::Models::Wallets::SwapQuoteParams} for more details.
+        #
+        #   @param wallet_id [String] ID of the wallet.
+        #
+        #   @param privy_authorization_signature [String] Request authorization signature. If multiple signatures are required, they shoul
+        #
+        #   @param request_options [Privy::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/privy/models.rb

@@ -256,10 +256,18 @@ module Privy
 
   CreateAccountInput = Privy::Models::CreateAccountInput
 
+  CreateLinkAuthIntentInput = Privy::Models::CreateLinkAuthIntentInput
+
+  CreateLinkAuthIntentResponse = Privy::Models::CreateLinkAuthIntentResponse
+
   CreateOrganizationSecretResponse = Privy::Models::CreateOrganizationSecretResponse
 
   CreateOrUpdateFiatCustomerRequestInput = Privy::Models::CreateOrUpdateFiatCustomerRequestInput
 
+  CreateStripeOnrampSessionInput = Privy::Models::CreateStripeOnrampSessionInput
+
+  CreateStripeOnrampSessionResponse = Privy::Models::CreateStripeOnrampSessionResponse
+
   CrossAppConnection = Privy::Models::CrossAppConnection
 
   CrossAppConnectionsResponse = Privy::Models::CrossAppConnectionsResponse
@@ -303,6 +311,8 @@ module Privy
 
   DeveloperFee = Privy::Models::DeveloperFee
 
+  DeviceAuthorizationResponse = Privy::Models::DeviceAuthorizationResponse
+
   EarnAsset = Privy::Models::EarnAsset
 
   EarnDepositActionResponse = Privy::Models::EarnDepositActionResponse
@@ -313,6 +323,12 @@ module Privy
 
   EarnIncentiveClaimRequestBody = Privy::Models::EarnIncentiveClaimRequestBody
 
+  EarnIncentiveRewardEntry = Privy::Models::EarnIncentiveRewardEntry
+
+  EarnIncentiveRewardsQuery = Privy::Models::EarnIncentiveRewardsQuery
+
+  EarnIncentiveRewardsResponse = Privy::Models::EarnIncentiveRewardsResponse
+
   EarnIncetiveClaimRewardEntry = Privy::Models::EarnIncetiveClaimRewardEntry
 
   EarnWithdrawActionResponse = Privy::Models::EarnWithdrawActionResponse
@@ -474,6 +490,10 @@ module Privy
 
   EvmWalletActionStepStatus = Privy::Models::EvmWalletActionStepStatus
 
+  ExchangeStripeTokensInput = Privy::Models::ExchangeStripeTokensInput
+
+  ExchangeStripeTokensResponse = Privy::Models::ExchangeStripeTokensResponse
+
   ExportPrivateKeyRpcInput = Privy::Models::ExportPrivateKeyRpcInput
 
   ExportPrivateKeyRpcResponse = Privy::Models::ExportPrivateKeyRpcResponse
@@ -570,8 +590,12 @@ module Privy
 
   FiatOnrampSource = Privy::Models::FiatOnrampSource
 
+  FiatOnrampStripeSDKSessionResponse = Privy::Models::FiatOnrampStripeSDKSessionResponse
+
   FiatOnrampTransactionStatus = Privy::Models::FiatOnrampTransactionStatus
 
+  FiatOnrampURLSessionResponse = Privy::Models::FiatOnrampURLSessionResponse
+
   FiatVirtualAccountRequest = Privy::Models::FiatVirtualAccountRequest
 
   FiatVirtualAccountResponse = Privy::Models::FiatVirtualAccountResponse
@@ -594,10 +618,6 @@ module Privy
 
   GasSpendResponseBody = Privy::Models::GasSpendResponseBody
 
-  GasSponsorshipConfiguration = Privy::Models::GasSponsorshipConfiguration
-
-  GasSponsorshipConfigurationInput = Privy::Models::GasSponsorshipConfigurationInput
-
   GetByWalletAddressRequestBody = Privy::Models::GetByWalletAddressRequestBody
 
   GetFiatCustomerRequestInput = Privy::Models::GetFiatCustomerRequestInput
@@ -614,6 +634,8 @@ module Privy
 
   GetFiatOnrampURLResponse = Privy::Models::GetFiatOnrampURLResponse
 
+  GetStripeCryptoCustomerResponse = Privy::Models::GetStripeCryptoCustomerResponse
+
   GuestAuthenticateRequestBody = Privy::Models::GuestAuthenticateRequestBody
 
   HDInitInput = Privy::Models::HDInitInput
@@ -720,6 +742,15 @@ module Privy
 
   KrakenEmbedCustomOrderAmount = Privy::Models::KrakenEmbedCustomOrderAmount
 
+  KrakenEmbedCustomOrderCancelledWebhookPayload =
+    Privy::Models::KrakenEmbedCustomOrderCancelledWebhookPayload
+
+  KrakenEmbedCustomOrderExecutedWebhookPayload =
+    Privy::Models::KrakenEmbedCustomOrderExecutedWebhookPayload
+
+  KrakenEmbedCustomOrderExecutionFailedWebhookPayload =
+    Privy::Models::KrakenEmbedCustomOrderExecutionFailedWebhookPayload
+
   KrakenEmbedCustomOrderOccurrence = Privy::Models::KrakenEmbedCustomOrderOccurrence
 
   KrakenEmbedCustomOrderOccurrenceExecutedAction =
@@ -832,6 +863,10 @@ module Privy
 
   KrakenEmbedUserVerifiedWebhookPayload = Privy::Models::KrakenEmbedUserVerifiedWebhookPayload
 
+  LinkAuthIntentCreated = Privy::Models::LinkAuthIntentCreated
+
+  LinkAuthIntentNoAccount = Privy::Models::LinkAuthIntentNoAccount
+
   LinkedAccount = Privy::Models::LinkedAccount
 
   LinkedAccountAppleInput = Privy::Models::LinkedAccountAppleInput
@@ -940,6 +975,10 @@ module Privy
 
   LinkJwtInput = Privy::Models::LinkJwtInput
 
+  ListStripeConsumerWalletsResponse = Privy::Models::ListStripeConsumerWalletsResponse
+
+  ListStripePaymentTokensResponse = Privy::Models::ListStripePaymentTokensResponse
+
   MfaDisabledWebhookPayload = Privy::Models::MfaDisabledWebhookPayload
 
   MfaEnabledWebhookPayload = Privy::Models::MfaEnabledWebhookPayload
@@ -1034,6 +1073,8 @@ module Privy
 
   OnrampProvider = Privy::Models::OnrampProvider
 
+  OnrampSessionParams = Privy::Models::OnrampSessionParams
+
   OptionalRefreshTokenInput = Privy::Models::OptionalRefreshTokenInput
 
   OrganizationSecretIDInput = Privy::Models::OrganizationSecretIDInput
@@ -1207,6 +1248,8 @@ module Privy
 
   RecoveryType = Privy::Models::RecoveryType
 
+  RefreshStripeQuoteResponse = Privy::Models::RefreshStripeQuoteResponse
+
   RelayerFee = Privy::Models::RelayerFee
 
   ResponsePasskeyInitAuthenticate = Privy::Models::ResponsePasskeyInitAuthenticate
@@ -1219,6 +1262,8 @@ module Privy
 
   RpcIntentResponse = Privy::Models::RpcIntentResponse
 
+  RuleDeleteIntentResponse = Privy::Models::RuleDeleteIntentResponse
+
   RuleIntentCreateRequestDetails = Privy::Models::RuleIntentCreateRequestDetails
 
   RuleIntentDeleteRequestDetails = Privy::Models::RuleIntentDeleteRequestDetails
@@ -1229,6 +1274,8 @@ module Privy
 
   RuleIntentUpdateRequestDetails = Privy::Models::RuleIntentUpdateRequestDetails
 
+  RuleMutateIntentResponse = Privy::Models::RuleMutateIntentResponse
+
   SeedPhraseExportInput = Privy::Models::SeedPhraseExportInput
 
   SeedPhraseExportResponse = Privy::Models::SeedPhraseExportResponse
@@ -1423,6 +1470,26 @@ module Privy
 
   SparkWalletLeaf = Privy::Models::SparkWalletLeaf
 
+  StripeConsumerWallet = Privy::Models::StripeConsumerWallet
+
+  StripeCryptoCustomerActive = Privy::Models::StripeCryptoCustomerActive
+
+  StripeCryptoCustomerExpired = Privy::Models::StripeCryptoCustomerExpired
+
+  StripeCryptoCustomerNone = Privy::Models::StripeCryptoCustomerNone
+
+  StripeOnrampCheckoutResponse = Privy::Models::StripeOnrampCheckoutResponse
+
+  StripeOnrampSessionStatus = Privy::Models::StripeOnrampSessionStatus
+
+  StripePaymentToken = Privy::Models::StripePaymentToken
+
+  StripeQuote = Privy::Models::StripeQuote
+
+  StripeTransactionDetails = Privy::Models::StripeTransactionDetails
+
+  StripeVerification = Privy::Models::StripeVerification
+
   SuccessResponse = Privy::Models::SuccessResponse
 
   SuiCommandName = Privy::Models::SuiCommandName

data/lib/privy/public_api/privy_client.rb

@@ -12,7 +12,7 @@ module Privy
     attr_reader :api
 
     # Service accessors.
-    attr_reader :wallets, :users, :policies, :key_quorums, :jwt_exchange
+    attr_reader :wallets, :users, :policies, :key_quorums, :transactions, :jwt_exchange
 
     # @return [Privy::PrivyRequestExpiryOptions]
     attr_reader :request_expiry_options
@@ -48,6 +48,7 @@ module Privy
       @users = Privy::Services::Users.new(client: @api, privy_client: self)
       @policies = Privy::Services::Policies.new(client: @api, privy_client: self)
       @key_quorums = Privy::Services::KeyQuorums.new(client: @api, privy_client: self)
+      @transactions = Privy::Services::Transactions.new(client: @api, privy_client: self)
       @jwt_exchange = Privy::JwtExchangeService.new(
         wallets_resource: @api.wallets,
         cache_max_capacity: authorization_key_cache_max_capacity

data/lib/privy/public_api/services/earn/ethereum/incentive.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Privy
+  module Services
+    class Earn
+      class Ethereum
+        class Incentive < Privy::Resources::Wallets::Earn::Ethereum::Incentive
+          attr_reader :privy_client
+
+          def initialize(client:, privy_client:)
+            super(client: client)
+            @privy_client = privy_client
+          end
+
+          # Claim incentive rewards for a wallet.
+          #
+          # @example Claim rewards on Base
+          #   client.wallets.earn.ethereum.incentive.claim("wallet-id", earn_incentive_claim_params: {
+          #     chain: "base"
+          #   }, authorization_context: ctx)
+          #
+          # @param wallet_id [String] ID of the wallet to claim rewards for.
+          # @param earn_incentive_claim_params [Hash] Body parameters for the incentive claim operation.
+          # @option earn_incentive_claim_params [String] :chain Blockchain network on which to perform the incentive claim.
+          # @param authorization_context [Privy::Authorization::AuthorizationContext, nil] Authorization context for owned wallets.
+          # @param idempotency_key [String, nil] Ensures the request is executed only once.
+          # @param request_expiry [Integer, nil] Absolute Unix-ms timestamp at which the
+          #   request expires. Defaults to the value computed by the client's
+          #   PrivyRequestExpiryOptions.
+          # @param request_options [Privy::RequestOptions, Hash, nil] Transport-level config (timeouts, retries).
+          #
+          # @return [Privy::Models::EarnIncentiveClaimActionResponse]
+          def claim(
+            wallet_id,
+            earn_incentive_claim_params:,
+            authorization_context: nil,
+            idempotency_key: nil,
+            request_expiry: nil,
+            request_options: nil
+          )
+            prepared = Privy::Authorization.prepare_request(
+              privy_client,
+              method: :post,
+              url: Privy::Authorization.signed_url(
+                privy_client,
+                "v1/wallets/#{wallet_id}/earn/ethereum/incentive/claim"
+              ),
+              body: earn_incentive_claim_params,
+              authorization_context: authorization_context,
+              idempotency_key: idempotency_key,
+              request_expiry: privy_client.compute_request_expiry(request_expiry)
+            )
+            combined_params = earn_incentive_claim_params.merge(request_options: request_options)
+            Privy::Authorization.merge_prepared_headers!(combined_params, prepared.headers)
+            _claim(wallet_id, combined_params)
+          end
+        end
+      end
+    end
+  end
+end