erc20 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b960e80558aca8b654d178d60629c83673a67c419a41be4e224be99b12bebbf
-  data.tar.gz: 706ad9b5c8187dd6db93821f0aefe2d84ddadfe6f77eac35d5e416e052653f57
+  metadata.gz: bf1f0dbee9d090079bd263a79eeafc0093866fc5503d7a1130b26e7b77ca8630
+  data.tar.gz: 105f04b7df7e9b8f45a3c34acb739fb6b74238e9f7180b624ceb724f8a4c1570
 SHA512:
-  metadata.gz: 935689bf9f9e0bc69a8d5415bf30d5f24f0c64c3057a5e5496229f73c1a4a0f65c51f2d243959f6cf0be39d44e35f19eaa4d0df1e62320d1861b9d28196de33c
-  data.tar.gz: 875542239945570f71fa515d478d70ba705b5c85a66d1109b1e138e71b318cdba01044c6a51a791912b2551c0f5d5cc02ff7022e7f1e560dfa45faa86d875c03
+  metadata.gz: e86283d48937fca5b956c0963b19c6b25b25226d6a60bd737e37d6201cc5dc82879d33ab79ff3ef919728762da601aa9d1bc56aaa85b94532f7edcafd29f04eb
+  data.tar.gz: f11fd8b7d8b017c4fbdc70b4442aa054344fee9451fd029e7826da8fe12961ac60447522945e83b941ab7ccf28a67299a9077c47b114f8736336d42c6b16088f

data/.github/workflows/actionlint.yml

@@ -28,6 +28,7 @@ name: actionlint
       - master
 jobs:
   actionlint:
+    timeout-minutes: 15
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4

data/.github/workflows/codecov.yml

@@ -25,6 +25,7 @@ name: codecov
       - master
 jobs:
   codecov:
+    timeout-minutes: 15
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
@@ -33,7 +34,7 @@ jobs:
           ruby-version: 3.3
           bundler-cache: true
       - run: bundle config set --global path "$(pwd)/vendor/bundle"
-      - run: bundle install
+      - run: bundle install --no-color
       - run: bundle exec rake
       - uses: codecov/codecov-action@v5
         with:

data/.github/workflows/copyrights.yml

@@ -28,6 +28,7 @@ name: copyrights
       - master
 jobs:
   copyrights:
+    timeout-minutes: 15
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4

data/.github/workflows/markdown-lint.yml

@@ -32,6 +32,7 @@ concurrency:
   cancel-in-progress: true
 jobs:
   markdown-lint:
+    timeout-minutes: 15
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4

data/.github/workflows/pdd.yml

@@ -28,6 +28,7 @@ name: pdd
       - master
 jobs:
   pdd:
+    timeout-minutes: 15
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4

data/.github/workflows/rake.yml

@@ -28,18 +28,27 @@ name: rake
       - master
 jobs:
   rake:
-    name: test
     strategy:
       matrix:
-        os: [ubuntu-24.04, macos-15, windows-2022]
+        os: [ubuntu-24.04]
         ruby: [3.3]
     runs-on: ${{ matrix.os }}
+    env:
+      INFURA_KEY: ${{ secrets.INFURA_KEY }}
+      GETBLOCK_KEY: ${{ secrets.GETBLOCK_KEY }}
+      GETBLOCK_SEPOILA_KEY: ${{ secrets.GETBLOCK_SEPOILA_KEY }}
     steps:
       - uses: actions/checkout@v4
+      - run: |
+          sudo apt-get update --yes --fix-missing
+          sudo apt-get install --yes autoconf
+        if: matrix.os == 'ubuntu-24.04'
+      - run: brew install automake
+        if: matrix.os == 'macos-15'
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
       - run: bundle config set --global path "$(pwd)/vendor/bundle"
-      - run: bundle install
+      - run: bundle install --no-color
       - run: bundle exec rake

data/.github/workflows/shellcheck.yml

@@ -0,0 +1,37 @@
+# (The MIT License)
+#
+# Copyright (c) 2025 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
+name: shellcheck
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  shellcheck:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ludeeus/action-shellcheck@master

data/.github/workflows/xcop.yml

@@ -28,6 +28,7 @@ name: xcop
       - master
 jobs:
   xcop:
+    timeout-minutes: 15
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4

data/.github/workflows/yamllint.yml

@@ -28,6 +28,7 @@ name: yamllint
       - master
 jobs:
   yamllint:
+    timeout-minutes: 15
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4

data/.gitignore

@@ -6,3 +6,4 @@ coverage/
 rdoc/
 doc/
 .yardoc/
+node_modules/

data/.gitleaksignore

@@ -0,0 +1,2 @@
+hardhat/hardhat.config.js:generic-api-key:38
+hardhat/hardhat.config.js:generic-api-key:42

data/.rubocop.yml

@@ -30,7 +30,7 @@ AllCops:
 require:
   - rubocop-minitest
   - rubocop-performance
-
+  - rubocop-rake
 Minitest/EmptyLineBeforeAssertionMethods:
   Enabled: false
 Gemspec/RequiredRubyVersion:
@@ -44,7 +44,7 @@ Layout/MultilineMethodCallIndentation:
 Metrics/AbcSize:
   Enabled: false
 Metrics/BlockLength:
-  Max: 30
+  Max: 50
 Metrics/CyclomaticComplexity:
   Max: 25
 Metrics/PerceivedComplexity:

data/.rultor.yml

@@ -29,7 +29,7 @@ release:
   pre: false
   script: |-
     [[ "${tag}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || exit -1
-    bundle exec rake
+    DONCE_SUDO=true bundle exec rake
     rm -rf *.gem
     sed -i "s/0\.0\.0/${tag}/g" lib/erc20.rb
     git add lib/erc20.rb
@@ -39,4 +39,4 @@ release:
     gem push *.gem --config-file ../rubygems.yml
 merge:
   script: |-
-    bundle exec rake
+    DONCE_SUDO=true bundle exec rake

data/Gemfile

@@ -23,16 +23,23 @@
 source 'https://rubygems.org'
 gemspec
 
+gem 'backtrace', '>0', require: false
+gem 'donce', '>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 'qbash', '>0', require: false
 gem 'rake', '13.2.1', require: false
-gem 'rspec-rails', '7.1.0', require: false
-gem 'rubocop', '1.71.1', require: false
+gem 'random-port', '>0', require: false
+gem 'rspec-rails', '7.1.1', require: false
+gem 'rubocop', '1.71.2', require: false
 gem 'rubocop-minitest', '0.36.0', require: false
 gem 'rubocop-performance', '1.23.1', require: false
+gem 'rubocop-rake', '>0', require: false
 gem 'rubocop-rspec', '3.4.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 'typhoeus', '>0', require: false
 gem 'yard', '0.9.37', require: false

data/Gemfile.lock

@@ -3,7 +3,11 @@ PATH
   specs:
     erc20 (0.0.0)
       backtrace (> 0)
+      eth (~> 0.4)
+      jsonrpc-client (> 0)
+      loog (> 0)
       tago (> 0)
+      websocket-client-simple (> 0)
 
 GEM
   remote: https://rubygems.org/
@@ -50,8 +54,39 @@ GEM
     date (3.4.1)
     diff-lcs (1.5.1)
     docile (1.4.1)
+    donce (0.1.0)
+      backtrace (> 0)
+      os (> 0)
+      qbash (> 0)
     drb (2.2.1)
+    elapsed (0.0.1)
+      loog (> 0)
+      tago (> 0)
     erubi (1.13.1)
+    eth (0.5.13)
+      forwardable (~> 1.3)
+      keccak (~> 1.3)
+      konstructor (~> 1.0)
+      openssl (>= 2.2, < 4.0)
+      rbsecp256k1 (~> 6.0)
+      scrypt (~> 3.0)
+    ethon (0.16.0)
+      ffi (>= 1.15.0)
+    event_emitter (0.2.6)
+    faraday (2.12.2)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.0)
+      net-http (>= 0.5.0)
+    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-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)
@@ -59,19 +94,31 @@ GEM
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.9.1)
+    json (2.10.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)
     logger (1.6.5)
     loofah (2.24.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.12.0)
     loog (0.6.0)
+    mini_portile2 (2.8.8)
     minitest (5.25.4)
     minitest-reporters (1.7.1)
       ansi
       builder
       minitest (>= 5.0)
       ruby-progressbar
