coinbase-sdk 0.0.14 → 0.1.0

data/lib/coinbase/client/models/wallet.rb

@@ -23,8 +23,7 @@ module Coinbase::Client
 
     attr_accessor :default_address
 
-    # The features enabled for the wallet
-    attr_accessor :enabled_features
+    attr_accessor :feature_set
 
     # The status of the Server-Signer for the wallet if present.
     attr_accessor :server_signer_status
@@ -57,7 +56,7 @@ module Coinbase::Client
         :'id' => :'id',
         :'network_id' => :'network_id',
         :'default_address' => :'default_address',
-        :'enabled_features' => :'enabled_features',
+        :'feature_set' => :'feature_set',
         :'server_signer_status' => :'server_signer_status'
       }
     end
@@ -73,7 +72,7 @@ module Coinbase::Client
         :'id' => :'String',
         :'network_id' => :'String',
         :'default_address' => :'Address',
-        :'enabled_features' => :'Array<Feature>',
+        :'feature_set' => :'FeatureSet',
         :'server_signer_status' => :'String'
       }
     end
@@ -115,12 +114,10 @@ module Coinbase::Client
         self.default_address = attributes[:'default_address']
       end
 
-      if attributes.key?(:'enabled_features')
-        if (value = attributes[:'enabled_features']).is_a?(Array)
-          self.enabled_features = value
-        end
+      if attributes.key?(:'feature_set')
+        self.feature_set = attributes[:'feature_set']
       else
-        self.enabled_features = nil
+        self.feature_set = nil
       end
 
       if attributes.key?(:'server_signer_status')
@@ -141,8 +138,8 @@ module Coinbase::Client
         invalid_properties.push('invalid value for "network_id", network_id cannot be nil.')
       end
 
-      if @enabled_features.nil?
-        invalid_properties.push('invalid value for "enabled_features", enabled_features cannot be nil.')
+      if @feature_set.nil?
+        invalid_properties.push('invalid value for "feature_set", feature_set cannot be nil.')
       end
 
       invalid_properties
@@ -154,8 +151,8 @@ module Coinbase::Client
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @id.nil?
       return false if @network_id.nil?
-      return false if @enabled_features.nil?
-      server_signer_status_validator = EnumAttributeValidator.new('String', ["pending_seed_creation", "active_seed"])
+      return false if @feature_set.nil?
+      server_signer_status_validator = EnumAttributeValidator.new('String', ["pending_seed_creation", "active_seed", "unknown_default_open_api"])
       return false unless server_signer_status_validator.valid?(@server_signer_status)
       true
     end
@@ -163,7 +160,7 @@ module Coinbase::Client
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] server_signer_status Object to be assigned
     def server_signer_status=(server_signer_status)
-      validator = EnumAttributeValidator.new('String', ["pending_seed_creation", "active_seed"])
+      validator = EnumAttributeValidator.new('String', ["pending_seed_creation", "active_seed", "unknown_default_open_api"])
       unless validator.valid?(server_signer_status)
         fail ArgumentError, "invalid value for \"server_signer_status\", must be one of #{validator.allowable_values}."
       end
@@ -178,7 +175,7 @@ module Coinbase::Client
           id == o.id &&
           network_id == o.network_id &&
           default_address == o.default_address &&
-          enabled_features == o.enabled_features &&
+          feature_set == o.feature_set &&
           server_signer_status == o.server_signer_status
     end
 
@@ -191,7 +188,7 @@ module Coinbase::Client
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, network_id, default_address, enabled_features, server_signer_status].hash
+      [id, network_id, default_address, feature_set, server_signer_status].hash
     end
 
     # Builds the object from hash

data/lib/coinbase/client/models/webhook_event_type.rb

@@ -18,9 +18,10 @@ module Coinbase::Client
     UNSPECIFIED = "unspecified".freeze
     ERC20_TRANSFER = "erc20_transfer".freeze
     ERC721_TRANSFER = "erc721_transfer".freeze
+    UNKNOWN_DEFAULT_OPEN_API = "unknown_default_open_api".freeze
 
     def self.all_vars
-      @all_vars ||= [UNSPECIFIED, ERC20_TRANSFER, ERC721_TRANSFER].freeze
+      @all_vars ||= [UNSPECIFIED, ERC20_TRANSFER, ERC721_TRANSFER, UNKNOWN_DEFAULT_OPEN_API].freeze
     end
 
     # Builds the enum from string

