erc20 0.0.20 → 0.1.0

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,7 +64,7 @@ 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
@@ -94,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
@@ -106,7 +108,7 @@ class ERC20::FakeWallet
   # @param [Integer] amount The amount of ETHs to send
   # @return [String] Transaction hash
   def eth_pay(priv, address, amount, gas_price: nil)
-    hex = '0x172de9cda30537eae68ab4a96163ebbb8f8a85293b8737dd2e5deb4714b14623'
+    hex = TXN_HASH
     @history << { method: :eth_pay, priv:, address:, amount:, gas_price:, result: hex }
     hex
   end
@@ -132,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'

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'
@@ -57,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
@@ -80,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
 

data/test/erc20/test_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'

data/test/test__helper.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
 
 $stdout.sync = true
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: erc20
 version: !ruby/object:Gem::Version
-  version: 0.0.20
+  version: 0.1.0
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-17 00:00:00.000000000 Z
+date: 2025-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: eth
@@ -80,12 +80,27 @@ dependencies:
     - - ">"
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: slop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '4'
 description: 'A simple library for making ERC20 manipulations as easy as they can
   be for cryptocurrency newbies: checking balance, sending payments, and monitoring
   addresses for incoming payments. The library expects Etherium node to provide JSON
   RPC and Websockets API.'
 email: yegor256@gmail.com
-executables: []
+executables:
+- erc20
 extensions: []
 extra_rdoc_files:
 - README.md
@@ -99,6 +114,7 @@ files:
 - ".github/workflows/markdown-lint.yml"
 - ".github/workflows/pdd.yml"
 - ".github/workflows/rake.yml"
+- ".github/workflows/reuse.yml"
 - ".github/workflows/shellcheck.yml"
 - ".github/workflows/xcop.yml"
 - ".github/workflows/yamllint.yml"
@@ -112,9 +128,16 @@ files:
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
+- LICENSES/MIT.txt
 - README.md
+- REUSE.toml
 - Rakefile
+- bin/erc20
 - erc20.gemspec
+- features/cli.feature
+- features/gem_package.feature
+- features/step_definitions/steps.rb
+- features/support/env.rb
 - hardhat/.gitignore
 - hardhat/Dockerfile
 - hardhat/contracts/Foo.sol