erc20 0.2.9 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdb92899afb7e0f3ac74c59c07cdf1f48441d8b8bab6c96fadffe506c49dcedd
-  data.tar.gz: fd0faec13d2aafdd1cbd02afd0066c17b308b96637469f60eca0cbd1d5102629
+  metadata.gz: 9719ca99febb05bab13326b5a1de126b73aa5d923ad7f091ef3c4493a6d4030f
+  data.tar.gz: b75de1bc31c3e1e1ac2b3167d92ac9d924841048035e190ec961dfebde81d9c5
 SHA512:
-  metadata.gz: 509bdbaa8838f52ad6ea7d8a779001c1bfd87ba9c448ce4b808849967575069b8452e3a1f50b506c38f282b709e31e690a31b4247452b34d8cc097caa72e3b45
-  data.tar.gz: 8fa48303af7a75dd4019062bb9d3904c84f76f16dd994ee95d3d6cb0f952c9e207030be9063781c3224af6d0a3cde0f107667cdd4447c9fdc4108a05725b3bc3
+  metadata.gz: 6c306141b126499fe21d589809a596567439b7ec70ada449a0b7b4feee656fddb08d94f21943b10c6ea8c73526327a337cc056adc861a720fdee0bdce5e3a2f4
+  data.tar.gz: adc65e660ef7394c02f0d37979a7568c91b032a07620d25a40d3874e866468b3531e617e353d8bcd48b9e453d10891aa4977f67e21cbd41912123ce470ea3d79

data/Gemfile

@@ -20,6 +20,7 @@ gem 'rake', '~>13.2', require: false
 gem 'random-port', '~>0.7', require: false
 gem 'rdoc', '~>7.0', require: false
 gem 'rubocop', '~>1.75', require: false
+gem 'rubocop-elegant', '~>0.5', require: false
 gem 'rubocop-minitest', '~>0.38', require: false
 gem 'rubocop-performance', '~>1.25', require: false
 gem 'rubocop-rake', '~>0.7', require: false

data/Gemfile.lock

@@ -13,13 +13,13 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.8)
+    addressable (2.9.0)
       public_suffix (>= 2.0.2, < 8.0)
-    ansi (1.5.0)
+    ansi (1.6.0)
     ast (2.4.3)
     backtrace (0.4.1)
     base64 (0.3.0)
-    bigdecimal (4.0.1)
+    bigdecimal (4.1.2)
     builder (3.3.0)
     concurrent-ruby (1.3.6)
     crack (1.0.1)
@@ -38,30 +38,31 @@ GEM
       multi_test (~> 1.1)
       sys-uname (~> 1.3)
     cucumber-ci-environment (11.0.0)
-    cucumber-core (16.1.1)
+    cucumber-core (16.2.0)
       cucumber-gherkin (> 36, < 40)
       cucumber-messages (> 31, < 33)
       cucumber-tag-expressions (> 6, < 9)
-    cucumber-cucumber-expressions (19.0.0)
+    cucumber-cucumber-expressions (19.0.1)
       bigdecimal
-    cucumber-gherkin (38.0.0)
+    cucumber-gherkin (39.1.0)
       cucumber-messages (>= 31, < 33)
     cucumber-html-formatter (22.3.0)
       cucumber-messages (> 23, < 33)
-    cucumber-messages (32.0.1)
+    cucumber-messages (32.3.1)
     cucumber-tag-expressions (8.1.0)
     date (3.5.1)
     diff-lcs (1.6.2)
     docile (1.4.1)
-    donce (0.4.0)
+    donce (0.7.0)
       backtrace (~> 0.3)
       os (~> 1.1)
       qbash (~> 0.3)
-    elapsed (0.2.2)
+    drb (2.2.3)
+    elapsed (0.3.1)
       loog (~> 0.6)
       tago (~> 0.1)
     ellipsized (0.3.0)
-    erb (6.0.1)
+    erb (6.0.4)
     eth (0.5.13)
       forwardable (~> 1.3)
       keccak (~> 1.3)
@@ -69,102 +70,107 @@ GEM
       openssl (>= 2.2, < 4.0)
       rbsecp256k1 (~> 6.0)
       scrypt (~> 3.0)
-    ethon (0.15.0)
+    ethon (0.18.0)
       ffi (>= 1.15.0)
+      logger
     eventmachine (1.2.7)
-    faraday (2.14.0)
+    faraday (2.14.2)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
-    faraday-net_http (3.4.2)
+    faraday-net_http (3.4.3)
       net-http (~> 0.5)
     faye-websocket (0.12.0)
       eventmachine (>= 0.12.0)
       websocket-driver (>= 0.8.0)
