coinbase 0.0.1 → 1.3.2

data/lib/coinbase/transfer.rb

@@ -1,153 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'constants'
-require 'bigdecimal'
-require 'eth'
-
-module Coinbase
-  # A representation of a Transfer, which moves an amount of an Asset from
-  # a user-controlled Wallet to another address. The fee is assumed to be paid
-  # in the native Asset of the Network. Currently only ETH transfers are supported. Transfers
-  # should be created through {link:Wallet#transfer} or {link:Address#transfer}.
-  class Transfer
-    attr_reader :network_id, :wallet_id, :from_address_id, :amount, :asset_id, :to_address_id
-
-    # A representation of a Transfer status.
-    module Status
-      # The Transfer is awaiting being broadcast to the Network. At this point, transaction
-      # hashes may not yet be assigned.
-      PENDING = :pending
-
-      # The Transfer has been broadcast to the Network. At this point, at least the transaction hash
-      # should be assigned.
-      BROADCAST = :broadcast
-
-      # The Transfer is complete, and has confirmed on the Network.
-      COMPLETE = :complete
-
-      # The Transfer has failed for some reason.
-      FAILED = :failed
-    end
-
-    # Returns a new Transfer object.
-    # @param network_id [Symbol] The ID of the Network on which the Transfer originated
-    # @param wallet_id [String] The ID of the Wallet from which the Transfer originated
-    # @param from_address_id [String] The ID of the address from which the Transfer originated
-    # @param amount [Integer, Float, BigDecimal] The amount of the Asset to send. Integers are interpreted as
-    #  the smallest denomination of the Asset (e.g. Wei for Ether). Floats and BigDecimals are interpreted as the Asset
-    #  itself (e.g. Ether).
-    # @param asset_id [Symbol] The ID of the Asset being transferred. Currently only ETH is supported.
-    # @param to_address_id [String] The address to which the Transfer is being sent
-    # @param client [Jimson::Client] (Optional) The JSON RPC client to use for interacting with the Network
-    def initialize(network_id, wallet_id, from_address_id, amount, asset_id, to_address_id,
-                   client: Jimson::Client.new(ENV.fetch('BASE_SEPOLIA_RPC_URL', nil)))
-
-      raise ArgumentError, "Unsupported asset: #{asset_id}" if asset_id != :eth
-
-      @network_id = network_id
-      @wallet_id = wallet_id
-      @from_address_id = from_address_id
-      @amount = normalize_eth_amount(amount)
-      @asset_id = asset_id
-      @to_address_id = to_address_id
-      @client = client
-    end
-
-    # Returns the underlying Transfer transaction, creating it if it has not been yet.
-    # @return [Eth::Tx::Eip1559] The Transfer transaction
-    def transaction
-      return @transaction unless @transaction.nil?
-
-      nonce = @client.eth_getTransactionCount(@from_address_id.to_s, 'latest').to_i(16)
-      gas_price = @client.eth_gasPrice.to_i(16)
-
-      params = {
-        chain_id: BASE_SEPOLIA.chain_id, # TODO: Don't hardcode Base Sepolia.
-        nonce: nonce,
-        priority_fee: gas_price, # TODO: Optimize this.
-        max_gas_fee: gas_price,
-        gas_limit: 21_000, # TODO: Handle multiple currencies.
-        from: Eth::Address.new(@from_address_id),
-        to: Eth::Address.new(@to_address_id),
-        value: (@amount * Coinbase::WEI_PER_ETHER).to_i
-      }
-
-      @transaction = Eth::Tx::Eip1559.new(Eth::Tx.validate_eip1559_params(params))
-      @transaction
-    end
-
-    # Returns the status of the Transfer.
-    # @return [Symbol] The status
-    def status
-      begin
-        # Create the transaction, and attempt to get the hash to see if it has been signed.
-        transaction.hash
-      rescue Eth::Signature::SignatureError
-        # If the transaction has not been signed, it is still pending.
-        return Status::PENDING
-      end
-
-      onchain_transaction = @client.eth_getTransactionByHash(transaction_hash)
-
-      if onchain_transaction.nil?
-        # If the transaction has not been broadcast, it is still pending.
-        Status::PENDING
-      elsif onchain_transaction['blockHash'].nil?
-        # If the transaction has been broadcast but hasn't been included in a block, it is
-        # broadcast.
-        Status::BROADCAST
-      else
-        transaction_receipt = @client.eth_getTransactionReceipt(transaction_hash)
-
-        if transaction_receipt['status'].to_i(16) == 1
-          Status::COMPLETE
-        else
-          Status::FAILED
-        end
-      end
-    end
-
-    # Waits until the Transfer is completed or failed by polling the Network at the given interval. Raises a
-    # Timeout::Error if the Transfer takes longer than the given timeout.
-    # @param interval_seconds [Integer] The interval at which to poll the Network, in seconds
-    # @param timeout_seconds [Integer] The maximum amount of time to wait for the Transfer to complete, in seconds
-    # @return [Transfer] The completed Transfer object
-    def wait!(interval_seconds = 0.2, timeout_seconds = 10)
-      start_time = Time.now
-
-      loop do
-        return self if status == Status::COMPLETE || status == Status::FAILED
-
-        raise Timeout::Error, 'Transfer timed out' if Time.now - start_time > timeout_seconds
-
-        self.sleep interval_seconds
-      end
-
-      self
-    end
-
-    # Returns the transaction hash of the Transfer, or nil if not yet available.
-    # @return [String] The transaction hash
-    def transaction_hash
-      "0x#{transaction.hash}"
-    rescue Eth::Signature::SignatureError
-      nil
-    end
-
-    private
-
-    # Normalizes the given Ether amount into a BigDecimal.
-    # @param amount [Integer, Float, BigDecimal] The amount to normalize
-    # @return [BigDecimal] The normalized amount
-    def normalize_eth_amount(amount)
-      case amount
-      when BigDecimal
-        amount
-      when Integer, Float
-        BigDecimal(amount.to_s)
-      else
-        raise ArgumentError, "Invalid amount: #{amount}"
-      end
-    end
-  end
-end

