erc20 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c869348131d5d5bcb38966bc1eaac3d3e9655b11d6846f7ca9bc54893fb68458
-  data.tar.gz: 625b971154f40e09a8fd66091d154df5657efc4dee202bf3a5db3cc62c7e2a54
+  metadata.gz: 96f0b876fa43c7c6ca87ebd998987fce27fa8a3c1923d906e71d674265083e7a
+  data.tar.gz: 9b43b005266bb003a086b4457a0d31f1dcd7eba08b82d6301ae5a93f9bfd32d3
 SHA512:
-  metadata.gz: 30abb7a895214f536f1c91ad6758b023ded4d28be61265c1db9576a60e71e3b3737b7c86157ba314d649b4096dd86b93936920d8c8a0d76ded554c86da69d931
-  data.tar.gz: 39083d6adc8e2eed75a7d548c2ae4a8311fc226199f2f6c679f23012945a31b2458a766278cb028fd7754d5c95975b2bbde7afbeb1342591cc1f3bf5d8b4f69e
+  metadata.gz: 1d3e51d047763a3139c77286b41af1fdfeb40c2d10ed0c86dbfe1f1443d328957a1b37fc27a147ffcfcbb2c40f1071144a781292cf71e58dd5858045740cefd4
+  data.tar.gz: d4baf3bd795940d5daad717ec0b8b182bc849fc000fd402ae3906d93ad31d371c1ed5aaf82e02af2ccc4ff051bd24b83104c73316c34eeb917c094e747f1f9f0

data/.gitignore

@@ -1,10 +1,10 @@
-coverage/
-.idea/
 *.gem
-.bundle/
 .DS_Store
-rdoc/
-doc/
+.bundle/
+.idea/
 .yardoc/
+coverage/
+doc/
 node_modules/
+rdoc/
 vendor/

data/.rultor.yml

@@ -3,7 +3,7 @@
 ---
 # yamllint disable rule:line-length
 docker:
-  image: yegor256/rultor-ruby
+  image: yegor256/ruby
 assets:
   rubygems.yml: yegor256/home#assets/rubygems.yml
 install: |

data/Gemfile

@@ -7,24 +7,24 @@ source 'https://rubygems.org'
 gemspec
 
 gem 'backtrace', '>0', require: false
-gem 'cucumber', '9.1.2', require: false
+gem 'concurrent-ruby', '~>1.2', require: false
+gem 'cucumber', '~>9.2', require: false
 gem 'donce', '>0', require: false
 gem 'faraday', '>0', require: false
 gem 'loog', '>0', require: false
-gem 'minitest', '5.25.4', require: false
-gem 'minitest-reporters', '1.7.1', require: false
-gem 'minitest-retry', '0.2.5', require: false
+gem 'minitest', '~>5.25', require: false
+gem 'minitest-reporters', '~>1.7', require: false
+gem 'minitest-retry', '~>0.2', require: false
 gem 'qbash', '>0', require: false
-gem 'rake', '13.2.1', require: false
+gem 'rake', '~>13.2', require: false
 gem 'random-port', '>0', require: false
-gem 'rspec-rails', '7.1.1', require: false
-gem 'rubocop', '1.72.2', require: false
+gem 'rubocop', '~>1.75', require: false
 gem 'rubocop-minitest', '>0', require: false
 gem 'rubocop-performance', '>0', require: false
 gem 'rubocop-rake', '>0', require: false
 gem 'rubocop-rspec', '>0', require: false
-gem 'simplecov', '0.22.0', require: false
-gem 'simplecov-cobertura', '2.1.0', require: false
-gem 'threads', '0.4.1', require: false
+gem 'simplecov', '~>0.22', require: false
+gem 'simplecov-cobertura', '~>2.1', require: false
+gem 'threads', '~>0.4', require: false
 gem 'typhoeus', '>0', require: false
-gem 'yard', '0.9.37', require: false
+gem 'yard', '~>0.9', require: false

data/Gemfile.lock

@@ -12,83 +12,49 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    actionpack (8.0.1)
-      actionview (= 8.0.1)
-      activesupport (= 8.0.1)
-      nokogiri (>= 1.8.5)
-      rack (>= 2.2.4)
-      rack-session (>= 1.0.1)
-      rack-test (>= 0.6.3)
-      rails-dom-testing (~> 2.2)
-      rails-html-sanitizer (~> 1.6)
-      useragent (~> 0.16)
-    actionview (8.0.1)
-      activesupport (= 8.0.1)
-      builder (~> 3.1)
-      erubi (~> 1.11)
-      rails-dom-testing (~> 2.2)
-      rails-html-sanitizer (~> 1.6)
-    activesupport (8.0.1)
-      base64
-      benchmark (>= 0.3)
-      bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.3.1)
-      connection_pool (>= 2.2.5)
-      drb
-      i18n (>= 1.6, < 2)
-      logger (>= 1.4.2)
-      minitest (>= 5.1)
-      securerandom (>= 0.3)
-      tzinfo (~> 2.0, >= 2.0.5)
-      uri (>= 0.13.1)
     ansi (1.5.0)
