coinbase-sdk 0.2.0 → 0.3.0

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

@@ -4,7 +4,7 @@
 #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
 

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

@@ -4,7 +4,7 @@
 #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
 

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

@@ -4,7 +4,7 @@
 #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
 

data/lib/coinbase/client/version.rb

@@ -4,7 +4,7 @@
 #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
 

data/lib/coinbase/client.rb

@@ -4,7 +4,7 @@
 #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
 
@@ -21,15 +21,21 @@ 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 :AddressTransactionList, 'coinbase/client/models/address_transaction_list'
 Coinbase::Client.autoload :Asset, 'coinbase/client/models/asset'
 Coinbase::Client.autoload :Balance, 'coinbase/client/models/balance'
+Coinbase::Client.autoload :BroadcastContractInvocationRequest, 'coinbase/client/models/broadcast_contract_invocation_request'
 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 :ContractInvocation, 'coinbase/client/models/contract_invocation'
+Coinbase::Client.autoload :ContractInvocationList, 'coinbase/client/models/contract_invocation_list'
 Coinbase::Client.autoload :CreateAddressRequest, 'coinbase/client/models/create_address_request'
+Coinbase::Client.autoload :CreateContractInvocationRequest, 'coinbase/client/models/create_contract_invocation_request'
+Coinbase::Client.autoload :CreatePayloadSignatureRequest, 'coinbase/client/models/create_payload_signature_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'
@@ -38,6 +44,10 @@ Coinbase::Client.autoload :CreateWalletRequest, 'coinbase/client/models/create_w
 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 :EthereumTransaction, 'coinbase/client/models/ethereum_transaction'
+Coinbase::Client.autoload :EthereumTransactionAccess, 'coinbase/client/models/ethereum_transaction_access'
+Coinbase::Client.autoload :EthereumTransactionAccessList, 'coinbase/client/models/ethereum_transaction_access_list'
+Coinbase::Client.autoload :EthereumTransactionFlattenedTrace, 'coinbase/client/models/ethereum_transaction_flattened_trace'
 Coinbase::Client.autoload :EthereumValidatorMetadata, 'coinbase/client/models/ethereum_validator_metadata'
 Coinbase::Client.autoload :FaucetTransaction, 'coinbase/client/models/faucet_transaction'
 Coinbase::Client.autoload :FeatureSet, 'coinbase/client/models/feature_set'
@@ -48,6 +58,8 @@ Coinbase::Client.autoload :GetStakingContextRequest, 'coinbase/client/models/get
 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 :PayloadSignature, 'coinbase/client/models/payload_signature'
+Coinbase::Client.autoload :PayloadSignatureList, 'coinbase/client/models/payload_signature_list'
 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'
@@ -70,6 +82,7 @@ Coinbase::Client.autoload :StakingRewardUSDValue, 'coinbase/client/models/stakin
 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'
+Coinbase::Client.autoload :TransactionContent, 'coinbase/client/models/transaction_content'
 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'
@@ -90,6 +103,7 @@ Coinbase::Client.autoload :WebhookList, 'coinbase/client/models/webhook_list'
 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 :ContractInvocationsApi, 'coinbase/client/api/contract_invocations_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'

data/lib/coinbase/constants.rb

@@ -9,4 +9,7 @@ module Coinbase
 
   # The default page limit for paginated API requests.
   DEFAULT_PAGE_LIMIT = 100
+
+  # The default page limit for transaction paginated API request.
+  DEFAULT_TRANSACTION_PAGE_LIMIT = 10
 end

data/lib/coinbase/contract_invocation.rb

