erc20 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71eb4c1f0b7e6778be6d2b121792c20aa190cdfdfc62948ce39e1c4ea1cb288f
-  data.tar.gz: 9dbb23249587fe95bf6681ab9b87a131b4f946343c515df036c1fa1c7f45b200
+  metadata.gz: 7843a4cb824e3689fb7a457f8ca0744f1d1059349aa6ea8bfe8805cd597e8b24
+  data.tar.gz: d11d0eb794c22737519ef5ee2083763ba8244ce91f01f0f120ee8e6970af53c0
 SHA512:
-  metadata.gz: aeb83a009f276a4ead1a30e1d1cb052816067fb1571cca6cb20cc39a7840422342cbf246b498932be850c2330663d7e08356c2b3f35f2365acc933511462a4ab
-  data.tar.gz: '08b280c073e3d8bd1cc7b335b8d520e1808e190b50aaa227ee5fed17ae78ebc622637cd28c037e5991ea2dd8356cddb4f794ba240313f441cde0e79c3e7163d3'
+  metadata.gz: 135c421a05cbc431e20113e8cd6d63294630588b6ba27a63249313455853b83266d697759764b6f82aae857131237fd5c8c85f4f1432fe74cb73a25935b5ca45
+  data.tar.gz: ecf62b97b0053bc123de22f600e61a90cbf2e0636c1afa199d96478df0186194a917d27f0234285deb14129715970e2b818be5f6cf7d3a692d131a685a1af41f

data/.rubocop.yml

@@ -11,7 +11,6 @@ AllCops:
   SuggestExtensions: false
   NewCops: enable
 plugins:
-  - rubocop-rspec
   - rubocop-performance
   - rubocop-rake
   - rubocop-minitest

data/Gemfile.lock

@@ -51,7 +51,7 @@ GEM
     cucumber-tag-expressions (6.1.2)
     diff-lcs (1.6.1)
     docile (1.4.1)
-    donce (0.2.0)
+    donce (0.2.4)
       backtrace (~> 0.3)
       os (~> 1.1)
       qbash (~> 0.3)
@@ -136,7 +136,7 @@ GEM
       rubyzip (~> 2.3)
     regexp_parser (2.10.0)
     rexml (3.4.1)
-    rubocop (1.75.2)
+    rubocop (1.75.3)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)

data/Rakefile

@@ -39,7 +39,6 @@ require 'rubocop/rake_task'
 desc 'Run RuboCop on all directories'
 RuboCop::RakeTask.new(:rubocop) do |task|
   task.fail_on_error = true
-  task.requires << 'rubocop-rspec'
 end
 
 require 'cucumber/rake/task'

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.4'
+  VERSION = '0.1.6'
 end

data/lib/erc20/wallet.rb

@@ -308,111 +308,127 @@ class ERC20::Wallet
   # @param [Boolean] raw TRUE if you need to get JSON events as they arrive from Websockets
   # @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))
+  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' 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
-      u = url(http: false)
-      log_it(:debug, "Connecting to #{u.hostname}:#{u.port}...")
-      ws = Faye::WebSocket::Client.new(u.to_s, [], proxy: @proxy ? { origin: @proxy } : {})
-      contract = @contract
-      attempt = []
-      log_url = "ws#{@ssl ? 's' : ''}://#{u.hostname}:#{u.port}"
-      ws.on(:open) do
-        safe do
-          verbose do
-            log_it(:debug, "Connected to #{log_url}")
-          end
+      reaccept(addresses, active, raw:, delay:, subscription_id:, &)
+    end
+  end
+
+  private
+
+  # @param [Array<String>] addresses Addresses to monitor
+  # @param [Array] active List of addresses that we are actually listening to
+  # @param [Boolean] raw TRUE if you need to get JSON events as they arrive from Websockets
+  # @param [Integer] delay How many seconds to wait between +eth_subscribe+ calls
+  # @param [Integer] subscription_id Unique ID of the subscription
+  # @return [Websocket]
+  def reaccept(addresses, active, raw:, delay:, subscription_id:, &)
+    u = url(http: false)
+    log_it(:debug, "Connecting ##{subscription_id} to #{u.hostname}:#{u.port}...")
+    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 = 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
-      ws.on(:message) do |msg|
-        safe do
-          verbose do
-            data = to_json(msg)
-            if data['id']
-              before = active.to_a
-              attempt.each do |a|
-                active.append(a) unless before.include?(a)
-              end
+    end
+    ws.on(:message) do |msg|
+      safe do
+        verbose do
+          data = to_json(msg)
+          if data['id']
+            before = active.to_a.uniq
+            addresses.to_a.each do |a|
+              next if before.include?(a)
+              active.append(a)
+            end
+            log_it(
+              :debug,
+              "Subscribed ##{subscription_id} to #{active.to_a.size} addresses at #{log_url}: " \
+              "#{active.to_a.map { |a| a[0..6] }.join(', ')}"
+            )
+          elsif data['method'] == 'eth_subscription' && data.dig('params', 'result')
+            event = data['params']['result']
+            if raw
+              log_it(:debug, "New event arrived from #{event['address']}")
+            else
+              event = {
+                amount: event['data'].to_i(16),
+                from: "0x#{event['topics'][1][26..].downcase}",
+                to: "0x#{event['topics'][2][26..].downcase}",
+                txn: event['transactionHash'].downcase
+              }
               log_it(
                 :debug,
-                "Subscribed ##{subscription_id} to #{active.to_a.size} addresses at #{log_url}: " \
-                "#{active.to_a.map { |a| a[0..6] }.join(', ')}"
+                "Payment of #{event[:amount]} tokens arrived at ##{subscription_id} " \
+                "from #{event[:from]} to #{event[:to]} in #{event[:txn]}"
               )
