privy_ruby 0.0.2 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51e25ac71d2aa91eb15e1f25786474dab96e24a923c19aba56ddc8e4eafd30aa
-  data.tar.gz: f6adf206cd6d68890b264536771bde67ab3b4e713a7427a69e0ace6c930ce2f9
+  metadata.gz: 24f26f4a50959cdf4a425471cc6eccb7bf9c9b12ee3beaeac5180c8cc3764cf1
+  data.tar.gz: 75f5e38ff6e8ff9a1be67f976e7a56165bc4d0f7ba8c7d7290d2a687b1a84342
 SHA512:
-  metadata.gz: 9363c7b9cc66d84ba4daa2060d2316eca42a728f2ebe05b0cae6fc2447d4b8c64e651bc754da42443d161d5007e9a4165445450e527b674d1fd28895351c87d4
-  data.tar.gz: db7de0267ee175d3f5adc0792cd71dbbce20057322b2a695f9f2391ac7fada81817df8ea9cf2b2d59b3e58af96f4a168dbe038edeefb67ba5271440b7df9a044
+  metadata.gz: a2e6be7e846dfb8d5698713754e0f745a37aa3a2bb7ba886bf797b8ba4820f6b937aa496eacdc10051279917e7c50899da410a688ba5ef57cc76abbead4edf6a
+  data.tar.gz: '0857860b67f021ba365409f8341fcb3e6f11672e13fc1e8449e5bab77710b934d9e0cecf6492e53f96d86f65b980a89e6ea9511131c11854187d68fa042556d6'

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.1.0 (2026-06-01)
+
+Full Changelog: [v0.0.2...v0.1.0](https://github.com/privy-io/ruby-sdk/compare/v0.0.2...v0.1.0)
+
+### Features
+
+* **api:** api update ([c3f99bb](https://github.com/privy-io/ruby-sdk/commit/c3f99bb1fb234e765d8916413ea41291159fbc2d))
+* **api:** api update ([5394738](https://github.com/privy-io/ruby-sdk/commit/539473886ed5be1af9f03caf7e132471563a6596))
+* **api:** api update ([c6f6a31](https://github.com/privy-io/ruby-sdk/commit/c6f6a31171dc2f12fb990fd11084eaff3a658a42))
+* **api:** api update ([124a1eb](https://github.com/privy-io/ruby-sdk/commit/124a1eb8d4b60bbf215ce6d7c44eba7df4066e25))
+* **api:** api update ([54ac7a9](https://github.com/privy-io/ruby-sdk/commit/54ac7a985a01f4205b670f0dc3b627ac6c0cd214))
+* **api:** api update ([47b8c13](https://github.com/privy-io/ruby-sdk/commit/47b8c13516892c9d1138fd7e890c00dbe78b0210))
+* transaction.get ([#55](https://github.com/privy-io/ruby-sdk/issues/55)) ([d0623c4](https://github.com/privy-io/ruby-sdk/commit/d0623c43e75f362e50c545580fba9b4182d9d553))
+* wallet actions earn ([#53](https://github.com/privy-io/ruby-sdk/issues/53)) ([96b1d76](https://github.com/privy-io/ruby-sdk/commit/96b1d76a440936e64d18785033aec72aa3a921e1))
+* wallet export and import ([#50](https://github.com/privy-io/ruby-sdk/issues/50)) ([2f9e563](https://github.com/privy-io/ruby-sdk/commit/2f9e56383d46ab9bfc0baed95036ff5bb1f81c18))
+
+
+### Chores
+
+* formatting ([#54](https://github.com/privy-io/ruby-sdk/issues/54)) ([58658ee](https://github.com/privy-io/ruby-sdk/commit/58658ee0a4a7c5bacf0a3ebef78f22fc8d2171be))
+
 ## 0.0.2 (2026-05-21)
 
 Full Changelog: [v0.0.1...v0.0.2](https://github.com/privy-io/ruby-sdk/compare/v0.0.1...v0.0.2)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "privy_ruby", "~> 0.0.2"
+gem "privy_ruby", "~> 0.1.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/privy/base58.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Privy
+  module Base58
+    ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
+    INDEX = ALPHABET.chars.each_with_index.to_h.freeze
+
+    module_function
+
+    def encode(bytes)
+      integer = bytes.unpack1("H*").to_i(16)
+      encoded = +""
+      while integer.positive?
+        integer, remainder = integer.divmod(58)
+        encoded.prepend(ALPHABET[remainder])
+      end
+
+      leading_zeroes = bytes.bytes.take_while(&:zero?).length
+      ("1" * leading_zeroes) + encoded
+    end
+
+    def decode(value)
+      integer = 0
+      value.each_char do |char|
+        digit = INDEX[char]
+        raise ArgumentError, "invalid base58 character: #{char.inspect}" if digit.nil?
+
+        integer = (integer * 58) + digit
+      end
+
+      bytes = []
+      while integer.positive?
+        bytes.unshift(integer & 0xff)
+        integer >>= 8
+      end
+
+      leading_zeroes = value.each_char.take_while { |char| char == "1" }.length
+      ("\x00".b * leading_zeroes) + bytes.pack("C*")
+    end
+  end
+end

data/lib/privy/client.rb

@@ -72,6 +72,9 @@ module Privy
     # @return [Privy::Resources::ClientAuth]
     attr_reader :client_auth
 
+    # @return [Privy::Resources::Onramps]
+    attr_reader :onramps
+
     # @return [Privy::Resources::Funding]
     attr_reader :funding
 
@@ -84,6 +87,9 @@ module Privy
     # @return [Privy::Resources::Shared]
     attr_reader :shared
 
+    # @return [Privy::Resources::OAuth]
+    attr_reader :oauth
+
     # @return [Privy::Resources::WalletActions]
     attr_reader :wallet_actions
 
@@ -190,10 +196,12 @@ module Privy
       @embedded_wallets = Privy::Resources::EmbeddedWallets.new(client: self)
       @analytics = Privy::Resources::Analytics.new(client: self)
       @client_auth = Privy::Resources::ClientAuth.new(client: self)
+      @onramps = Privy::Resources::Onramps.new(client: self)
       @funding = Privy::Resources::Funding.new(client: self)
       @organizations = Privy::Resources::Organizations.new(client: self)
       @cross_app = Privy::Resources::CrossApp.new(client: self)
       @shared = Privy::Resources::Shared.new(client: self)
+      @oauth = Privy::Resources::OAuth.new(client: self)
       @wallet_actions = Privy::Resources::WalletActions.new(client: self)
       @yield_ = Privy::Resources::Yield.new(client: self)
       @kraken_embed = Privy::Resources::KrakenEmbed.new(client: self)

data/lib/privy/cryptography.rb

@@ -48,5 +48,39 @@ module Privy
         OpenSSL::PKey.read(@public_key_spki)
       end
     end
+
+    HpkeEncryptedPayload = Data.define(:encapsulated_key, :ciphertext)
+
+    class HpkeSender
+      def initialize
+        @hpke = HPKE.new(HPKE::DHKEM_P256_HKDF_SHA256, HPKE::HKDF_SHA256, HPKE::CHACHA20_POLY1305)
+      end
+
+      # Encrypts a payload for a recipient using HPKE base mode.
+      #
+      # @param public_key_spki [String] Raw DER bytes of the recipient's SPKI-encoded public key,
+      #   or a raw uncompressed P-256 public key point.
+      # @param payload [String] Raw plaintext bytes
+      # @return [Privy::Cryptography::HpkeEncryptedPayload]
+      def encrypt(public_key_spki, payload)
+        recipient_public_key = OpenSSL::PKey.read(normalize_public_key_spki(public_key_spki))
+        encrypted = @hpke.setup_base_s(recipient_public_key, "")
+        ciphertext = encrypted.fetch(:context_s).seal("", payload)
+
+        HpkeEncryptedPayload.new(encapsulated_key: encrypted.fetch(:enc), ciphertext: ciphertext)
+      end
+
+      private
+
+      def normalize_public_key_spki(public_key)
+        return p256_uncompressed_point_to_spki(public_key) if public_key.bytesize == 65 && public_key.getbyte(0) == 0x04
+
+        public_key
+      end
+
+      def p256_uncompressed_point_to_spki(public_key)
+        ["3059301306072a8648ce3d020106082a8648ce3d030107034200"].pack("H*") + public_key
+      end
+    end
   end
 end

data/lib/privy/models/create_link_auth_intent_input.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class CreateLinkAuthIntentInput < Privy::Internal::Type::BaseModel
+      # @!attribute email
+      #
+      #   @return [String, nil]
+      optional :email, String
+
+      # @!method initialize(email: nil)
+      #   Input for creating a Link auth intent to initiate Stripe onramp authentication.
+      #
+      #   @param email [String]
+    end
+  end
+end

data/lib/privy/models/create_link_auth_intent_response.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class CreateLinkAuthIntentResponse < Privy::Internal::Type::BaseModel
+      # @!attribute data
+      #   Auth intent created. Pass id to authenticate().
+      #
+      #   @return [Privy::Models::LinkAuthIntentCreated, Privy::Models::LinkAuthIntentNoAccount]
+      required :data, union: -> { Privy::CreateLinkAuthIntentResponse::Data }
+
+      # @!method initialize(data:)
+      #   The created Link auth intent.
+      #
+      #   @param data [Privy::Models::LinkAuthIntentCreated, Privy::Models::LinkAuthIntentNoAccount] Auth intent created. Pass id to authenticate().
+
+      # Auth intent created. Pass id to authenticate().
+      #
+      # @see Privy::Models::CreateLinkAuthIntentResponse#data
+      module Data
+        extend Privy::Internal::Type::Union
+
+        discriminator :status
+
+        # Auth intent created. Pass id to authenticate().
+        variant :created, -> { Privy::LinkAuthIntentCreated }
+
+        # No Link account for this email. Call registerLinkUser() then retry.
+        variant :no_account, -> { Privy::LinkAuthIntentNoAccount }
+
+        # @!method self.variants
+        #   @return [Array(Privy::Models::LinkAuthIntentCreated, Privy::Models::LinkAuthIntentNoAccount)]
+      end
+    end
+  end
+end

data/lib/privy/models/create_stripe_onramp_session_input.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class CreateStripeOnrampSessionInput < Privy::Internal::Type::BaseModel
+      # @!attribute environment
+      #   Whether to use the sandbox or production environment for fiat onramp.
+      #
+      #   @return [Symbol, Privy::Models::FiatOnrampEnvironment]
+      required :environment, enum: -> { Privy::FiatOnrampEnvironment }
+
+      # @!attribute session
+      #   Parameters for creating a Stripe onramp session.
+      #
+      #   @return [Privy::Models::OnrampSessionParams]
+      required :session, -> { Privy::OnrampSessionParams }
+
+      # @!attribute session_id
+      #
+      #   @return [String]
+      required :session_id, String
+
+      # @!method initialize(environment:, session:, session_id:)
+      #   Input for creating a Stripe onramp session.
+      #
+      #   @param environment [Symbol, Privy::Models::FiatOnrampEnvironment] Whether to use the sandbox or production environment for fiat onramp.
+      #
+      #   @param session [Privy::Models::OnrampSessionParams] Parameters for creating a Stripe onramp session.
+      #
+      #   @param session_id [String]
+    end
+  end
+end

data/lib/privy/models/create_stripe_onramp_session_response.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class CreateStripeOnrampSessionResponse < Privy::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute session_id
+      #
+      #   @return [String]
+      required :session_id, String
+
+      # @!method initialize(id:, session_id:)
+      #   The created onramp session.
+      #
+      #   @param id [String]
+      #   @param session_id [String]
+    end
+  end
+end

data/lib/privy/models/device_authorization_response.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class DeviceAuthorizationResponse < Privy::Internal::Type::BaseModel
+      # @!attribute device_code
+      #   A long-lived code used by the device to poll for authorization status.
+      #
+      #   @return [String]
+      required :device_code, String
+
+      # @!attribute expires_in
+      #   The lifetime in seconds of the device_code and user_code.
+      #
+      #   @return [Integer]
+      required :expires_in, Integer
+
+      # @!attribute interval
+      #   The minimum number of seconds the device should wait between polling requests.
+      #
+      #   @return [Integer]
+      required :interval, Integer
+
+      # @!attribute user_code
+      #   A short code displayed to the user, who enters it at the verification URI to
+      #   authorize the device.
+      #
+      #   @return [String]
+      required :user_code, String
+
+      # @!attribute verification_uri
+      #   The URI where the user navigates to enter the user_code.
+      #
+      #   @return [String]
+      required :verification_uri, String
+
+      # @!attribute verification_uri_complete
+      #   The verification URI with the user_code pre-filled as a query parameter.
+      #
+      #   @return [String]
+      required :verification_uri_complete, String
+
+      # @!method initialize(device_code:, expires_in:, interval:, user_code:, verification_uri:, verification_uri_complete:)
+      #   Some parameter documentations has been truncated, see
+      #   {Privy::Models::DeviceAuthorizationResponse} for more details.
+      #
+      #   Response from the device authorization endpoint per RFC 8628. Contains codes and
+      #   URIs for the device flow.
+      #
+      #   @param device_code [String] A long-lived code used by the device to poll for authorization status.
+      #
+      #   @param expires_in [Integer] The lifetime in seconds of the device_code and user_code.
+      #
+      #   @param interval [Integer] The minimum number of seconds the device should wait between polling requests.
+      #
+      #   @param user_code [String] A short code displayed to the user, who enters it at the verification URI to aut
+      #
+      #   @param verification_uri [String] The URI where the user navigates to enter the user_code.
+      #
+      #   @param verification_uri_complete [String] The verification URI with the user_code pre-filled as a query parameter.
+    end
+  end
+end

data/lib/privy/models/earn_incentive_reward_entry.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    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

data/lib/privy/models/earn_incentive_rewards_query.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    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

data/lib/privy/models/earn_incentive_rewards_response.rb

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

data/lib/privy/models/exchange_stripe_tokens_input.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class ExchangeStripeTokensInput < Privy::Internal::Type::BaseModel
+      # @!attribute auth_intent_id
+      #
+      #   @return [String]
+      required :auth_intent_id, String
+
+      # @!attribute crypto_customer_id
+      #
+      #   @return [String]
+      required :crypto_customer_id, String
+
+      # @!method initialize(auth_intent_id:, crypto_customer_id:)
+      #   Input for exchanging a Link auth intent for OAuth tokens.
+      #
+      #   @param auth_intent_id [String]
+      #   @param crypto_customer_id [String]
+    end
+  end
+end

data/lib/privy/models/exchange_stripe_tokens_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class ExchangeStripeTokensResponse < Privy::Internal::Type::BaseModel
+      # @!attribute crypto_customer_id
+      #
+      #   @return [String]
+      required :crypto_customer_id, String
+
+      # @!method initialize(crypto_customer_id:)
+      #   Confirmation that tokens were exchanged and stored.
+      #
+      #   @param crypto_customer_id [String]
+    end
+  end
+end

data/lib/privy/models/fiat_onramp_provider.rb

@@ -12,6 +12,8 @@ module Privy
       MOONPAY_SANDBOX = :"moonpay-sandbox"
       COINBASE = :coinbase
       COINBASE_SANDBOX = :"coinbase-sandbox"
+      STRIPE = :stripe
+      STRIPE_SANDBOX = :"stripe-sandbox"
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/privy/models/fiat_onramp_stripe_sdk_session_response.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class FiatOnrampStripeSDKSessionResponse < Privy::Internal::Type::BaseModel
+      # @!attribute network
+      #
+      #   @return [String]
+      required :network, String
+
+      # @!attribute publishable_key
+      #
+      #   @return [String]
+      required :publishable_key, String
+
+      # @!attribute session_id
+      #
+      #   @return [String]
+      required :session_id, String
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Privy::Models::FiatOnrampStripeSDKSessionResponse::Type]
+      required :type, enum: -> { Privy::FiatOnrampStripeSDKSessionResponse::Type }
+
+      # @!method initialize(network:, publishable_key:, session_id:, type:)
+      #   Provider session initialization for embedded SDK providers (Stripe).
+      #
+      #   @param network [String]
+      #   @param publishable_key [String]
+      #   @param session_id [String]
+      #   @param type [Symbol, Privy::Models::FiatOnrampStripeSDKSessionResponse::Type]
+
+      # @see Privy::Models::FiatOnrampStripeSDKSessionResponse#type
+      module Type
+        extend Privy::Internal::Type::Enum
+
+        STRIPE_SDK = :"stripe-sdk"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/fiat_onramp_url_session_response.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class FiatOnrampURLSessionResponse < Privy::Internal::Type::BaseModel
+      # @!attribute session_id
+      #
+      #   @return [String]
+      required :session_id, String
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Privy::Models::FiatOnrampURLSessionResponse::Type]
+      required :type, enum: -> { Privy::FiatOnrampURLSessionResponse::Type }
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(session_id:, type:, url:)
+      #   Provider session initialization for popup-based providers.
+      #
+      #   @param session_id [String]
+      #   @param type [Symbol, Privy::Models::FiatOnrampURLSessionResponse::Type]
+      #   @param url [String]
+
+      # @see Privy::Models::FiatOnrampURLSessionResponse#type
+      module Type
+        extend Privy::Internal::Type::Enum
+
+        URL = :url
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/get_fiat_onramp_url_response.rb

@@ -2,22 +2,20 @@
 
 module Privy
   module Models
-    class GetFiatOnrampURLResponse < Privy::Internal::Type::BaseModel
-      # @!attribute session_id
-      #
-      #   @return [String]
-      required :session_id, String
+    # Provider session initialization — either a hosted URL or embedded SDK config.
+    module GetFiatOnrampURLResponse
+      extend Privy::Internal::Type::Union
 
-      # @!attribute url
-      #
-      #   @return [String]
-      required :url, String
+      discriminator :type
 
-      # @!method initialize(session_id:, url:)
-      #   The response containing a fiat onramp provider session URL.
-      #
-      #   @param session_id [String]
-      #   @param url [String]
+      # Provider session initialization for popup-based providers.
+      variant :url, -> { Privy::FiatOnrampURLSessionResponse }
+
+      # Provider session initialization for embedded SDK providers (Stripe).
+      variant :"stripe-sdk", -> { Privy::FiatOnrampStripeSDKSessionResponse }
+
+      # @!method self.variants
+      #   @return [Array(Privy::Models::FiatOnrampURLSessionResponse, Privy::Models::FiatOnrampStripeSDKSessionResponse)]
     end
   end
 end

data/lib/privy/models/get_stripe_crypto_customer_response.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class GetStripeCryptoCustomerResponse < Privy::Internal::Type::BaseModel
+      # @!attribute data
+      #   Active onramp session with customer verifications.
+      #
+      #   @return [Privy::Models::StripeCryptoCustomerActive, Privy::Models::StripeCryptoCustomerExpired, Privy::Models::StripeCryptoCustomerNone]
+      required :data, union: -> { Privy::GetStripeCryptoCustomerResponse::Data }
+
+      # @!method initialize(data:)
+      #   Stripe onramp session status and customer verification info.
+      #
+      #   @param data [Privy::Models::StripeCryptoCustomerActive, Privy::Models::StripeCryptoCustomerExpired, Privy::Models::StripeCryptoCustomerNone] Active onramp session with customer verifications.
+
+      # Active onramp session with customer verifications.
+      #
+      # @see Privy::Models::GetStripeCryptoCustomerResponse#data
+      module Data
+        extend Privy::Internal::Type::Union
+
+        discriminator :status
+
+        # Active onramp session with customer verifications.
+        variant :active, -> { Privy::StripeCryptoCustomerActive }
+
+        # Expired onramp session. Token refresh failed, re-authentication required.
+        variant :expired, -> { Privy::StripeCryptoCustomerExpired }
+
+        # No onramp session. User must authenticate via Link.
+        variant :none, -> { Privy::StripeCryptoCustomerNone }
+
+        # @!method self.variants
+        #   @return [Array(Privy::Models::StripeCryptoCustomerActive, Privy::Models::StripeCryptoCustomerExpired, Privy::Models::StripeCryptoCustomerNone)]
+      end
+    end
+  end
+end