@@ -0,0 +1,234 @@
+# frozen_string_literal: true
+
+module Coinbase
+  # A representation of a Contract Invocation.
+  class ContractInvocation
+    class << self
+      # Creates a new ContractInvocation object.
+      # @param address_id [String] The Address ID of the signing Address
+      # @param wallet_id [String] The Wallet ID associated with the signing Address
+      # @param contract_address [String] The contract address
+      # @param abi [Array<Hash>] The contract ABI
+      # @param method [String] The contract method
+      # @param args [Hash] The arguments to pass to the contract method.
+      #   The keys should be the argument names, and the values should be the argument values.
+      # @return [ContractInvocation] The new Contract Invocation object
+      # @raise [Coinbase::ApiError] If the request to create the Contract Invocation fails
+      def create(
+        address_id:,
+        wallet_id:,
+        contract_address:,
+        abi:,
+        method:,
+        args: {}
+      )
+        model = Coinbase.call_api do
+          contract_invocation_api.create_contract_invocation(
+            wallet_id,
+            address_id,
+            contract_address: contract_address,
+            abi: abi.to_json,
+            method: method,
+            args: args.to_json
+          )
+        end
+
+        new(model)
+      end
+
+      # Enumerates the payload signatures for a given address belonging to a wallet.
+      # The result is an enumerator that lazily fetches from the server, and can be iterated over,
+      # converted an array, etc...
+      # @return [Enumerable<Coinbase::ContractInvocation>] Enumerator that returns payload signatures
+      def list(wallet_id:, address_id:)
+        Coinbase::Pagination.enumerate(
+          ->(page) { fetch_page(wallet_id, address_id, page) }
+        ) do |contract_invocation|
+          new(contract_invocation)
+        end
+      end
+
+      private
+
+      def contract_invocation_api
+        Coinbase::Client::ContractInvocationsApi.new(Coinbase.configuration.api_client)
+      end
+
+      def fetch_page(wallet_id, address_id, page)
+        contract_invocation_api.list_contract_invocations(
+          wallet_id,
+          address_id,
+          limit: DEFAULT_PAGE_LIMIT,
+          page: page
+        )
+      end
+    end
+
+    # Returns a new ContractInvocation object. Do not use this method directly.
+    # Instead use Coinbase::ContractInvocation.create.
+    # @param model [Coinbase::Client::ContractInvocation] The underlying Contract Invocation obejct
+    def initialize(model)
+      raise unless model.is_a?(Coinbase::Client::ContractInvocation)
+
+      @model = model
+    end
+
+    # Returns the Contract Invocation ID.
+    # @return [String] The Contract Invocation ID
+    def id
+      @model.contract_invocation_id
+    end
+
+    # Returns the Wallet ID of the Contract Invocation.
+    # @return [String] The Wallet ID
+    def wallet_id
+      @model.wallet_id
+    end
+
+    # Returns the Address ID of the Contract Invocation.
+    # @return [String] The Address ID
+    def address_id
+      @model.address_id
+    end
+
+    # Returns the Network of the Contract Invocation.
+    # @return [Coinbase::Network] The Network
+    def network
+      @network ||= Coinbase::Network.from_id(@model.network_id)
+    end
+
+    # Returns the Contract Address of the Contract Invocation.
+    # @return [String] The Contract Address
+    def contract_address
+      @model.contract_address
+    end
+
+    # Returns the ABI of the Contract Invocation.
+    # @return [Array<Hash>] The ABI
+    def abi
+      JSON.parse(@model.abi)
+    end
+
+    # Returns the method of the Contract Invocation.
+    # @return [String] The method
+    def method
+      @model.method
+    end
+
+    # Returns the arguments of the Contract Invocation.
+    # @return [Hash] The arguments
+    def args
+      JSON.parse(@model.args).transform_keys(&:to_sym)
+    end
+
+    # Returns the transaction.
+    # @return [Coinbase::Transaction] The Transfer transaction
+    def transaction
+      @transaction ||= Coinbase::Transaction.new(@model.transaction)
+    end
+
+    # Returns the status of the Contract Invocation.
+    # @return [String] The status
+    def status
+      transaction.status
+    end
+
+    # Signs the Contract Invocation transaction with the given key.
+    # This is required before broadcasting the Contract Invocation when not using
+    # a Server-Signer.
+    # @param key [Eth::Key] The key to sign the ContractInvocation with
+    # @raise [RuntimeError] If the key is not an Eth::Key
+    # @return [ContractInvocation] The ContractInvocation object
+    def sign(key)
+      raise unless key.is_a?(Eth::Key)
+
+      transaction.sign(key)
+
+      self
+    end
+
+    # Broadcasts the ContractInvocation to the Network.
+    # @raise [RuntimeError] If the ContractInvocation is not signed
+    # @return [ContractInvocation] The ContractInvocation object
+    def broadcast!
+      raise TransactionNotSignedError unless transaction.signed?
+
+      @model = Coinbase.call_api do
+        contract_invocation_api.broadcast_contract_invocation(
+          wallet_id,
+          address_id,
+          id,
+          { signed_payload: transaction.signature }
+        )
+      end
+
+      @transaction = Coinbase::Transaction.new(@model.transaction)
+
+      self
+    end
+
+    # # Reload reloads the Contract Invocation model with the latest version from the server side.
+    # @return [ContractInvocation] The most recent version of Contract Invocation from the server
+    def reload
+      @model = Coinbase.call_api do
+        contract_invocation_api.get_contract_invocation(wallet_id, address_id, id)
+      end
+
+      @transaction = Coinbase::Transaction.new(@model.transaction)
+
+      self
+    end
+
+    # Waits until the Contract Invocation is signed or failed by polling the server at the given interval. Raises a
+    # Timeout::Error if the Contract Invocation takes longer than the given timeout.
+    # @param interval_seconds [Integer] The interval at which to poll the server, in seconds
+    # @param timeout_seconds [Integer] The maximum amount of time to wait for the Contract Invocation to be signed,
+    # in seconds.
+    # @return [ContractInvocation] The completed Contract Invocation object
+    def wait!(interval_seconds = 0.2, timeout_seconds = 20)
+      start_time = Time.now
+
+      loop do
+        reload
+
+        return self if transaction.terminal_state?
+
+        raise Timeout::Error, 'Contract Invocation timed out' if Time.now - start_time > timeout_seconds
+
+        self.sleep interval_seconds
+      end
+
+      self
+    end
+
+    # Returns a String representation of the Contract Invocation.
+    # @return [String] a String representation of the Contract Invocation
+    def to_s
+      Coinbase.pretty_print_object(
+        self.class,
+        id: id,
+        wallet_id: wallet_id,
+        address_id: address_id,
+        network_id: network.id,
+        status: status,
+        abi: abi.to_json,
+        method: method,
+        args: args.to_json,
+        transaction_hash: transaction.transaction_hash,
+        transaction_link: transaction.transaction_link
+      )
+    end
+
+    # Same as to_s.
+    # @return [String] a String representation of the ContractInvocation
+    def inspect
+      to_s
+    end
+
+    private
+
+    def contract_invocation_api
+      @contract_invocation_api ||= Coinbase::Client::ContractInvocationsApi.new(Coinbase.configuration.api_client)
+    end
+  end
+end