data/lib/coinbase/client.rb

@@ -19,6 +19,7 @@ require 'coinbase/client/configuration'
 # Models
 Coinbase::Client.autoload :Address, 'coinbase/client/models/address'
 Coinbase::Client.autoload :AddressBalanceList, 'coinbase/client/models/address_balance_list'
+Coinbase::Client.autoload :AddressHistoricalBalanceList, 'coinbase/client/models/address_historical_balance_list'
 Coinbase::Client.autoload :AddressList, 'coinbase/client/models/address_list'
 Coinbase::Client.autoload :Asset, 'coinbase/client/models/asset'
 Coinbase::Client.autoload :Balance, 'coinbase/client/models/balance'
@@ -39,12 +40,14 @@ Coinbase::Client.autoload :CreateWebhookRequest, 'coinbase/client/models/create_
 Coinbase::Client.autoload :Error, 'coinbase/client/models/error'
 Coinbase::Client.autoload :EthereumValidatorMetadata, 'coinbase/client/models/ethereum_validator_metadata'
 Coinbase::Client.autoload :FaucetTransaction, 'coinbase/client/models/faucet_transaction'
-Coinbase::Client.autoload :Feature, 'coinbase/client/models/feature'
+Coinbase::Client.autoload :FeatureSet, 'coinbase/client/models/feature_set'
+Coinbase::Client.autoload :FetchHistoricalStakingBalances200Response, 'coinbase/client/models/fetch_historical_staking_balances200_response'
 Coinbase::Client.autoload :FetchStakingRewards200Response, 'coinbase/client/models/fetch_staking_rewards200_response'
 Coinbase::Client.autoload :FetchStakingRewardsRequest, 'coinbase/client/models/fetch_staking_rewards_request'
 Coinbase::Client.autoload :GetStakingContextRequest, 'coinbase/client/models/get_staking_context_request'
-Coinbase::Client.autoload :NativeEthStakingContext, 'coinbase/client/models/native_eth_staking_context'
-Coinbase::Client.autoload :PartialEthStakingContext, 'coinbase/client/models/partial_eth_staking_context'
+Coinbase::Client.autoload :HistoricalBalance, 'coinbase/client/models/historical_balance'
+Coinbase::Client.autoload :Network, 'coinbase/client/models/network'
+Coinbase::Client.autoload :NetworkIdentifier, 'coinbase/client/models/network_identifier'
 Coinbase::Client.autoload :SeedCreationEvent, 'coinbase/client/models/seed_creation_event'
 Coinbase::Client.autoload :SeedCreationEventResult, 'coinbase/client/models/seed_creation_event_result'
 Coinbase::Client.autoload :ServerSigner, 'coinbase/client/models/server_signer'
@@ -55,12 +58,15 @@ Coinbase::Client.autoload :ServerSignerList, 'coinbase/client/models/server_sign
 Coinbase::Client.autoload :SignatureCreationEvent, 'coinbase/client/models/signature_creation_event'
 Coinbase::Client.autoload :SignatureCreationEventResult, 'coinbase/client/models/signature_creation_event_result'
 Coinbase::Client.autoload :SignedVoluntaryExitMessageMetadata, 'coinbase/client/models/signed_voluntary_exit_message_metadata'
+Coinbase::Client.autoload :SponsoredSend, 'coinbase/client/models/sponsored_send'
+Coinbase::Client.autoload :StakingBalance, 'coinbase/client/models/staking_balance'
 Coinbase::Client.autoload :StakingContext, 'coinbase/client/models/staking_context'
 Coinbase::Client.autoload :StakingContextContext, 'coinbase/client/models/staking_context_context'
 Coinbase::Client.autoload :StakingOperation, 'coinbase/client/models/staking_operation'
 Coinbase::Client.autoload :StakingOperationMetadata, 'coinbase/client/models/staking_operation_metadata'
 Coinbase::Client.autoload :StakingReward, 'coinbase/client/models/staking_reward'
 Coinbase::Client.autoload :StakingRewardFormat, 'coinbase/client/models/staking_reward_format'
+Coinbase::Client.autoload :StakingRewardUSDValue, 'coinbase/client/models/staking_reward_usd_value'
 Coinbase::Client.autoload :Trade, 'coinbase/client/models/trade'
 Coinbase::Client.autoload :TradeList, 'coinbase/client/models/trade_list'
 Coinbase::Client.autoload :Transaction, 'coinbase/client/models/transaction'