-    ast (2.4.2)
+    ast (2.4.3)
     backtrace (0.4.0)
     base64 (0.2.0)
-    benchmark (0.4.0)
     bigdecimal (3.1.9)
     builder (3.3.0)
     concurrent-ruby (1.3.5)
-    connection_pool (2.5.0)
-    crass (1.0.6)
-    cucumber (9.1.2)
-      builder (~> 3.2, >= 3.2.4)
-      cucumber-ci-environment (~> 9.2, >= 9.2.0)
-      cucumber-core (~> 12.0)
+    cucumber (9.2.1)
+      builder (~> 3.2)
+      cucumber-ci-environment (> 9, < 11)
+      cucumber-core (> 13, < 14)
       cucumber-cucumber-expressions (~> 17.0)
-      cucumber-gherkin (> 24, < 27)
+      cucumber-gherkin (> 24, < 28)
       cucumber-html-formatter (> 20.3, < 22)
       cucumber-messages (> 19, < 25)
       diff-lcs (~> 1.5)
-      mini_mime (~> 1.1, >= 1.1.5)
-      multi_test (~> 1.1, >= 1.1.0)
-      sys-uname (~> 1.2, >= 1.2.3)
-    cucumber-ci-environment (9.2.0)
-    cucumber-core (12.0.0)
-      cucumber-gherkin (>= 25, < 27)
+      mini_mime (~> 1.1)
+      multi_test (~> 1.1)
+      sys-uname (~> 1.2)
+    cucumber-ci-environment (10.0.1)
+    cucumber-core (13.0.3)
+      cucumber-gherkin (>= 27, < 28)
       cucumber-messages (>= 20, < 23)
-      cucumber-tag-expressions (~> 5.0, >= 5.0.4)
+      cucumber-tag-expressions (> 5, < 7)
     cucumber-cucumber-expressions (17.1.0)
       bigdecimal
-    cucumber-gherkin (26.2.0)
-      cucumber-messages (>= 19.1.4, < 22.1)
+    cucumber-gherkin (27.0.0)
+      cucumber-messages (>= 19.1.4, < 23)
     cucumber-html-formatter (21.9.0)
       cucumber-messages (> 19, < 28)
     cucumber-messages (22.0.0)
-    cucumber-tag-expressions (5.0.6)
-    date (3.4.1)
-    diff-lcs (1.6.0)
+    cucumber-tag-expressions (6.1.2)
+    diff-lcs (1.6.1)
     docile (1.4.1)
-    donce (0.1.0)
-      backtrace (> 0)
-      os (> 0)
-      qbash (> 0)
-    drb (2.2.1)
+    donce (0.2.0)
+      backtrace (~> 0.3)
+      os (~> 1.1)
+      qbash (~> 0.3)
     elapsed (0.0.1)
       loog (> 0)
       tago (> 0)
-    erubi (1.13.1)
-    eth (0.5.13)
+    eth (0.5.14)
+      bigdecimal (~> 3.1)
       forwardable (~> 1.3)
       keccak (~> 1.3)
       konstructor (~> 1.0)
@@ -98,7 +64,7 @@ GEM
     ethon (0.16.0)
       ffi (>= 1.15.0)
     eventmachine (1.2.7)
-    faraday (2.12.2)
+    faraday (2.13.0)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
@@ -107,22 +73,15 @@ GEM
     faye-websocket (0.11.3)
       eventmachine (>= 0.12.0)
       websocket-driver (>= 0.5.1)
-    ffi (1.17.1-arm64-darwin)
-    ffi (1.17.1-x64-mingw-ucrt)
-    ffi (1.17.1-x86_64-darwin)
-    ffi (1.17.1-x86_64-linux-gnu)
+    ffi (1.17.2-arm64-darwin)
+    ffi (1.17.2-x64-mingw-ucrt)
+    ffi (1.17.2-x86_64-darwin)
+    ffi (1.17.2-x86_64-linux-gnu)
     ffi-compiler (1.3.2)
       ffi (>= 1.15.5)
       rake
     forwardable (1.3.3)
-    i18n (1.14.7)
-      concurrent-ruby (~> 1.0)
-    io-console (0.8.0)
-    irb (1.15.1)
-      pp (>= 0.6.0)
-      rdoc (>= 4.0.0)
-      reline (>= 0.4.2)
-    json (2.10.1)
+    json (2.10.2)
     jsonrpc-client (0.1.4)
       faraday
       multi_json (>= 1.1.0)
@@ -130,14 +89,11 @@ GEM
     konstructor (1.0.2)
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
-    logger (1.6.6)
-    loofah (2.24.0)
-      crass (~> 1.0.2)
-      nokogiri (>= 1.12.0)
+    logger (1.7.0)
     loog (0.6.0)
     mini_mime (1.1.5)
     mini_portile2 (2.8.8)
-    minitest (5.25.4)
+    minitest (5.25.5)
     minitest-reporters (1.7.1)
       ansi
       builder
@@ -149,56 +105,20 @@ GEM
     multi_test (1.1.0)
     net-http (0.6.0)
       uri