data/lib/coinbase/payload_signature.rb

@@ -0,0 +1,181 @@
+# frozen_string_literal: true
+
+require_relative 'constants'
+
+module Coinbase
+  # A representation of a Payload Signature.
+  class PayloadSignature
+    # A representation of a Payload Signature status.
+    module Status
+      # The Payload Signature is pending signing.
+      # At this point, the Signature is not available yet.
+      PENDING = 'pending'
+
+      # The Payload Signature has been signed.
+      SIGNED = 'signed'
+
+      # The Payload Signature has failed.
+      FAILED = 'failed'
+
+      # The states that are considered terminal.
+      TERMINAL_STATES = [SIGNED, FAILED].freeze
+    end
+
+    class << self
+      # Creates a new PayloadSignature object.
+      # @param wallet_id [String] The Wallet ID associated with the signing Address
+      # @param address_id [String] The Address ID of the signing Address
+      # @param unsigned_payload [String] The hex-encoded Unsigned Payload
+      # @param signature [String] (Optional) The Signature if the Wallet is not using an MPC Server-Signer
+      # @return [PayloadSignature] The new Payload Signature object
+      # @raise [Coinbase::ApiError] If the request to create the Payload Signature fails
+      def create(wallet_id:, address_id:, unsigned_payload:, signature: nil)
+        create_payload_signature_request = {
+          unsigned_payload: unsigned_payload,
+          signature: signature
+        }.compact
+
+        model = Coinbase.call_api do
+          addresses_api.create_payload_signature(
+            wallet_id,
+            address_id,
+            create_payload_signature_request: create_payload_signature_request
+          )
+        end
+
+        new(model)
+      end
+
+      # Enumerates the payload signatures for a given address belonging to a wallet.
+      # The result is an enumerator that lazily fetches from the server, and can be iterated over,
+      # converted an array, etc...
+      # @return [Enumerable<Coinbase::PayloadSignature>] Enumerator that returns payload signatures
+      def list(wallet_id:, address_id:)
+        Coinbase::Pagination.enumerate(
+          ->(page) { fetch_page(wallet_id, address_id, page) }
+        ) do |payload_signature|
+          new(payload_signature)
+        end
+      end
+
+      private
+
+      def addresses_api
+        Coinbase::Client::AddressesApi.new(Coinbase.configuration.api_client)
+      end
+
+      def fetch_page(wallet_id, address_id, page)
+        addresses_api.list_payload_signatures(wallet_id, address_id, { limit: DEFAULT_PAGE_LIMIT, page: page })
+      end
+    end
+
+    # Returns a new PayloadSignature object. Do not use this method directly.
+    # Instead use Coinbase::PayloadSignature.create.
+    # @param model [Coinbase::Client::PayloadSignature] The underlying Payload Signature obejct
+    def initialize(model)
+      raise unless model.is_a?(Coinbase::Client::PayloadSignature)
+
+      @model = model
+    end
+
+    # Returns the Payload Signature ID.
+    # @return [String] The Payload Signature ID
+    def id
+      @model.payload_signature_id
+    end
+
+    # Returns the Wallet ID of the Payload Signature.
+    # @return [String] The Wallet ID
+    def wallet_id
+      @model.wallet_id
+    end
+
+    # Returns the Address ID of the Payload Signature.
+    # @return [String] The Address ID
+    def address_id
+      @model.address_id
+    end
+
+    # Returns the Unsigned Payload of the Payload Signature.
+    # @return [String] The Unsigned Payload
+    def unsigned_payload
+      @model.unsigned_payload
+    end
+
+    # Returns the Signature of the Payload Signature.
+    # @return [String] The Signature
+    def signature
+      @model.signature
+    end
+
+    # Returns the status of the Payload Signature.
+    # @return [Symbol] The status
+    def status
+      @model.status
+    end
+
+    # Returns whether the Payload Signature is in a terminal state.
+    # @return [Boolean] Whether the Payload Signature is in a terminal state
+    def terminal_state?
+      Status::TERMINAL_STATES.include?(status)
+    end
+
+    # # Reload reloads the Payload Signature model with the latest version from the server side.
+    # @return [PayloadSignature] The most recent version of Payload Signature from the server
+    def reload
+      @model = Coinbase.call_api do
+        addresses_api.get_payload_signature(wallet_id, address_id, id)
+      end
+
+      self
+    end
+
+    # Waits until the Payload Signature is signed or failed by polling the server at the given interval. Raises a
+    # Timeout::Error if the Payload Signature takes longer than the given timeout.
+    # @param interval_seconds [Integer] The interval at which to poll the server, in seconds
+    # @param timeout_seconds [Integer] The maximum amount of time to wait for the Payload Signature to be signed,
+    # in seconds.
+    # @return [PayloadSignature] The completed Payload Signature object
+    def wait!(interval_seconds = 0.2, timeout_seconds = 20)
+      start_time = Time.now
+
+      loop do
+        reload
+
+        return self if terminal_state?
+
+        raise Timeout::Error, 'Payload Signature timed out' if Time.now - start_time > timeout_seconds
+
+        self.sleep interval_seconds
+      end
+
+      self
+    end
+
+    # Returns a String representation of the Payload Signature.
+    # @return [String] a String representation of the Payload Signature
+    def to_s
+      Coinbase.pretty_print_object(
+        self.class,
+        id: id,
+        wallet_id: wallet_id,
+        address_id: address_id,
+        status: status,
+        unsigned_payload: unsigned_payload,
+        signature: signature
+      )
+    end
+
+    # Same as to_s.
+    # @return [String] a String representation of the PayloadSignature
+    def inspect
+      to_s
+    end
+
+    private
+
+    def addresses_api
+      Coinbase::Client::AddressesApi.new(Coinbase.configuration.api_client)
+    end
+  end
+end

