erc20 0.0.19 → 0.0.21

data/hardhat/Dockerfile

@@ -1,22 +1,5 @@
-# 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.
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 FROM node:22
 

data/hardhat/contracts/Foo.sol

@@ -1,4 +1,6 @@
+// SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
 // SPDX-License-Identifier: MIT
+
 pragma solidity ^0.8.28;
 
 contract Foo {

data/hardhat/hardhat.config.js

@@ -1,22 +1,5 @@
-// 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.
+// SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+// SPDX-License-Identifier: MIT
 
 require("@nomicfoundation/hardhat-toolbox");
 

data/hardhat/ignition/modules/Foo.ts

@@ -1,22 +1,5 @@
-// 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.
+// SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+// SPDX-License-Identifier: MIT
 
 import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
 

data/lib/erc20/erc20.rb

@@ -1,24 +1,7 @@
 # frozen_string_literal: true
 
-# 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.
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 # This module makes manipulations with Etherium ERC20 tokens
 # as simple as they can be, if you have a provider of
@@ -42,5 +25,5 @@
 # License:: MIT
 module ERC20
   # Current version of the gem (changed by the +.rultor.yml+ on every release)
-  VERSION = '0.0.19'
+  VERSION = '0.0.21'
 end

data/lib/erc20/fake_wallet.rb

@@ -1,24 +1,7 @@
 # frozen_string_literal: true
 
-# 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.
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require_relative 'erc20'
 require_relative 'wallet'
@@ -29,6 +12,9 @@ require_relative 'wallet'
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 class ERC20::FakeWallet
+  # Transaction hash always returned:
+  TXN_HASH = '0x172de9cda30537eae68ab4a96163ebbb8f8a85293b8737dd2e5deb4714b14623'
+
   # Fakes:
   attr_reader :host, :port, :ssl, :chain, :contract, :ws_path, :http_path
 
@@ -45,6 +31,22 @@ class ERC20::FakeWallet
     @ws_path = '/'
     @http_path = '/'
     @history = []
+    @balances = {}
+    @eth_balances = {}
+  end
+
+  # Set balance, to be returned by the +balance()+.
+  # @param [String] address Public key, in hex, starting from '0x'
+  # @param [Integer] tokens How many tokens to put there
+  def set_balance(address, tokens)
+    @balances[address] = tokens
+  end
+
+  # Set balance, to be returned by the +balance()+.
+  # @param [String] address Public key, in hex, starting from '0x'
+  # @param [Integer] wei How many wei to put there
+  def set_eth_balance(address, wei)
+    @eth_balances[address] = wei
   end
 
   # Get ERC20 balance of a public address.
@@ -52,7 +54,7 @@ class ERC20::FakeWallet
   # @param [String] address Public key, in hex, starting from '0x'
   # @return [Integer] Balance, in tokens
   def balance(address)
-    b = 42_000_000
+    b = @balances[address] || 42_000_000
     @history << { method: :balance, address:, result: b }
     b
   end
@@ -62,31 +64,29 @@ class ERC20::FakeWallet
   # @param [String] address Public key, in hex, starting from '0x'
   # @return [Integer] Balance, in tokens
   def eth_balance(address)
-    b = 77_000_000_000_000_000
+    b = @eth_balances[address] || 77_000_000_000_000_000
     @history << { method: :eth_balance, address:, result: b }
     b
   end
 
-  # How much ETH gas is required in order to send this ERC20 transaction.
+  # How much gas units is required in order to send ERC20 transaction.
   #
   # @param [String] from The departing address, in hex
   # @param [String] to Arriving address, in hex
-  # @return [Integer] How many ETH required
-  def gas_required(from, to = from)
-    g = 66_000
-    @history << { method: :gas_required, from:, to:, result: g }
-    g
+  # @param [Integer] amount How many ERC20 tokens to send
+  # @return [Integer] How many gas units required
+  def gas_estimate(from, to, amount)
+    gas = 66_000
+    @history << { method: :gas_estimate, from:, to:, amount:, result: gas }
+    gas
   end
 
-  # How much ETH gas is required in order to send this ETH transaction.
-  #
-  # @param [String] from The departing address, in hex
-  # @param [String] to Arriving address, in hex (may be skipped)
-  # @return [Integer] How many ETH required
-  def eth_gas_required(from, to = from)
-    g = 55_000
-    @history << { method: :eth_gas_required, from:, to:, result: g }
-    g
+  # What is the price of gas unit in gwei?
+  # @return [Integer] Price of gas unit, in gwei (0.000000001 ETH)
+  def gas_price
+    gwei = 55_555
+    @history << { method: :gas_price, result: gwei }
+    gwei
   end
 
   # Send a single ERC20 payment from a private address to a public one.
@@ -96,7 +96,7 @@ class ERC20::FakeWallet
   # @param [Integer] _amount The amount of ERC20 tokens to send
   # @return [String] Transaction hash
   def pay(priv, address, amount, gas_limit: nil, gas_price: nil)
-    hex = '0x172de9cda30537eae68ab4a96163ebbb8f8a85293b8737dd2e5deb4714b14623'
+    hex = TXN_HASH
     @history << { method: :pay, priv:, address:, amount:, gas_limit:, gas_price:, result: hex }
     hex
   end
@@ -107,9 +107,9 @@ class ERC20::FakeWallet
   # @param [String] address Public key, in hex
   # @param [Integer] amount The amount of ETHs to send
   # @return [String] Transaction hash
-  def eth_pay(priv, address, amount, gas_limit: nil, gas_price: nil)
-    hex = '0x172de9cda30537eae68ab4a96163ebbb8f8a85293b8737dd2e5deb4714b14623'
-    @history << { method: :eth_pay, priv:, address:, amount:, gas_limit:, gas_price:, result: hex }
+  def eth_pay(priv, address, amount, gas_price: nil)
+    hex = TXN_HASH
+    @history << { method: :eth_pay, priv:, address:, amount:, gas_price:, result: hex }
     hex
   end
 
@@ -134,7 +134,7 @@ class ERC20::FakeWallet
             amount: 424_242,
             from: '0xd5ff1bfcde7a03da61ad229d962c74f1ea2f16a5',
             to: a,
-            txn: '0x172de9cda30537eae68ab4a96163ebbb8f8a85293b8737dd2e5deb4714b14623'
+            txn: TXN_HASH
           }
         end
       yield event

