privy_ruby 0.0.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51e25ac71d2aa91eb15e1f25786474dab96e24a923c19aba56ddc8e4eafd30aa
-  data.tar.gz: f6adf206cd6d68890b264536771bde67ab3b4e713a7427a69e0ace6c930ce2f9
+  metadata.gz: '084a5766c69229fc0513f76be1dfcfa93c88b440b257ae3627ec99b02d86add9'
+  data.tar.gz: 3f2a1597ecd5f94da344fb7186fe9b5933ffd09a4cc80775e42c3f8a85366bf5
 SHA512:
-  metadata.gz: 9363c7b9cc66d84ba4daa2060d2316eca42a728f2ebe05b0cae6fc2447d4b8c64e651bc754da42443d161d5007e9a4165445450e527b674d1fd28895351c87d4
-  data.tar.gz: db7de0267ee175d3f5adc0792cd71dbbce20057322b2a695f9f2391ac7fada81817df8ea9cf2b2d59b3e58af96f4a168dbe038edeefb67ba5271440b7df9a044
+  metadata.gz: bb46a564adc43b1a0f2027f2ec18d6bac81caf465027ec4094beaacd0b52f0b38459ac2fc569bbf917a35bf3ba7d8631aa9fa0fb0f6dd54e049e941a6ba03872
+  data.tar.gz: 3fe7e9539f2c0a495f20af158b2d3ab314c13ebdef98f3ad12266f00cca040b76d884a2d87de241cd958d41eeb1c620b3f12c8a8f081ae65a83d2619ac9b6cd3

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 0.2.0 (2026-06-05)
+
+Full Changelog: [v0.1.0...v0.2.0](https://github.com/privy-io/ruby-sdk/compare/v0.1.0...v0.2.0)
+
+### Features
+
+* **api:** api update ([28c0f44](https://github.com/privy-io/ruby-sdk/commit/28c0f443e0bf9844b899845f2d2974c613fc0866))
+* **api:** api update ([5ef4349](https://github.com/privy-io/ruby-sdk/commit/5ef4349cc57bc7d8438eb0645f24a5befd532710))
+* **api:** api update ([263594f](https://github.com/privy-io/ruby-sdk/commit/263594fb816a62e0f5bd91c3e15a311161fdacbe))
+* **api:** api update ([ec23c50](https://github.com/privy-io/ruby-sdk/commit/ec23c50b5b2be99a30e3fecb60a611186620b257))
+* **api:** api update ([4b9daed](https://github.com/privy-io/ruby-sdk/commit/4b9daed0e62564e63a4629fc5cb0b1ea3406558e))
+* **api:** api update ([cead6ea](https://github.com/privy-io/ruby-sdk/commit/cead6eaa5b7f14ea4d53cb57031df82a604960f9))
+
+## 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.2.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

@@ -47,6 +47,7 @@ module Privy
     # @return [Privy::Resources::KeyQuorums]
     attr_reader :key_quorums
 
+    # Operations related to authorization intents for wallet actions
     # @return [Privy::Resources::Intents]
     attr_reader :intents
 
@@ -72,6 +73,12 @@ module Privy
     # @return [Privy::Resources::ClientAuth]
     attr_reader :client_auth
 
+    # @return [Privy::Resources::Shared]
+    attr_reader :shared
+
+    # @return [Privy::Resources::Onramps]
+    attr_reader :onramps
+
     # @return [Privy::Resources::Funding]
     attr_reader :funding
 
@@ -81,8 +88,8 @@ module Privy
     # @return [Privy::Resources::CrossApp]
     attr_reader :cross_app
 
-    # @return [Privy::Resources::Shared]
-    attr_reader :shared
+    # @return [Privy::Resources::OAuth]
+    attr_reader :oauth
 
     # @return [Privy::Resources::WalletActions]
     attr_reader :wallet_actions
@@ -190,10 +197,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)
+      @shared = Privy::Resources::Shared.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/analytics_event_input.rb

@@ -11,7 +11,7 @@ module Privy
       # @!attribute client_id
       #
       #   @return [String, nil]
-      optional :client_id, String
+      optional :client_id, String, nil?: true
 
       # @!attribute payload
       #
@@ -22,7 +22,7 @@ module Privy
       #   The input for capturing an analytics event.
       #
       #   @param event_name [String]
-      #   @param client_id [String]
+      #   @param client_id [String, nil]
       #   @param payload [Hash{Symbol=>Object}]
     end
   end

data/lib/privy/models/bitcoin_address.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    BitcoinAddress = String
+  end
+end

data/lib/privy/models/bridge_destination_asset.rb

@@ -2,6 +2,7 @@
 
 module Privy
   module Models
+    # Supported destination stablecoin assets for fiat-to-crypto transfers.
     module BridgeDestinationAsset
       extend Privy::Internal::Type::Enum
 

data/lib/privy/models/bridge_fiat_virtual_account_destination.rb

@@ -9,6 +9,7 @@ module Privy
       required :address, String
 
       # @!attribute asset
+      #   Supported destination stablecoin assets for fiat-to-crypto transfers.
       #
       #   @return [Symbol, Privy::Models::BridgeDestinationAsset]
       required :asset, enum: -> { Privy::BridgeDestinationAsset }
@@ -19,8 +20,12 @@ module Privy
       required :chain, String
 
       # @!method initialize(address:, asset:, chain:)
+      #   The destination chain, asset, and address for a virtual account transfer.
+      #
       #   @param address [String]
-      #   @param asset [Symbol, Privy::Models::BridgeDestinationAsset]
+      #
+      #   @param asset [Symbol, Privy::Models::BridgeDestinationAsset] Supported destination stablecoin assets for fiat-to-crypto transfers.
+      #
       #   @param chain [String]
     end
   end

data/lib/privy/models/bridge_fiat_virtual_account_request.rb

@@ -4,6 +4,7 @@ module Privy
   module Models
     class BridgeFiatVirtualAccountRequest < Privy::Internal::Type::BaseModel
       # @!attribute destination
+      #   The destination chain, asset, and address for a virtual account transfer.
       #
       #   @return [Privy::Models::BridgeFiatVirtualAccountDestination]
       required :destination, -> { Privy::BridgeFiatVirtualAccountDestination }
@@ -14,6 +15,7 @@ module Privy
       required :provider, enum: -> { Privy::BridgeFiatVirtualAccountRequest::Provider }
 
       # @!attribute source
+      #   The source fiat currency configuration for a virtual account.
       #
       #   @return [Privy::Models::BridgeFiatVirtualAccountSource]
       required :source, -> { Privy::BridgeFiatVirtualAccountSource }
@@ -21,9 +23,11 @@ module Privy
       # @!method initialize(destination:, provider:, source:)
       #   The request input for creating virtual account.
       #
-      #   @param destination [Privy::Models::BridgeFiatVirtualAccountDestination]
+      #   @param destination [Privy::Models::BridgeFiatVirtualAccountDestination] The destination chain, asset, and address for a virtual account transfer.
+      #
       #   @param provider [Symbol, Privy::Models::BridgeFiatVirtualAccountRequest::Provider]
-      #   @param source [Privy::Models::BridgeFiatVirtualAccountSource]
+      #
+      #   @param source [Privy::Models::BridgeFiatVirtualAccountSource] The source fiat currency configuration for a virtual account.
 
       # @see Privy::Models::BridgeFiatVirtualAccountRequest#provider
       module Provider

data/lib/privy/models/bridge_fiat_virtual_account_response.rb

@@ -10,6 +10,7 @@ module Privy
       required :deposit_instructions, union: -> { Privy::BridgeFiatVirtualAccountDepositInstructions }
 
       # @!attribute destination
+      #   The destination chain, asset, and address for a virtual account transfer.
       #
       #   @return [Privy::Models::BridgeFiatVirtualAccountDestination]
       required :destination, -> { Privy::BridgeFiatVirtualAccountDestination }
@@ -29,7 +30,7 @@ module Privy
       #
       #   @param deposit_instructions [Privy::Models::BridgeUsdFiatVirtualAccountDepositInstructions, Privy::Models::BridgeEurFiatVirtualAccountDepositInstructions, Privy::Models::BridgeMxnFiatVirtualAccountDepositInstructions, Privy::Models::BridgeBrlFiatVirtualAccountDepositInstructions, Privy::Models::BridgeGbpFiatVirtualAccountDepositInstructions] The deposit instructions for a virtual account.
       #
-      #   @param destination [Privy::Models::BridgeFiatVirtualAccountDestination]
+      #   @param destination [Privy::Models::BridgeFiatVirtualAccountDestination] The destination chain, asset, and address for a virtual account transfer.
       #
       #   @param provider [Symbol, Privy::Models::BridgeFiatVirtualAccountResponse::Provider]
       #

data/lib/privy/models/bridge_fiat_virtual_account_source.rb

@@ -4,12 +4,15 @@ module Privy
   module Models
     class BridgeFiatVirtualAccountSource < Privy::Internal::Type::BaseModel
       # @!attribute asset
+      #   Supported source fiat currencies for virtual account deposits.
       #
       #   @return [Symbol, Privy::Models::BridgeSourceAsset]
       required :asset, enum: -> { Privy::BridgeSourceAsset }
 
       # @!method initialize(asset:)
-      #   @param asset [Symbol, Privy::Models::BridgeSourceAsset]
+      #   The source fiat currency configuration for a virtual account.
+      #
+      #   @param asset [Symbol, Privy::Models::BridgeSourceAsset] Supported source fiat currencies for virtual account deposits.
     end
   end
 end

data/lib/privy/models/bridge_sandbox_fiat_virtual_account_request.rb

@@ -4,6 +4,7 @@ module Privy
   module Models
     class BridgeSandboxFiatVirtualAccountRequest < Privy::Internal::Type::BaseModel
       # @!attribute destination
+      #   The destination chain, asset, and address for a virtual account transfer.
       #
       #   @return [Privy::Models::BridgeFiatVirtualAccountDestination]
       required :destination, -> { Privy::BridgeFiatVirtualAccountDestination }
@@ -14,6 +15,7 @@ module Privy
       required :provider, enum: -> { Privy::BridgeSandboxFiatVirtualAccountRequest::Provider }
 
       # @!attribute source
+      #   The source fiat currency configuration for a virtual account.
       #
       #   @return [Privy::Models::BridgeFiatVirtualAccountSource]
       required :source, -> { Privy::BridgeFiatVirtualAccountSource }
@@ -21,9 +23,11 @@ module Privy
       # @!method initialize(destination:, provider:, source:)
       #   The request input for creating virtual account.
       #
-      #   @param destination [Privy::Models::BridgeFiatVirtualAccountDestination]
+      #   @param destination [Privy::Models::BridgeFiatVirtualAccountDestination] The destination chain, asset, and address for a virtual account transfer.
+      #
       #   @param provider [Symbol, Privy::Models::BridgeSandboxFiatVirtualAccountRequest::Provider]
-      #   @param source [Privy::Models::BridgeFiatVirtualAccountSource]
+      #
+      #   @param source [Privy::Models::BridgeFiatVirtualAccountSource] The source fiat currency configuration for a virtual account.
 
       # @see Privy::Models::BridgeSandboxFiatVirtualAccountRequest#provider
       module Provider

data/lib/privy/models/bridge_sandbox_fiat_virtual_account_response.rb

@@ -10,6 +10,7 @@ module Privy
       required :deposit_instructions, union: -> { Privy::BridgeFiatVirtualAccountDepositInstructions }
 
       # @!attribute destination
+      #   The destination chain, asset, and address for a virtual account transfer.
       #
       #   @return [Privy::Models::BridgeFiatVirtualAccountDestination]
       required :destination, -> { Privy::BridgeFiatVirtualAccountDestination }
@@ -29,7 +30,7 @@ module Privy
       #
       #   @param deposit_instructions [Privy::Models::BridgeUsdFiatVirtualAccountDepositInstructions, Privy::Models::BridgeEurFiatVirtualAccountDepositInstructions, Privy::Models::BridgeMxnFiatVirtualAccountDepositInstructions, Privy::Models::BridgeBrlFiatVirtualAccountDepositInstructions, Privy::Models::BridgeGbpFiatVirtualAccountDepositInstructions] The deposit instructions for a virtual account.
       #
-      #   @param destination [Privy::Models::BridgeFiatVirtualAccountDestination]
+      #   @param destination [Privy::Models::BridgeFiatVirtualAccountDestination] The destination chain, asset, and address for a virtual account transfer.
       #
       #   @param provider [Symbol, Privy::Models::BridgeSandboxFiatVirtualAccountResponse::Provider]
       #

data/lib/privy/models/bridge_source_asset.rb

@@ -2,6 +2,7 @@
 
 module Privy
   module Models
+    # Supported source fiat currencies for virtual account deposits.
     module BridgeSourceAsset
       extend Privy::Internal::Type::Enum
 

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,38 @@
+# 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
+
+      # @!attribute transaction_details
+      #   Transaction details returned from a Stripe onramp session.
+      #
+      #   @return [Privy::Models::CreateStripeOnrampSessionResponse::TransactionDetails, nil]
+      optional :transaction_details, -> { Privy::CreateStripeOnrampSessionResponse::TransactionDetails }
+
+      # @!method initialize(id:, session_id:, transaction_details: nil)
+      #   The created onramp session.
+      #
+      #   @param id [String]
+      #
+      #   @param session_id [String]
+      #
+      #   @param transaction_details [Privy::Models::CreateStripeOnrampSessionResponse::TransactionDetails] Transaction details returned from a Stripe onramp session.
+
+      # @see Privy::Models::CreateStripeOnrampSessionResponse#transaction_details
+      class TransactionDetails < Privy::Models::OnrampSessionTransactionDetails
+        # @!method initialize
+        #   Transaction details returned from a Stripe onramp session.
+      end
+    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/device_verify_action.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    # The action to take on the device authorization request.
+    module DeviceVerifyAction
+      extend Privy::Internal::Type::Enum
+
+      APPROVE = :approve
+      DENY = :deny
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/privy/models/device_verify_request_body.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class DeviceVerifyRequestBody < Privy::Internal::Type::BaseModel
+      # @!attribute action
+      #   The action to take on the device authorization request.
+      #
+      #   @return [Symbol, Privy::Models::DeviceVerifyAction]
+      required :action, enum: -> { Privy::DeviceVerifyAction }
+
+      # @!attribute user_code
+      #   The user code displayed on the CLI device.
+      #
+      #   @return [String]
+      required :user_code, String
+
+      # @!method initialize(action:, user_code:)
+      #   Request body for approving or denying a device authorization request. The user
+      #   must be authenticated and belong to the target app.
+      #
+      #   @param action [Symbol, Privy::Models::DeviceVerifyAction] The action to take on the device authorization request.
+      #
+      #   @param user_code [String] The user code displayed on the CLI device.
+    end
+  end
+end

data/lib/privy/models/device_verify_response.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class DeviceVerifyResponse < Privy::Internal::Type::BaseModel
+      # @!attribute success
+      #   Whether the action was processed successfully.
+      #
+      #   @return [Boolean]
+      required :success, Privy::Internal::Type::Boolean
+
+      # @!method initialize(success:)
+      #   Response indicating the device authorization action was processed.
+      #
+      #   @param success [Boolean] Whether the action was processed successfully.
+    end
+  end
+end