coinbase-sdk 0.3.0 → 0.6.0

data/lib/coinbase/smart_contract.rb

@@ -23,63 +23,64 @@ module Coinbase
     )
       Coinbase::Pagination.enumerate(
         lambda { |page|
-          list_events_page(network_id, protocol_name, contract_address, contract_name, event_name, from_block_height,
-                           to_block_height, page)
+          list_events_page(
+            network_id,
+            protocol_name,
+            contract_address,
+            contract_name,
+            event_name,
+            from_block_height,
+            to_block_height,
+            page
+          )
         }
       ) do |contract_event|
         Coinbase::ContractEvent.new(contract_event)
       end
     end
 
-    # Returns a new SmartContract object.
-    # @param model [Coinbase::Client::SmartContract] The underlying SmartContract object
-    def initialize(model)
-      @model = model
-    end
-
-    # Returns the network ID of the SmartContract.
-    # @return [String] The network ID
-    def network_id
-      Coinbase.to_sym(@model.network_id)
-    end
-
-    # Returns the protocol name of the SmartContract.
-    # @return [String] The protocol name
-    def protocol_name
-      @model.protocol_name
-    end
-
-    # Returns the contract name of the SmartContract.
-    # @return [String] The contract name
-    def contract_name
-      @model.contract_name
-    end
-
-    # Returns the address of the SmartContract.
-    # @return [String] The contract address
-    def address
-      @model.address
-    end
-
-    # Returns a string representation of the SmartContract.
-    # @return [String] a string representation of the SmartContract
-    def to_s
-      "Coinbase::SmartContract{
-        network_id: '#{network_id}',
-        protocol_name: '#{protocol_name}',
-        contract_name: '#{contract_name}',
-        address: '#{address}'}"
-    end
+    # Creates a new ERC20 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 total_supply [String] The total supply of the token, denominate in whole units.
+    # @return [SmartContract] The new ERC20 Token SmartContract object
+    def self.create_token_contract(
+      address_id:,
+      wallet_id:,
+      name:,
+      symbol:,
+      total_supply:
+    )
+      contract = Coinbase.call_api do
+        smart_contracts_api.create_smart_contract(
+          wallet_id,
+          address_id,
+          {
+            type: Coinbase::Client::SmartContractType::ERC20,
+            options: Coinbase::Client::TokenContractOptions.new(
+              name: name,
+              symbol: symbol,
+              total_supply: BigDecimal(total_supply).to_i.to_s
+            ).to_body
+          }
+        )
+      end
 
-    # Same as to_s.
-    # @return [String] a string representation of the SmartContract
-    def inspect
-      to_s
+      new(contract)
     end
 
     def self.contract_events_api
       Coinbase::Client::ContractEventsApi.new(Coinbase.configuration.api_client)
     end
+    private_class_method :contract_events_api
+
+    def self.smart_contracts_api
+      Coinbase::Client::SmartContractsApi.new(Coinbase.configuration.api_client)
+    end
+    private_class_method :smart_contracts_api
 
     def self.list_events_page(
       network_id,
@@ -102,5 +103,175 @@ module Coinbase
         { next_page: page }
       )
     end