-    ffi (1.17.3-arm64-darwin)
-    ffi (1.17.3-x64-mingw-ucrt)
-    ffi (1.17.3-x86_64-darwin)
-    ffi (1.17.3-x86_64-linux-gnu)
-    ffi-compiler (1.3.2)
+    ffi (1.17.4-arm64-darwin)
+    ffi (1.17.4-x64-mingw-ucrt)
+    ffi (1.17.4-x86_64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
+    ffi-compiler (1.4.2)
       ffi (>= 1.15.5)
       rake
     forwardable (1.4.0)
     hashdiff (1.2.1)
-    json (2.18.0)
+    json (2.19.5)
     jsonrpc-client (0.1.4)
       faraday
       multi_json (>= 1.1.0)
-    keccak (1.3.2)
+    keccak (1.3.3)
     konstructor (1.0.2)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
-    loog (0.7.2)
+    loog (0.8.0)
       ellipsized
       logger (~> 1.0)
     memoist3 (1.0.0)
     mini_mime (1.1.5)
     mini_portile2 (2.8.9)
-    minitest (6.0.1)
+    minitest (6.0.6)
+      drb (~> 2.0)
       prism (~> 1.5)
-    minitest-reporters (1.7.1)
+    minitest-reporters (1.8.0)
       ansi
       builder
-      minitest (>= 5.0)
+      minitest (>= 5.0, < 7)
       ruby-progressbar
     minitest-retry (0.3.1)
       minitest (>= 5.0)
-    multi_json (1.19.1)
+    multi_json (1.21.1)
     multi_test (1.1.0)
     net-http (0.9.1)
       uri (>= 0.11.1)
-    openssl (3.3.2)
+    openssl (3.3.3)
     os (1.1.4)
-    parallel (1.27.0)
-    parser (3.3.10.1)
+    parallel (2.1.0)
+    parser (3.3.11.1)
       ast (~> 2.4.1)
       racc
     pkg-config (1.6.5)
-    prism (1.8.0)
+    prism (1.9.0)
     psych (5.3.1)
       date
       stringio
-    public_suffix (7.0.2)
-    qbash (0.6.0)
+    public_suffix (7.0.5)
+    qbash (0.8.4)
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
       tago (> 0)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.3.1)
-    random-port (0.7.6)
+    rake (13.4.2)
+    random-port (0.8.2)
       tago (~> 0.0)
     rbsecp256k1 (6.0.0)
       mini_portile2 (~> 2.8)
       pkg-config (~> 1.5)
       rubyzip (~> 2.3)
-    rdoc (7.1.0)
+    rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
       tsort
-    regexp_parser (2.11.3)
+    regexp_parser (2.12.0)
     rexml (3.4.4)