@@ -72,6 +78,7 @@ Coinbase::Client.autoload :User, 'coinbase/client/models/user'
 Coinbase::Client.autoload :Validator, 'coinbase/client/models/validator'
 Coinbase::Client.autoload :ValidatorDetails, 'coinbase/client/models/validator_details'
 Coinbase::Client.autoload :ValidatorList, 'coinbase/client/models/validator_list'
+Coinbase::Client.autoload :ValidatorStatus, 'coinbase/client/models/validator_status'
 Coinbase::Client.autoload :Wallet, 'coinbase/client/models/wallet'
 Coinbase::Client.autoload :WalletList, 'coinbase/client/models/wallet_list'
 Coinbase::Client.autoload :Webhook, 'coinbase/client/models/webhook'
@@ -84,12 +91,14 @@ Coinbase::Client.autoload :AddressesApi, 'coinbase/client/api/addresses_api'
 Coinbase::Client.autoload :AssetsApi, 'coinbase/client/api/assets_api'
 Coinbase::Client.autoload :ContractEventsApi, 'coinbase/client/api/contract_events_api'
 Coinbase::Client.autoload :ExternalAddressesApi, 'coinbase/client/api/external_addresses_api'
+Coinbase::Client.autoload :NetworksApi, 'coinbase/client/api/networks_api'
 Coinbase::Client.autoload :ServerSignersApi, 'coinbase/client/api/server_signers_api'
 Coinbase::Client.autoload :StakeApi, 'coinbase/client/api/stake_api'
 Coinbase::Client.autoload :TradesApi, 'coinbase/client/api/trades_api'
 Coinbase::Client.autoload :TransfersApi, 'coinbase/client/api/transfers_api'
 Coinbase::Client.autoload :UsersApi, 'coinbase/client/api/users_api'
 Coinbase::Client.autoload :ValidatorsApi, 'coinbase/client/api/validators_api'
+Coinbase::Client.autoload :WalletStakeApi, 'coinbase/client/api/wallet_stake_api'
 Coinbase::Client.autoload :WalletsApi, 'coinbase/client/api/wallets_api'
 Coinbase::Client.autoload :WebhooksApi, 'coinbase/client/api/webhooks_api'
 

data/lib/coinbase/constants.rb

@@ -4,16 +4,6 @@ require_relative 'asset'
 require_relative 'network'
 
 module Coinbase
-  # The Base Sepolia Network.
-  BASE_SEPOLIA = Network.new(
-    network_id: :base_sepolia,
-    display_name: 'Base Sepolia',
-    protocol_family: :evm,
-    is_testnet: true,
-    native_asset_id: :eth,
-    chain_id: 84_532
-  )
-
   # The number of decimal places in Gwei.
   GWEI_DECIMALS = 9
 

data/lib/coinbase/contract_event.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Coinbase
+  # Represents a single contract event
+  class ContractEvent
+    # Returns a new ContractEvent object.
+    # @param model [Coinbase::Client::ContractEvent] The underlying ContractEvent object
+    def initialize(model)
+      @model = model
+    end
+
+    # Returns the network ID of the ContractEvent.
+    # @return [String] The network ID
+    def network_id
+      @model.network_id
+    end
+
+    # Returns the protocol name of the ContractEvent.
+    # @return [String] The protocol name
+    def protocol_name
+      @model.protocol_name
+    end
+
+    # Returns the contract name of the ContractEvent.
+    # @return [String] The contract name
+    def contract_name
+      @model.contract_name
+    end
+
+    # Returns the event name of the ContractEvent.
+    # @return [String] The event name
+    def event_name
+      @model.event_name
+    end
+
+    # Returns the signature of the ContractEvent.
+    # @return [String] The event signature
+    def sig
+      @model.sig
+    end
+
+    # Returns the four bytes of the Keccak hash of the event signature.
+    # @return [String] The four bytes of the event signature hash
+    def four_bytes
+      @model.four_bytes
+    end
+
+    # Returns the contract address of the ContractEvent.
+    # @return [String] The contract address
+    def contract_address
+      @model.contract_address
+    end
+
+    # Returns the block time of the ContractEvent.
+    # @return [Time] The block time
+    def block_time
+      Time.parse(@model.block_time)
+    end
+
+    # Returns the block height of the ContractEvent.
+    # @return [Integer] The block height
+    def block_height
+      @model.block_height
+    end
+
+    # Returns the transaction hash of the ContractEvent.
+    # @return [String] The transaction hash
+    def tx_hash
+      @model.tx_hash
+    end
+
+    # Returns the transaction index of the ContractEvent.
+    # @return [Integer] The transaction index
+    def tx_index
+      @model.tx_index
+    end
+
+    # Returns the event index of the ContractEvent.
+    # @return [Integer] The event index
+    def event_index
+      @model.event_index
+    end
+
+    # Returns the event data of the ContractEvent.
+    # @return [String] The event data
+    def data
+      @model.data
+    end
+
+    # Returns a string representation of the ContractEvent.
+    # @return [String] a string representation of the ContractEvent
+    def to_s
+      "Coinbase::ContractEvent{network_id: '#{network_id}', protocol_name: '#{protocol_name}', " \
+        "contract_name: '#{contract_name}', event_name: '#{event_name}', contract_address: '#{contract_address}', " \
+        "block_height: #{block_height}, tx_hash: '#{tx_hash}', data: '#{data}'}"
+    end
+
+    # Same as to_s.
+    # @return [String] a string representation of the ContractEvent
+    def inspect
+      to_s
+    end
+  end
+end