data/lib/coinbase/transaction.rb

@@ -26,6 +26,9 @@ module Coinbase
       # The Transaction has failed for some reason.
       FAILED = 'failed'
 
+      # The Transaction isn't specified it's status in Receipt.
+      UNSPECIFIED = 'unspecified'
+
       # The states that are considered terminal on-chain.
       TERMINAL_STATES = [COMPLETE, FAILED].freeze
     end
@@ -80,12 +83,30 @@ module Coinbase
       Status::TERMINAL_STATES.include?(status)
     end
 
+    # Returns the block hash of which the Transaction is recorded.
+    # @return [String] The to block_hash
+    def block_hash
+      @model.block_hash
+    end
+
+    # Returns the block height of which the Transaction is recorded.
+    # @return [String] The to block_height
+    def block_height
+      @model.block_height
+    end
+
     # Returns the link to the transaction on the blockchain explorer.
     # @return [String] The link to the transaction on the blockchain explorer
     def transaction_link
       @model.transaction_link
     end
 
+    # Returns the block height of which the Transaction is recorded.
+    # @return [String] The to block_height
+    def content
+      @model.content
+    end
+
     # Returns the underlying raw transaction.
     # @return [Eth::Tx::Eip1559] The raw transaction
     def raw

data/lib/coinbase/version.rb

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