-    rubocop (1.82.1)
+    rubocop (1.86.2)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
-      parallel (~> 1.10)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.48.0, < 2.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.0)
+    rubocop-ast (1.49.1)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
-    rubocop-minitest (0.38.2)
+    rubocop-elegant (0.5.1)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.75)
+    rubocop-minitest (0.39.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
       rubocop-ast (>= 1.38.0, < 2.0)
@@ -190,22 +196,26 @@ GEM
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
     stringio (3.2.0)
-    sys-uname (1.4.1)
+    sys-uname (1.5.1)
+      ffi (~> 1.1)
+      memoist3 (~> 1.0.0)
+    sys-uname (1.5.1-universal-mingw32)
       ffi (~> 1.1)
       memoist3 (~> 1.0.0)
+      win32ole
     tago (0.7.0)
     thor (1.5.0)
     threads (0.5.0)
       backtrace (~> 0)
       concurrent-ruby (~> 1.0)
     tsort (0.2.0)
-    typhoeus (1.5.0)
-      ethon (>= 0.9.0, < 0.16.0)
+    typhoeus (1.6.0)
+      ethon (>= 0.18.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.2.0)
     uri (1.1.1)
-    webmock (3.26.1)
+    webmock (3.26.2)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
@@ -213,7 +223,8 @@ GEM
       base64
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
-    yard (0.9.38)
+    win32ole (1.9.3)
+    yard (0.9.44)
 
 PLATFORMS
   arm64-darwin-22
@@ -240,6 +251,7 @@ DEPENDENCIES
   random-port (~> 0.7)
   rdoc (~> 7.0)
   rubocop (~> 1.75)
+  rubocop-elegant (~> 0.5)
   rubocop-minitest (~> 0.38)
   rubocop-performance (~> 1.25)
   rubocop-rake (~> 0.7)

data/README.md

@@ -29,7 +29,7 @@ Or simply add this to your Gemfile:
 gem 'erc20'
 ```
 
-Then, make an instance of the main class and use to read
+Then, make an instance of the main class and use it to read
 balances, send and receive payments:
 
 ```ruby
@@ -40,6 +40,8 @@ w = ERC20::Wallet.new(
   host: 'mainnet.infura.io',
   http_path: '/v3/<your-infura-key>',
   ws_path: '/ws/v3/<your-infura-key>',
+  attempts: 3, # retry failed HTTP RPC calls up to 3 times, with backoff
+  fallbacks: ['https://eth.drpc.org'], # alternative RPC endpoints to try
   log: $stdout
 )
 
@@ -75,8 +77,8 @@ To check the price of a gas unit and the expected cost of a payment:
 # How many gas units required to send this payment:
 units = w.gas_estimate(from, to, amount)
 
-# What is the price of a gas unit, in gwei:
-gwei = w.gas_price
+# What is the price of a gas unit, in wei:
+price = w.gas_price
 ```
 
 To generate a new private key, use [eth](https://rubygems.org/gems/eth):
@@ -106,7 +108,7 @@ w = ERC20::Wallet.new(
 You can use [squid-proxy] [Docker] image to set up your own [HTTP proxy] server.
 
 Of course, this library works with [Polygon], [Optimism],
-and other EVM compatible blockchains.
+and other [EVM] compatible blockchains.
 
 ## How to use in command line
 
@@ -170,3 +172,4 @@ If it's clean and you don't see any error messages, submit your pull request.
 [Docker]: https://www.docker.com/
 [Polygon]: https://polygon.technology/
 [Optimism]: https://www.optimism.io/
+[EVM]: https://ethereum.org/developers/docs/evm/

data/Rakefile

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
+require 'rake'
+require 'rake/clean'
 # SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
 require 'rubygems'
-require 'rake'
-require 'rake/clean'
 
 ENV['RAKE'] = 'true'
 

data/bin/erc20

@@ -44,6 +44,9 @@ class Bin < Thor
     desc: 'HTTP/S proxy for all requests, e.g. "localhost:3128"'
   class_option :attempts, type: :numeric, default: 1,
     desc: 'How many times should we try before failing'
+  class_option :fallbacks, type: :array,
+    default: ['https://ethereum.publicnode.com', 'https://eth.drpc.org', 'https://rpc.ankr.com/eth'],
+    desc: 'Fallback HTTP RPC endpoint URLs to try when the primary host fails'
   class_option :dry, type: :boolean, default: false,
     desc: "Don't send a real payment, run in a read-only mode"
   class_option :verbose, type: :boolean, default: false,
@@ -136,6 +139,8 @@ class Bin < Thor
           host: options[:host], port: options[:port].to_i,
           http_path: options[:http_path], ws_path: options[:ws_path],
           ssl: options[:ssl],
+          attempts: options[:attempts].to_i,
+          fallbacks: options[:fallbacks],
           log: log
         )
       end

data/erc20.gemspec

@@ -7,7 +7,7 @@ require 'English'
 require_relative 'lib/erc20/erc20'
 
 Gem::Specification.new do |s|
-  s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
+  s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to?(:required_rubygems_version=)
   s.required_ruby_version = '~>3.0'
   s.name = 'erc20'
   s.version = ERC20::VERSION
@@ -25,12 +25,12 @@ Gem::Specification.new do |s|
   s.rdoc_options = ['--charset=UTF-8']
   s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
   s.extra_rdoc_files = ['README.md', 'LICENSE.txt']
-  s.add_dependency 'elapsed', '~>0.2'
-  s.add_dependency 'eth', '~>0.5'
-  s.add_dependency 'faye-websocket', '~>0.11'
-  s.add_dependency 'json', '~>2.10'
-  s.add_dependency 'jsonrpc-client', '~>0.1'
-  s.add_dependency 'loog', '~>0.4'
-  s.add_dependency 'thor', '~>1.3'
+  s.add_dependency('elapsed', '~>0.2')
+  s.add_dependency('eth', '~>0.5')
+  s.add_dependency('faye-websocket', '~>0.11')
+  s.add_dependency('json', '~>2.10')
+  s.add_dependency('jsonrpc-client', '~>0.1')
+  s.add_dependency('loog', '~>0.4')
+  s.add_dependency('thor', '~>1.3')
   s.metadata['rubygems_mfa_required'] = 'true'
 end

data/features/step_definitions/steps.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
+require 'English'
 # SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
 require 'tmpdir'
-require 'English'
 require_relative '../../lib/erc20'
 
 Before do
@@ -31,19 +31,19 @@ When(%r{^I run bin/erc20 with "([^"]*)"$}) do |arg|
 end
 
 Then(/^Stdout contains "([^"]*)"$/) do |txt|
-  raise "STDOUT doesn't contain '#{txt}':\n#{@stdout}" unless @stdout.include?(txt)
+  raise(StandardError, "STDOUT doesn't contain '#{txt}':\n#{@stdout}") unless @stdout.include?(txt)
 end
 
 Then(/^Stdout is empty$/) do
-  raise "STDOUT is not empty:\n#{@stdout}" unless @stdout == ''
+  raise(StandardError, "STDOUT is not empty:\n#{@stdout}") unless @stdout == ''
 end
 
 Then(/^Exit code is zero$/) do
-  raise "Non-zero exit #{@exitstatus}:\n#{@stdout}" unless @exitstatus.zero?
+  raise(StandardError, "Non-zero exit #{@exitstatus}:\n#{@stdout}") unless @exitstatus.zero?
 end
 
 Then(/^Exit code is not zero$/) do
-  raise 'Zero exit code' if @exitstatus.zero?
+  raise(StandardError, 'Zero exit code') if @exitstatus.zero?
 end
 
 When(/^I run bash with "([^"]*)"$/) do |text|

data/features/support/env.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
+require 'cucumber'
 # SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
 require 'simplecov'
-require 'cucumber'
 require_relative '../../lib/erc20'

data/lib/erc20/erc20.rb

@@ -24,6 +24,5 @@
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 module ERC20
-  # Current version of the gem (changed by the +.rultor.yml+ on every release)
-  VERSION = '0.2.9' unless defined?(VERSION)
+  VERSION = '0.3.0' unless defined?(VERSION)
 end

data/lib/erc20/fake_wallet.rb

@@ -12,14 +12,9 @@ require_relative 'wallet'
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 class ERC20::FakeWallet
-  # Transaction hash always returned:
   TXN_HASH = '0x172de9cda30537eae68ab4a96163ebbb8f8a85293b8737dd2e5deb4714b14623'
 
-  # Fakes:
-  attr_reader :host, :port, :ssl, :chain, :contract, :ws_path, :http_path
-
-  # Full history of all method calls:
-  attr_reader :history
+  attr_reader :host, :port, :ssl, :chain, :contract, :ws_path, :http_path, :history
 
   # Ctor.
   def initialize
@@ -77,7 +72,7 @@ class ERC20::FakeWallet
     42_000_000
   end
 
-  # How much gas units is required in order to send ERC20 transaction.
+  # How many gas units are required to send an ERC20 transaction.
   #
   # @param [String] from The departing address, in hex
   # @param [String] to Arriving address, in hex
@@ -137,7 +132,7 @@ class ERC20::FakeWallet
       sleep(delay)
       a = addresses.to_a.sample
       next if a.nil?
-      event =
+      yield(
         if raw
           {}
         else
@@ -148,7 +143,7 @@ class ERC20::FakeWallet
             txn: TXN_HASH
           }
         end
-      yield event
+      )
     end
   end
 end

data/lib/erc20/wallet.rb

@@ -58,10 +58,9 @@ require_relative 'erc20'
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 class ERC20::Wallet
-  # Address of USDT contract.
   USDT = '0xdac17f958d2ee523a2206206994597c13d831ec7'
+  TRANSFER = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'
 
-  # These properties are read-only:
   attr_reader :host, :port, :ssl, :chain, :contract, :ws_path, :http_path
 
   # Constructor.
@@ -73,36 +72,50 @@ class ERC20::Wallet
   # @param [String] ws_path The path in the connection URL, for Websockets
   # @param [Boolean] ssl Should we use SSL (for https and wss)
   # @param [String] proxy The URL of the proxy to use
+  # @param [Integer] attempts How many times to retry a failed HTTP RPC call before giving up
+  # @param [Array<String>] fallbacks Alternative HTTP RPC endpoint URLs to try when the primary one fails
   # @param [Object] log The destination for logs
-  def initialize(contract: USDT, chain: 1, log: $stdout,
-                 host: nil, port: 443, http_path: '/', ws_path: '/',
-                 ssl: true, proxy: nil)
-    raise 'Contract can\'t be nil' unless contract
-    raise 'Contract must be a String' unless contract.is_a?(String)
-    raise 'Invalid format of the contract' unless /^0x[0-9a-fA-F]{40}$/.match?(contract)
+  def initialize(
+    contract: USDT, chain: 1, log: $stdout,
+    host: nil, port: 443, http_path: '/', ws_path: '/',
+    ssl: true, proxy: nil, attempts: 1, fallbacks: []
+  )
+    raise(ArgumentError, 'Contract can\'t be nil') unless contract
+    raise(ArgumentError, 'Contract must be a String') unless contract.is_a?(String)
+    raise(ArgumentError, 'Invalid format of the contract') unless /^0x[0-9a-fA-F]{40}$/.match?(contract)
     @contract = contract
-    raise 'Host can\'t be nil' unless host
-    raise 'Host must be a String' unless host.is_a?(String)
+    raise(ArgumentError, 'Host can\'t be nil') unless host
+    raise(ArgumentError, 'Host must be a String') unless host.is_a?(String)
     @host = host
-    raise 'Port can\'t be nil' unless port
-    raise 'Port must be an Integer' unless port.is_a?(Integer)
-    raise 'Port must be a positive Integer' unless port.positive?
+    raise(ArgumentError, 'Port can\'t be nil') unless port
+    raise(ArgumentError, 'Port must be an Integer') unless port.is_a?(Integer)
+    raise(ArgumentError, 'Port must be a positive Integer') unless port.positive?
     @port = port
-    raise 'Ssl can\'t be nil' if ssl.nil?
+    raise(ArgumentError, 'Ssl can\'t be nil') if ssl.nil?
     @ssl = ssl
-    raise 'Http_path can\'t be nil' unless http_path
-    raise 'Http_path must be a String' unless http_path.is_a?(String)
+    raise(ArgumentError, 'Http_path can\'t be nil') unless http_path
+    raise(ArgumentError, 'Http_path must be a String') unless http_path.is_a?(String)
     @http_path = http_path
-    raise 'Ws_path can\'t be nil' unless ws_path
-    raise 'Ws_path must be a String' unless ws_path.is_a?(String)
+    raise(ArgumentError, 'Ws_path can\'t be nil') unless ws_path
+    raise(ArgumentError, 'Ws_path must be a String') unless ws_path.is_a?(String)
     @ws_path = ws_path
-    raise 'Log can\'t be nil' unless log
+    raise(ArgumentError, 'Log can\'t be nil') unless log
     @log = log
-    raise 'Chain can\'t be nil' unless chain
-    raise 'Chain must be an Integer' unless chain.is_a?(Integer)
-    raise 'Chain must be a positive Integer' unless chain.positive?
+    raise(ArgumentError, 'Chain can\'t be nil') unless chain
+    raise(ArgumentError, 'Chain must be an Integer') unless chain.is_a?(Integer)
+    raise(ArgumentError, 'Chain must be a positive Integer') unless chain.positive?
     @chain = chain
     @proxy = proxy
+    raise(ArgumentError, 'Attempts can\'t be nil') unless attempts
+    raise(ArgumentError, 'Attempts must be an Integer') unless attempts.is_a?(Integer)
+    raise(ArgumentError, 'Attempts must be a positive Integer') unless attempts.positive?
+    @attempts = attempts
+    raise(ArgumentError, 'Fallbacks can\'t be nil') if fallbacks.nil?
+    raise(ArgumentError, 'Fallbacks must be an Array') unless fallbacks.is_a?(Array)
+    fallbacks.each do |f|
+      raise(ArgumentError, 'Each fallback must be a String') unless f.is_a?(String)
+    end
+    @fallbacks = fallbacks
     @mutex = Mutex.new
   end
 
@@ -115,16 +128,11 @@ class ERC20::Wallet
   # @param [String] address Public key, in hex, starting from '0x'
   # @return [Integer] Balance, in tokens
   def balance(address)
-    raise 'Address can\'t be nil' unless address
-    raise 'Address must be a String' unless address.is_a?(String)
-    raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(address)
-    func = '70a08231' # balanceOf
-    data = "0x#{func}000000000000000000000000#{address[2..].downcase}"
-    r =
-      with_jsonrpc do |jr|
-        jr.eth_call({ to: @contract, data: data }, 'latest')
-      end
-    b = r[2..].to_i(16)
+    raise(ArgumentError, 'Address can\'t be nil') unless address
+    raise(ArgumentError, 'Address must be a String') unless address.is_a?(String)
+    raise(ArgumentError, 'Invalid format of the address') unless /^0x[0-9a-fA-F]{40}$/.match?(address)
+    data = "0x70a08231000000000000000000000000#{address[2..].downcase}"
+    b = with_jsonrpc { |jr| jr.eth_call({ to: @contract, data: data }, 'latest') }[2..].to_i(16)
     log_it(:debug, "The balance of #{address} is #{b} ERC20 tokens")
     b
   end
@@ -137,14 +145,10 @@ class ERC20::Wallet
   # @param [String] address Public key, in hex, starting from '0x'
   # @return [Integer] Balance, in ETH
   def eth_balance(address)
-    raise 'Address can\'t be nil' unless address
-    raise 'Address must be a String' unless address.is_a?(String)
-    raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(address)
-    r =
-      with_jsonrpc do |jr|
-        jr.eth_getBalance(address, 'latest')
-      end
-    b = r[2..].to_i(16)
+    raise(ArgumentError, 'Address can\'t be nil') unless address
+    raise(ArgumentError, 'Address must be a String') unless address.is_a?(String)
+    raise(ArgumentError, 'Invalid format of the address') unless /^0x[0-9a-fA-F]{40}$/.match?(address)
+    b = with_jsonrpc { |jr| jr.eth_getBalance(address, 'latest') }[2..].to_i(16)
     log_it(:debug, "The balance of #{address} is #{b} ETHs")
     b
   end
@@ -154,24 +158,23 @@ class ERC20::Wallet
   # @param [String] txn Hex of transaction
   # @return [Integer] Balance, in ERC20 tokens
   def sum_of(txn)
-    raise 'Transaction hash can\'t be nil' unless txn
-    raise 'Transaction hash must be a String' unless txn.is_a?(String)
-    raise 'Invalid format of the transaction hash' unless /^0x[0-9a-fA-F]{64}$/.match?(txn)
+    raise(ArgumentError, 'Transaction hash can\'t be nil') unless txn
+    raise(ArgumentError, 'Transaction hash must be a String') unless txn.is_a?(String)
+    raise(ArgumentError, 'Invalid format of the transaction hash') unless /^0x[0-9a-fA-F]{64}$/.match?(txn)
     receipt =
       with_jsonrpc do |jr|
         jr.eth_getTransactionReceipt(txn)
       end
-    raise "Transaction not found: #{txn}" if receipt.nil?
+    raise(StandardError, "Transaction not found: #{txn}") if receipt.nil?
     logs = receipt['logs'] || []
-    transfer_event = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'
     logs.each do |log|
-      next unless log['topics'] && log['topics'][0] == transfer_event
+      next unless log['topics'] && log['topics'][0] == TRANSFER
       next unless log['address'].downcase == @contract.downcase
       amount = log['data'].to_i(16)
       log_it(:debug, "Found transfer of #{amount} tokens in transaction #{txn}")
       return amount
     end
-    raise "No transfer event found in transaction #{txn}"
+    raise(StandardError, "No transfer event found in transaction #{txn}")
   end
 
   # How many gas units are required to send an ERC20 transaction.
@@ -181,15 +184,15 @@ class ERC20::Wallet
   # @param [Integer] amount How many ERC20 tokens to send
   # @return [Integer] Number of gas units required
   def gas_estimate(from, to, amount)
-    raise 'Address can\'t be nil' unless from
-    raise 'Address must be a String' unless from.is_a?(String)
-    raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(from)
-    raise 'Address can\'t be nil' unless to
-    raise 'Address must be a String' unless to.is_a?(String)
-    raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(to)
-    raise 'Amount can\'t be nil' unless amount
-    raise "Amount (#{amount}) must be an Integer" unless amount.is_a?(Integer)
-    raise "Amount (#{amount}) must be a positive Integer" unless amount.positive?
+    raise(ArgumentError, 'Address can\'t be nil') unless from
+    raise(ArgumentError, 'Address must be a String') unless from.is_a?(String)
+    raise(ArgumentError, 'Invalid format of the address') unless /^0x[0-9a-fA-F]{40}$/.match?(from)
+    raise(ArgumentError, 'Address can\'t be nil') unless to
+    raise(ArgumentError, 'Address must be a String') unless to.is_a?(String)
+    raise(ArgumentError, 'Invalid format of the address') unless /^0x[0-9a-fA-F]{40}$/.match?(to)
+    raise(ArgumentError, 'Amount can\'t be nil') unless amount
+    raise(ArgumentError, "Amount (#{amount}) must be an Integer") unless amount.is_a?(Integer)
+    raise(ArgumentError, "Amount (#{amount}) must be a positive Integer") unless amount.positive?
     gas =
       with_jsonrpc do |jr|
         jr.eth_estimateGas({ from:, to: @contract, data: to_pay_data(to, amount) }, 'latest').to_i(16)
@@ -198,25 +201,35 @@ class ERC20::Wallet
     gas
   end
 
-  # What is the price of gas unit in gwei?
+  GAS_PRICE_TIP = 1_000_000_000
+
+  # What is the price of gas unit in wei?
   #
   # In Ethereum, gas is a unit that measures the computational work required to
   # execute operations on the network. Every transaction and smart contract
   # interaction consumes gas. Gas price is the amount of ETH you're willing to pay
-  # for each unit of gas, denominated in gwei (1 gwei = 0.000000001 ETH). Higher
+  # for each unit of gas, denominated in wei (1 gwei = 0.000000001 ETH). Higher
   # gas prices incentivize miners to include your transaction sooner, while lower
   # prices may result in longer confirmation times.
   #
-  # @return [Integer] Price of gas unit, in gwei (0.000000001 ETH)
+  # The returned price is not the bare EIP-1559 base fee. The base fee alone
+  # leaves a zero miner tip (+tip = gasPrice - baseFee = 0+), so proposers have
+  # no incentive to include the transaction, and it becomes unmineable the
+  # moment the base fee rises (it may grow up to 12.5% per block). To make the
+  # price mineable, we double the base fee (a buffer that absorbs several blocks
+  # of base-fee growth) and add a priority tip (+GAS_PRICE_TIP+).
+  #
+  # @return [Integer] Price of gas unit, in wei (1 gwei = 0.000000001 ETH)
   def gas_price
     block =
       with_jsonrpc do |jr|
         jr.eth_getBlockByNumber('latest', false)
       end
-    raise "Can't get gas price, try again later" if block.nil?
-    gwei = block['baseFeePerGas'].to_i(16)
-    log_it(:debug, "The cost of one gas unit is #{gwei} gwei")
-    gwei
+    raise(StandardError, "Can't get gas price, try again later") if block.nil?
+    base = block['baseFeePerGas'].to_i(16)
+    price = (base * 2) + GAS_PRICE_TIP
+    log_it(:debug, "The base fee is #{base} wei, the cost of one gas unit is #{price} wei")
+    price
   end
 
   # Send a single ERC20 payment from a private address to a public one.
@@ -236,40 +249,40 @@ class ERC20::Wallet
   # @param [Integer] price How much gas you pay per computation unit
   # @return [String] Transaction hash
   def pay(priv, address, amount, limit: nil, price: gas_price)
-    raise 'Private key can\'t be nil' unless priv
-    raise 'Private key must be a String' unless priv.is_a?(String)
-    raise 'Invalid format of private key' unless /^[0-9a-fA-F]{64}$/.match?(priv)
-    raise 'Address can\'t be nil' unless address
-    raise 'Address must be a String' unless address.is_a?(String)
-    raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(address)
-    raise 'Amount can\'t be nil' unless amount
-    raise "Amount (#{amount}) must be an Integer" unless amount.is_a?(Integer)
-    raise "Amount (#{amount}) must be a positive Integer" unless amount.positive?
+    raise(ArgumentError, 'Private key can\'t be nil') unless priv
+    raise(ArgumentError, 'Private key must be a String') unless priv.is_a?(String)
+    raise(ArgumentError, 'Invalid format of private key') unless /^[0-9a-fA-F]{64}$/.match?(priv)
+    raise(ArgumentError, 'Address can\'t be nil') unless address
+    raise(ArgumentError, 'Address must be a String') unless address.is_a?(String)
+    raise(ArgumentError, 'Invalid format of the address') unless /^0x[0-9a-fA-F]{40}$/.match?(address)
+    raise(ArgumentError, 'Amount can\'t be nil') unless amount
+    raise(ArgumentError, "Amount (#{amount}) must be an Integer") unless amount.is_a?(Integer)
+    raise(ArgumentError, "Amount (#{amount}) must be a positive Integer") unless amount.positive?
     if limit
-      raise 'Gas limit must be an Integer' unless limit.is_a?(Integer)
-      raise "Gas limit #{limit} is below #{Eth::Tx::DEFAULT_GAS_LIMIT}" if limit < Eth::Tx::DEFAULT_GAS_LIMIT
-      raise "Gas limit #{limit} is above #{Eth::Tx::BLOCK_GAS_LIMIT}" if limit > Eth::Tx::BLOCK_GAS_LIMIT
+      raise(ArgumentError, 'Gas limit must be an Integer') unless limit.is_a?(Integer)
+      raise(ArgumentError, "Gas limit #{limit} is below #{Eth::Tx::DEFAULT_GAS_LIMIT}") if limit < Eth::Tx::DEFAULT_GAS_LIMIT
+      raise(ArgumentError, "Gas limit #{limit} is above #{Eth::Tx::BLOCK_GAS_LIMIT}") if limit > Eth::Tx::BLOCK_GAS_LIMIT
     end
     if price
-      raise 'Gas price must be an Integer' unless price.is_a?(Integer)
-      raise 'Gas price must be a positive Integer' unless price.positive?
+      raise(ArgumentError, 'Gas price must be an Integer') unless price.is_a?(Integer)
+      raise(ArgumentError, 'Gas price must be a positive Integer') unless price.positive?
     end
     key = Eth::Key.new(priv: priv)
     from = key.address.to_s
     tnx =
       @mutex.synchronize do
         with_jsonrpc do |jr|
-          nonce = jr.eth_getTransactionCount(from, 'pending').to_i(16)
-          h = {
-            nonce:,
-            gas_price: price,
-            gas_limit: limit || gas_estimate(from, address, amount),
-            to: @contract,
-            value: 0,
-            data: to_pay_data(address, amount),
-            chain_id: @chain
-          }
-          tx = Eth::Tx.new(h)
+          tx = Eth::Tx.new(
+            {
+              nonce: jr.eth_getTransactionCount(from, 'pending').to_i(16),
+              gas_price: price,
+              gas_limit: limit || gas_estimate(from, address, amount),
+              to: @contract,
+              value: 0,
+              data: to_pay_data(address, amount),
+              chain_id: @chain
+            }
+          )
           tx.sign(key)
           hex = "0x#{tx.hex}"
           log_it(:debug, "Sending ERC20 transaction #{hex}")
@@ -288,34 +301,34 @@ class ERC20::Wallet
   # @param [Integer] price How much gas you pay per computation unit
   # @return [String] Transaction hash
   def eth_pay(priv, address, amount, price: gas_price)
-    raise 'Private key can\'t be nil' unless priv
-    raise 'Private key must be a String' unless priv.is_a?(String)
-    raise 'Invalid format of private key' unless /^[0-9a-fA-F]{64}$/.match?(priv)
-    raise 'Address can\'t be nil' unless address
-    raise 'Address must be a String' unless address.is_a?(String)
-    raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(address)
-    raise 'Amount can\'t be nil' unless amount
-    raise "Amount (#{amount}) must be an Integer" unless amount.is_a?(Integer)
-    raise "Amount (#{amount}) must be a positive Integer" unless amount.positive?
+    raise(ArgumentError, 'Private key can\'t be nil') unless priv
+    raise(ArgumentError, 'Private key must be a String') unless priv.is_a?(String)
+    raise(ArgumentError, 'Invalid format of private key') unless /^[0-9a-fA-F]{64}$/.match?(priv)
+    raise(ArgumentError, 'Address can\'t be nil') unless address
+    raise(ArgumentError, 'Address must be a String') unless address.is_a?(String)
+    raise(ArgumentError, 'Invalid format of the address') unless /^0x[0-9a-fA-F]{40}$/.match?(address)
+    raise(ArgumentError, 'Amount can\'t be nil') unless amount
+    raise(ArgumentError, "Amount (#{amount}) must be an Integer") unless amount.is_a?(Integer)
+    raise(ArgumentError, "Amount (#{amount}) must be a positive Integer") unless amount.positive?
     if price
-      raise 'Gas price must be an Integer' unless price.is_a?(Integer)
-      raise 'Gas price must be a positive Integer' unless price.positive?
+      raise(ArgumentError, 'Gas price must be an Integer') unless price.is_a?(Integer)
+      raise(ArgumentError, 'Gas price must be a positive Integer') unless price.positive?
     end
     key = Eth::Key.new(priv: priv)
     from = key.address.to_s
     tnx =
       @mutex.synchronize do
         with_jsonrpc do |jr|
-          nonce = jr.eth_getTransactionCount(from, 'pending').to_i(16)
-          h = {
-            chain_id: @chain,
-            nonce:,
-            gas_price: price,
-            gas_limit: 22_000,
-            to: address,
-            value: amount
-          }
-          tx = Eth::Tx.new(h)
+          tx = Eth::Tx.new(
+            {
+              chain_id: @chain,
+              nonce: jr.eth_getTransactionCount(from, 'pending').to_i(16),
+              gas_price: price,
+              gas_limit: 22_000,
+              to: address,
+              value: amount
+            }
+          )
           tx.sign(key)
           hex = "0x#{tx.hex}"
           log_it(:debug, "Sending ETH transaction #{hex}")
@@ -352,16 +365,16 @@ class ERC20::Wallet
   # @param [Integer] delay How many seconds to wait between +eth_subscribe+ calls
   # @param [Integer] subscription_id Unique ID of the subscription
   def accept(addresses, active = [], raw: false, delay: 1, subscription_id: rand(99_999), &)
-    raise 'Addresses can\'t be nil' unless addresses
-    raise 'Addresses must respond to .to_a()' unless addresses.respond_to?(:to_a)
-    raise 'Active can\'t be nil' unless active
-    raise 'Active must respond to .to_a()' unless active.respond_to?(:to_a)
-    raise 'Active must respond to .append()' unless active.respond_to?(:append)
-    raise 'Active must respond to .clear()' unless active.respond_to?(:clear)
-    raise 'Delay must be an Integer' unless delay.is_a?(Integer)
-    raise 'Delay must be a positive Integer or positive Float' unless delay.positive?
-    raise 'Subscription ID must be an Integer' unless subscription_id.is_a?(Integer)
-    raise 'Subscription ID must be a positive Integer' unless subscription_id.positive?
+    raise(ArgumentError, 'Addresses can\'t be nil') unless addresses
+    raise(ArgumentError, 'Addresses must respond to .to_a()') unless addresses.respond_to?(:to_a)
+    raise(ArgumentError, 'Active can\'t be nil') unless active
+    raise(ArgumentError, 'Active must respond to .to_a()') unless active.respond_to?(:to_a)
+    raise(ArgumentError, 'Active must respond to .append()') unless active.respond_to?(:append)
+    raise(ArgumentError, 'Active must respond to .clear()') unless active.respond_to?(:clear)
+    raise(ArgumentError, 'Delay must be an Integer') unless delay.is_a?(Integer)
+    raise(ArgumentError, 'Delay must be a positive Integer or positive Float') unless delay.positive?
+    raise(ArgumentError, 'Subscription ID must be an Integer') unless subscription_id.is_a?(Integer)
+    raise(ArgumentError, 'Subscription ID must be a positive Integer') unless subscription_id.positive?
     EventMachine.run do
       reaccept(addresses, active, raw:, delay:, subscription_id:, &)
     end
@@ -389,6 +402,7 @@ class ERC20::Wallet
           timer =
             EventMachine.add_periodic_timer(delay) do
               next if active.to_a.sort == addresses.to_a.sort
+              # rubocop:disable Style/Send
               ws.send(
                 {
                   jsonrpc: '2.0',
@@ -407,6 +421,7 @@ class ERC20::Wallet
                   ]
                 }.to_json
               )
+              # rubocop:enable Style/Send
               log_it(
                 :debug,
                 "Requested to subscribe ##{subscription_id} to #{addresses.to_a.size} addresses: " \
@@ -448,7 +463,7 @@ class ERC20::Wallet
                 "from #{event[:from]} to #{event[:to]} in #{event[:txn]}"
               )
             end
-            yield event
+            yield(event)
           end
         end
       end
@@ -482,13 +497,13 @@ class ERC20::Wallet
     yield
   rescue StandardError => e
     log_it(:error, Backtrace.new(e).to_s)
-    raise e
+    raise(e)
   end
 
   def safe
     yield
   rescue StandardError
-    # ignore it
+    nil
   end
 
   def url(http: true)
@@ -503,25 +518,30 @@ class ERC20::Wallet
       opts[:connection] =
         Faraday.new do |f|
           f.adapter(Faraday.default_adapter)
-          f.proxy = {
-            uri: "#{uri.scheme}://#{uri.hostname}:#{uri.port}",
-            user: uri.user,
-            password: uri.password
-          }
+          f.proxy = { uri: "#{uri.scheme}://#{uri.hostname}:#{uri.port}", user: uri.user, password: uri.password }
         end
     end
-    elapsed(@log, good: "Talked to #{url.host}:#{url.port}") do
-      yield JSONRPC::Client.new(url.to_s, opts)
+    endpoints = [url.to_s] + @fallbacks
+    attempt = 0
+    begin
+      attempt += 1
+      u = URI.parse(endpoints[(attempt - 1) % endpoints.size])
+      elapsed(@log, good: "Talked to #{u.host}:#{u.port}") do
+        yield(JSONRPC::Client.new(u.to_s, opts))
+      end
+    rescue StandardError => e
+      raise if attempt >= @attempts
+      pause = 2**(attempt - 1)
+      log_it(:debug, "Attempt #{attempt}/#{@attempts} to #{u.host} failed (#{e.class}), retrying in #{pause}s")
+      sleep(pause)
+      retry
     end
   end
 
   def to_pay_data(address, amount)
-    func = 'a9059cbb' # transfer(address,uint256)
     to_clean = address.downcase.sub(/^0x/, '')
-    to_padded = ('0' * (64 - to_clean.size)) + to_clean
     amt_hex = amount.to_s(16)
-    amt_padded = ('0' * (64 - amt_hex.size)) + amt_hex
-    "0x#{func}#{to_padded}#{amt_padded}"
+    "0xa9059cbb#{('0' * (64 - to_clean.size)) + to_clean}#{('0' * (64 - amt_hex.size)) + amt_hex}"
   end
 
   def log_it(method, msg)

data/lib/erc20.rb

@@ -4,5 +4,5 @@
 # SPDX-License-Identifier: MIT
 
 require_relative 'erc20/erc20'
-require_relative 'erc20/wallet'
 require_relative 'erc20/fake_wallet'
+require_relative 'erc20/wallet'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: erc20
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.3.0
 platform: ruby
 authors:
 - Yegor Bugayenko