data/lib/coinbase/wallet.rb

@@ -1,160 +0,0 @@
-# frozen_string_literal: true
-
-require 'jimson'
-require 'money-tree'
-require 'securerandom'
-
-module Coinbase
-  # A representation of a Wallet. Wallets come with a single default Address, but can expand to have a set of Addresses,
-  # each of which can hold a balance of one or more Assets. Wallets can create new Addresses, list their addresses,
-  # list their balances, and transfer Assets to other Addresses.
-  class Wallet
-    attr_reader :wallet_id, :network_id
-
-    # Returns a new Wallet object.
-    # @param seed [Integer] (Optional) The seed to use for the Wallet. Expects a 32-byte hexadecimal. If not provided,
-    #   a new seed will be generated.
-    # @param address_count [Integer] (Optional) The number of addresses to generate for the Wallet. If not provided,
-    #   a single address will be generated.
-    # @param client [Jimson::Client] (Optional) The JSON RPC client to use for interacting with the Network
-    def initialize(seed: nil, address_count: 1, client: Jimson::Client.new(ENV.fetch('BASE_SEPOLIA_RPC_URL', nil)))
-      raise ArgumentError, 'Seed must be 32 bytes' if !seed.nil? && seed.length != 64
-      raise ArgumentError, 'Address count must be positive' if address_count < 1
-
-      @master = seed.nil? ? MoneyTree::Master.new : MoneyTree::Master.new(seed_hex: seed)
-
-      @wallet_id = SecureRandom.uuid
-      # TODO: Make Network an argument to the constructor.
-      @network_id = :base_sepolia
-      @addresses = []
-
-      # TODO: Adjust derivation path prefix based on network protocol.
-      @address_path_prefix = "m/44'/60'/0'/0"
-      @address_index = 0
-
-      @client = client
-
-      address_count.times { create_address }
-    end
-
-    # Creates a new Address in the Wallet.
-    # @return [Address] The new Address
-    def create_address
-      # TODO: Register with server.
-      path = "#{@address_path_prefix}/#{@address_index}"
-      private_key = @master.node_for_path(path).private_key.to_hex
-      key = Eth::Key.new(priv: private_key)
-      address = Address.new(@network_id, key.address.address, @wallet_id, key, client: @client)
-      @addresses << address
-      @address_index += 1
-      address
-    end
-
-    # Returns the default address of the Wallet.
-    # @return [Address] The default address
-    def default_address
-      @addresses.first
-    end
-
-    # Returns the Address with the given ID.
-    # @param address_id [String] The ID of the Address to retrieve
-    # @return [Address] The Address
-    def get_address(address_id)
-      @addresses.find { |address| address.address_id == address_id }
-    end
-
-    # Returns the list of Addresses in the Wallet.
-    # @return [Array<Address>] The list of Addresses
-    def list_addresses
-      # TODO: Register with server.
-      @addresses
-    end
-
-    # Returns the list of balances of this Wallet. Balances are aggregated across all Addresses in the Wallet.
-    # @return [BalanceMap] The list of balances. The key is the Asset ID, and the value is the balance.
-    def list_balances
-      balance_map = BalanceMap.new
-
-      @addresses.each do |address|
-        address.list_balances.each do |asset_id, balance|
-          balance_map[asset_id] ||= BigDecimal(0)
-          current_balance = balance_map[asset_id]
-          new_balance = balance + current_balance
-          balance_map[asset_id] = new_balance
-        end
-      end
-
-      balance_map
-    end
-
-    # Returns the balance of the provided Asset. Balances are aggregated across all Addresses in the Wallet.
-    # @param asset_id [Symbol] The ID of the Asset to retrieve the balance for
-    # @return [BigDecimal] The balance of the Asset
-    def get_balance(asset_id)
-      normalized_asset_id = if %i[wei gwei].include?(asset_id)
-                              :eth
-                            else
-                              asset_id
-                            end
-
-      eth_balance = list_balances[normalized_asset_id] || BigDecimal(0)
-
-      case asset_id
-      when :eth
-        eth_balance
-      when :gwei
-        eth_balance * Coinbase::GWEI_PER_ETHER
-      when :wei
-        eth_balance * Coinbase::WEI_PER_ETHER
-      else
-        BigDecimal(0)
-      end
-    end
-
-    # Transfers the given amount of the given Asset to the given address. Only same-Network Transfers are supported.
-    # Currently only the default_address is used to source the Transfer.
-    # @param amount [Integer, Float, BigDecimal] The amount of the Asset to send
-    # @param asset_id [Symbol] The ID of the Asset to send
-    # @param destination [Wallet | Address | String] The destination of the transfer. If a Wallet, sends to the Wallet's
-    #  default address. If a String, interprets it as the address ID.
-    # @return [Transfer] The hash of the Transfer transaction.
-    def transfer(amount, asset_id, destination)
-      if destination.is_a?(Wallet)
-        raise ArgumentError, 'Transfer must be on the same Network' if destination.network_id != @network_id
-
-        destination = destination.default_address.address_id
-      elsif destination.is_a?(Address)
-        raise ArgumentError, 'Transfer must be on the same Network' if destination.network_id != @network_id
-
-        destination = destination.address_id
-      end
-
-      default_address.transfer(amount, asset_id, destination)
-    end
-
-    # Exports the Wallet's data to a WalletData object.
-    # @return [WalletData] The Wallet data
-    def export
-      WalletData.new(@master.seed_hex, @addresses.length)
-    end
-
-    # The data required to recreate a Wallet.
-    class WalletData
-      attr_reader :seed, :address_count
-
-      # Returns a new WalletData object.
-      # @param seed [String] The seed of the Wallet
-      # @param address_count [Integer] The number of addresses in the Wallet
-      def initialize(seed, address_count)
-        @seed = seed
-        @address_count = address_count
-      end
-    end
-
-    # Returns the data required to recreate the Wallet.
-    # @return [WalletData] The Wallet data
-    def to_data
-      WalletData.new(@master.seed_hex, @addresses.length)
-    end
-  end
-end