data/lib/coinbase/wallet.rb

@@ -226,8 +226,18 @@ module Coinbase
     # @param options [Hash] Additional options for the staking operation
     # @return [BigDecimal] The claimable balance
 
+    # @!method sign_payload
+    # 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
+
+    # @!method invoke_contract
+    # Invokes a contract with the given ABI, method, and arguments.
+    # @param abi [Array<Hash>] The ABI of the contract
+    #
+
     def_delegators :default_address, :transfer, :trade, :faucet, :stake, :unstake, :claim_stake, :staking_balances,
-                   :stakeable_balance, :unstakeable_balance, :claimable_balance
+                   :stakeable_balance, :unstakeable_balance, :claimable_balance, :sign_payload, :invoke_contract
 
     # Returns the addresses belonging to the Wallet.
     # @return [Array<Coinbase::WalletAddress>] The addresses belonging to the Wallet

data/lib/coinbase/webhook.rb

@@ -22,6 +22,8 @@ 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
@@ -29,16 +31,18 @@ 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...' }]
+      #     event_filters: [{ 'contract_address' => '0x...', 'from_address' => '0x...', 'to_address' => '0x...' }],
+      #     signature_header: 'example_header'
       #   )
-      def create(network_id:, notification_uri:, event_type:, event_filters:)
+      def create(network_id:, notification_uri:, event_type:, event_filters:, signature_header: '')
         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
+              event_filters: event_filters,
+              signature_header: signature_header
             }
           )
         end
@@ -112,6 +116,14 @@ module Coinbase
       @model.event_filters
     end
 
+    # Returns the signature header for the webhook. It is used as the value of callback header
+    # with key 'x-webhook-signature'.
+    #
+    # @return [String] The signature header value.
+    def signature_header
+      @model.signature_header
+    end
+
     # Updates the webhook with a new notification URI.
     #
     # @param notification_uri [String] The new URI for webhook notifications.
@@ -124,9 +136,7 @@ module Coinbase
         webhooks_api.update_webhook(
           id,
           update_webhook_request: {
-            network_id: network_id,
             notification_uri: notification_uri,
-            event_type: event_type,
             event_filters: event_filters.map(&:to_hash)
           }
         )
@@ -162,7 +172,8 @@ module Coinbase
         network_id: @model.network_id,
         event_type: @model.event_type,
         notification_uri: @model.notification_uri,
-        event_filters: @model.event_filters.map(&:to_hash).to_json
+        event_filters: @model.event_filters.map(&:to_hash).to_json,
+        signature_header: @model.signature_header
       )
     end
 

data/lib/coinbase.rb

@@ -12,12 +12,14 @@ require_relative 'coinbase/historical_balance'
 require_relative 'coinbase/client'
 require_relative 'coinbase/constants'
 require_relative 'coinbase/contract_event'
+require_relative 'coinbase/contract_invocation'
 require_relative 'coinbase/destination'
 require_relative 'coinbase/errors'
 require_relative 'coinbase/faucet_transaction'
 require_relative 'coinbase/middleware'
 require_relative 'coinbase/network'
 require_relative 'coinbase/pagination'
+require_relative 'coinbase/payload_signature'
 require_relative 'coinbase/trade'
 require_relative 'coinbase/transfer'
 require_relative 'coinbase/transaction'