+    private_class_method :list_events_page
+
+    # Returns a new SmartContract object.
+    # @param model [Coinbase::Client::SmartContract] The underlying SmartContract object
+    def initialize(model)
+      raise unless model.is_a?(Coinbase::Client::SmartContract)
+
+      @model = model
+    end
+
+    # Returns the SmartContract ID.
+    # NOTE: This is not the contract address and is primarily used before
+    # the contract is deployed.
+    # @return [String] The SmartContract ID
+    def id
+      @model.smart_contract_id
+    end
+
+    # Returns the Network of the SmartContract.
+    # @return [Coinbase::Network] The Network
+    def network
+      @network ||= Coinbase::Network.from_id(@model.network_id)
+    end
+
+    # Returns the contract address of the SmartContract.
+    # @return [String] The contract address
+    def contract_address
+      @model.contract_address
+    end
+
+    # Returns the address of the deployer of the SmartContract.
+    # @return [String] The deployer address
+    def deployer_address
+      @model.deployer_address
+    end
+
+    # Returns the ABI of the Smart Contract.
+    # @return [Array<Hash>] The ABI
+    def abi
+      JSON.parse(@model.abi)
+    end
+
+    # Returns the ID of the wallet that deployed the SmartContract.
+    # @return [String] The wallet ID
+    def wallet_id
+      @model.wallet_id
+    end
+
+    # Returns the type of the SmartContract.
+    # @return [Coinbase::Client::SmartContractType] The SmartContract type
+    def type
+      @model.type
+    end
+
+    # Returns the options of the SmartContract.
+    # @return [Coinbase::Client::SmartContractOptions] The SmartContract options
+    def options
+      @model.options
+    end
+
+    # Returns the transaction.
+    # @return [Coinbase::Transaction] The SmartContracy deployment transaction
+    def transaction
+      @transaction ||= Coinbase::Transaction.new(@model.transaction)
+    end
+
+    # Returns the status of the SmartContract.
+    # @return [String] The status
+    def status
+      transaction.status
+    end
+
+    # Signs the SmartContract deployment transaction with the given key.
+    # This is required before broadcasting the SmartContract.
+    # @param key [Eth::Key] The key to sign the SmartContract with
+    # @return [SmartContract] The SmartContract object
+    # @raise [RuntimeError] If the key is not an Eth::Key
+    # @raise [Coinbase::AlreadySignedError] If the SmartContract has already been signed
+    def sign(key)
+      raise unless key.is_a?(Eth::Key)
+
+      transaction.sign(key)
+    end
+
+    # Deploys the signed SmartContract to the blockchain.
+    # @return [SmartContract] The SmartContract object
+    # @raise [Coinbase::TransactionNotSignedError] If the SmartContract has not been signed
+    def deploy!
+      raise TransactionNotSignedError unless transaction.signed?
+
+      @model = Coinbase.call_api do
+        smart_contracts_api.deploy_smart_contract(
+          wallet_id,
+          deployer_address,
+          id,
+          { signed_payload: transaction.signature }
+        )
+      end
+
+      @transaction = Coinbase::Transaction.new(@model.transaction)
+
+      self
+    end
+
+    # Reloads the Smart Contract model with the latest version from the server side.
+    # @return [SmartContract] The most recent version of Smart Contract from the server
+    def reload
+      @model = Coinbase.call_api do
+        smart_contracts_api.get_smart_contract(
+          wallet_id,
+          deployer_address,
+          id
+        )
+      end
+
+      @transaction = Coinbase::Transaction.new(@model.transaction)
+
+      self
+    end
+
+    # Waits until the Smart Contract deployment is signed or failed by polling the server at the given interval.
+    # @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 Smart Contract,
+    # deployment to land on-chain, in seconds
+    # @return [SmartContract] The completed Smart Contract object
+    # @raise [Timeout::Error] if the Contract Invocation takes longer than the given timeout
+    def wait!(interval_seconds = 0.2, timeout_seconds = 20)
+      start_time = Time.now
+
+      loop do
+        reload
+
+        return self if transaction.terminal_state?
+
+        if Time.now - start_time > timeout_seconds
+          raise Timeout::Error,
+                'SmartContract deployment timed out. Try waiting again.'
+        end
+
+        self.sleep interval_seconds
+      end
+
+      self
+    end
+
+    # Same as to_s.
+    # @return [String] a string representation of the SmartContract
+    def inspect
+      to_s
+    end
+
+    # Returns a string representation of the SmartContract.
+    # @return [String] a string representation of the SmartContract
+    def to_s
+      Coinbase.pretty_print_object(
+        self.class,
+        network: network.id,
+        contract_address: contract_address,
+        deployer_address: deployer_address,
+        type: type,
+        status: status,
+        options: Coinbase.pretty_print_object('Options', **options)
+      )
+    end
+
+    private
+
+    def smart_contracts_api
+      @smart_contracts_api ||= Coinbase::Client::SmartContractsApi.new(Coinbase.configuration.api_client)
+    end
   end
 end

data/lib/coinbase/transaction.rb

@@ -147,6 +147,9 @@ module Coinbase
     # Signs the Transaction with the provided key and returns the hex signing payload.
     # @return [String] The hex-encoded signed payload
     def sign(key)
+      raise 'Invalid key type' unless key.is_a?(Eth::Key)
+      raise Coinbase::AlreadySignedError if signed?
+
       raw.sign(key)
 
       signature

data/lib/coinbase/transfer.rb

@@ -84,7 +84,7 @@ module Coinbase
     end
 
     # Returns the Network of the Transfer.
-    # @return [Symbol] The Network
+    # @return [Coinbase::Network] The Network
     def network
       @network ||= Coinbase::Network.from_id(@model.network_id)
     end

data/lib/coinbase/version.rb

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

data/lib/coinbase/wallet.rb

