coinbase-sdk 0.0.13 → 0.0.14

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

@@ -0,0 +1,244 @@
+=begin
+#Coinbase Platform API
+
+#This is the OpenAPI 3.0 specification for the Coinbase Platform APIs, used in conjunction with the Coinbase Platform SDKs.
+
+The version of the OpenAPI document: 0.0.1-alpha
+Contact: yuga.cohler@coinbase.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.7.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Coinbase::Client
+  # 
+  class WebhookList
+    attr_accessor :data
+
+    # True if this list has another page of items after this one that can be fetched.
+    attr_accessor :has_more
+
+    # The page token to be used to fetch the next page.
+    attr_accessor :next_page
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'data' => :'data',
+        :'has_more' => :'has_more',
+        :'next_page' => :'next_page'
+      }
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'data' => :'Array<Webhook>',
+        :'has_more' => :'Boolean',
+        :'next_page' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Coinbase::Client::WebhookList` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!self.class.attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Coinbase::Client::WebhookList`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'data')
+        if (value = attributes[:'data']).is_a?(Array)
+          self.data = value
+        end
+      else
+        self.data = nil
+      end
+
+      if attributes.key?(:'has_more')
+        self.has_more = attributes[:'has_more']
+      end
+
+      if attributes.key?(:'next_page')
+        self.next_page = attributes[:'next_page']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @data.nil?
+        invalid_properties.push('invalid value for "data", data cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @data.nil?
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          data == o.data &&
+          has_more == o.has_more &&
+          next_page == o.next_page
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [data, has_more, next_page].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Deserializes the data based on type
+    # @param string type Data type
+    # @param string value Value to be deserialized
+    # @return [Object] Deserialized data
+    def self._deserialize(type, value)
+      case type.to_sym
+      when :Time
+        Time.parse(value)
+      when :Date
+        Date.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :Boolean
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when :Object
+        # generic object (usually a Hash), return directly
+        value
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        # models (e.g. Pet) or oneOf
+        klass = Coinbase::Client.const_get(type)
+        klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+      end
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_hash (backward compatibility)
+    # @return [Hash] Returns the object in the form of hash
+    def to_body
+      to_hash
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+  end
+
+end

data/lib/coinbase/client/version.rb

@@ -6,7 +6,7 @@
 The version of the OpenAPI document: 0.0.1-alpha
 Contact: yuga.cohler@coinbase.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.6.0
+Generator version: 7.7.0
 
 =end
 

data/lib/coinbase/client.rb

@@ -6,7 +6,7 @@
 The version of the OpenAPI document: 0.0.1-alpha
 Contact: yuga.cohler@coinbase.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.6.0
+Generator version: 7.7.0
 
 =end
 
@@ -22,15 +22,20 @@ Coinbase::Client.autoload :AddressBalanceList, 'coinbase/client/models/address_b
 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'
+Coinbase::Client.autoload :BroadcastStakingOperationRequest, 'coinbase/client/models/broadcast_staking_operation_request'
 Coinbase::Client.autoload :BroadcastTradeRequest, 'coinbase/client/models/broadcast_trade_request'
 Coinbase::Client.autoload :BroadcastTransferRequest, 'coinbase/client/models/broadcast_transfer_request'
 Coinbase::Client.autoload :BuildStakingOperationRequest, 'coinbase/client/models/build_staking_operation_request'
+Coinbase::Client.autoload :ContractEvent, 'coinbase/client/models/contract_event'
+Coinbase::Client.autoload :ContractEventList, 'coinbase/client/models/contract_event_list'
 Coinbase::Client.autoload :CreateAddressRequest, 'coinbase/client/models/create_address_request'
 Coinbase::Client.autoload :CreateServerSignerRequest, 'coinbase/client/models/create_server_signer_request'
+Coinbase::Client.autoload :CreateStakingOperationRequest, 'coinbase/client/models/create_staking_operation_request'
 Coinbase::Client.autoload :CreateTradeRequest, 'coinbase/client/models/create_trade_request'
 Coinbase::Client.autoload :CreateTransferRequest, 'coinbase/client/models/create_transfer_request'
 Coinbase::Client.autoload :CreateWalletRequest, 'coinbase/client/models/create_wallet_request'
 Coinbase::Client.autoload :CreateWalletRequestWallet, 'coinbase/client/models/create_wallet_request_wallet'
+Coinbase::Client.autoload :CreateWebhookRequest, 'coinbase/client/models/create_webhook_request'
 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'
@@ -62,16 +67,22 @@ Coinbase::Client.autoload :Transaction, 'coinbase/client/models/transaction'
 Coinbase::Client.autoload :TransactionType, 'coinbase/client/models/transaction_type'
 Coinbase::Client.autoload :Transfer, 'coinbase/client/models/transfer'
 Coinbase::Client.autoload :TransferList, 'coinbase/client/models/transfer_list'
+Coinbase::Client.autoload :UpdateWebhookRequest, 'coinbase/client/models/update_webhook_request'
 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 :Wallet, 'coinbase/client/models/wallet'
 Coinbase::Client.autoload :WalletList, 'coinbase/client/models/wallet_list'
+Coinbase::Client.autoload :Webhook, 'coinbase/client/models/webhook'
+Coinbase::Client.autoload :WebhookEventFilter, 'coinbase/client/models/webhook_event_filter'
+Coinbase::Client.autoload :WebhookEventType, 'coinbase/client/models/webhook_event_type'
+Coinbase::Client.autoload :WebhookList, 'coinbase/client/models/webhook_list'
 
 # APIs
 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 :ServerSignersApi, 'coinbase/client/api/server_signers_api'
 Coinbase::Client.autoload :StakeApi, 'coinbase/client/api/stake_api'
@@ -80,6 +91,7 @@ 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 :WalletsApi, 'coinbase/client/api/wallets_api'
+Coinbase::Client.autoload :WebhooksApi, 'coinbase/client/api/webhooks_api'
 
 module Coinbase::Client
   class << self

data/lib/coinbase/middleware.rb

@@ -3,6 +3,7 @@
 require_relative 'authenticator'
 require_relative 'client/configuration'
 require 'faraday'
+require 'faraday/retry'
 
 module Coinbase
   # A module for middleware that can be used with Faraday.
@@ -18,6 +19,17 @@ module Coinbase
         config.host = uri.host + (uri.port ? ":#{uri.port}" : '')
         config.scheme = uri.scheme if uri.scheme
         config.request(:authenticator)
+        retry_options = {
+          max: Coinbase.configuration.max_network_tries,
+          interval: 0.05,
+          interval_randomness: 0.5,
+          backoff_factor: 2,
+          methods: %i[get],
+          retry_statuses: [500, 502, 503, 504]
+        }
+        config.configure_faraday_connection do |conn|
+          conn.request :retry, retry_options
+        end
       end
     end
   end

data/lib/coinbase/staking_operation.rb

@@ -9,6 +9,67 @@ module Coinbase
   class StakingOperation
     attr_reader :transactions
 
+    # Builds an ephemeral staking operation this is intended to be called via an Address or Wallet.
+    # @param amount [BigDecimal] The amount to stake, in the primary denomination of the asset
+    # @param network_id [Symbol] The Network ID
+    # @param asset_id [Symbol] The Asset ID
+    # @param address_id [String] The Address ID
+    # @param action [Symbol] The action to perform
+    # @param mode [Symbol] The staking mode
+    # @param options [Hash] Additional options
+    # @return [Coinbase::StakingOperation] The staking operation
+    def self.build(amount, network_id, asset_id, address_id, action, mode, options)
+      model = Coinbase.call_api do
+        asset = Coinbase::Asset.fetch(network_id, asset_id)
+        stake_api.build_staking_operation(
+          {
+            asset_id: asset.primary_denomination.to_s,
+            address_id: address_id,
+            action: action,
+            network_id: Coinbase.normalize_network(network_id),
+            options: {
+              amount: asset.to_atomic_amount(amount).to_i.to_s,
+              mode: mode
+            }.merge(options)
+          }
+        )
+      end
+
+      new(model)
+    end
+
+    # Creates a persisted staking operation this is intended to be called via an Address or Wallet.
+    # @param amount [BigDecimal] The amount to stake, in the primary denomination of the asset
+    # @param network_id [Symbol] The Network ID
+    # @param asset_id [Symbol] The Asset ID
+    # @param address_id [String] The Address ID
+    # @param wallet_id [String] The Wallet ID
+    # @param action [Symbol] The action to perform
+    # @param mode [Symbol] The staking mode
+    # @param options [Hash] Additional options
+    # @return [Coinbase::StakingOperation] The staking operation
+    def self.create(amount, network_id, asset_id, address_id, wallet_id, action, mode, options)
+      model = Coinbase.call_api do
+        asset = Coinbase::Asset.fetch(network_id, asset_id)
+        stake_api.create_staking_operation(
+          wallet_id,
+          address_id,
+          {
+            asset_id: asset.primary_denomination.to_s,
+            address_id: address_id,
+            action: action,
+            network_id: Coinbase.normalize_network(network_id),
+            options: {
+              amount: asset.to_atomic_amount(amount).to_i.to_s,
+              mode: mode
+            }.merge(options)
+          }
+        )
+      end
+
+      new(model)
+    end
+
     # Returns a new StakingOperation object.
     # @param model [Coinbase::Client::StakingOperation] The underlying StakingOperation object
     def initialize(model)
@@ -39,6 +100,12 @@ module Coinbase
       @model.status
     end
 
+    # Returns the Wallet ID of the Staking Operation.
+    # @return [String] The Wallet ID
+    def wallet_id
+      @model.wallet_id
+    end
+
     # Waits until the Staking Operation is completed or failed by polling its status at the given interval. Raises a
     # Timeout::Error if the Staking Operation takes longer than the given timeout.
     # @param interval_seconds [Integer] The interval at which to poll, in seconds
@@ -66,13 +133,18 @@ module Coinbase
     # @param network_id [Symbol] The Network ID
     # @param address_id [Symbol] The Address ID
     # @param id [String] The ID of the StakingOperation
+    # @param wallet_id [String] The optional Wallet ID
     # @return [Coinbase::StakingOperation] The staking operation
-    def self.fetch(network_id, address_id, id)
+    def self.fetch(network_id, address_id, id, wallet_id: nil)
       staking_operation_model = Coinbase.call_api do
-        stake_api.get_external_staking_operation(network_id, address_id, id)
+        if wallet_id.nil?
+          stake_api.get_external_staking_operation(network_id, address_id, id)
+        else
+          stake_api.get_staking_operation(wallet_id, address_id, id)
+        end
       end
 
-      from_model(staking_operation_model)
+      new(staking_operation_model)
     end
 
     # Signs the Open Transactions with the provided key
@@ -87,7 +159,11 @@ module Coinbase
     # @return [Coinbase::StakingOperation] The updated staking operation
     def reload
       @model = Coinbase.call_api do
-        stake_api.get_external_staking_operation(network_id, address_id, id)
+        if wallet_id.nil?
+          stake_api.get_external_staking_operation(network_id, address_id, id)
+        else
+          stake_api.get_staking_operation(wallet_id, address_id, id)
+        end
       end
 
       from_model(@model)
@@ -108,10 +184,33 @@ module Coinbase
       signed_voluntary_exit_messages
     end
 
+    # Broadcasts the Staking Operation transactions to the network
+    # @return [Coinbase::StakingOperation]
+    def broadcast!
+      transactions.each_with_index do |transaction, i|
+        raise TransactionNotSignedError unless transaction.signed?
+
+        Coinbase.call_api do
+          stake_api.broadcast_staking_operation(
+            wallet_id,
+            address_id,
+            id,
+            { signed_payload: transaction.raw.hex, transaction_index: i }
+          )
+        end
+      end
+
+      self
+    end
+
+    def self.stake_api
+      Coinbase::Client::StakeApi.new(Coinbase.configuration.api_client)
+    end
+
     private
 
     def stake_api
-      @stake_api ||= Coinbase::Client::StakeApi.new(Coinbase.configuration.api_client)
+      @stake_api ||= self.class.stake_api
     end
 
     def from_model(model)
@@ -120,6 +219,8 @@ module Coinbase
       @transactions = model.transactions.map do |transaction_model|
         Transaction.new(transaction_model)
       end
+
+      self
     end
   end
 end

data/lib/coinbase/trade.rb

@@ -147,7 +147,7 @@ module Coinbase
 
       payloads = { signed_payload: transaction.raw.hex }
 
-      payloads[:approve_tx_signed_payload] = approve_transaction.raw.hex unless approve_transaction.nil?
+      payloads[:approve_transaction_signed_payload] = approve_transaction.raw.hex unless approve_transaction.nil?
 
       @model = Coinbase.call_api do
         trades_api.broadcast_trade(wallet_id, address_id, id, payloads)

data/lib/coinbase/transfer.rb

@@ -125,20 +125,19 @@ module Coinbase
     # Returns the link to the transaction on the blockchain explorer.
     # @return [String] The link to the transaction on the blockchain explorer
     def transaction_link
-      # TODO: Parameterize this by Network.
-      "https://sepolia.basescan.org/tx/#{transaction_hash}"
+      transaction.transaction_link
     end
 
     # Returns the Unsigned Payload of the Transfer.
     # @return [String] The Unsigned Payload
     def unsigned_payload
-      @model.unsigned_payload
+      transaction.unsigned_payload
     end
 
     # Returns the Signed Payload of the Transfer.
     # @return [String] The Signed Payload
     def signed_payload
-      @model.signed_payload
+      transaction.signed_payload
     end
 
     # Returns the Transfer transaction.
@@ -150,7 +149,7 @@ module Coinbase
     # Returns the Transaction Hash of the Transfer.
     # @return [String] The Transaction Hash
     def transaction_hash
-      @model.transaction_hash
+      transaction.transaction_hash
     end
 
     # Returns the status of the Transfer.

data/lib/coinbase/wallet.rb

@@ -294,6 +294,82 @@ module Coinbase
       default_address.trade(amount, from_asset_id, to_asset_id)
     end
 
+    # Stakes the given amount of the given Asset.
+    # Currently only the default_address is used to source the Stake.
+    # @param amount [Integer, Float, BigDecimal] The amount of the Asset to stake.
+    # @param asset_id [Symbol] The ID of the Asset to stake.
+    # @param mode [Symbol] (Optional) The staking mode. Defaults to :default.
+    # @param options [Hash] (Optional) Additional options for the staking operation.
+    # @return [Coinbase::StakingOperation] The stake operation
+    def stake(amount, asset_id, mode: :default, options: {})
+      default_address.stake(amount, asset_id, mode: mode, options: options)
+    end
+
+    # Unstakes the given amount of the given Asset.
+    # Currently only the default_address is used to source the Unstake.
+    # @param amount [Integer, Float, BigDecimal] The amount of the Asset to unstake.
+    # @param asset_id [Symbol] The ID of the Asset to unstake.
+    # @param mode [Symbol] (Optional) The staking mode. Defaults to :default.
+    # @param options [Hash] (Optional) Additional options for the unstaking operation.
+    # @return [Coinbase::StakingOperation] The unstake operation
+    def unstake(amount, asset_id, mode: :default, options: {})
+      default_address.unstake(amount, asset_id, mode: mode, options: options)
+    end
+
+    # Claims stake of the given amount of the given Asset.
+    # Currently only the default_address is used as the source for claim_stake.
+    # @param amount [Integer, Float, BigDecimal] The amount of the Asset to claim_stake.
+    # @param asset_id [Symbol] The ID of the Asset to claim_stake.
+    # @param mode [Symbol] (Optional) The staking mode. Defaults to :default.
+    # @param options [Hash] (Optional) Additional options for the unstaking operation.
+    # @return [Coinbase::StakingOperation] The claim_stake operation
+    def claim_stake(amount, asset_id, mode: :default, options: {})
+      default_address.claim_stake(amount, asset_id, mode: mode, options: options)
+    end
+
+    # Retrieves the balances used for staking for the supplied asset.
+    # Currently only the default_address is used to source the staking balances.
+    # @param asset_id [Symbol] The asset to retrieve staking balances for
+    # @param mode [Symbol] The staking mode. Defaults to :default.
+    # @param options [Hash] Additional options for the staking operation
+    # @return [Hash] The staking balances
+    # @return [BigDecimal] :stakeable_balance The amount of the asset that can be staked
+    # @return [BigDecimal] :unstakeable_balance The amount of the asset that is currently staked and cannot be unstaked
+    # @return [BigDecimal] :claimable_balance The amount of the asset that can be claimed
+    def staking_balances(asset_id, mode: :default, options: {})
+      default_address.staking_balances(asset_id, mode: mode, options: options)
+    end
+
+    # Retrieves the stakeable balance for the supplied asset.
+    # Currently only the default_address is used to source the stakeable balance.
+    # @param asset_id [Symbol] The asset to retrieve the stakeable balance for
+    # @param mode [Symbol] The staking mode. Defaults to :default.
+    # @param options [Hash] Additional options for the staking operation
+    # @return [BigDecimal] The stakeable balance
+    def stakeable_balance(asset_id, mode: :default, options: {})
+      default_address.stakeable_balance(asset_id, mode: mode, options: options)
+    end
+
+    # Retrieves the unstakeable balance for the supplied asset.
+    # Currently only the default_address is used to source the unstakeable balance.
+    # @param asset_id [Symbol] The asset to retrieve the unstakeable balance for
+    # @param mode [Symbol] The staking mode. Defaults to :default.
+    # @param options [Hash] Additional options for the staking operation
+    # @return [BigDecimal] The unstakeable balance
+    def unstakeable_balance(asset_id, mode: :default, options: {})
+      default_address.unstakeable_balance(asset_id, mode: mode, options: options)
+    end
+
+    # Retrieves the claimable balance for the supplied asset.
+    # Currently only the default_address is used to source the claimable balance.
+    # @param asset_id [Symbol] The asset to retrieve the claimable balance for
+    # @param mode [Symbol] The staking mode. Defaults to :default.
+    # @param options [Hash] Additional options for the staking operation
+    # @return [BigDecimal] The claimable balance
+    def claimable_balance(asset_id, mode: :default, options: {})
+      default_address.claimable_balance(asset_id, mode: mode, options: options)
+    end
+
     # Exports the Wallet's data to a Data object.
     # @return [Data] The Wallet data
     def export

data/lib/coinbase.rb

@@ -62,13 +62,14 @@ module Coinbase
 
   # Configuration object for the Coinbase SDK.
   class Configuration
-    attr_accessor :api_url, :api_key_name, :api_key_private_key, :debug_api, :use_server_signer
+    attr_accessor :api_url, :api_key_name, :api_key_private_key, :debug_api, :use_server_signer, :max_network_tries
 
     # Initializes the configuration object.
     def initialize
       @api_url = 'https://api.cdp.coinbase.com'
       @debug_api = false
       @use_server_signer = false
+      @max_network_tries = 3
     end
 
     # Sets configuration values based on the provided CDP API Key JSON file.