data/lib/erc20/wallet.rb

@@ -1,24 +1,7 @@
 # frozen_string_literal: true
 
-# 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.
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'eth'
 require 'eventmachine'
@@ -159,34 +142,33 @@ class ERC20::Wallet
     b
   end
 
-  # How much ETH gas is required in order to send ERC20 transaction.
+  # How much gas units is required in order to send ERC20 transaction.
   #
   # @param [String] from The departing address, in hex
-  # @param [String] to Arriving address, in hex (it's OK to skip it)
-  # @return [Integer] How many ETH required
-  def gas_required(from, to = from)
+  # @param [String] to Arriving address, in hex
+  # @param [Integer] amount How many ERC20 tokens to send
+  # @return [Integer] How many gas units required
+  def gas_estimate(from, to, amount)
     raise 'Address can\'t be nil' unless from
     raise 'Address must be a String' unless from.is_a?(String)
     raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(from)
     raise 'Address can\'t be nil' unless to
     raise 'Address must be a String' unless to.is_a?(String)
     raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(to)
-    gas_estimate(from, to, to_pay_data(from, 100_000))
+    raise 'Amount can\'t be nil' unless amount
+    raise "Amount (#{amount}) must be an Integer" unless amount.is_a?(Integer)
+    raise "Amount (#{amount}) must be a positive Integer" unless amount.positive?
+    gas = jsonrpc.eth_estimateGas({ from:, to: @contract, data: to_pay_data(to, amount) }, 'latest').to_i(16)
+    @log.debug("It would take #{gas} gas units to send #{amount} tokens from #{from} to #{to}")
+    gas
   end
 
-  # How much ETH gas is required in order to send this ETH transaction.
-  #
-  # @param [String] from The departing address, in hex
-  # @param [String] to Arriving address, in hex (it's OK to skip it)
-  # @return [Integer] How many ETH required
-  def eth_gas_required(from, to = from)
-    raise 'Address can\'t be nil' unless from
-    raise 'Address must be a String' unless from.is_a?(String)
-    raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(from)
-    raise 'Address can\'t be nil' unless to
-    raise 'Address must be a String' unless to.is_a?(String)
-    raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(to)
-    gas_estimate(from, to)
+  # What is the price of gas unit in gwei?
+  # @return [Integer] Price of gas unit, in gwei (0.000000001 ETH)
+  def gas_price
+    gwei = jsonrpc.eth_getBlockByNumber('latest', false)['baseFeePerGas'].to_i(16)
+    @log.debug("The cost of one gas unit is #{gwei} gwei")
+    gwei
   end
 
   # Send a single ERC20 payment from a private address to a public one.
@@ -194,10 +176,10 @@ class ERC20::Wallet
   # @param [String] priv Private key, in hex
   # @param [String] address Public key, in hex
   # @param [Integer] amount The amount of ERC20 tokens to send