-    nokogiri (1.18.3-arm64-darwin)
-      racc (~> 1.4)
-    nokogiri (1.18.3-x64-mingw-ucrt)
-      racc (~> 1.4)
-    nokogiri (1.18.3-x86_64-darwin)
-      racc (~> 1.4)
-    nokogiri (1.18.3-x86_64-linux-gnu)
-      racc (~> 1.4)
     openssl (3.3.0)
     os (1.1.4)
-    parallel (1.26.3)
-    parser (3.3.7.1)
+    parallel (1.27.0)
+    parser (3.3.8.0)
       ast (~> 2.4.1)
       racc
-    pkg-config (1.5.9)
-    pp (0.6.2)
-      prettyprint
-    prettyprint (0.2.0)
-    psych (5.2.3)
-      date
-      stringio
+    pkg-config (1.6.1)
+    prism (1.4.0)
     qbash (0.4.0)
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
       tago (> 0)
     racc (1.8.1)
-    rack (3.1.10)
-    rack-session (2.1.0)
-      base64 (>= 0.1.0)
-      rack (>= 3.0.0)
-    rack-test (2.2.0)
-      rack (>= 1.3)
-    rackup (2.2.1)
-      rack (>= 3)
-    rails-dom-testing (2.2.0)
-      activesupport (>= 5.0.0)
-      minitest
-      nokogiri (>= 1.6)
-    rails-html-sanitizer (1.6.2)
-      loofah (~> 2.21)
-      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
-    railties (8.0.1)
-      actionpack (= 8.0.1)
-      activesupport (= 8.0.1)
-      irb (~> 1.13)
-      rackup (>= 1.0.0)
-      rake (>= 12.2)
-      thor (~> 1.0, >= 1.2.2)
-      zeitwerk (~> 2.6)
     rainbow (3.1.1)
     rake (13.2.1)
     random-port (0.7.5)
@@ -207,30 +127,9 @@ GEM
       mini_portile2 (~> 2.8)
       pkg-config (~> 1.5)
       rubyzip (~> 2.3)
-    rdoc (6.12.0)
-      psych (>= 4.0.0)
     regexp_parser (2.10.0)
-    reline (0.6.0)
-      io-console (~> 0.5)
     rexml (3.4.1)
-    rspec-core (3.13.3)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.3)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-rails (7.1.1)
-      actionpack (>= 7.0)
-      activesupport (>= 7.0)
-      railties (>= 7.0)
-      rspec-core (~> 3.13)
-      rspec-expectations (~> 3.13)
-      rspec-mocks (~> 3.13)
-      rspec-support (~> 3.13)
-    rspec-support (3.13.2)
-    rubocop (1.72.2)
+    rubocop (1.75.2)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -238,23 +137,24 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.38.0, < 2.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.38.0)
-      parser (>= 3.3.1.0)
-    rubocop-minitest (0.37.1)
+    rubocop-ast (1.44.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-minitest (0.38.0)
       lint_roller (~> 1.1)
-      rubocop (>= 1.72.1, < 2.0)
+      rubocop (>= 1.75.0, < 2.0)
       rubocop-ast (>= 1.38.0, < 2.0)
-    rubocop-performance (1.24.0)
+    rubocop-performance (1.25.0)
       lint_roller (~> 1.1)
-      rubocop (>= 1.72.1, < 2.0)
+      rubocop (>= 1.75.0, < 2.0)
       rubocop-ast (>= 1.38.0, < 2.0)
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
-    rubocop-rspec (3.5.0)
+    rubocop-rspec (3.6.0)
       lint_roller (~> 1.1)
       rubocop (~> 1.72, >= 1.72.1)
     ruby-progressbar (1.13.0)
@@ -262,7 +162,6 @@ GEM
     scrypt (3.0.8)
       ffi-compiler (>= 1.0, < 2.0)
       rake (>= 9, < 14)
-    securerandom (0.4.1)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
@@ -273,29 +172,23 @@ GEM
     simplecov-html (0.13.1)
     simplecov_json_formatter (0.1.4)
     slop (4.10.1)
-    stringio (3.1.5)
     sys-uname (1.3.1)
       ffi (~> 1.1)
-    tago (0.0.2)
-    thor (1.3.2)
+    tago (0.1.0)
     threads (0.4.1)
       backtrace (~> 0)
       concurrent-ruby (~> 1.0)
     typhoeus (1.4.1)
       ethon (>= 0.9.0)
-    tzinfo (2.0.6)
-      concurrent-ruby (~> 1.0)
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.0.4)
-    uri (1.0.2)
-    useragent (0.16.11)
+    uri (1.0.3)
     websocket-driver (0.7.7)
       base64
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
     yard (0.9.37)
-    zeitwerk (2.7.2)
 
 PLATFORMS
   arm64-darwin-22
@@ -308,28 +201,28 @@ PLATFORMS
 
 DEPENDENCIES
   backtrace (> 0)
-  cucumber (= 9.1.2)
+  concurrent-ruby (~> 1.2)
+  cucumber (~> 9.2)
   donce (> 0)
   erc20!
   faraday (> 0)
   loog (> 0)