data/lib/coinbase/correlation.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'securerandom'
+
+module Coinbase
+  # A middleware that injects correlation data into the request headers.
+  class Correlation < Faraday::Middleware
+    # Initializes the Correlation middleware.
+    # @param app [Faraday::Connection] The Faraday connection
+    def initialize(app)
+      super(app)
+      @app = app
+    end
+
+    # Processes the request by adding the Correlation Data to the request headers.
+    # @param env [Faraday::Env] The Faraday request environment
+    def call(env)
+      env.request_headers['Correlation-Context'] = correlation_data
+      @app.call(env)
+    end
+
+    def correlation_data
+      @correlation_data ||= {
+        sdk_version: Coinbase::VERSION,
+        sdk_language: 'ruby'
+      }.map { |key, val| "#{key}=#{CGI.escape(val)}" }.join(',')
+    end
+  end
+end

data/lib/coinbase/destination.rb

@@ -20,32 +20,34 @@ module Coinbase
     #   If the destination is a String, it uses it as the Address ID.
     # @param network_id [Symbol] The ID of the Network to which the Destination belongs
     # @return [Destination] The Destination object
-    def initialize(model, network_id: nil)
+    def initialize(model, network:)
+      network = Coinbase::Network.from_id(network)
+
       case model
       when Coinbase::Destination
-        raise ArgumentError, 'destination network must match destination' unless model.network_id == network_id
+        raise ArgumentError, 'destination network must match destination' unless model.network == network
 
         @address_id = model.address_id
-        @network_id = model.network_id
+        @network = model.network
       when Coinbase::Wallet
-        raise ArgumentError, 'destination network must match wallet' unless model.network_id == network_id
+        raise ArgumentError, 'destination network must match wallet' unless model.network == network
         raise ArgumentError, 'destination wallet must have default address' if model.default_address.nil?
 
         @address_id = model.default_address.id
-        @network_id = model.network_id
+        @network = model.network
       when Coinbase::Address
-        raise ArgumentError, 'destination network must match address' unless model.network_id == network_id
+        raise ArgumentError, 'destination network must match address' unless model.network == network
 
         @address_id = model.id
-        @network_id = model.network_id
+        @network = model.network
       when String
         @address_id = model
-        @network_id = network_id
+        @network = network
       else
         raise ArgumentError, "unsupported destination type: #{model.class}"
       end
     end
 
-    attr_reader :address_id, :network_id
+    attr_reader :address_id, :network
   end
 end

data/lib/coinbase/errors.rb

@@ -56,6 +56,13 @@ module Coinbase
     end
   end
 
+  # An error raised when an operation is attempted with insufficient funds.
+  class NetworkUnsupportedError < StandardError
+    def initialize(network_id)
+      super("Network #{network_id} is not supported")
+    end
+  end
+
   # An error raised when an operation is attempted with insufficient funds.
   class InsufficientFundsError < StandardError
     def initialize(expected, exact, msg = 'Insufficient funds')
@@ -63,6 +70,13 @@ module Coinbase
     end
   end
 
