coinbase-sdk 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2313a5ef68b35c37a63761a05e180c114334fbf0d66c1999b1be04c065a50c64
-  data.tar.gz: 0ebbb9e277b58368ed608dd91a626016e7cfd51888b9b29d28315546e5c6a09a
+  metadata.gz: eb84cbd1ab8caed73d5f13f149f99b93d002a680c767e8787dbc6f60fd72f7da
+  data.tar.gz: ec856cae3c68d140f162abb3566131cf8cc620927f539c7d8dbb090a9802d2a5
 SHA512:
-  metadata.gz: a9224a29e1cb866c16acca444cf99b06dcb35086aa2f0ff9503e786f42d9dd7c5a6b3a74259689b1f139d93c6cccb8bc8b762ec3578f38d43289e34406dbf3d4
-  data.tar.gz: 8a6ee67daf8eb6fdcd8fda7d2333f09307c00c2c19b675a401a951cd6a56f2b73918e80c4e99e5d09c7d2d6767c558c44503e0e5b6be6dc88cf095ef4bcb332e
+  metadata.gz: 853736276f36210c32c051ebee8583f1596ce88eddb2e3b107a60fa78d3cfd34cf1b14ca05f30db464b5b4a418225e7af10129640c1830f22c38250ec2f64b54
+  data.tar.gz: 685826f02959985e2a36132db985f040588239936dc25df57f352ed38b8c5204e7ea67e6ef8f0b5695e2a03f7a0268bbb7ec3861efb795c99f543957f63c2b59

data/lib/coinbase/address/wallet_address.rb

@@ -155,6 +155,50 @@ module Coinbase
       smart_contract
     end
 
+    # Deploys a new ERC721 NFT contract with the given name, symbol, and base URI.
+    # @param name [String] The name of the NFT contract.
+    # @param symbol [String] The symbol of the NFT contract.
+    # @param base_uri [String] The base URI for the NFT contract.
+    # @return [Coinbase::SmartContract] The deployed NFT contract.
+    # @raise [AddressCannotSignError] if the Address does not have a private key backing it.
+    def deploy_nft(name:, symbol:, base_uri:)
+      ensure_can_sign!
+
+      smart_contract = SmartContract.create_nft_contract(
+        address_id: id,
+        wallet_id: wallet_id,
+        name: name,
+        symbol: symbol,
+        base_uri: base_uri
+      )
+
+      return smart_contract if Coinbase.use_server_signer?
+
+      smart_contract.sign(@key)
+      smart_contract.deploy!
+      smart_contract
+    end
+
+    # Deploys a new ERC1155 multi-token contract with the given URI.
+    # @param uri [String] The URI for the token metadata, where {id} will be replaced with the token ID.
+    # @return [Coinbase::SmartContract] The deployed multi-token contract.
+    # @raise [AddressCannotSignError] if the Address does not have a private key backing it.
+    def deploy_multi_token(uri:)
+      ensure_can_sign!
+
+      smart_contract = SmartContract.create_multi_token_contract(
+        address_id: id,
+        wallet_id: wallet_id,
+        uri: uri
+      )
+
+      return smart_contract if Coinbase.use_server_signer?
+
+      smart_contract.sign(@key)
+      smart_contract.deploy!
+      smart_contract
+    end
+
     # Signs the given unsigned payload.
     # @param unsigned_payload [String] The hex-encoded hashed unsigned payload for the Address to sign.
     # @return [Coinbase::PayloadSignature] The payload signature

data/lib/coinbase/address.rb

@@ -252,6 +252,10 @@ module Coinbase
       @balance_history_api ||= Coinbase::Client::BalanceHistoryApi.new(Coinbase.configuration.api_client)
     end
 
+    def transaction_history_api
+      @transaction_history_api ||= Coinbase::Client::TransactionHistoryApi.new(Coinbase.configuration.api_client)
+    end
+
     def stake_api
       @stake_api ||= Coinbase::Client::StakeApi.new(Coinbase.configuration.api_client)
     end