@@ -234,10 +234,19 @@ module Coinbase
     # @!method invoke_contract
     # Invokes a contract with the given ABI, method, and arguments.
     # @param abi [Array<Hash>] The ABI of the contract
-    #
+
+    # @!method deploy_token
+    # Deploys a new ERC20 token contract with the given name, symbol, and total supply.
+    # @param name [String] The name of the token.
+    # @param symbol [String] The symbol of the token.
+    # @param total_supply [Integer, BigDecimal] The total supply of the token, denominated in
+    # whole units.
+    # @return [Coinbase::SmartContract] The deployed 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
+                   :stakeable_balance, :unstakeable_balance, :claimable_balance, :sign_payload, :invoke_contract,
+                   :deploy_token
 
     # Returns the addresses belonging to the Wallet.
     # @return [Array<Coinbase::WalletAddress>] The addresses belonging to the Wallet

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: coinbase-sdk
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Yuga Cohler
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-09-05 00:00:00.000000000 Z
+date: 2024-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -279,11 +279,13 @@ files:
 - lib/coinbase/client.rb
 - lib/coinbase/client/api/addresses_api.rb
 - lib/coinbase/client/api/assets_api.rb
+- lib/coinbase/client/api/balance_history_api.rb
 - lib/coinbase/client/api/contract_events_api.rb
 - lib/coinbase/client/api/contract_invocations_api.rb
 - lib/coinbase/client/api/external_addresses_api.rb
 - lib/coinbase/client/api/networks_api.rb
 - lib/coinbase/client/api/server_signers_api.rb
+- 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/transfers_api.rb
@@ -315,12 +317,16 @@ files:
 - lib/coinbase/client/models/create_contract_invocation_request.rb
 - lib/coinbase/client/models/create_payload_signature_request.rb
 - lib/coinbase/client/models/create_server_signer_request.rb
+- lib/coinbase/client/models/create_smart_contract_request.rb
 - lib/coinbase/client/models/create_staking_operation_request.rb
 - lib/coinbase/client/models/create_trade_request.rb
 - 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_webhook_request.rb
+- lib/coinbase/client/models/deploy_smart_contract_request.rb
+- lib/coinbase/client/models/erc20_transfer_event.rb
+- lib/coinbase/client/models/erc721_transfer_event.rb
 - lib/coinbase/client/models/error.rb
 - lib/coinbase/client/models/ethereum_transaction.rb
 - lib/coinbase/client/models/ethereum_transaction_access.rb
@@ -337,6 +343,7 @@ files:
 - lib/coinbase/client/models/historical_balance.rb
 - lib/coinbase/client/models/network.rb
 - lib/coinbase/client/models/network_identifier.rb
+- lib/coinbase/client/models/nft_contract_options.rb
 - lib/coinbase/client/models/payload_signature.rb
 - lib/coinbase/client/models/payload_signature_list.rb
 - lib/coinbase/client/models/seed_creation_event.rb
@@ -349,6 +356,10 @@ files:
 - lib/coinbase/client/models/signature_creation_event.rb
 - lib/coinbase/client/models/signature_creation_event_result.rb
 - lib/coinbase/client/models/signed_voluntary_exit_message_metadata.rb
+- lib/coinbase/client/models/smart_contract.rb
+- lib/coinbase/client/models/smart_contract_list.rb
+- lib/coinbase/client/models/smart_contract_options.rb
+- lib/coinbase/client/models/smart_contract_type.rb
 - lib/coinbase/client/models/sponsored_send.rb
 - lib/coinbase/client/models/staking_balance.rb
 - lib/coinbase/client/models/staking_context.rb
@@ -358,6 +369,7 @@ files:
 - lib/coinbase/client/models/staking_reward.rb
 - lib/coinbase/client/models/staking_reward_format.rb
 - lib/coinbase/client/models/staking_reward_usd_value.rb
+- lib/coinbase/client/models/token_contract_options.rb
 - lib/coinbase/client/models/trade.rb
 - lib/coinbase/client/models/trade_list.rb
 - lib/coinbase/client/models/transaction.rb
@@ -376,7 +388,9 @@ files:
 - lib/coinbase/client/models/webhook.rb
 - lib/coinbase/client/models/webhook_event_filter.rb
 - lib/coinbase/client/models/webhook_event_type.rb
+- lib/coinbase/client/models/webhook_event_type_filter.rb
 - lib/coinbase/client/models/webhook_list.rb
+- lib/coinbase/client/models/webhook_wallet_activity_filter.rb
 - lib/coinbase/client/version.rb
 - lib/coinbase/constants.rb
 - lib/coinbase/contract_event.rb