-  minitest (= 5.25.4)
-  minitest-reporters (= 1.7.1)
-  minitest-retry (= 0.2.5)
+  minitest (~> 5.25)
+  minitest-reporters (~> 1.7)
+  minitest-retry (~> 0.2)
   qbash (> 0)
-  rake (= 13.2.1)
+  rake (~> 13.2)
   random-port (> 0)
-  rspec-rails (= 7.1.1)
-  rubocop (= 1.72.2)
+  rubocop (~> 1.75)
   rubocop-minitest (> 0)
   rubocop-performance (> 0)
   rubocop-rake (> 0)
   rubocop-rspec (> 0)
-  simplecov (= 0.22.0)
-  simplecov-cobertura (= 2.1.0)
-  threads (= 0.4.1)
+  simplecov (~> 0.22)
+  simplecov-cobertura (~> 2.1)
+  threads (~> 0.4)
   typhoeus (> 0)
-  yard (= 0.9.37)
+  yard (~> 0.9)
 
 BUNDLED WITH
    2.5.16

data/README.md

@@ -1,21 +1,36 @@
-# Etherium ERC20 Manipulations in Ruby
+# Ethereum ERC20 Manipulations in Ruby
 
-[![DevOps By Rultor.com](http://www.rultor.com/b/yegor256/erc20)](http://www.rultor.com/p/yegor256/erc20)
+[![DevOps By Rultor.com](https://www.rultor.com/b/yegor256/erc20)](https://www.rultor.com/p/yegor256/erc20)
 [![We recommend RubyMine](https://www.elegantobjects.org/rubymine.svg)](https://www.jetbrains.com/ruby/)
 
 [![rake](https://github.com/yegor256/erc20/actions/workflows/rake.yml/badge.svg)](https://github.com/yegor256/erc20/actions/workflows/rake.yml)
-[![PDD status](http://www.0pdd.com/svg?name=yegor256/erc20)](http://www.0pdd.com/p?name=yegor256/erc20)
-[![Gem Version](https://badge.fury.io/rb/erc20.svg)](http://badge.fury.io/rb/erc20)
+[![PDD status](https://www.0pdd.com/svg?name=yegor256/erc20)](https://www.0pdd.com/p?name=yegor256/erc20)
+[![Gem Version](https://badge.fury.io/rb/erc20.svg)](https://badge.fury.io/rb/erc20)
 [![Test Coverage](https://img.shields.io/codecov/c/github/yegor256/erc20.svg)](https://codecov.io/github/yegor256/erc20?branch=master)
-[![Yard Docs](http://img.shields.io/badge/yard-docs-blue.svg)](http://rubydoc.info/github/yegor256/erc20/master/frames)
+[![Yard Docs](https://img.shields.io/badge/yard-docs-blue.svg)](https://rubydoc.info/github/yegor256/erc20/master/frames)
 [![Hits-of-Code](https://hitsofcode.com/github/yegor256/erc20)](https://hitsofcode.com/view/github/yegor256/erc20)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/erc20/blob/master/LICENSE.txt)
 
 This small Ruby [gem](https://rubygems.org/gems/erc20)
-makes manipulations with [Etherium] [ERC20] tokens
-as simple as they can be, if you have a provider of
-[JSON-RPC] and [WebSockets] Etherium APIs, for example
-[Infura], [GetBlock], or [Alchemy]:
+makes manipulations with [Ethereum] [ERC20] tokens
+as simple as possible, when you have a provider of
+[JSON-RPC] and [WebSockets] Ethereum APIs, such as
+[Infura], [GetBlock], or [Alchemy].
+
+Install it like this:
+
+```bash
+gem install erc20
+```
+
+Or simply add this to your Gemfile:
+
+```ruby
+gem 'erc20'
+```
+
+Then, make an instance of the main class and use to read
+balances, send and receive payments:
 
 ```ruby
 # Create a wallet:
@@ -44,10 +59,10 @@ w.accept(addresses) do |event|
 end
 ```
 
-It's also possible to check ETH balance and send ETH transaction:
+You can also check ETH balance and send ETH transactions:
 
 ```ruby
-# Check how many ETHs are there on the given address:
+# Check how many ETHs are on the given address:
 eth = w.eth_balance(address)
 
 # Send a few ETHs to someone and get transaction hash:
@@ -91,7 +106,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 forks of [Etherium].
+and other EVM compatible blockchains.
 
 ## How to use in command line
 
@@ -110,13 +125,13 @@ Then, run it:
 erc20 --help
 ```
 
-It should be obvious how to use it. If not, please, submit an issue.
+Usage should be straightforward. If you have questions, please submit an issue.
 
 ## How to use in tests
 
-You can use `ERC20::FakeWallet` class that behaves exactly like
+You can use the `ERC20::FakeWallet` class that behaves exactly like
 `ERC20::Wallet`, but doesn't make any network connections to the provider.
-Also, it remembers all requests that were sent to it:
+Additionally, it records all requests sent to it:
 
 ```ruby
 require 'erc20'
@@ -129,7 +144,7 @@ assert w.history.include?({ method: :pay, priv:, address:, amount: 42_000 })
 
 Read
 [these guidelines](https://www.yegor256.com/2014/04/15/github-guidelines.html).
-Make sure you build is green before you contribute
+Make sure your build is green before you contribute
 your pull request. You will need to have
 [Ruby](https://www.ruby-lang.org/en/) 3.2+ and
 [Bundler](https://bundler.io/) installed. Then:
@@ -142,7 +157,7 @@ bundle exec rake
 If it's clean and you don't see any error messages, submit your pull request.
 
 [gem]: https://github.com/rubygems/rubygems
-[Etherium]: https://en.wikipedia.org/wiki/Ethereum
+[Ethereum]: https://en.wikipedia.org/wiki/Ethereum
 [ERC20]: https://ethereum.org/en/developers/docs/standards/tokens/erc-20/
 [JSON-RPC]: https://ethereum.org/en/developers/docs/apis/json-rpc/
 [Websockets]: https://ethereum.org/en/developers/tutorials/using-websockets/

data/REUSE.toml

@@ -4,6 +4,10 @@
 version = 1
 [[annotations]]
 path = [
+    "**.json",
+    "**.md",
+    "**.png",
+    "**.txt",
     "**/*.csv",
     "**/*.jpg",
     "**/*.json",
@@ -13,13 +17,19 @@ path = [
     "**/*.svg",
     "**/*.txt",
     "**/*.vm",
+    "**/.DS_Store",
     "**/.gitignore",
+    "**/.gitleaksignore",
+    "**/.pdd",
     "**/CNAME",
+    "**/Cargo.toml",
+    "**/Gemfile.lock",
+    ".DS_Store",
     ".gitattributes",
     ".gitignore",
     ".gitleaksignore",
     ".pdd",
-    ".xcop",
+    "Cargo.toml",
     "Gemfile.lock",
     "README.md",
     "hardhat/.gitignore",

data/bin/erc20

@@ -18,7 +18,7 @@ begin
     opts = Slop.parse(ARGV, strict: true, help: true) do |o|
       o.banner = "Usage (#{ERC20::VERSION}): erc20 [options] command [args]
 Commands are:
-    key:         Generate a new Etherium private key (64 symbols)
+    key:         Generate a new Ethereum private key (64 symbols)
     address:     Turn private key into a public address (44 symbols)
     price:       Get current price of one gas unit, in gwei
     pay:         Send ERC20 payment
@@ -33,7 +33,7 @@ Options are:"
       )
       o.integer(
         '--chain',
-        'Etherium chain ID',
+        'Ethereum chain ID',
         default: 1
       )
       o.string(

data/erc20.gemspec

@@ -12,12 +12,12 @@ Gem::Specification.new do |s|
   s.name = 'erc20'
   s.version = ERC20::VERSION
   s.license = 'MIT'
-  s.summary = 'Sending and receiving ERC20 tokens in Etherium network'
+  s.summary = 'Sending and receiving ERC20 tokens in Ethereum network'
   s.description =
     'A simple library for making ERC20 manipulations as easy as they ' \
     'can be for cryptocurrency newbies: checking balance, sending payments, ' \
     'and monitoring addresses for incoming payments. The library expects ' \
-    'Etherium node to provide JSON RPC and Websockets API.'
+    'Ethereum node to provide JSON RPC and Websockets API.'
   s.authors = ['Yegor Bugayenko']
   s.email = 'yegor256@gmail.com'
   s.homepage = 'http://github.com/yegor256/erc20.rb'

data/lib/erc20/erc20.rb

@@ -3,9 +3,9 @@
 # SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
-# This module makes manipulations with Etherium ERC20 tokens
+# This module makes manipulations with Ethereum ERC20 tokens
 # as simple as they can be, if you have a provider of
-# JSON-RPC and WebSockets Etherium APIs, for example
+# JSON-RPC and WebSockets Ethereum APIs, for example
 # Infura, GetBlock, or Alchemy.
 #
 # Start like this:
@@ -25,5 +25,5 @@
 # License:: MIT
 module ERC20
   # Current version of the gem (changed by the +.rultor.yml+ on every release)
-  VERSION = '0.1.0'
+  VERSION = '0.1.2'
 end

data/lib/erc20/fake_wallet.rb

@@ -91,9 +91,11 @@ class ERC20::FakeWallet
 
   # Send a single ERC20 payment from a private address to a public one.
   #
-  # @param [String] _priv Private key, in hex
-  # @param [String] _address Public key, in hex
-  # @param [Integer] _amount The amount of ERC20 tokens to send
+  # @param [String] priv Private key, in hex
+  # @param [String] address Public key, in hex
+  # @param [Integer] amount The amount of ERC20 tokens to send
+  # @param [Integer] gas_limit Optional gas limit
+  # @param [Integer] gas_price Optional gas price in gwei
   # @return [String] Transaction hash
   def pay(priv, address, amount, gas_limit: nil, gas_price: nil)
     hex = TXN_HASH
@@ -106,6 +108,7 @@ class ERC20::FakeWallet
   # @param [String] priv Private key, in hex
   # @param [String] address Public key, in hex
   # @param [Integer] amount The amount of ETHs to send
+  # @param [Integer] gas_price Optional gas price in gwei
   # @return [String] Transaction hash
   def eth_pay(priv, address, amount, gas_price: nil)
     hex = TXN_HASH

data/lib/erc20/wallet.rb

@@ -12,7 +12,7 @@ require 'loog'
 require 'uri'
 require_relative 'erc20'
 
-# A wallet with ERC20 tokens on Etherium.
+# A wallet with ERC20 tokens on Ethereum.
 #
 # Objects of this class are thread-safe.
 #
@@ -64,7 +64,7 @@ class ERC20::Wallet
   attr_reader :host, :port, :ssl, :chain, :contract, :ws_path, :http_path
 
   # Constructor.
-  # @param [String] contract Hex of the contract in Etherium
+  # @param [String] contract Hex of the contract in Ethereum
   # @param [Integer] chain The ID of the chain (1 for mainnet)
   # @param [String] host The host to connect to
   # @param [Integer] port TCP port to use
@@ -107,9 +107,9 @@ class ERC20::Wallet
 
   # Get ERC20 balance of a public address (it's not the same as ETH balance!).
   #
-  # An address in Etherium may have many balances. One of them is the main
-  # balance in ETH crypto. Another balance is the one kept by ERC20 contract
-  # in its own ledge in root storage. This balance is checked by this method.
+  # An address in Ethereum may have many balances. One of them is the main
+  # balance in ETH crypto. Another balance is the one kept by the ERC20 contract
+  # in its own ledger in root storage. This balance is checked by this method.
   #
   # @param [String] address Public key, in hex, starting from '0x'
   # @return [Integer] Balance, in tokens
@@ -121,13 +121,13 @@ class ERC20::Wallet
     data = "0x#{func}000000000000000000000000#{address[2..].downcase}"
     r = jsonrpc.eth_call({ to: @contract, data: data }, 'latest')
     b = r[2..].to_i(16)
-    @log.debug("Balance of #{address} is #{b} ERC20 tokens")
+    @log.debug("The balance of #{address} is #{b} ERC20 tokens")
     b
   end
 
   # Get ETH balance of a public address.
   #
-  # An address in Etherium may have many balances. One of them is the main
+  # An address in Ethereum may have many balances. One of them is the main
   # balance in ETH crypto. This balance is checked by this method.
   #
   # @param [String] hex Public key, in hex, starting from '0x'
@@ -138,16 +138,16 @@ class ERC20::Wallet
     raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(address)
     r = jsonrpc.eth_getBalance(address, 'latest')
     b = r[2..].to_i(16)
-    @log.debug("Balance of #{address} is #{b} ETHs")
+    @log.debug("The balance of #{address} is #{b} ETHs")
     b
   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
+  # @param [String] from The sending address, in hex
+  # @param [String] to The receiving address, in hex
   # @param [Integer] amount How many ERC20 tokens to send
-  # @return [Integer] How many gas units required
+  # @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)
@@ -164,15 +164,33 @@ class ERC20::Wallet
   end
 
   # What is the price of gas unit in gwei?
+  #
+  # 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
+  # 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)
   def gas_price
-    gwei = jsonrpc.eth_getBlockByNumber('latest', false)['baseFeePerGas'].to_i(16)
+    block = jsonrpc.eth_getBlockByNumber('latest', false)
+    raise "Can't get gas price, try again later" if block.nil?
+    gwei = block['baseFeePerGas'].to_i(16)
     @log.debug("The cost of one gas unit is #{gwei} gwei")
     gwei
   end
 
   # Send a single ERC20 payment from a private address to a public one.
   #
+  # ERC20 payments differ fundamentally from native ETH transfers. While ETH transfers
+  # simply move the cryptocurrency directly between addresses, ERC20 token transfers
+  # are actually interactions with a smart contract. When you transfer ERC20 tokens,
+  # you're not sending anything directly to another user - instead, you're calling
+  # the token contract's transfer function, which updates its internal ledger to
+  # decrease your balance and increase the recipient's balance. This requires more
+  # gas than ETH transfers since it involves executing contract code.
+  #
   # @param [String] priv Private key, in hex
   # @param [String] address Public key, in hex
   # @param [Integer] amount The amount of ERC20 tokens to send
@@ -225,8 +243,7 @@ class ERC20::Wallet
   #
   # @param [String] priv Private key, in hex
   # @param [String] address Public key, in hex
-  # @param [Integer] amount The amount of ERC20 tokens to send
-  # @param [Integer] limit How much gas you're ready to spend
+  # @param [Integer] amount The amount of ETH to send
   # @param [Integer] price How much gas you pay per computation unit
   # @return [String] Transaction hash
   def eth_pay(priv, address, amount, price: gas_price)
@@ -272,14 +289,19 @@ class ERC20::Wallet
   # +Thread.kill+.
   #
   # The array with the list of addresses (+addresses+) may change its
-  # content on-fly. The +accept()+ method will +eht_subscribe+ to the addresses
+  # content on-the-fly. The +accept()+ method will +eth_subscribe+ to the addresses
   # that are added and will +eth_unsubscribe+ from those that are removed.
   # Once we actually start listening, the +active+ array will be updated
   # with the list of addresses.
   #
-  # The +addresses+ must have +to_a()+ implemented.
-  # The +active+ must have +append()+ implemented.
-  # Only these methods will be called.
+  # The +addresses+ must have +to_a()+ implemented. This method will be
+  # called every +delay+ seconds. It is expected that it returns the list
+  # of Ethereum public addresses that must be monitored.
+  #
+  # The +active+ must have +append()+ and +to_a()+ implemented. This array
+  # maintains the list of addresses that were mentioned in incoming transactions.
+  # This array is used mostly for testing. It is suggested to always provide
+  # an empty array.
   #
   # @param [Array<String>] addresses Addresses to monitor
   # @param [Array] active List of addresses that we are actually listening to
@@ -291,8 +313,8 @@ class ERC20::Wallet
     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 .append()' unless active.respond_to?(:append)
-    raise 'Amount must be an Integer' unless delay.is_a?(Integer)
-    raise 'Amount must be a positive Integer' unless delay.positive?
+    raise 'Delay must be an Integer' unless delay.is_a?(Integer)
+    raise 'Delay must be a positive Integer' 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?
     EventMachine.run do
@@ -332,11 +354,15 @@ class ERC20::Wallet
                 txn: event['transactionHash'].downcase
               }
               log.debug(
-                "Payment of #{event[:amount]} tokens arrived" \
+                "Payment of #{event[:amount]} tokens arrived " \
                 "from #{event[:from]} to #{event[:to]} in #{event[:txn]}"
               )
             end
-            yield event
+            begin
+              yield event
+            rescue StandardError => e
+              @log.error(Backtrace.new(e).to_s)
+            end
           end
         end
       end

data/test/erc20/test_fake_wallet.rb

@@ -8,19 +8,18 @@ require 'donce'
 require 'eth'
 require 'faraday'
 require 'loog'
-require 'minitest/autorun'
 require 'random-port'
 require 'shellwords'
 require 'threads'
 require 'typhoeus'
-require_relative '../../lib/erc20/fake_wallet'
 require_relative '../test__helper'
+require_relative '../../lib/erc20/fake_wallet'
 
 # Test.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
-class TestFakeWallet < Minitest::Test
+class TestFakeWallet < ERC20::Test
   def test_checks_gas_estimate
     b = ERC20::FakeWallet.new.gas_estimate(
       '0xEB2fE8872A6f1eDb70a2632Effffffffffffffff',

data/test/erc20/test_wallet.rb

@@ -8,20 +8,19 @@ require 'donce'
 require 'eth'
 require 'faraday'
 require 'loog'
-require 'minitest/autorun'
 require 'random-port'
 require 'shellwords'
 require 'threads'
 require 'typhoeus'
-require_relative '../../lib/erc20/wallet'
 require_relative '../test__helper'
+require_relative '../../lib/erc20/wallet'
 
 # Test.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
-class TestWallet < Minitest::Test
-  # At this address, in Etherium mainnet, there are $8 USDT and 0.0042 ETH. I won't
+class TestWallet < ERC20::Test
+  # At this address, in Ethereum mainnet, there are $8 USDT and 0.0042 ETH. I won't
   # move them anyway, that's why tests can use this address forever.
   STABLE = '0x7232148927F8a580053792f44D4d59d40Fd00ABD'
 
@@ -60,6 +59,7 @@ class TestWallet < Minitest::Test
   def test_fails_with_invalid_infura_key
     skip('Apparently, even with invalid key, Infura returns balance')
     w = ERC20::Wallet.new(
+      contract: ERC20::Wallet.USDT,
       host: 'mainnet.infura.io',
       http_path: '/v3/invalid-key-here',
       log: loog
@@ -76,7 +76,8 @@ class TestWallet < Minitest::Test
   def test_checks_balance_on_polygon
     w = ERC20::Wallet.new(
       contract: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F',
-      host: 'polygon-mainnet.infura.io', http_path: "/v3/#{env('INFURA_KEY')}",
+      host: 'polygon-mainnet.infura.io',
+      http_path: "/v3/#{env('INFURA_KEY')}",
       log: loog
     )
     b = w.balance(STABLE)
@@ -200,6 +201,57 @@ class TestWallet < Minitest::Test
     end
   end
 
+  def test_accepts_many_payments_on_hardhat
+    walter = Eth::Key.new(priv: WALTER).address.to_s.downcase
+    on_hardhat do |wallet|
+      active = []
+      events = Concurrent::Set.new
+      total = 10
+      daemon =
+        Thread.new do
+          wallet.accept([walter], active) do |e|
+            events.add(e)
+          end
+        rescue StandardError => e
+          loog.error(Backtrace.new(e))
+        end
+      wait_for { !active.empty? }
+      sum = 1_234
+      Threads.new(total).assert do
+        wallet.pay(JEFF, walter, sum)
+      end
+      wait_for { events.size == total }
+      daemon.kill
+      daemon.join(30)
+      assert_equal(total, events.size)
+    end
+  end
+
+  def test_accepts_payments_with_failures_on_hardhat
+    walter = Eth::Key.new(priv: WALTER).address.to_s.downcase
+    on_hardhat do |wallet|
+      active = []
+      events = Concurrent::Set.new
+      total = 10
+      daemon =
+        Thread.new do
+          wallet.accept([walter], active) do |e|
+            events.add(e)
+            raise 'intentional'
+          end
+        end
+      wait_for { !active.empty? }
+      sum = 1_234
+      Threads.new(total).assert do
+        wallet.pay(JEFF, walter, sum)
+      end
+      wait_for { events.size == total }
+      daemon.kill
+      daemon.join(30)
+      assert_equal(total, events.size)
+    end
+  end
+
   def test_accepts_payments_on_changing_addresses_on_hardhat
     walter = Eth::Key.new(priv: WALTER).address.to_s.downcase
     jeff = Eth::Key.new(priv: JEFF).address.to_s.downcase
@@ -290,20 +342,19 @@ class TestWallet < Minitest::Test
 
   def test_checks_balance_via_proxy_on_mainnet
     via_proxy do |proxy|
-      on_hardhat do
-        w = ERC20::Wallet.new(
-          host: 'mainnet.infura.io', http_path: "/v3/#{env('INFURA_KEY')}",
-          proxy:, log: loog
-        )
-        assert_equal(8_000_000, w.balance(STABLE))
-      end
+      w = ERC20::Wallet.new(
+        host: 'mainnet.infura.io',
+        http_path: "/v3/#{env('INFURA_KEY')}",
+        proxy:, log: loog
+      )
+      assert_equal(8_000_000, w.balance(STABLE))
     end
   end
 
   def test_pays_on_mainnet
     skip('This is live, must be run manually')
     w = mainnet
-    print 'Enter Etherium ERC20 private key (64 chars): '
+    print 'Enter Ethereum ERC20 private key (64 chars): '
     priv = gets.chomp
     to = '0xEB2fE8872A6f1eDb70a2632EA1f869AB131532f6'
     txn = w.pay(priv, to, 1_990_000)
@@ -315,6 +366,7 @@ class TestWallet < Minitest::Test
   def env(var)
     key = ENV.fetch(var, nil)
     skip("The #{var} environment variable is not set") if key.nil?
+    skip("The #{var} environment variable is empty") if key.empty?
     key
   end
 

data/test/test__helper.rb

@@ -6,21 +6,34 @@
 $stdout.sync = true
 
 require 'simplecov'
-SimpleCov.external_at_exit = true
-SimpleCov.start
-
 require 'simplecov-cobertura'
-SimpleCov.formatter = SimpleCov::Formatter::CoberturaFormatter
+unless SimpleCov.running
+  SimpleCov.command_name('test')
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new(
+    [
+      SimpleCov::Formatter::HTMLFormatter,
+      SimpleCov::Formatter::CoberturaFormatter
+    ]
+  )
+  SimpleCov.minimum_coverage 90
+  SimpleCov.minimum_coverage_by_file 90
+  SimpleCov.start do
+    add_filter 'test/'
+    add_filter 'vendor/'
+    add_filter 'target/'
+    track_files 'lib/**/*.rb'
+    track_files '*.rb'
+  end
+end
 
 require 'minitest/autorun'
-
 require 'minitest/reporters'
 Minitest::Reporters.use! [Minitest::Reporters::SpecReporter.new]
 
 # To make tests retry on failure:
 if ENV['RAKE']
   require 'minitest/retry'
-  Minitest::Retry.use!(methods_to_skip: [])
+  Minitest::Retry.use!
 end
 
 # Primitive array.
@@ -42,7 +55,7 @@ end
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
-class Minitest::Test
+class ERC20::Test < Minitest::Test
   def loog
     ENV['RAKE'] ? Loog::ERRORS : Loog::VERBOSE
   end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: erc20
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Yegor Bugayenko
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-25 00:00:00.000000000 Z
+date: 2025-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: eth
@@ -96,7 +95,7 @@ dependencies:
         version: '4'
 description: 'A simple library for making ERC20 manipulations as easy as they can
   be for cryptocurrency newbies: checking balance, sending payments, and monitoring
-  addresses for incoming payments. The library expects Etherium node to provide JSON
+  addresses for incoming payments. The library expects Ethereum node to provide JSON
   RPC and Websockets API.'
 email: yegor256@gmail.com
 executables:
@@ -123,7 +122,6 @@ files:
 - ".pdd"
 - ".rubocop.yml"
 - ".rultor.yml"
-- ".simplecov"
 - ".yamllint.yml"
 - Gemfile
 - Gemfile.lock
@@ -157,7 +155,6 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options:
 - "--charset=UTF-8"
 require_paths:
@@ -173,8 +170,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
-summary: Sending and receiving ERC20 tokens in Etherium network
+summary: Sending and receiving ERC20 tokens in Ethereum network
 test_files: []

data/.simplecov

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-#
-# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
-
-if Gem.win_platform?
-  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
-    SimpleCov::Formatter::HTMLFormatter
-  ]
-  SimpleCov.start do
-    add_filter '/test/'
-  end
-else
-  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new(
-    [SimpleCov::Formatter::HTMLFormatter]
-  )
-  SimpleCov.start do
-    add_filter '/test/'
-    minimum_coverage 20
-  end
-end