+  # An error raised when a resource is already signed.
+  class AlreadySignedError < StandardError
+    def initialize(msg = 'Resource already signed')
+      super(msg)
+    end
+  end
+
   # An error raised when a transaction is not signed.
   class TransactionNotSignedError < StandardError
     def initialize(msg = 'Transaction must be signed')

data/lib/coinbase/historical_balance.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Coinbase
+  # A representation of an HistoricalBalance.
+  class HistoricalBalance
+    # Converts a Coinbase::Client::HistoricalBalance model to a Coinbase::HistoricalBalance
+    # @param historical_balance_model [Coinbase::Client::HistoricalBalance] The historical balance fetched from the API.
+    # @return [HistoricalBalance] The converted HistoricalBalance object.
+    def self.from_model(historical_balance_model)
+      asset = Coinbase::Asset.from_model(historical_balance_model.asset)
+
+      new(
+        amount: asset.from_atomic_amount(historical_balance_model.amount),
+        block_height: BigDecimal(historical_balance_model.block_height),
+        block_hash: historical_balance_model.block_hash,
+        asset: asset
+      )
+    end
+
+    # Returns a new HistoricalBalance object. Do not use this method. Instead, use Balance.from_model or
+    # Balance.from_model_and_asset_id.
+    # @param amount [BigDecimal] The amount of the Asset
+    # @param block_height [BigDecimal] The block height at which the balance was recorded
+    # @param block_hash [String] The block hash at which the balance was recorded
+    # @param asset [Asset] The asset we want to fetch
+    def initialize(amount:, block_height:, block_hash:, asset:)
+      @amount = amount
+      @block_height = block_height
+      @block_hash = block_hash
+      @asset = asset
+    end
+
+    attr_reader :amount, :block_height, :block_hash, :asset
+
+    # Returns a string representation of the HistoricalBalance.
+    # @return [String] a string representation of the HistoricalBalance
+    def to_s
+      Coinbase.pretty_print_object(
+        self.class,
+        amount: amount.to_i,
+        block_height: block_height.to_i,
+        block_hash: block_hash,
+        asset: asset
+      )
+    end
+
+    # Same as to_s.
+    # @return [String] a string representation of the HistoricalBalance
+    def inspect
+      to_s
+    end
+  end
+end

data/lib/coinbase/middleware.rb

@@ -9,6 +9,7 @@ module Coinbase
   # A module for middleware that can be used with Faraday.
   module Middleware
     Faraday::Request.register_middleware authenticator: -> { Coinbase::Authenticator }
+    Faraday::Request.register_middleware correlation: -> { Coinbase::Correlation }
 
     # Returns the default middleware configuration for the Coinbase SDK.
     def self.config
@@ -19,6 +20,7 @@ module Coinbase
         config.host = uri.host + (uri.port ? ":#{uri.port}" : '')
         config.scheme = uri.scheme if uri.scheme
         config.request(:authenticator)
+        config.request(:correlation)
         retry_options = {
           max: Coinbase.configuration.max_network_tries,
           interval: 0.05,

data/lib/coinbase/network.rb

@@ -3,39 +3,122 @@
 module Coinbase
   # A blockchain network.
   class Network
-    attr_reader :chain_id
+    # Returns the Network object for the given ID, if supported.
+    # @param network_id [Symbol, String] The ID of the network
+    # @return [Network] The network object
+    def self.from_id(network_id)
+      return network_id if network_id.is_a?(Network)
 
-    # Returns a new Network object. Do not use this method directly. Instead, use the Network constants defined in
+      network = NETWORK_MAP.fetch(Coinbase.to_sym(network_id), nil)
+
+      return network unless network.nil?
+
+      raise NetworkUnsupportedError, network_id
+    end
+
+    # Constructs a new Network object. Do not use this method directly. Instead, use the Network constants defined in
     # the Coinbase module.
-    # @param network_id [Symbol] The Network ID
-    # @param display_name [String] The Network's display name
-    # @param protocol_family [String] The protocol family to which the Network belongs
-    #   (e.g., "evm")
-    # @param is_testnet [Boolean] Whether the Network is a testnet
-    # @param native_asset_id [String] The ID of the Network's native Asset
-    # @param chain_id [Integer] The Chain ID of the Network
-    def initialize(network_id:, display_name:, protocol_family:, is_testnet:, native_asset_id:, chain_id:)
-      @network_id = network_id
-      @display_name = display_name
-      @protocol_family = protocol_family
-      @is_testnet = is_testnet
-      @native_asset_id = native_asset_id
-      @chain_id = chain_id
+    # @param id [Symbol, String] The Network ID
+    # @return [Network] The new Network object
+    def initialize(id)
+      @id = ::Coinbase.to_sym(id)
+    end
+
+    # Returns the equality of the Network object with another Network object by ID.
+    # @param other [Coinbase::Network] The network object to compare
+    # @return [Boolean] Whether the Network objects are equal
+    def ==(other)
+      return false unless other.is_a?(Network)
+
+      id == other.id
+    end
+
+    attr_reader :id
+
+    def normalized_id
+      id.to_s.gsub('_', '-')
+    end
+
+    # The Chain ID of the Network.
+    # @return [Integer] The Chain ID of the Network
+    # @example
+    #   network.chain_id #=> 84_532
+    def chain_id
+      model.chain_id
+    end
+
+    # Whether the Network is a testnet.
+    # @return [Boolean] Whether the Network is a testnet
+    # @example
+    #   network.testnet? #=> true
+    def testnet?
+      model.is_testnet
+    end
+
+    # The display name of the Network.
+    # @return [String] The display name of the Network
+    # @example
+    #  network.display_name #=> "Base Sepolia"
+    def display_name
+      model.display_name
+    end
+
+    # The protocol family to which the Network belongs. Example: `evm`.
+    # @return [String] The protocol family to which the Network belongs.
+    # @example
+    #  network.protocol_family #=> "evm"
+    def protocol_family
+      model.protocol_family
+    end
+
+    # The address path prefix of the Network.
+    # @return [String] The address path prefix of the Network
+    # @example
+    #   network.address_path_prefix #=> "m/44'/60'/0'/0"
+    def address_path_prefix
+      model.address_path_prefix
     end
 
     # Gets the Asset with the given ID.
-    #
     # @param asset_id [Symbol] The ID of the Asset
     # @return [Asset] The Asset with the given ID
     def get_asset(asset_id)
-      Asset.fetch(@network_id, asset_id)
+      Asset.fetch(@id, asset_id)
     end
 
     # Gets the native Asset of the Network.
-    #
     # @return [Asset] The native Asset of the Network
     def native_asset
-      @native_asset ||= get_asset(@native_asset_id)
+      @native_asset ||= Coinbase::Asset.from_model(model.native_asset)
+    end
+
+    def to_s
+      details = { id: id }
+
+      # Only include optional details if the model is already fetched.
+      unless @model.nil?
+        Coinbase::Client::Network.attribute_map.each_key do |attr|
+          details[attr] = @model.send(attr)
+        end
+      end
+
+      Coinbase.pretty_print_object(self.class, **details)
+    end
+
+    def inspect
+      to_s
+    end
+
+    private
+
+    def networks_api
+      @networks_api ||= Coinbase::Client::NetworksApi.new(Coinbase.configuration.api_client)
+    end
+
+    def model
+      @model ||= Coinbase.call_api do
+        networks_api.get_network(Coinbase.normalize_network(id))
+      end
     end
   end
 end

data/lib/coinbase/server_signer.rb

@@ -5,9 +5,15 @@ require_relative 'client'
 module Coinbase
   # A representation of a Server-Signer. Server-Signers are assigned to sign transactions for a Wallet.
   class ServerSigner
-    # Returns a new Server-Signer object. Do not use this method directly. Instead, use ServerSigner.default.
-    def initialize(model)
-      @model = model
+    # A representation of ServerSigner status in a Wallet.
+    module Status
+      # The Wallet is awaiting seed creation by the ServerSigner. At this point,
+      # the Wallet cannot create addresses or sign transactions.
+      PENDING = 'pending_seed_creation'
+
+      # The Wallet has an associated seed created by the ServerSigner. It is ready
+      # to create addresses and sign transactions.
+      ACTIVE = 'active_seed'
     end
 
     class << self
@@ -30,6 +36,11 @@ module Coinbase
       end
     end
 
+    # Returns a new Server-Signer object. Do not use this method directly. Instead, use ServerSigner.default.
+    def initialize(model)
+      @model = model
+    end
+
     # Returns the Server-Signer ID.
     # @return [String] the Server-Signer ID
     def id