+    minitest-retry (0.2.5)
+      minitest (>= 5.0)
+    multi_json (1.15.0)
+    mutex_m (0.3.0)
+    net-http (0.6.0)
+      uri
     nokogiri (1.18.2-arm64-darwin)
       racc (~> 1.4)
     nokogiri (1.18.2-x64-mingw-ucrt)
@@ -80,16 +127,24 @@ GEM
       racc (~> 1.4)
     nokogiri (1.18.2-x86_64-linux-gnu)
       racc (~> 1.4)
+    openssl (3.3.0)
+    os (1.1.4)
     parallel (1.26.3)
-    parser (3.3.7.0)
+    parser (3.3.7.1)
       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
+    qbash (0.4.0)
+      backtrace (> 0)
+      elapsed (> 0)
+      loog (> 0)
+      tago (> 0)
     racc (1.8.1)
     rack (3.1.9)
     rack-session (2.1.0)
@@ -116,13 +171,19 @@ GEM
       zeitwerk (~> 2.6)
     rainbow (3.1.1)
     rake (13.2.1)
-    rdoc (6.11.0)
+    random-port (0.7.5)
+      tago (> 0)
+    rbsecp256k1 (6.0.0)
+      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.0)
-    rspec-core (3.13.2)
+    rspec-core (3.13.3)
       rspec-support (~> 3.13.0)
     rspec-expectations (3.13.3)
       diff-lcs (>= 1.2.0, < 2.0)
@@ -130,7 +191,7 @@ GEM
     rspec-mocks (3.13.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-rails (7.1.0)
+    rspec-rails (7.1.1)
       actionpack (>= 7.0)
       activesupport (>= 7.0)
       railties (>= 7.0)
@@ -139,7 +200,7 @@ GEM
       rspec-mocks (~> 3.13)
       rspec-support (~> 3.13)
     rspec-support (3.13.2)
-    rubocop (1.71.1)
+    rubocop (1.71.2)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
@@ -157,9 +218,15 @@ GEM
     rubocop-performance (1.23.1)
       rubocop (>= 1.48.1, < 2.0)
       rubocop-ast (>= 1.31.1, < 2.0)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
     rubocop-rspec (3.4.0)
       rubocop (~> 1.61)
     ruby-progressbar (1.13.0)
+    rubyzip (2.4.1)
+    scrypt (3.0.8)
+      ffi-compiler (>= 1.0, < 2.0)
+      rake (>= 9, < 14)
     securerandom (0.4.1)
     simplecov (0.22.0)
       docile (~> 1.1)
@@ -176,6 +243,8 @@ GEM
     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)
@@ -183,6 +252,12 @@ GEM
     unicode-emoji (4.0.4)
     uri (1.0.2)
     useragent (0.16.11)
+    websocket (1.2.11)
+    websocket-client-simple (0.9.0)
+      base64
+      event_emitter
+      mutex_m
+      websocket
     yard (0.9.37)
     zeitwerk (2.7.1)
 
@@ -196,19 +271,26 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
+  backtrace (> 0)
+  donce (> 0)
   erc20!
   loog (> 0)
   minitest (= 5.25.4)
   minitest-reporters (= 1.7.1)
+  minitest-retry (= 0.2.5)
+  qbash (> 0)
   rake (= 13.2.1)
-  rspec-rails (= 7.1.0)
-  rubocop (= 1.71.1)
+  random-port (> 0)
+  rspec-rails (= 7.1.1)
+  rubocop (= 1.71.2)
   rubocop-minitest (= 0.36.0)
   rubocop-performance (= 1.23.1)
+  rubocop-rake (> 0)
   rubocop-rspec (= 3.4.0)
   simplecov (= 0.22.0)
   simplecov-cobertura (= 2.1.0)
   threads (= 0.4.1)
+  typhoeus (> 0)
   yard (= 0.9.37)
 
 BUNDLED WITH

data/README.md

@@ -11,27 +11,47 @@
 [![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 library makes Etherium ERC20 manipulations
-as simple as they can be, for a cryptocurrency newbie:
+This small Ruby library makes manipulations with [Etherium] [ERC20] tokens
+as simple as they can be, if you have a provider of
+[JSON-RPC] and [WebSocket] Etherium APIs, for example
+[Infura], [GetBlock], or [Alchemy]:
 
 ```ruby
-# List of private keys:
-keys = ['...', '...']
-
 # Create a wallet:
-w = ERC20::Wallet.new(keys)
+w = ERC20::Wallet.new(
+  contract: ERC20::Wallet.USDT, # hex of it
+  rpc: 'https://mainnet.infura.io/v3/<your-key>',
+  wss: 'wss://mainnet.infura.io/v3/<your-key>',
+  log: $stdout
+)
 
-# Add new key and return its public address:
-address = w.create
+# Check balance on the address:
+usdt = w.balance(address)
 
-# Send a few tokens to someone:
-w.send(to_address, amount)
+# Send a few tokens to someone and get transaction hash:
+txn = w.pay(private_key, to_address, amount)
 
 # Stay waiting, and trigger the block when transactions arrive:
-w.accept(&block)
+addresses = ['0x...', '0x...']
+w.accept(addresses) do |event|
+  puts event['data'].to_i(16)) # how much
+  puts "0x#{event['topics'][1][26..]}" # who sent the payment
+  puts "0x#{event['topics'][2][26..]}" # who was the receiver
+end
+```
+
+To generate a new private key, use [eth](https://rubygems.org/gems/eth):
+
+```ruby
+require 'eth'
+key = Eth::Key.new.private_hex
 ```
 
-That's it.
+To get address from private one:
+
+```ruby
+public_hex = Eth::Key.new(priv: key).address
+```
 
 ## How to contribute
 
@@ -48,3 +68,11 @@ bundle exec rake
 ```
 
 If it's clean and you don't see any error messages, submit your pull request.
+
+[Etherium]: 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/
+[Websocket]: https://ethereum.org/en/developers/tutorials/using-websockets/
+[Infura]: https://infura.io/
+[Alchemy]: https://alchemy.com/
+[GetBlock]: https://getblock.io/

data/Rakefile

@@ -32,7 +32,7 @@ def version
   Gem::Specification.load(Dir['*.gemspec'].first).version
 end
 
-task default: %i[clean test rubocop yard copyright]
+task default: %i[clean test rubocop yard]
 
 require 'rake/testtask'
 desc 'Run all unit tests'
@@ -61,11 +61,3 @@ desc 'Run benchmark script'
 task :benchmark do
   ruby 'benchmarks/simple.rb'
 end
-
-task :copyright do
-  sh "grep -q -r '#{Date.today.strftime('%Y')}' \
-    --include '*.rb' \
-    --include '*.txt' \
-    --include 'Rakefile' \
-    ."
-end

data/erc20.gemspec

@@ -40,6 +40,10 @@ Gem::Specification.new do |s|
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = ['README.md', 'LICENSE.txt']
   s.add_dependency 'backtrace', '>0'
+  s.add_dependency 'eth', '~>0.4'
+  s.add_dependency 'jsonrpc-client', '>0'
+  s.add_dependency 'loog', '>0'
   s.add_dependency 'tago', '>0'
+  s.add_dependency 'websocket-client-simple', '>0'
   s.metadata['rubygems_mfa_required'] = 'true'
 end

data/hardhat/.gitignore

@@ -0,0 +1,5 @@
+artifacts/
+cache/
+node_modules/
+ignition/deployments/
+package-lock.json

data/hardhat/Dockerfile

@@ -0,0 +1,44 @@
+# Copyright (c) 2025 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+FROM node:22
+
+ENV HOME=/hh
+WORKDIR /app
+EXPOSE 8545
+
+COPY package.json .
+RUN npm install
+
+# These two must be provided via '--build-arg':
+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
+
+COPY contracts contracts
+COPY ignition ignition
+
+RUN rm -rf ignition/deployments
+
+RUN npx hardhat compile
+
+RUN rm -rf cache

data/hardhat/contracts/Foo.sol

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.28;
+
+contract Foo {
+    string public name = "Foo";
+    string public symbol = "FOO";
+    uint8 public decimals = 18;
+
+    // Tracks the total token supply
+    uint256 public totalSupply;
+
+    // Owner of the token contract (for minting, etc., if desired)
+    address public owner;
+
+    // Balances for each account
+    mapping(address => uint256) private _balances;
+
+    // Allowances for each account, where allowances[from][spender] = amount
+    mapping(address => mapping(address => uint256)) private _allowances;
+
+    // Events
+    event Transfer(address indexed from, address indexed to, uint256 value);
+    event Approval(address indexed owner, address indexed spender, uint256 value);
+
+    // Constructor: Mint an initial supply to the deployer
+    constructor() {
+        owner = msg.sender;
+        _mint(owner, 100000);
+        _mint(0xd5fF1bFCDE7A03Da61ad229d962c74F1eA2f16A5, 123000000000); // Jeff
+        _mint(0xd7a63Ac9DD3d7878bc042A4bADA214EE4aff8c85, 456000000000); // Walter
+    }
+
+    function balanceOf(address account) external view returns (uint256) {
+        return _balances[account];
+    }
+
+    function transfer(address recipient, uint256 amount) external returns (bool) {
+        _transfer(msg.sender, recipient, amount);
+        return true;
+    }
+
+    function allowance(address _owner, address _spender) external view returns (uint256) {
+        return _allowances[_owner][_spender];
+    }
+
+    function approve(address spender, uint256 amount) external returns (bool) {
+        _approve(msg.sender, spender, amount);
+        return true;
+    }
+
+    function transferFrom(
+        address sender,
+        address recipient,
+        uint256 amount
+    ) external returns (bool) {
+        uint256 currentAllowance = _allowances[sender][msg.sender];
+        require(currentAllowance >= amount, "ERC20: transfer amount exceeds allowance");
+        _approve(sender, msg.sender, currentAllowance - amount);
+        _transfer(sender, recipient, amount);
+
+        return true;
+    }
+
+    function mint(address account, uint256 amount) public {
+        require(msg.sender == owner, "ERC20: only owner can mint");
+        _mint(account, amount);
+    }
+
+    function _transfer(address sender, address recipient, uint256 amount) internal {
+        require(sender != address(0), "ERC20: transfer from the zero address");
+        require(recipient != address(0), "ERC20: transfer to the zero address");
+        require(_balances[sender] >= amount, "ERC20: transfer amount exceeds balance");
+        _balances[sender] -= amount;
+        _balances[recipient] += amount;
+        emit Transfer(sender, recipient, amount);
+    }
+
+    function _approve(
+        address tokenOwner,
+        address spender,
+        uint256 amount
+    ) internal {
+        require(tokenOwner != address(0), "ERC20: approve from the zero address");
+        require(spender != address(0), "ERC20: approve to the zero address");
+        _allowances[tokenOwner][spender] = amount;
+        emit Approval(tokenOwner, spender, amount);
+    }
+
+    function _mint(address account, uint256 amount) internal {
+        require(account != address(0), "ERC20: mint to the zero address");
+        totalSupply += amount;
+        _balances[account] += amount;
+        emit Transfer(address(0), account, amount);
+    }
+}

data/hardhat/hardhat.config.js

@@ -0,0 +1,52 @@
+// Copyright (c) 2025 Yegor Bugayenko
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+require("@nomicfoundation/hardhat-toolbox");
+
+/** @type import("hardhat/config").HardhatUserConfig */
+
+module.exports = {
+  solidity: "0.8.28",
+  defaultNetwork: "foo",
+  networks: {
+    hardhat: {
+      chainId: 4242,
+      gas: 10,
+      gasPrice: 4,
+      maxFeePerGas: 100,
+      maxPriorityFeePerGas: 100,
+      initialBaseFeePerGas: 100,
+      accounts: [
+        {
+          privateKey: "81a9b2114d53731ecc84b261ef6c0387dde34d5907fe7b441240cc21d61bf80a",
+          balance: "55555555555555555555555"
+        },
+        {
+          privateKey: "91f9111b1744d55361e632771a4e53839e9442a9fef45febc0a5c838c686a15b",
+          balance: "66666666666666666666666"
+        }
+      ]
+    },
+    foo: {
+      chainId: 4242,
+      url: "http://HOST:PORT"
+    }
+  }
+};

data/hardhat/ignition/modules/Foo.ts

@@ -0,0 +1,28 @@
+// Copyright (c) 2025 Yegor Bugayenko
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the 'Software'), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
+
+const FooModule = buildModule("FooModule", (m) => {
+  const foo = m.contract("Foo");
+  return { foo };
+});
+
+export default FooModule;

data/hardhat/package.json

@@ -0,0 +1,7 @@
+{
+  "devDependencies": {
+    "@nomicfoundation/hardhat-ignition-ethers": "^0.15.9",
+    "@nomicfoundation/hardhat-toolbox": "^5.0.0",
+    "hardhat": "^2.22.18"
+  }
+}

data/lib/erc20/wallet.rb

@@ -20,6 +20,10 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+require 'eth'
+require 'jsonrpc/client'
+require 'loog'
+require 'websocket-client-simple'
 require_relative '../erc20'
 
 # A wallet.
@@ -30,18 +34,133 @@ require_relative '../erc20'
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 class ERC20::Wallet
+  # Address of USDT contract.
+  USDT = '0xdac17f958d2ee523a2206206994597c13d831ec7'
+
   # Constructor.
-  # @param [Array<String>] keys Private keys
-  # @param [String] host The host of the server
+  # @param [String] contract Hex of the contract in Etherium
+  # @param [String] rpc The URL of Etherium JSON-RPC provider
+  # @param [Integer] chain The ID of the chain (1 for mainnet)
   # @param [Object] log The destination for logs
-  def initialize(keys, host: '', log: $stdout)
-    @keys = keys
-    @host = host
+  def initialize(contract: USDT, rpc: nil, wss: nil, chain: 1, log: $stdout)
+    @contract = contract
+    @rpc = rpc
+    @wss = wss
     @log = log
+    @chain = chain
+  end
+
+  # Get balance of a public address.
+  #
+  # @param [String] hex Public key, in hex, starting from '0x'
+  # @return [Integer] Balance, in
+  def balance(hex)
+    func = '70a08231' # balanceOf
+    padded = "000000000000000000000000#{hex[2..].downcase}"
+    data = "0x#{func}#{padded}"
+    r = jsonrpc.eth_call({ to: @contract, data: data }, 'latest')
+    r[2..].to_i(16)
+  end
+
+  # Send a single 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 [Integer] gas_limit How much gas you are ready to spend
+  # @param [Integer] gas_price How much gas you pay per computation unit
+  # @return [String] Transaction hash
+  def pay(priv, address, amount, gas_limit: nil, gas_price: nil)
+    func = 'a9059cbb' # transfer(address,uint256)
+    to_clean = address.downcase.sub(/^0x/, '')
+    to_padded = ('0' * (64 - to_clean.size)) + to_clean
+    amt_hex = amount.to_s(16)
+    amt_padded = ('0' * (64 - amt_hex.size)) + amt_hex
+    data = "0x#{func}#{to_padded}#{amt_padded}"
+    key = Eth::Key.new(priv: priv)
+    from = key.address
+    nonce = jsonrpc.eth_getTransactionCount(from, 'pending').to_i(16)
+    tx = Eth::Tx.new(
+      {
+        nonce:,
+        gas_price: gas_price || gas_best_price,
+        gas_limit: gas_limit || gas_estimate(from, data),
+        to: @contract,
+        value: 0,
+        data: data,
+        chain_id: @chain
+      }
+    )
+    tx.sign(key)
+    jsonrpc.eth_sendRawTransaction("0x#{tx.hex}")
+  end
+
+  # Wait for incoming transactions and let the block know when they
+  # arrive. It's a blocking call, it's better to run it in a separate
+  # thread.
+  #
+  # @param [Array<String>] addresses Addresses to monitor
+  # @param [Array] ready When connected, TRUE will be added to this array
+  def accept(addresses, connected: [])
+    WebSocket::Client::Simple.connect(@wss) do |ws|
+      log = @log
+      contract = @contract
+      wss = @wss
+      ws.on(:open) do
+        log.debug("Connected to #{wss}")
+        msg = {
+          jsonrpc: '2.0',
+          id: 1,
+          method: 'eth_subscribe',
+          params: [
+            'logs',
+            {
+              address: contract,
+              topics: [
+                '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+                nil,
+                addresses.map { |a| "0x000000000000000000000000#{a[2..]}" }
+              ]
+            }
+          ]
+        }
+        ws.send(msg.to_json)
+        connected.append(1)
+      end
+      ws.on(:message) do |msg|
+        data =
+          begin
+            JSON.parse(msg.data)
+          rescue StandardError
+            {}
+          end
+        if data['method'] == 'eth_subscription' && data.dig('params', 'result')
+          event = data['params']['result']
+          log.debug("New transaction from: #{event['address']}")
+          yield event
+        end
+      end
+      ws.on(:close) do |_e|
+        log.debug("Disconnected from #{wss}")
+      end
+      ws.on(:error) do |e|
+        log.debug("Error at #{wss}: #{e}")
+      end
+    end
+  end
+
+  private
+
+  def jsonrpc
+    JSONRPC.logger = Loog::NULL
+    JSONRPC::Client.new(@rpc)
+  end
+
+  def gas_estimate(from, data)
+    jsonrpc.eth_estimateGas({ from:, to: @contract, data: }, 'latest').to_i(16)
   end
 
-  # Create new key and return its public address.
-  def create
-    'none'
+  def gas_best_price
+    jsonrpc.eth_getBlockByNumber('latest', false)['baseFeePerGas'].to_i(16)
   end
 end

data/lib/erc20.rb

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

data/test/erc20/test_wallet.rb

@@ -20,8 +20,14 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-require 'minitest/autorun'
+require 'backtrace'
+require 'donce'
+require 'eth'
 require 'loog'
+require 'random-port'
+require 'shellwords'
+require 'typhoeus'
+require 'minitest/autorun'
 require_relative '../../lib/erc20'
 require_relative '../../lib/erc20/wallet'
 
@@ -30,9 +36,162 @@ require_relative '../../lib/erc20/wallet'
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 class TestWallet < Minitest::Test
-  def test_simple
-    keys = []
-    w = ERC20::Wallet.new(keys, log: Loog::VERBOSE)
-    refute_nil(w.create)
+  # At this address, in the mainnet, there are a few USDT tokens. I won't
+  # move them anyway, that's why tests can use this address forever.
+  STABLE_ADDRESS = '0xEB2fE8872A6f1eDb70a2632EA1f869AB131532f6'
+
+  # One guy private hex.
+  JEFF = '81a9b2114d53731ecc84b261ef6c0387dde34d5907fe7b441240cc21d61bf80a'
+
+  # Another guy private hex.
+  WALTER = '91f9111b1744d55361e632771a4e53839e9442a9fef45febc0a5c838c686a15b'
+
+  def test_checks_balance_on_mainnet
+    b = mainnet.balance(STABLE_ADDRESS)
+    refute_nil(b)
+    assert_equal(27_258_889, b)
+  end
+
+  def test_checks_balance_of_absent_address
+    a = '0xEB2fE8872A6f1eDb70a2632Effffffffffffffff'
+    b = mainnet.balance(a)
+    refute_nil(b)
+    assert_equal(0, b)
+  end
+
+  def test_fails_with_invalid_infura_key
+    w = ERC20::Wallet.new(
+      rpc: 'https://mainnet.infura.io/v3/invalid-key-here',
+      log: Loog::NULL
+    )
+    assert_raises(StandardError) { w.balance(STABLE_ADDRESS) }
+  end
+
+  def test_checks_balance_on_testnet
+    skip('does not work')
+    b = testnet.balance(STABLE_ADDRESS)
+    refute_nil(b)
+    assert_predicate(b, :positive?)
+  end
+
+  def test_checks_balance_on_hardhat
+    on_hardhat do |wallet|
+      b = wallet.balance(Eth::Key.new(priv: JEFF).address.to_s)
+      assert_equal(123_000_100_000, b)
+    end
+  end
+
+  def test_pays_on_hardhat
+    on_hardhat do |wallet|
+      to = Eth::Key.new(priv: WALTER).address.to_s
+      before = wallet.balance(to)
+      sum = 42_000
+      from = Eth::Key.new(priv: JEFF).address.to_s
+      assert_operator(wallet.balance(from), :>, sum * 2)
+      wallet.pay(JEFF, to, sum)
+      assert_equal(before + sum, wallet.balance(to))
+    end
+  end
+
+  def test_accepts_payments_on_hardhat
+    walter = Eth::Key.new(priv: WALTER).address.to_s.downcase
+    jeff = Eth::Key.new(priv: JEFF).address.to_s.downcase
+    on_hardhat do |wallet|
+      connected = []
+      event = nil
+      daemon =
+        Thread.new do
+          wallet.accept([walter, jeff], connected:) do |e|
+            event = e
+          end
+        rescue StandardError => e
+          puts Backtrace.new(e)
+        end
+      wait_for { !connected.empty? }
+      sum = 77_000
+      wallet.pay(JEFF, walter, sum)
+      wait_for { !event.nil? }
+      daemon.kill
+      daemon.join(30)
+      assert_equal(sum, event['data'].to_i(16))
+      from = "0x#{event['topics'][1][26..].downcase}"
+      assert_equal(jeff, from)
+      to = "0x#{event['topics'][2][26..].downcase}"
+      assert_equal(walter, to)
+    end
+  end
+
+  private
+
+  def wait_for
+    start = Time.now
+    loop do
+      sleep(0.1)
+      break if yield
+      raise 'timeout' if Time.now - start > 15
+    rescue Errno::ECONNREFUSED
+      retry
+    end
+  end
+
+  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?
+    key
+  end
+
+  def mainnet
+    [
+      "https://mainnet.infura.io/v3/#{env('INFURA_KEY')}",
+      "https://go.getblock.io/#{env('GETBLOCK_KEY')}"
+    ].map do |rpc|
+      ERC20::Wallet.new(rpc:, log: Loog::NULL)
+    end.sample
+  end
+
+  def testnet
+    [
+      "https://sepolia.infura.io/v3/#{env('INFURA_KEY')}",
+      "https://go.getblock.io/#{env('GETBLOCK_SEPOILA_KEY')}"
+    ].map do |rpc|
+      ERC20::Wallet.new(rpc:, log: Loog::NULL)
+    end.sample
+  end
+
+  def on_hardhat
+    RandomPort::Pool::SINGLETON.acquire do |port|
+      donce(
+        home: File.join(__dir__, '../../hardhat'),
+        ports: { port => 8545 },
+        command: 'npx hardhat node',
+        log: Loog::NULL
+      ) 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: Loog::NULL,
+          root: true
+        ).split("\n").last
+        wallet = ERC20::Wallet.new(
+          contract:, chain: 4242,
+          rpc: "http://localhost:#{port}",
+          wss: "ws://localhost:#{port}",
+          log: Loog::NULL
+        )
+        yield wallet
+      end
+    end
   end
 end

data/test/test__helper.rb

@@ -33,3 +33,7 @@ require 'minitest/autorun'
 
 require 'minitest/reporters'
 Minitest::Reporters.use! [Minitest::Reporters::SpecReporter.new]
+
+# To make tests retry on failure:
+require 'minitest/retry'
+Minitest::Retry.use!(methods_to_skip: [])

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: erc20
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-31 00:00:00.000000000 Z
+date: 2025-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace
@@ -24,6 +24,48 @@ dependencies:
     - - ">"
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: eth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: jsonrpc-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: loog
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: tago
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +80,20 @@ dependencies:
     - - ">"
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: websocket-client-simple
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A simple library for making ERC20 manipulations as easy as theycan be
   for cryptocurrency newbies
 email: yegor256@gmail.com
@@ -55,9 +111,11 @@ files:
 - ".github/workflows/markdown-lint.yml"
 - ".github/workflows/pdd.yml"
 - ".github/workflows/rake.yml"
+- ".github/workflows/shellcheck.yml"
 - ".github/workflows/xcop.yml"
 - ".github/workflows/yamllint.yml"
 - ".gitignore"
+- ".gitleaksignore"
 - ".pdd"
 - ".rubocop.yml"
 - ".rultor.yml"
@@ -69,6 +127,12 @@ files:
 - README.md
 - Rakefile
 - erc20.gemspec
+- hardhat/.gitignore
+- hardhat/Dockerfile
+- hardhat/contracts/Foo.sol
+- hardhat/hardhat.config.js
+- hardhat/ignition/modules/Foo.ts
+- hardhat/package.json
 - lib/erc20.rb
 - lib/erc20/wallet.rb
 - renovate.json