-  # @param [Integer] gas_limit How much gas you're ready to spend
-  # @param [Integer] gas_price How much gas you pay per computation unit
+  # @param [Integer] limit How much gas you're ready to spend
+  # @param [Integer] price How much gas you pay per computation unit
   # @return [String] Transaction hash
-  def pay(priv, address, amount, gas_limit: nil, gas_price: gas_best_price)
+  def pay(priv, address, amount, limit: nil, price: gas_price)
     raise 'Private key can\'t be nil' unless priv
     raise 'Private key must be a String' unless priv.is_a?(String)
     raise 'Invalid format of private key' unless /^[0-9a-fA-F]{64}$/.match?(priv)
@@ -205,30 +187,29 @@ class ERC20::Wallet
     raise 'Address must be a String' unless address.is_a?(String)
     raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(address)
     raise 'Amount can\'t be nil' unless amount
-    raise 'Amount must be an Integer' unless amount.is_a?(Integer)
-    raise 'Amount must be a positive Integer' unless amount.positive?
-    if gas_limit
-      raise 'Gas limit must be an Integer' unless gas_limit.is_a?(Integer)
-      raise 'Gas limit must be a positive Integer' unless gas_limit.positive?
+    raise "Amount (#{amount}) must be an Integer" unless amount.is_a?(Integer)
+    raise "Amount (#{amount}) must be a positive Integer" unless amount.positive?
+    if limit
+      raise 'Gas limit must be an Integer' unless limit.is_a?(Integer)
+      raise 'Gas limit must be a positive Integer' unless limit.positive?
     end
-    if gas_price
-      raise 'Gas price must be an Integer' unless gas_price.is_a?(Integer)
-      raise 'Gas price must be a positive Integer' unless gas_price.positive?
+    if price
+      raise 'Gas price must be an Integer' unless price.is_a?(Integer)
+      raise 'Gas price must be a positive Integer' unless price.positive?
     end
     key = Eth::Key.new(priv: priv)
     from = key.address.to_s
-    data = to_pay_data(address, amount)
     tnx =
       @mutex.synchronize do
         nonce = jsonrpc.eth_getTransactionCount(from, 'pending').to_i(16)
         tx = Eth::Tx.new(
           {
             nonce:,
-            gas_price: gas_price,
-            gas_limit: gas_limit || gas_estimate(from, @contract, data),
+            gas_price: price,
+            gas_limit: limit || gas_estimate(from, address, amount),
             to: @contract,
             value: 0,
-            data:,
+            data: to_pay_data(address, amount),
             chain_id: @chain
           }
         )
@@ -245,10 +226,10 @@ class ERC20::Wallet
   # @param [String] priv Private key, in hex
   # @param [String] address Public key, in hex
   # @param [Integer] amount The amount of ERC20 tokens to send
-  # @param [Integer] gas_limit How much gas you're ready to spend
-  # @param [Integer] gas_price How much gas you pay per computation unit
+  # @param [Integer] limit How much gas you're ready to spend
+  # @param [Integer] price How much gas you pay per computation unit
   # @return [String] Transaction hash
-  def eth_pay(priv, address, amount, gas_limit: nil, gas_price: gas_best_price)
+  def eth_pay(priv, address, amount, price: gas_price)
     raise 'Private key can\'t be nil' unless priv
     raise 'Private key must be a String' unless priv.is_a?(String)
     raise 'Invalid format of private key' unless /^[0-9a-fA-F]{64}$/.match?(priv)
@@ -256,15 +237,11 @@ class ERC20::Wallet
     raise 'Address must be a String' unless address.is_a?(String)
     raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(address)
     raise 'Amount can\'t be nil' unless amount
-    raise 'Amount must be an Integer' unless amount.is_a?(Integer)
-    raise 'Amount must be a positive Integer' unless amount.positive?
-    if gas_limit
-      raise 'Gas limit must be an Integer' unless gas_limit.is_a?(Integer)
-      raise 'Gas limit must be a positive Integer' unless gas_limit.positive?
-    end
-    if gas_price
-      raise 'Gas price must be an Integer' unless gas_price.is_a?(Integer)
-      raise 'Gas price must be a positive Integer' unless gas_price.positive?
+    raise "Amount (#{amount}) must be an Integer" unless amount.is_a?(Integer)
+    raise "Amount (#{amount}) must be a positive Integer" unless amount.positive?
+    if price
+      raise 'Gas price must be an Integer' unless price.is_a?(Integer)
+      raise 'Gas price must be a positive Integer' unless price.positive?
     end
     key = Eth::Key.new(priv: priv)
     from = key.address.to_s
@@ -275,8 +252,8 @@ class ERC20::Wallet
           {
             chain_id: @chain,
             nonce:,
-            gas_price: gas_price,
-            gas_limit: gas_limit || gas_estimate(from, address),
+            gas_price: price,
+            gas_limit: 22_000,
             to: address,
             value: amount
           }