-            elsif data['method'] == 'eth_subscription' && data.dig('params', 'result')
-              event = data['params']['result']
-              if raw
-                log_it(:debug, "New event arrived from #{event['address']}")
-              else
-                event = {
-                  amount: event['data'].to_i(16),
-                  from: "0x#{event['topics'][1][26..].downcase}",
-                  to: "0x#{event['topics'][2][26..].downcase}",
-                  txn: event['transactionHash'].downcase
-                }
-                log_it(
-                  :debug,
-                  "Payment of #{event[:amount]} tokens arrived " \
-                  "from #{event[:from]} to #{event[:to]} in #{event[:txn]}"
-                )
-              end
-              yield event
             end
+            yield event
           end
         end
       end
-      ws.on(:close) do
-        safe do
-          verbose do
-            log_it(:debug, "Disconnected from #{log_url}")
-          end
+    end
+    ws.on(:close) do
+      safe do
+        verbose do
+          log_it(:debug, "Disconnected ##{subscription_id} from #{log_url}")
+          active.clear
+          timer&.cancel
+          reaccept(addresses, active, raw:, delay:, subscription_id: subscription_id + 1, &)
         end
       end
-      ws.on(:error) do |e|
-        safe do
-          verbose do
-            log_it(:debug, "Error at #{log_url}: #{e.message}")
-          end
+    end
+    ws.on(:error) do |e|
+      safe do
+        verbose do
+          log_it(:debug, "Failed ##{subscription_id} at #{log_url}: #{e.message}")
         end
       end
-      EventMachine.add_periodic_timer(delay) do
-        next if active.to_a.sort == addresses.to_a.sort
-        attempt = addresses.to_a
-        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 at #{log_url}: " \
-          "#{addresses.to_a.map { |a| a[0..6] }.join(', ')}"
-        )
-      end
     end
   end
 
-  private
-
   def to_json(msg)
     JSON.parse(msg.data)
   rescue StandardError

data/test/erc20/test_wallet.rb

@@ -7,7 +7,9 @@ require 'backtrace'
 require 'donce'
 require 'eth'
 require 'faraday'
+require 'fileutils'
 require 'json'
+require 'os'
 require 'random-port'
 require 'shellwords'
 require 'threads'
@@ -20,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(
@@ -83,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
@@ -231,6 +174,38 @@ class TestWallet < ERC20::Test
     end
   end
 
+  def test_accepts_payments_on_hardhat_after_disconnect
+    skip('Works only on macOS') unless OS.mac?
+    WebMock.enable_net_connect!
+    walter = Eth::Key.new(priv: WALTER).address.to_s.downcase
+    Dir.mktmpdir do |home|
+      die = File.join(home, 'die.txt')
+      on_hardhat(die:) do |wallet|
+        active = []
+        events = []
+        daemon =
+          Thread.new do
+            wallet.accept([walter], active, subscription_id: 42) do |e|
+              events.append(e)
+            end
+          rescue StandardError => e
+            fake_loog.error(Backtrace.new(e))
+          end
+        wait_for { !active.empty? }
+        wallet.pay(JEFF, walter, 4_567)
+        wait_for { events.size == 1 }
+        FileUtils.touch(die)
+        on_hardhat(port: wallet.port) do
+          wallet.pay(JEFF, walter, 3_456)
+          wait_for { events.size > 1 }
+          daemon.kill
+          daemon.join(30)
+          assert_equal(3, events.size)
+        end
+      end
+    end
+  end
+
   def test_accepts_many_payments_on_hardhat
     WebMock.enable_net_connect!
     walter = Eth::Key.new(priv: WALTER).address.to_s.downcase
@@ -345,26 +320,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
@@ -376,133 +331,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
-    RandomPort::Pool::SINGLETON.acquire do |port|
-      donce(
-        home: File.join(__dir__, '../../hardhat'),
-        ports: { port => 8545 },
-        command: 'npx hardhat node',
-        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.4
+  version: 0.1.6
 platform: ruby
 authors:
 - Yegor Bugayenko
 bindir: bin
 cert_chain: []
-date: 2025-04-21 00:00:00.000000000 Z
+date: 2025-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: eth
@@ -149,6 +149,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: