erc20 0.1.5 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01ef1fcd61cd21540d932e28c65ed8afa08891e0cc20b498202eb146809d4993
-  data.tar.gz: c8e4593fb968dcfbad8e27d24aa974a37946b444eb42b4022139c48c51ffc5ca
+  metadata.gz: 6e76d55c6807ddcd06e895bc54cd2edd16ad079b48131eaac1b118005f1b1d5b
+  data.tar.gz: 2bd2c637aa1e05d82695eb6581fed32992aabb45ed47dec179b78879380d1869
 SHA512:
-  metadata.gz: 38e4e84ea00f176c34a9f3f15ff0e77473f31fb29196b72d7e7b70af38e7aa8877015ff3249822b55665dfadac2cecb909a46d4c62554bcf5c85d8e1a1d30744
-  data.tar.gz: ffc78c5dfe3817bb59481f6e27e5e5fe7539ffca1e931fe8752fa31e98fee9e4c1880a2d3ce40496549c16b764524c0fad70c147d6f8a7467d8f1ba9c990d6dc
+  metadata.gz: d9e574760a4e257e5b8e5131b25a8af9cf5b7dcbb4e32e03093f50114cc84d308faa691032d155e6ebe291c4ce4ad838f0253e46942a8b146b324ef6fe72f88d
+  data.tar.gz: fad0c35c9e011414a49cc727d5ff3321b74a4c6424463d7f5c947c74c73d0f8e1e22b91702d5341fea0988c6c5b5ed31ee3e625675393cbf7165e4163f0aa70a

data/.github/workflows/hadolint.yml

@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+name: hadolint
+'on':
+  push:
+  pull_request:
+jobs:
+  hadolint:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: hadolint/hadolint-action@v3.1.0
+        with:
+          dockerfile: hardhat/Dockerfile

data/.github/workflows/typos.yml

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
+name: typos
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  typos:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: crate-ci/typos@v1.32.0

data/.gitignore

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

data/Gemfile

@@ -9,13 +9,12 @@ gemspec
 gem 'backtrace', '>0', require: false
 gem 'concurrent-ruby', '~>1.2', require: false
 gem 'cucumber', '~>9.2', require: false
-gem 'donce', '>=0.2.3', require: false
+gem 'donce', '>0', require: false
 gem 'faraday', '>0', require: false
 gem 'loog', '>0', require: false
 gem 'minitest', '~>5.25', require: false
 gem 'minitest-reporters', '~>1.7', require: false
 gem 'minitest-retry', '~>0.2', require: false
-gem 'os', '>0', require: false
 gem 'qbash', '>0', require: false
 gem 'rake', '~>13.2', require: false
 gem 'random-port', '>0', require: false
@@ -23,6 +22,7 @@ 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', require: false
 gem 'simplecov-cobertura', '~>2.1', require: false
 gem 'threads', '~>0.4', require: false

data/Gemfile.lock

@@ -49,9 +49,9 @@ GEM
       cucumber-messages (> 19, < 28)
     cucumber-messages (22.0.0)
     cucumber-tag-expressions (6.1.2)
-    diff-lcs (1.6.1)
+    diff-lcs (1.6.2)
     docile (1.4.1)
-    donce (0.2.3)
+    donce (0.2.4)
       backtrace (~> 0.3)
       os (~> 1.1)
       qbash (~> 0.3)
@@ -69,7 +69,7 @@ GEM
     ethon (0.16.0)
       ffi (>= 1.15.0)
     eventmachine (1.2.7)
-    faraday (2.13.0)
+    faraday (2.13.1)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
@@ -87,18 +87,19 @@ GEM
       rake
     forwardable (1.3.3)
     hashdiff (1.1.2)
-    json (2.10.2)
+    json (2.12.0)
     jsonrpc-client (0.1.4)
       faraday
       multi_json (>= 1.1.0)
     keccak (1.3.2)
     konstructor (1.0.2)
-    language_server-protocol (3.17.0.4)
+    language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
-    loog (0.6.0)
+    loog (0.6.1)
+      logger (~> 1.0)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.8)
+    mini_portile2 (2.8.9)
     minitest (5.25.5)
     minitest-reporters (1.7.1)
       ansi
@@ -117,10 +118,10 @@ GEM
     parser (3.3.8.0)
       ast (~> 2.4.1)
       racc
-    pkg-config (1.6.1)
+    pkg-config (1.6.2)
     prism (1.4.0)
-    public_suffix (6.0.1)
-    qbash (0.4.0)
+    public_suffix (6.0.2)
+    qbash (0.4.5)
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
@@ -136,7 +137,7 @@ GEM
       rubyzip (~> 2.3)
     regexp_parser (2.10.0)
     rexml (3.4.1)
-    rubocop (1.75.3)
+    rubocop (1.75.5)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -161,6 +162,9 @@ GEM
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
+    rubocop-rspec (3.6.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
     ruby-progressbar (1.13.0)
     rubyzip (2.4.1)
     scrypt (3.0.8)
@@ -211,14 +215,13 @@ DEPENDENCIES
   backtrace (> 0)
   concurrent-ruby (~> 1.2)
   cucumber (~> 9.2)
-  donce (>= 0.2.3)
+  donce (> 0)
   erc20!
   faraday (> 0)
   loog (> 0)
   minitest (~> 5.25)
   minitest-reporters (~> 1.7)
   minitest-retry (~> 0.2)
-  os (> 0)
   qbash (> 0)
   rake (~> 13.2)
   random-port (> 0)
@@ -226,6 +229,7 @@ DEPENDENCIES
   rubocop-minitest (> 0)
   rubocop-performance (> 0)
   rubocop-rake (> 0)
+  rubocop-rspec (> 0)
   simplecov (~> 0.22)
   simplecov-cobertura (~> 2.1)
   threads (~> 0.4)

data/REUSE.toml

@@ -4,10 +4,19 @@
 version = 1
 [[annotations]]
 path = [
+    ".DS_Store",
+    ".gitattributes",
+    ".gitignore",
+    ".gitleaksignore",
+    ".pdd",
     "**.json",
     "**.md",
     "**.png",
     "**.txt",
+    "**/.DS_Store",
+    "**/.gitignore",
+    "**/.gitleaksignore",
+    "**/.pdd",
     "**/*.csv",
     "**/*.jpg",
     "**/*.json",
@@ -17,23 +26,14 @@ path = [
     "**/*.svg",
     "**/*.txt",
     "**/*.vm",
-    "**/.DS_Store",
-    "**/.gitignore",
-    "**/.gitleaksignore",
-    "**/.pdd",
-    "**/CNAME",
     "**/Cargo.toml",
+    "**/CNAME",
     "**/Gemfile.lock",
-    ".DS_Store",
-    ".gitattributes",
-    ".gitignore",
-    ".gitleaksignore",
-    ".pdd",
     "Cargo.toml",
     "Gemfile.lock",
-    "README.md",
     "hardhat/.gitignore",
     "hardhat/package.json",
+    "README.md",
     "renovate.json",
 ]
 precedence = "override"

data/hardhat/Dockerfile

@@ -14,14 +14,12 @@ RUN npm install
 ARG PORT=8080
 ARG HOST=localhost
 COPY hardhat.config.js .
-RUN sed -i "s/PORT/$PORT/g" hardhat.config.js
-RUN sed -i "s/HOST/$HOST/g" hardhat.config.js
+RUN sed -i "s/PORT/$PORT/g" hardhat.config.js \
+  && sed -i "s/HOST/$HOST/g" hardhat.config.js
 
 COPY contracts contracts
 COPY ignition ignition
 
-RUN rm -rf ignition/deployments
-
-RUN npx hardhat compile
-
-RUN rm -rf cache
+RUN rm -rf ignition/deployments \
+  && npx hardhat compile \
+  && rm -rf cache

data/lib/erc20/erc20.rb

@@ -25,5 +25,5 @@
 # License:: MIT
 module ERC20
   # Current version of the gem (changed by the +.rultor.yml+ on every release)
-  VERSION = '0.1.5'
+  VERSION = '0.2.0'
 end

data/lib/erc20/fake_wallet.rb

@@ -69,6 +69,14 @@ class ERC20::FakeWallet
     b
   end
 
+  # Get ERC20 amount (in tokens) that was sent in the given transaction.
+  #
+  # @param [String] txn Hex of transaction
+  # @return [Integer] Balance, in ERC20 tokens
+  def sum_of(_txn)
+    42_000_000
+  end
+
   # How much gas units is required in order to send ERC20 transaction.
   #
   # @param [String] from The departing address, in hex

data/lib/erc20/wallet.rb

@@ -142,6 +142,28 @@ class ERC20::Wallet
     b
   end
 
+  # Get ERC20 amount (in tokens) that was sent in the given transaction.
+  #
+  # @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)
+    receipt = jsonrpc.eth_getTransactionReceipt(txn)
+    raise "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['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}"
+  end
+
   # How many gas units are required to send an ERC20 transaction.
   #
   # @param [String] from The sending address, in hex
@@ -312,9 +334,11 @@ class ERC20::Wallet
     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' unless delay.positive?
+    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?
     EventMachine.run do
@@ -336,37 +360,38 @@ class ERC20::Wallet
     contract = @contract
     log_url = "ws#{@ssl ? 's' : ''}://#{u.hostname}:#{u.port}"
     ws = Faye::WebSocket::Client.new(u.to_s, [], proxy: @proxy ? { origin: @proxy } : {}, ping: 60)
-    timer =
-      EventMachine.add_periodic_timer(delay) do
-        next if active.to_a.sort == addresses.to_a.sort
-        ws.send(
-          {
-            jsonrpc: '2.0',
-            id: subscription_id,
-            method: 'eth_subscribe',
-            params: [
-              'logs',
-              {
-                address: contract,
-                topics: [
-                  '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
-                  nil,
-                  addresses.to_a.map { |a| "0x000000000000000000000000#{a[2..]}" }
-                ]
-              }
-            ]
-          }.to_json
-        )
-        log_it(
-          :debug,
-          "Requested to subscribe ##{subscription_id} to #{addresses.to_a.size} addresses: " \
-          "#{addresses.to_a.map { |a| a[0..6] }.join(', ')}"
-        )
-      end
+    timer = nil
     ws.on(:open) do
       safe do
         verbose do
           log_it(:debug, "Connected ##{subscription_id} to #{log_url}")
+          timer =
+            EventMachine.add_periodic_timer(delay) do
+              next if active.to_a.sort == addresses.to_a.sort
+              ws.send(
+                {
+                  jsonrpc: '2.0',
+                  id: subscription_id,
+                  method: 'eth_subscribe',
+                  params: [
+                    'logs',
+                    {
+                      address: contract,
+                      topics: [
+                        '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+                        nil,
+                        addresses.to_a.map { |a| "0x000000000000000000000000#{a[2..]}" }
+                      ]
+                    }
+                  ]
+                }.to_json
+              )
+              log_it(
+                :debug,
+                "Requested to subscribe ##{subscription_id} to #{addresses.to_a.size} addresses: " \
+                "#{addresses.to_a.map { |a| a[0..6] }.join(', ')}"
+              )
+            end
         end
       end
     end
@@ -411,9 +436,8 @@ class ERC20::Wallet
       safe do
         verbose do
           log_it(:debug, "Disconnected ##{subscription_id} from #{log_url}")
-          sleep(delay)
           active.clear
-          timer.cancel
+          timer&.cancel
           reaccept(addresses, active, raw:, delay:, subscription_id: subscription_id + 1, &)
         end
       end

data/test/erc20/test_fake_wallet.rb

@@ -68,6 +68,11 @@ class TestFakeWallet < ERC20::Test
     assert_equal(b, w.eth_balance(a))
   end
 
+  def test_reads_sum_of_payment
+    txn = '0xcf0598d640d4bea3367e6af28a08c54342a39156afd292a31453778e4755945d'
+    assert_predicate(ERC20::FakeWallet.new.sum_of(txn), :positive?)
+  end
+
   def test_returns_host
     assert_equal('example.com', ERC20::FakeWallet.new.host)
   end

data/test/erc20/test_wallet.rb

@@ -22,58 +22,12 @@ require_relative '../../lib/erc20/wallet'
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 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'
-
   # One guy private hex.
   JEFF = '81a9b2114d53731ecc84b261ef6c0387dde34d5907fe7b441240cc21d61bf80a'
 
   # Another guy private hex.
   WALTER = '91f9111b1744d55361e632771a4e53839e9442a9fef45febc0a5c838c686a15b'
 
-  def test_checks_balance_on_mainnet
-    WebMock.enable_net_connect!
-    b = mainnet.balance(STABLE)
-    refute_nil(b)
-    assert_equal(8_000_000, b) # this is $8 USDT
-  end
-
-  def test_checks_eth_balance_on_mainnet
-    WebMock.enable_net_connect!
-    b = mainnet.eth_balance(STABLE)
-    refute_nil(b)
-    assert_equal(4_200_000_000_000_000, b) # this is 0.0042 ETH
-  end
-
-  def test_checks_balance_of_absent_address
-    WebMock.enable_net_connect!
-    a = '0xEB2fE8872A6f1eDb70a2632Effffffffffffffff'
-    b = mainnet.balance(a)
-    refute_nil(b)
-    assert_equal(0, b)
-  end
-
-  def test_checks_gas_estimate_on_mainnet
-    WebMock.enable_net_connect!
-    b = mainnet.gas_estimate(STABLE, Eth::Key.new(priv: JEFF).address.to_s, 44_000)
-    refute_nil(b)
-    assert_predicate(b, :positive?)
-    assert_operator(b, :>, 1000)
-  end
-
-  def test_fails_with_invalid_infura_key
-    WebMock.enable_net_connect!
-    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: fake_loog
-    )
-    assert_raises(StandardError) { w.balance(STABLE) }
-  end
-
   def test_logs_to_stdout
     WebMock.disable_net_connect!
     stub_request(:post, 'https://example.org/').to_return(
@@ -85,25 +39,12 @@ class TestWallet < ERC20::Test
       http_path: '/',
       log: $stdout
     )
-    w.balance(STABLE)
+    w.balance(Eth::Key.new(priv: JEFF).address.to_s)
   end
 
   def test_checks_balance_on_testnet
     WebMock.enable_net_connect!
-    b = testnet.balance(STABLE)
-    refute_nil(b)
-    assert_predicate(b, :zero?)
-  end
-
-  def test_checks_balance_on_polygon
-    WebMock.enable_net_connect!
-    w = ERC20::Wallet.new(
-      contract: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F',
-      host: 'polygon-mainnet.infura.io',
-      http_path: "/v3/#{env('INFURA_KEY')}",
-      log: fake_loog
-    )
-    b = w.balance(STABLE)
+    b = testnet.balance(Eth::Key.new(priv: JEFF).address.to_s)
     refute_nil(b)
     assert_predicate(b, :zero?)
   end
@@ -162,6 +103,15 @@ class TestWallet < ERC20::Test
     end
   end
 
+  def test_reads_payment_amount_on_hardhat
+    WebMock.enable_net_connect!
+    on_hardhat do |wallet|
+      sum = 33_330
+      txn = wallet.pay(JEFF, Eth::Key.new(priv: WALTER).address.to_s, sum)
+      assert_equal(sum, wallet.sum_of(txn))
+    end
+  end
+
   def test_eth_pays_on_hardhat
     WebMock.enable_net_connect!
     on_hardhat do |wallet|
@@ -379,26 +329,6 @@ class TestWallet < ERC20::Test
     end
   end
 
-  def test_accepts_payments_on_mainnet
-    WebMock.enable_net_connect!
-    active = []
-    failed = false
-    net = mainnet
-    daemon =
-      Thread.new do
-        net.accept([STABLE], active) do |_|
-          # ignore it
-        end
-      rescue StandardError => e
-        failed = true
-        fake_loog.error(Backtrace.new(e))
-      end
-    wait_for { !active.empty? }
-    daemon.kill
-    daemon.join(30)
-    refute(failed)
-  end
-
   def test_checks_balance_via_proxy
     WebMock.enable_net_connect!
     b = nil
@@ -410,151 +340,4 @@ class TestWallet < ERC20::Test
     end
     assert_equal(123_000_100_000, b)
   end
-
-  def test_checks_balance_via_proxy_on_mainnet
-    WebMock.enable_net_connect!
-    via_proxy do |proxy|
-      w = ERC20::Wallet.new(
-        host: 'mainnet.infura.io',
-        http_path: "/v3/#{env('INFURA_KEY')}",
-        proxy:, log: fake_loog
-      )
-      assert_equal(8_000_000, w.balance(STABLE))
-    end
-  end
-
-  def test_pays_on_mainnet
-    WebMock.enable_net_connect!
-    skip('This is live, must be run manually')
-    w = mainnet
-    print 'Enter Ethereum ERC20 private key (64 chars): '
-    priv = gets.chomp
-    to = '0xEB2fE8872A6f1eDb70a2632EA1f869AB131532f6'
-    txn = w.pay(priv, to, 1_990_000)
-    assert_equal(66, txn.length)
-  end
-
-  private
-
-  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
-
-  def mainnet
-    [
-      {
-        host: 'mainnet.infura.io',
-        http_path: "/v3/#{env('INFURA_KEY')}",
-        ws_path: "/ws/v3/#{env('INFURA_KEY')}"
-      },
-      {
-        host: 'go.getblock.io',
-        http_path: "/#{env('GETBLOCK_KEY')}",
-        ws_path: "/#{env('GETBLOCK_WS_KEY')}"
-      }
-    ].map do |server|
-      ERC20::Wallet.new(
-        host: server[:host],
-        http_path: server[:http_path],
-        ws_path: server[:ws_path],
-        log: fake_loog
-      )
-    end.sample
-  end
-
-  def testnet
-    [
-      {
-        host: 'sepolia.infura.io',
-        http_path: "/v3/#{env('INFURA_KEY')}",
-        ws_path: "/ws/v3/#{env('INFURA_KEY')}"
-      },
-      {
-        host: 'go.getblock.io',
-        http_path: "/#{env('GETBLOCK_SEPOILA_KEY')}",
-        ws_path: "/#{env('GETBLOCK_SEPOILA_KEY')}"
-      }
-    ].map do |server|
-      ERC20::Wallet.new(
-        host: server[:host],
-        http_path: server[:http_path],
-        ws_path: server[:ws_path],
-        log: fake_loog
-      )
-    end.sample
-  end
-
-  def through_proxy(wallet, proxy)
-    ERC20::Wallet.new(
-      contract: wallet.contract, chain: wallet.chain,
-      host: donce_host, port: wallet.port, http_path: wallet.http_path, ws_path: wallet.ws_path,
-      ssl: wallet.ssl, proxy:, log: fake_loog
-    )
-  end
-
-  def via_proxy
-    RandomPort::Pool::SINGLETON.acquire do |port|
-      donce(
-        image: 'yegor256/squid-proxy:latest',
-        ports: { port => 3128 },
-        env: { 'USERNAME' => 'jeffrey', 'PASSWORD' => 'swordfish' },
-        root: true, log: fake_loog
-      ) do
-        yield "http://jeffrey:swordfish@localhost:#{port}"
-      end
-    end
-  end
-
-  def on_hardhat(port: nil, die: nil)
-    RandomPort::Pool::SINGLETON.acquire do |rnd|
-      port = rnd if port.nil?
-      if die
-        killer = [
-          '&',
-          'HARDHAT_PID=$!;',
-          'export HARDHAT_PID;',
-          'while true; do',
-          "  if [ -e #{Shellwords.escape(File.join('/die', File.basename(die)))} ]; then",
-          '    kill -9 "${HARDHAT_PID}";',
-          '    break;',
-          '  else',
-          '    sleep 0.1;',
-          '  fi;',
-          'done'
-        ].join(' ')
-      end
-      cmd = "npx hardhat node #{killer if die}"
-      donce(
-        home: File.join(__dir__, '../../hardhat'),
-        ports: { port => 8545 },
-        volumes: die ? { File.dirname(die) => '/die' } : {},
-        command: "/bin/bash -c #{Shellwords.escape(cmd)}",
-        log: fake_loog
-      ) do
-        wait_for_port(port)
-        cmd = [
-          '(cat hardhat.config.js)',
-          '(ls -al)',
-          '(echo y | npx hardhat ignition deploy ./ignition/modules/Foo.ts --network foo --deployment-id foo)',
-          '(npx hardhat ignition status foo | tail -1 | cut -d" " -f3)'
-        ].join(' && ')
-        contract = donce(
-          home: File.join(__dir__, '../../hardhat'),
-          command: "/bin/bash -c #{Shellwords.escape(cmd)}",
-          build_args: { 'HOST' => donce_host, 'PORT' => port },
-          log: fake_loog,
-          root: true
-        ).split("\n").last
-        wallet = ERC20::Wallet.new(
-          contract:, chain: 4242,
-          host: 'localhost', port:, http_path: '/', ws_path: '/', ssl: false,
-          log: fake_loog
-        )
-        yield wallet
-      end
-    end
-  end
 end

data/test/erc20/test_wallet_live.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'backtrace'
+require 'donce'
+require 'eth'
+require 'faraday'
+require 'fileutils'
+require 'json'
+require 'os'
+require 'random-port'
+require 'shellwords'
+require 'threads'
+require 'typhoeus'
+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 TestWalletLive < 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'
+
+  def test_checks_balance_on_mainnet
+    WebMock.enable_net_connect!
+    b = mainnet.balance(STABLE)
+    refute_nil(b)
+    assert_equal(8_000_000, b) # this is $8 USDT
+  end
+
+  def test_checks_eth_balance_on_mainnet
+    WebMock.enable_net_connect!
+    b = mainnet.eth_balance(STABLE)
+    refute_nil(b)
+    assert_equal(4_200_000_000_000_000, b) # this is 0.0042 ETH
+  end
+
+  def test_checks_balance_of_absent_address
+    WebMock.enable_net_connect!
+    a = '0xEB2fE8872A6f1eDb70a2632Effffffffffffffff'
+    b = mainnet.balance(a)
+    refute_nil(b)
+    assert_equal(0, b)
+  end
+
+  def test_checks_gas_estimate_on_mainnet
+    WebMock.enable_net_connect!
+    b = mainnet.gas_estimate(STABLE, '0x7232148927F8a580053792f44D4d5FFFFFFFFFFF', 44_000)
+    refute_nil(b)
+    assert_predicate(b, :positive?)
+    assert_operator(b, :>, 1000)
+  end
+
+  def test_fails_with_invalid_infura_key
+    WebMock.enable_net_connect!
+    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: fake_loog
+    )
+    assert_raises(StandardError) { w.balance(STABLE) }
+  end
+
+  def test_checks_balance_on_polygon
+    WebMock.enable_net_connect!
+    w = ERC20::Wallet.new(
+      contract: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F',
+      host: 'polygon-mainnet.infura.io',
+      http_path: "/v3/#{env('INFURA_KEY')}",
+      log: fake_loog
+    )
+    b = w.balance(STABLE)
+    refute_nil(b)
+    assert_predicate(b, :zero?)
+  end
+
+  def test_accepts_payments_on_mainnet
+    WebMock.enable_net_connect!
+    active = []
+    failed = false
+    net = mainnet
+    daemon =
+      Thread.new do
+        net.accept([STABLE], active) do |_|
+          # ignore it
+        end
+      rescue StandardError => e
+        failed = true
+        fake_loog.error(Backtrace.new(e))
+      end
+    wait_for { !active.empty? }
+    daemon.kill
+    daemon.join(30)
+    refute(failed)
+  end
+
+  def test_checks_balance_via_proxy_on_mainnet
+    WebMock.enable_net_connect!
+    via_proxy do |proxy|
+      w = ERC20::Wallet.new(
+        host: 'mainnet.infura.io',
+        http_path: "/v3/#{env('INFURA_KEY')}",
+        proxy:, log: fake_loog
+      )
+      assert_equal(8_000_000, w.balance(STABLE))
+    end
+  end
+
+  def test_pays_on_mainnet
+    WebMock.enable_net_connect!
+    skip('This is live, must be run manually')
+    w = mainnet
+    print 'Enter Ethereum ERC20 private key (64 chars): '
+    priv = gets.chomp
+    to = '0xEB2fE8872A6f1eDb70a2632EA1f869AB131532f6'
+    txn = w.pay(priv, to, 1_990_000)
+    assert_equal(66, txn.length)
+  end
+end

data/test/test__helper.rb

@@ -42,6 +42,10 @@ class Primitivo
     @array = array
   end
 
+  def clear
+    @array.clear
+  end
+
   def to_a
     @array.to_a
   end
@@ -77,4 +81,126 @@ class ERC20::Test < Minitest::Test
   def wait_for_port(port)
     wait_for { Typhoeus::Request.get("http://localhost:#{port}").code == 200 }
   end
+
+  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
+
+  def mainnet
+    [
+      {
+        host: 'mainnet.infura.io',
+        http_path: "/v3/#{env('INFURA_KEY')}",
+        ws_path: "/ws/v3/#{env('INFURA_KEY')}"
+      },
+      {
+        host: 'go.getblock.io',
+        http_path: "/#{env('GETBLOCK_KEY')}",
+        ws_path: "/#{env('GETBLOCK_WS_KEY')}"
+      }
+    ].map do |server|
+      ERC20::Wallet.new(
+        host: server[:host],
+        http_path: server[:http_path],
+        ws_path: server[:ws_path],
+        log: fake_loog
+      )
+    end.sample
+  end
+
+  def testnet
+    [
+      {
+        host: 'sepolia.infura.io',
+        http_path: "/v3/#{env('INFURA_KEY')}",
+        ws_path: "/ws/v3/#{env('INFURA_KEY')}"
+      },
+      {
+        host: 'go.getblock.io',
+        http_path: "/#{env('GETBLOCK_SEPOILA_KEY')}",
+        ws_path: "/#{env('GETBLOCK_SEPOILA_KEY')}"
+      }
+    ].map do |server|
+      ERC20::Wallet.new(
+        host: server[:host],
+        http_path: server[:http_path],
+        ws_path: server[:ws_path],
+        log: fake_loog
+      )
+    end.sample
+  end
+
+  def through_proxy(wallet, proxy)
+    ERC20::Wallet.new(
+      contract: wallet.contract, chain: wallet.chain,
+      host: donce_host, port: wallet.port, http_path: wallet.http_path, ws_path: wallet.ws_path,
+      ssl: wallet.ssl, proxy:, log: fake_loog
+    )
+  end
+
+  def via_proxy
+    RandomPort::Pool::SINGLETON.acquire do |port|
+      donce(
+        image: 'yegor256/squid-proxy:latest',
+        ports: { port => 3128 },
+        env: { 'USERNAME' => 'jeffrey', 'PASSWORD' => 'swordfish' },
+        root: true, log: fake_loog
+      ) do
+        yield "http://jeffrey:swordfish@localhost:#{port}"
+      end
+    end
+  end
+
+  def on_hardhat(port: nil, die: nil)
+    RandomPort::Pool::SINGLETON.acquire do |rnd|
+      port = rnd if port.nil?
+      if die
+        killer = [
+          '&',
+          'HARDHAT_PID=$!;',
+          'export HARDHAT_PID;',
+          'while true; do',
+          "  if [ -e #{Shellwords.escape(File.join('/die', File.basename(die)))} ]; then",
+          '    kill -9 "${HARDHAT_PID}";',
+          '    break;',
+          '  else',
+          '    sleep 0.1;',
+          '  fi;',
+          'done'
+        ].join(' ')
+      end
+      cmd = "npx hardhat node #{killer if die}"
+      donce(
+        home: File.join(__dir__, '../hardhat'),
+        ports: { port => 8545 },
+        volumes: die ? { File.dirname(die) => '/die' } : {},
+        command: "/bin/bash -c #{Shellwords.escape(cmd)}",
+        log: fake_loog
+      ) do
+        wait_for_port(port)
+        cmd = [
+          '(cat hardhat.config.js)',
+          '(ls -al)',
+          '(echo y | npx hardhat ignition deploy ./ignition/modules/Foo.ts --network foo --deployment-id foo)',
+          '(npx hardhat ignition status foo | tail -1 | cut -d" " -f3)'
+        ].join(' && ')
+        contract = donce(
+          home: File.join(__dir__, '../hardhat'),
+          command: "/bin/bash -c #{Shellwords.escape(cmd)}",
+          build_args: { 'HOST' => donce_host, 'PORT' => port },
+          log: fake_loog,
+          root: true
+        ).split("\n").last
+        wallet = ERC20::Wallet.new(
+          contract:, chain: 4242,
+          host: 'localhost', port:, http_path: '/', ws_path: '/', ssl: false,
+          log: fake_loog
+        )
+        yield wallet
+      end
+    end
+  end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: erc20
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.2.0
 platform: ruby
 authors:
 - Yegor Bugayenko
 bindir: bin
 cert_chain: []
-date: 2025-04-23 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: eth
@@ -102,19 +102,21 @@ executables:
 - erc20
 extensions: []
 extra_rdoc_files:
-- README.md
 - LICENSE.txt
+- README.md
 files:
 - ".0pdd.yml"
 - ".gitattributes"
 - ".github/workflows/actionlint.yml"
 - ".github/workflows/codecov.yml"
 - ".github/workflows/copyrights.yml"
+- ".github/workflows/hadolint.yml"
 - ".github/workflows/markdown-lint.yml"
 - ".github/workflows/pdd.yml"
 - ".github/workflows/rake.yml"
 - ".github/workflows/reuse.yml"
 - ".github/workflows/shellcheck.yml"
+- ".github/workflows/typos.yml"
 - ".github/workflows/xcop.yml"
 - ".github/workflows/yamllint.yml"
 - ".gitignore"
@@ -149,6 +151,7 @@ files:
 - renovate.json
 - test/erc20/test_fake_wallet.rb
 - test/erc20/test_wallet.rb
+- test/erc20/test_wallet_live.rb
 - test/test__helper.rb
 homepage: http://github.com/yegor256/erc20.rb
 licenses:
@@ -170,7 +173,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Sending and receiving ERC20 tokens in Ethereum network
 test_files: []