@@ -438,15 +415,6 @@ class ERC20::Wallet
     JSONRPC::Client.new(url, connection:)
   end
 
-  # How much gas should be spent in order to send a transaction from one
-  # public address to another public address, possible carrying some data
-  # inside the transaction.
-  def gas_estimate(from, to, data = '')
-    gas = jsonrpc.eth_estimateGas({ from:, to:, data: }, 'latest').to_i(16)
-    @log.debug("Estimated gas is #{gas} ETH#{data.empty? ? '' : ', for ERC20 transfer'}")
-    gas
-  end
-
   def to_pay_data(address, amount)
     func = 'a9059cbb' # transfer(address,uint256)
     to_clean = address.downcase.sub(/^0x/, '')
@@ -455,8 +423,4 @@ class ERC20::Wallet
     amt_padded = ('0' * (64 - amt_hex.size)) + amt_hex
     "0x#{func}#{to_padded}#{amt_padded}"
   end
-
-  def gas_best_price
-    jsonrpc.eth_getBlockByNumber('latest', false)['baseFeePerGas'].to_i(16)
-  end
 end

data/lib/erc20.rb

@@ -1,24 +1,7 @@
 # frozen_string_literal: true
 
-# 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.
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require_relative 'erc20/erc20'
 require_relative 'erc20/wallet'

data/test/erc20/test_fake_wallet.rb

@@ -1,24 +1,7 @@
 # frozen_string_literal: true
 
-# 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.
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'backtrace'
 require 'donce'
@@ -38,14 +21,18 @@ require_relative '../test__helper'
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 class TestFakeWallet < Minitest::Test
-  def test_checks_gas_required
-    b = ERC20::FakeWallet.new.gas_required('0xEB2fE8872A6f1eDb70a2632Effffffffffffffff')
+  def test_checks_gas_estimate
+    b = ERC20::FakeWallet.new.gas_estimate(
+      '0xEB2fE8872A6f1eDb70a2632Effffffffffffffff',
+      '0xfadef8ba4a5d709a2bf55b7a8798c9b438c640c1',
+      44_000
+    )
     refute_nil(b)
   end
 
-  def test_checks_eth_gas_required
-    b = ERC20::FakeWallet.new.eth_gas_required('0xEB2fE8872A6f1eDb70a2632Effffffffffffffff')
-    refute_nil(b)
+  def test_checks_gas_price
+    gwei = ERC20::FakeWallet.new.gas_price
+    refute_nil(gwei)
   end
 
   def test_checks_fake_balance
@@ -53,17 +40,35 @@ class TestFakeWallet < Minitest::Test
     a = '0xEB2fE8872A6f1eDb70a2632Effffffffffffffff'
     b = w.balance(a)
     refute_nil(b)
+    assert_equal(42_000_000, b)
     assert_includes(w.history, { method: :balance, result: b, address: a })
   end
 
+  def test_checks_preset_fake_balance
+    w = ERC20::FakeWallet.new
+    a = '0xEB2fE8872A6f1eDb70a2632Effffffffeefbbfaa'
+    b = 55_555
+    w.set_balance(a, b)
+    assert_equal(b, w.balance(a))
+  end
+
   def test_checks_fake_eth_balance
-    a = '0xEB2fE8872A6f1eDb70a2632Effffffffffffffff'
+    a = '0xEB2fE8872A6f1eDb70a2632Ebbffffff66fff77f'
     w = ERC20::FakeWallet.new
     b = w.eth_balance(a)
     refute_nil(b)
+    assert_equal(77_000_000_000_000_000, b)
     assert_includes(w.history, { method: :eth_balance, result: b, address: a })
   end
 
+  def test_checks_preset_fake_eth_balance
+    a = '0xEB2fE8872A6f1eDb70a2632Eff88fff99fff33ff'
+    w = ERC20::FakeWallet.new
+    b = 33_333
+    w.set_eth_balance(a, b)
+    assert_equal(b, w.eth_balance(a))
+  end
+
   def test_returns_host
     assert_equal('example.com', ERC20::FakeWallet.new.host)
   end
@@ -76,6 +81,7 @@ class TestFakeWallet < Minitest::Test
     txn = w.pay(priv, address, amount)
     assert_equal(66, txn.length)
     assert_match(/^0x[a-f0-9]{64}$/, txn)
+    assert_equal(ERC20::FakeWallet::TXN_HASH, txn)
     assert_includes(w.history, { method: :pay, result: txn, priv:, address:, amount:, gas_limit: nil, gas_price: nil })
   end