@@ -266,7 +270,7 @@ module Coinbase
     end
 
     def list_transaction_page(page)
-      addresses_api.list_address_transactions(
+      transaction_history_api.list_address_transactions(
         network.normalized_id,
         id,
         { limit: DEFAULT_TRANSACTION_PAGE_LIMIT, page: page }

data/lib/coinbase/client/api/external_addresses_api.rb

@@ -94,85 +94,6 @@ module Coinbase::Client
       return data, status_code, headers
     end
 
-    # List transactions for an address.
-    # List all transactions that interact with the address.
-    # @param network_id [String] The ID of the blockchain network
-    # @param address_id [String] The ID of the address to fetch the transactions for.
-    # @param [Hash] opts the optional parameters
-    # @option opts [Integer] :limit A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
-    # @option opts [String] :page A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
-    # @return [AddressTransactionList]
-    def list_address_transactions(network_id, address_id, opts = {})
-      data, _status_code, _headers = list_address_transactions_with_http_info(network_id, address_id, opts)
-      data
-    end
-
-    # List transactions for an address.
-    # List all transactions that interact with the address.
-    # @param network_id [String] The ID of the blockchain network
-    # @param address_id [String] The ID of the address to fetch the transactions for.
-    # @param [Hash] opts the optional parameters
-    # @option opts [Integer] :limit A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
-    # @option opts [String] :page A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
-    # @return [Array<(AddressTransactionList, Integer, Hash)>] AddressTransactionList data, response status code and response headers
-    def list_address_transactions_with_http_info(network_id, address_id, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: ExternalAddressesApi.list_address_transactions ...'
-      end
-      # verify the required parameter 'network_id' is set
-      if @api_client.config.client_side_validation && network_id.nil?
-        fail ArgumentError, "Missing the required parameter 'network_id' when calling ExternalAddressesApi.list_address_transactions"
-      end
-      # verify the required parameter 'address_id' is set
-      if @api_client.config.client_side_validation && address_id.nil?
-        fail ArgumentError, "Missing the required parameter 'address_id' when calling ExternalAddressesApi.list_address_transactions"
-      end
-      if @api_client.config.client_side_validation && !opts[:'page'].nil? && opts[:'page'].to_s.length > 5000
-        fail ArgumentError, 'invalid value for "opts[:"page"]" when calling ExternalAddressesApi.list_address_transactions, the character length must be smaller than or equal to 5000.'
-      end
-
-      # resource path
-      local_var_path = '/v1/networks/{network_id}/addresses/{address_id}/transactions'.sub('{' + 'network_id' + '}', CGI.escape(network_id.to_s)).sub('{' + 'address_id' + '}', CGI.escape(address_id.to_s))
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
-      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'AddressTransactionList'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || []
-
-      new_options = opts.merge(
-        :operation => :"ExternalAddressesApi.list_address_transactions",
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: ExternalAddressesApi#list_address_transactions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
     # Get the balances of an external address
     # List all of the balances of an external address
     # @param network_id [String] The ID of the blockchain network

data/lib/coinbase/client/api/transaction_history_api.rb

@@ -0,0 +1,101 @@
+=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
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.8.0
+
+=end
+
+require 'cgi'
+
+module Coinbase::Client
+  class TransactionHistoryApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # List transactions for an address.
+    # List all transactions that interact with the address.
+    # @param network_id [String] The ID of the blockchain network
+    # @param address_id [String] The ID of the address to fetch the transactions for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
+    # @option opts [String] :page A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
+    # @return [AddressTransactionList]
+    def list_address_transactions(network_id, address_id, opts = {})
+      data, _status_code, _headers = list_address_transactions_with_http_info(network_id, address_id, opts)
+      data
+    end
+
+    # List transactions for an address.
+    # List all transactions that interact with the address.
+    # @param network_id [String] The ID of the blockchain network
+    # @param address_id [String] The ID of the address to fetch the transactions for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
+    # @option opts [String] :page A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
+    # @return [Array<(AddressTransactionList, Integer, Hash)>] AddressTransactionList data, response status code and response headers
+    def list_address_transactions_with_http_info(network_id, address_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TransactionHistoryApi.list_address_transactions ...'
+      end
+      # verify the required parameter 'network_id' is set
+      if @api_client.config.client_side_validation && network_id.nil?
+        fail ArgumentError, "Missing the required parameter 'network_id' when calling TransactionHistoryApi.list_address_transactions"
+      end
+      # verify the required parameter 'address_id' is set
+      if @api_client.config.client_side_validation && address_id.nil?
+        fail ArgumentError, "Missing the required parameter 'address_id' when calling TransactionHistoryApi.list_address_transactions"
+      end
+      if @api_client.config.client_side_validation && !opts[:'page'].nil? && opts[:'page'].to_s.length > 5000
+        fail ArgumentError, 'invalid value for "opts[:"page"]" when calling TransactionHistoryApi.list_address_transactions, the character length must be smaller than or equal to 5000.'
+      end
+
+      # resource path
+      local_var_path = '/v1/networks/{network_id}/addresses/{address_id}/transactions'.sub('{' + 'network_id' + '}', CGI.escape(network_id.to_s)).sub('{' + 'address_id' + '}', CGI.escape(address_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AddressTransactionList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"TransactionHistoryApi.list_address_transactions",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TransactionHistoryApi#list_address_transactions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/coinbase/client/api/webhooks_api.rb

@@ -19,6 +19,76 @@ module Coinbase::Client
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # Create a new webhook scoped to a wallet
+    # Create a new webhook scoped to a wallet
+    # @param wallet_id [String] The ID of the wallet to create the webhook for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [CreateWalletWebhookRequest] :create_wallet_webhook_request
+    # @return [Webhook]
+    def create_wallet_webhook(wallet_id, opts = {})
+      data, _status_code, _headers = create_wallet_webhook_with_http_info(wallet_id, opts)
+      data
+    end
+
+    # Create a new webhook scoped to a wallet
+    # Create a new webhook scoped to a wallet
+    # @param wallet_id [String] The ID of the wallet to create the webhook for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [CreateWalletWebhookRequest] :create_wallet_webhook_request
+    # @return [Array<(Webhook, Integer, Hash)>] Webhook data, response status code and response headers
+    def create_wallet_webhook_with_http_info(wallet_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WebhooksApi.create_wallet_webhook ...'
+      end
+      # verify the required parameter 'wallet_id' is set
+      if @api_client.config.client_side_validation && wallet_id.nil?
+        fail ArgumentError, "Missing the required parameter 'wallet_id' when calling WebhooksApi.create_wallet_webhook"
+      end
+      # resource path
+      local_var_path = '/v1/wallets/{wallet_id}/webhooks'.sub('{' + 'wallet_id' + '}', CGI.escape(wallet_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+        header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'create_wallet_webhook_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Webhook'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"WebhooksApi.create_wallet_webhook",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WebhooksApi#create_wallet_webhook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create a new webhook
     # Create a new webhook
     # @param [Hash] opts the optional parameters
@@ -51,7 +121,7 @@ module Coinbase::Client
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
-          header_params['Content-Type'] = content_type
+        header_params['Content-Type'] = content_type
       end
 
       # form parameters
@@ -251,7 +321,7 @@ module Coinbase::Client
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
-          header_params['Content-Type'] = content_type
+        header_params['Content-Type'] = content_type
       end
 
       # form parameters

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

@@ -0,0 +1,232 @@
+=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
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.8.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Coinbase::Client
+  class CreateWalletWebhookRequest
+    # The URL to which the notifications will be sent
+    attr_accessor :notification_uri
+
+    # The custom header to be used for x-webhook-signature header on callbacks, so developers can verify the requests are coming from Coinbase.
+    attr_accessor :signature_header
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'notification_uri' => :'notification_uri',
+        :'signature_header' => :'signature_header'
+      }
+    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
+      {
+        :'notification_uri' => :'String',
+        :'signature_header' => :'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::CreateWalletWebhookRequest` 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::CreateWalletWebhookRequest`. 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?(:'notification_uri')
+        self.notification_uri = attributes[:'notification_uri']
+      else
+        self.notification_uri = nil
+      end
+
+      if attributes.key?(:'signature_header')
+        self.signature_header = attributes[:'signature_header']
+      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 @notification_uri.nil?
+        invalid_properties.push('invalid value for "notification_uri", notification_uri 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 @notification_uri.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 &&
+          notification_uri == o.notification_uri &&
+          signature_header == o.signature_header
+    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
+      [notification_uri, signature_header].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/models/multi_token_contract_options.rb

@@ -0,0 +1,223 @@
+=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
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.8.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Coinbase::Client
+  # Options for multi-token contract creation
+  class MultiTokenContractOptions
+    # The URI for all token metadata
+    attr_accessor :uri
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'uri' => :'uri'
+      }
+    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
+      {
+        :'uri' => :'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::MultiTokenContractOptions` 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::MultiTokenContractOptions`. 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?(:'uri')
+        self.uri = attributes[:'uri']
+      else
+        self.uri = nil
+      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 @uri.nil?
+        invalid_properties.push('invalid value for "uri", uri 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 @uri.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 &&
+          uri == o.uri
+    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
+      [uri].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/models/network_identifier.rb

@@ -21,11 +21,12 @@ module Coinbase::Client
     ETHEREUM_MAINNET = "ethereum-mainnet".freeze
     POLYGON_MAINNET = "polygon-mainnet".freeze
     SOLANA_DEVNET = "solana-devnet".freeze
+    SOLANA_MAINNET = "solana-mainnet".freeze
     ARBITRUM_MAINNET = "arbitrum-mainnet".freeze
     UNKNOWN_DEFAULT_OPEN_API = "unknown_default_open_api".freeze
 
     def self.all_vars
-      @all_vars ||= [BASE_SEPOLIA, BASE_MAINNET, ETHEREUM_HOLESKY, ETHEREUM_MAINNET, POLYGON_MAINNET, SOLANA_DEVNET, ARBITRUM_MAINNET, UNKNOWN_DEFAULT_OPEN_API].freeze
+      @all_vars ||= [BASE_SEPOLIA, BASE_MAINNET, ETHEREUM_HOLESKY, ETHEREUM_MAINNET, POLYGON_MAINNET, SOLANA_DEVNET, SOLANA_MAINNET, ARBITRUM_MAINNET, UNKNOWN_DEFAULT_OPEN_API].freeze
     end
 
     # Builds the enum from string

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

@@ -22,11 +22,15 @@ module Coinbase::Client
     # The symbol of the NFT
     attr_accessor :symbol
 
+    # The base URI for the NFT metadata
+    attr_accessor :base_uri
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'name' => :'name',
-        :'symbol' => :'symbol'
+        :'symbol' => :'symbol',
+        :'base_uri' => :'base_uri'
       }
     end
 
@@ -39,7 +43,8 @@ module Coinbase::Client
     def self.openapi_types
       {
         :'name' => :'String',
-        :'symbol' => :'String'
+        :'symbol' => :'String',
+        :'base_uri' => :'String'
       }
     end
 
@@ -75,6 +80,12 @@ module Coinbase::Client
       else
         self.symbol = nil
       end
+
+      if attributes.key?(:'base_uri')
+        self.base_uri = attributes[:'base_uri']
+      else
+        self.base_uri = nil
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -90,6 +101,10 @@ module Coinbase::Client
         invalid_properties.push('invalid value for "symbol", symbol cannot be nil.')
       end
 
+      if @base_uri.nil?
+        invalid_properties.push('invalid value for "base_uri", base_uri cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -99,6 +114,7 @@ module Coinbase::Client
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @name.nil?
       return false if @symbol.nil?
+      return false if @base_uri.nil?
       true
     end
 
@@ -108,7 +124,8 @@ module Coinbase::Client
       return true if self.equal?(o)
       self.class == o.class &&
           name == o.name &&
-          symbol == o.symbol
+          symbol == o.symbol &&
+          base_uri == o.base_uri
     end
 
     # @see the `==` method
@@ -120,7 +137,7 @@ module Coinbase::Client
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [name, symbol].hash
+      [name, symbol, base_uri].hash
     end
 
     # Builds the object from hash

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

@@ -20,6 +20,7 @@ module Coinbase::Client
       # List of class defined in oneOf (OpenAPI v3)
       def openapi_one_of
         [
+          :'MultiTokenContractOptions',
           :'NFTContractOptions',
           :'TokenContractOptions'
         ]

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

@@ -17,10 +17,11 @@ module Coinbase::Client
   class SmartContractType
     ERC20 = "erc20".freeze
     ERC721 = "erc721".freeze
+    ERC1155 = "erc1155".freeze
     UNKNOWN_DEFAULT_OPEN_API = "unknown_default_open_api".freeze
 
     def self.all_vars
-      @all_vars ||= [ERC20, ERC721, UNKNOWN_DEFAULT_OPEN_API].freeze
+      @all_vars ||= [ERC20, ERC721, ERC1155, UNKNOWN_DEFAULT_OPEN_API].freeze
     end
 
     # Builds the enum from string

data/lib/coinbase/client.rb

@@ -60,6 +60,7 @@ Coinbase::Client.autoload :FetchStakingRewards200Response, 'coinbase/client/mode
 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 :HistoricalBalance, 'coinbase/client/models/historical_balance'
+Coinbase::Client.autoload :MultiTokenContractOptions, 'coinbase/client/models/multi_token_contract_options'
 Coinbase::Client.autoload :NFTContractOptions, 'coinbase/client/models/nft_contract_options'
 Coinbase::Client.autoload :Network, 'coinbase/client/models/network'
 Coinbase::Client.autoload :NetworkIdentifier, 'coinbase/client/models/network_identifier'
@@ -123,6 +124,7 @@ Coinbase::Client.autoload :ServerSignersApi, 'coinbase/client/api/server_signers
 Coinbase::Client.autoload :SmartContractsApi, 'coinbase/client/api/smart_contracts_api'
 Coinbase::Client.autoload :StakeApi, 'coinbase/client/api/stake_api'
 Coinbase::Client.autoload :TradesApi, 'coinbase/client/api/trades_api'
+Coinbase::Client.autoload :TransactionHistoryApi, 'coinbase/client/api/transaction_history_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'

data/lib/coinbase/smart_contract.rb

@@ -72,6 +72,60 @@ module Coinbase
       new(contract)
     end
 
+    # Creates a new ERC721 token contract, that can subsequently be deployed to
+    # the blockchain.
+    # @param address_id [String] The address ID of deployer
+    # @param wallet_id [String] The wallet ID of the deployer
+    # @param name [String] The name of the token
+    # @param symbol [String] The symbol of the token
+    # @param base_uri [String] The base URI for the token metadata
+    # @return [SmartContract] The new ERC721 Token SmartContract object
+    def self.create_nft_contract(
+      address_id:,
+      wallet_id:,
+      name:,
+      symbol:,
+      base_uri:
+    )
+      contract = Coinbase.call_api do
+        smart_contracts_api.create_smart_contract(
+          wallet_id,
+          address_id,
+          {
+            type: Coinbase::Client::SmartContractType::ERC721,
+            options: Coinbase::Client::NFTContractOptions.new(
+              name: name,
+              symbol: symbol,
+              base_uri: base_uri
+            ).to_body
+          }
+        )
+      end
+
+      new(contract)
+    end
+
+    def self.create_multi_token_contract(
+      address_id:,
+      wallet_id:,
+      uri:
+    )
+      contract = Coinbase.call_api do
+        smart_contracts_api.create_smart_contract(
+          wallet_id,
+          address_id,
+          {
+            type: Coinbase::Client::SmartContractType::ERC1155,
+            options: Coinbase::Client::MultiTokenContractOptions.new(
+              uri: uri
+            ).to_body
+          }
+        )
+      end
+
+      new(contract)
+    end
+
     def self.contract_events_api
       Coinbase::Client::ContractEventsApi.new(Coinbase.configuration.api_client)
     end

data/lib/coinbase/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Coinbase
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
 end

data/lib/coinbase/wallet.rb

@@ -244,9 +244,23 @@ module Coinbase
     # @return [Coinbase::SmartContract] The deployed token contract.
     # @raise [AddressCannotSignError] if the Address does not have a private key backing it.
 
+    # @!method deploy_nft
+    # Deploys a new ERC721 NFT contract with the given name, symbol, and base URI.
+    # @param name [String] The name of the NFT contract.
+    # @param symbol [String] The symbol of the NFT contract.
+    # @param base_uri [String] The base URI for the NFT contract.
+    # @return [Coinbase::SmartContract] The deployed NFT contract.
+    # @raise [AddressCannotSignError] if the Address does not have a private key backing it.
+
+    # @!method deploy_multi_token
+    # Deploys a new ERC1155 multi-token contract with the given URI.
+    # @param uri [String] The URI for the token metadata, where {id} will be replaced with the token ID.
+    # @return [Coinbase::SmartContract] The deployed multi-token contract.
+    # @raise [AddressCannotSignError] if the Address does not have a private key backing it.
+
     def_delegators :default_address, :transfer, :trade, :faucet, :stake, :unstake, :claim_stake, :staking_balances,
                    :stakeable_balance, :unstakeable_balance, :claimable_balance, :sign_payload, :invoke_contract,
-                   :deploy_token
+                   :deploy_token, :deploy_nft, :deploy_multi_token
 
     # Returns the addresses belonging to the Wallet.
     # @return [Array<Coinbase::WalletAddress>] The addresses belonging to the Wallet
@@ -468,6 +482,22 @@ module Coinbase
       "Successfully loaded seed for wallet #{id} from #{file_path}."
     end
 
+    # Creates a new webhook on the current wallet for tracking wallet activity events.
+    #
+    # @param notification_uri [String] The URI to which the webhook notifications will be sent.
+    #
+    # @return [Coinbase::Client::Webhook] The newly created webhook instance.
+    def create_webhook(notification_uri:)
+      Coinbase.call_api do
+        webhooks_api.create_wallet_webhook(
+          id,
+          create_wallet_webhook_request: {
+            notification_uri: notification_uri
+          }
+        )
+      end
+    end
+
     # Returns a String representation of the Wallet.
     # @return [String] a String representation of the Wallet
     def to_s
@@ -592,6 +622,10 @@ module Coinbase
       @wallets_api ||= Coinbase::Client::WalletsApi.new(Coinbase.configuration.api_client)
     end
 
+    def webhooks_api
+      @webhooks_api ||= Coinbase::Client::WebhooksApi.new(Coinbase.configuration.api_client)
+    end
+
     def set_addresses
       address_list = Coinbase.call_api do
         addresses_api.list_addresses(@model.id, { limit: MAX_ADDRESSES })

data/lib/coinbase/webhook.rb

@@ -22,8 +22,6 @@ module Coinbase
       # @param event_filters [Array<Hash>] Filters applied to the events that determine
       #   which specific events trigger the webhook. Each filter should be a hash that
       #   can include keys like `contract_address`, `from_address`, or `to_address`.
-      # @param signature_header [String] The custom header to be used for x-webhook-signature header on callbacks,
-      #   so developers can verify the requests are coming from Coinbase.
       # @return [Coinbase::Webhook] A new instance of Webhook.
       #
       # @example Create a new webhook
@@ -31,18 +29,16 @@ module Coinbase
       #     network_id: :ethereum_mainnet,
       #     notification_uri: 'https://example.com/callback',
       #     event_type: 'transaction',
-      #     event_filters: [{ 'contract_address' => '0x...', 'from_address' => '0x...', 'to_address' => '0x...' }],
-      #     signature_header: 'example_header'
+      #     event_filters: [{ 'contract_address' => '0x...', 'from_address' => '0x...', 'to_address' => '0x...' }]
       #   )
-      def create(network_id:, notification_uri:, event_type:, event_filters:, signature_header: '')
+      def create(network_id:, notification_uri:, event_type:, event_filters:)
         model = Coinbase.call_api do
           webhooks_api.create_webhook(
             create_webhook_request: {
               network_id: Coinbase.normalize_network(network_id),
               notification_uri: notification_uri,
               event_type: event_type,
-              event_filters: event_filters,
-              signature_header: signature_header
+              event_filters: event_filters
             }
           )
         end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: coinbase-sdk
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Yuga Cohler
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-09-18 00:00:00.000000000 Z
+date: 2024-09-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -288,6 +288,7 @@ files:
 - lib/coinbase/client/api/smart_contracts_api.rb
 - lib/coinbase/client/api/stake_api.rb
 - lib/coinbase/client/api/trades_api.rb
+- lib/coinbase/client/api/transaction_history_api.rb
 - lib/coinbase/client/api/transfers_api.rb
 - lib/coinbase/client/api/users_api.rb
 - lib/coinbase/client/api/validators_api.rb
@@ -323,6 +324,7 @@ files:
 - lib/coinbase/client/models/create_transfer_request.rb
 - lib/coinbase/client/models/create_wallet_request.rb
 - lib/coinbase/client/models/create_wallet_request_wallet.rb
+- lib/coinbase/client/models/create_wallet_webhook_request.rb
 - lib/coinbase/client/models/create_webhook_request.rb
 - lib/coinbase/client/models/deploy_smart_contract_request.rb
 - lib/coinbase/client/models/erc20_transfer_event.rb
@@ -334,13 +336,13 @@ files:
 - lib/coinbase/client/models/ethereum_transaction_flattened_trace.rb
 - lib/coinbase/client/models/ethereum_validator_metadata.rb
 - lib/coinbase/client/models/faucet_transaction.rb
-- lib/coinbase/client/models/feature.rb
 - lib/coinbase/client/models/feature_set.rb
 - lib/coinbase/client/models/fetch_historical_staking_balances200_response.rb
 - lib/coinbase/client/models/fetch_staking_rewards200_response.rb
 - lib/coinbase/client/models/fetch_staking_rewards_request.rb
 - lib/coinbase/client/models/get_staking_context_request.rb
 - lib/coinbase/client/models/historical_balance.rb
+- lib/coinbase/client/models/multi_token_contract_options.rb
 - lib/coinbase/client/models/network.rb
 - lib/coinbase/client/models/network_identifier.rb
 - lib/coinbase/client/models/nft_contract_options.rb

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

@@ -1,43 +0,0 @@
-=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 Feature
-    TRANSFER = "transfer".freeze
-    TRADE = "trade".freeze
-    FAUCET = "faucet".freeze
-    SERVER_SIGNER = "server_signer".freeze
-    UNKNOWN_DEFAULT_OPEN_API = "unknown_default_open_api".freeze
-
-    def self.all_vars
-      @all_vars ||= [TRANSFER, TRADE, FAUCET, SERVER_SIGNER, UNKNOWN_DEFAULT_OPEN_API].freeze
-    end
-
-    # Builds the enum from string
-    # @param [String] The enum value in the form of the string
-    # @return [String] The enum value
-    def self.build_from_hash(value)
-      new.build_from_hash(value)
-    end
-
-    # Builds the enum from string
-    # @param [String] The enum value in the form of the string
-    # @return [String] The enum value
-    def build_from_hash(value)
-      return value if Feature.all_vars.include?(value)
-      raise "Invalid ENUM value #{value} for class #Feature"
-    end
-  end
-end