erc20 0.0.14 → 0.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac1bd8d3ffe6bf19ceb44174514dca9abb57746110c864821de775b2f11f955a
-  data.tar.gz: 7cc7b1d4fe20626629ea99ca5bb6cbb02686c872e36106c4c05fab846ad9b24b
+  metadata.gz: 7d2dd0547d65ca59e601a28f93a2b35b45ae8b3dc57fe6a09bd296d13fe807fd
+  data.tar.gz: a69c35dfd60d083f891a840285411373e7996937481f7c52a63f2ce9c09e2462
 SHA512:
-  metadata.gz: 7212c53bce48a094d0eaa8359bed81cad82e81f883caa47da2da4851cff7c6d3956036a3919265925f540b125cede427f5a9c506a60e3b002469bed22096695a
-  data.tar.gz: 7a80add54d6ecf810bff74a265cf4dca8ae8b99ae8c8f9e046cfec537bc9256d7a6127159d52d0b04001a7c3b17f9895c4b64814e7d9b058789e2c267b648a21
+  metadata.gz: 1ddfb2214d688465488e224c59460e185b8bb361acadfd3b4d215053392f53dcf23367366b29a577b563be982432233efcc72ba5f4e6f6cae6651189b221c53c
+  data.tar.gz: d8f93754ea6baf64d46591aa3ab52559bb601785df08d3071f51d5e283c7d0ad7c2b226bdaec12abbef913750136f5e895a302a451aa4ddac2225b862497631f

data/.rubocop.yml

@@ -63,3 +63,4 @@ Security/MarshalLoad:
   Enabled: false
 Layout/MultilineAssignmentLayout:
   Enabled: true
+require: []

data/Gemfile

@@ -35,10 +35,10 @@ gem 'rake', '13.2.1', require: false
 gem 'random-port', '>0', require: false
 gem 'rspec-rails', '7.1.1', require: false
 gem 'rubocop', '1.72.1', require: false
-gem 'rubocop-minitest', '0.37.1', require: false
-gem 'rubocop-performance', '1.24.0', require: false
+gem 'rubocop-minitest', '>0', require: false
+gem 'rubocop-performance', '>0', require: false
 gem 'rubocop-rake', '>0', require: false
-gem 'rubocop-rspec', '3.4.0', require: false
+gem 'rubocop-rspec', '>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

data/Gemfile.lock

@@ -184,7 +184,7 @@ GEM
     regexp_parser (2.10.0)
     reline (0.6.0)
       io-console (~> 0.5)
-    rexml (3.4.0)
+    rexml (3.4.1)
     rspec-core (3.13.3)
       rspec-support (~> 3.13.0)
     rspec-expectations (3.13.3)
@@ -288,10 +288,10 @@ DEPENDENCIES
   random-port (> 0)
   rspec-rails (= 7.1.1)
   rubocop (= 1.72.1)
-  rubocop-minitest (= 0.37.1)
-  rubocop-performance (= 1.24.0)
+  rubocop-minitest (> 0)
+  rubocop-performance (> 0)
   rubocop-rake (> 0)
-  rubocop-rspec (= 3.4.0)
+  rubocop-rspec (> 0)
   simplecov (= 0.22.0)
   simplecov-cobertura (= 2.1.0)
   threads (= 0.4.1)

data/README.md

@@ -37,13 +37,23 @@ hex = w.pay(private_key, to_address, amount)
 # Stay waiting, and trigger the block when new ERC20 payments show up:
 addresses = ['0x...', '0x...'] # only wait for payments to these addresses
 w.accept(addresses) do |event|
-  puts event[:txt] # hash of transaction
+  puts event[:txn] # hash of transaction
   puts event[:amount] # how much, in tokens (1000000 = $1 USDT)
   puts event[:from] # who sent the payment
   puts event[:to] # who was the receiver
 end
 ```
 
+It's also possible to check ETH balance and send ETH transaction:
+
+```ruby
+# Check how many ETHs are there on the given address:
+eth = w.eth_balance(address)
+
+# Send a few ETHs to someone and get transaction hash:
+hex = w.eth_pay(private_key, to_address, amount)
+```
+
 To generate a new private key, use [eth](https://rubygems.org/gems/eth):
 
 ```ruby
@@ -51,7 +61,7 @@ require 'eth'
 key = Eth::Key.new.private_hex
 ```
 
-To get address from private one:
+To convert a private key to a public address:
 
 ```ruby
 public_hex = Eth::Key.new(priv: key).address

data/lib/erc20/erc20.rb

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

data/lib/erc20/fake_wallet.rb

@@ -43,7 +43,7 @@ class ERC20::FakeWallet
     @http_path = '/'
   end
 
-  # Get balance of a public address.
+  # Get ERC20 balance of a public address.
   #
   # @param [String] _hex Public key, in hex, starting from '0x'
   # @return [Integer] Balance, in tokens
@@ -51,7 +51,15 @@ class ERC20::FakeWallet
     42_000_000
   end
 
-  # Send a single payment from a private address to a public one.
+  # Get ETH balance of a public address.
+  #
+  # @param [String] _hex Public key, in hex, starting from '0x'
+  # @return [Integer] Balance, in tokens
+  def eth_balance(_hex)
+    42_000_000
+  end
+
+  # Send a single ERC20 payment from a private address to a public one.
   #
   # @param [String] _priv Private key, in hex
   # @param [String] _address Public key, in hex
@@ -61,6 +69,16 @@ class ERC20::FakeWallet
     '0x172de9cda30537eae68ab4a96163ebbb8f8a85293b8737dd2e5deb4714b14623'
   end
 
+  # Send a single ETH 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 ETHs to send
+  # @return [String] Transaction hash
+  def eth_pay(_priv, _address, _amount, *)
+    '0x172de9cda30537eae68ab4a96163ebbb8f8a85293b8737dd2e5deb4714b14623'
+  end
+
   # Wait and accept.
   #
   # @param [Array<String>] addresses Addresses to monitor

data/lib/erc20/wallet.rb

@@ -122,23 +122,44 @@ class ERC20::Wallet
     @mutex = Mutex.new
   end
 
-  # Get balance of a public address.
+  # Get ERC20 balance of a public address (it's not the same as ETH balance!).
   #
-  # @param [String] hex Public key, in hex, starting from '0x'
+  # An address in Etherium may have many balances. One of them is the main
+  # balance in ETH crypto. Another balance is the one kept by ERC20 contract
+  # in its own ledge in root storage. This balance is checked by this method.
+  #
+  # @param [String] address Public key, in hex, starting from '0x'
   # @return [Integer] Balance, in tokens
-  def balance(hex)
-    raise 'Address can\'t be nil' unless hex
-    raise 'Address must be a String' unless hex.is_a?(String)
-    raise 'Invalid format of the address' unless /^0x[0-9a-fA-F]{40}$/.match?(hex)
+  def balance(address)
+    raise 'Address can\'t be nil' unless address
+    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)
     func = '70a08231' # balanceOf
-    data = "0x#{func}000000000000000000000000#{hex[2..].downcase}"
+    data = "0x#{func}000000000000000000000000#{address[2..].downcase}"
     r = jsonrpc.eth_call({ to: @contract, data: data }, 'latest')
     b = r[2..].to_i(16)
-    @log.debug("Balance of #{hex} is #{b}")
+    @log.debug("Balance of #{address} is #{b} ERC20 tokens")
+    b
+  end
+
+  # Get ETH balance of a public address.
+  #
+  # An address in Etherium may have many balances. One of them is the main
+  # balance in ETH crypto. This balance is checked by this method.
+  #
+  # @param [String] hex Public key, in hex, starting from '0x'
+  # @return [Integer] Balance, in ETH
+  def eth_balance(address)
+    raise 'Address can\'t be nil' unless address
+    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)
+    r = jsonrpc.eth_getBalance(address, 'latest')
+    b = r[2..].to_i(16)
+    @log.debug("Balance of #{address} is #{b} ETHs")
     b
   end
 
-  # Send a single payment from a private address to a public one.
+  # Send a single ERC20 payment from a private address to a public one.
   #
   # @param [String] priv Private key, in hex
   # @param [String] address Public key, in hex
@@ -171,7 +192,7 @@ class ERC20::Wallet
     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
+    from = key.address.to_s
     tnx =
       @mutex.synchronize do
         nonce = jsonrpc.eth_getTransactionCount(from, 'pending').to_i(16)
@@ -179,7 +200,7 @@ class ERC20::Wallet
           {
             nonce:,
             gas_price: gas_price || gas_best_price,
-            gas_limit: gas_limit || gas_estimate(from, data),
+            gas_limit: gas_limit || gas_estimate(from, @contract, data),
             to: @contract,
             value: 0,
             data: data,
@@ -190,7 +211,58 @@ class ERC20::Wallet
         hex = "0x#{tx.hex}"
         jsonrpc.eth_sendRawTransaction(hex)
       end
-    @log.debug("Sent #{amount} from #{from} to #{address}: #{tnx}")
+    @log.debug("Sent #{amount} ERC20 tokens from #{from} to #{address}: #{tnx}")
+    tnx.downcase
+  end
+
+  # Send a single ETH 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're ready to spend
+  # @param [Integer] gas_price How much gas you pay per computation unit
+  # @return [String] Transaction hash
+  def eth_pay(priv, address, amount, gas_limit: nil, gas_price: nil)
+    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)
+    raise 'Address can\'t be nil' unless address
+    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?
+    end
+    key = Eth::Key.new(priv: priv)
+    from = key.address.to_s
+    data = ''
+    tnx =
+      @mutex.synchronize do
+        nonce = jsonrpc.eth_getTransactionCount(from, 'pending').to_i(16)
+        tx = Eth::Tx.new(
+          {
+            chain_id: @chain,
+            nonce:,
+            gas_price: gas_price || gas_best_price,
+            gas_limit: gas_limit || gas_estimate(from, address, data),
+            to: address,
+            value: amount,
+            data:
+          }
+        )
+        tx.sign(key)
+        hex = "0x#{tx.hex}"
+        jsonrpc.eth_sendRawTransaction(hex)
+      end
+    @log.debug("Sent #{amount} ETHs from #{from} to #{address}: #{tnx}")
     tnx.downcase
   end
 
@@ -343,8 +415,8 @@ class ERC20::Wallet
     JSONRPC::Client.new(url, connection:)
   end
 
-  def gas_estimate(from, data)
-    jsonrpc.eth_estimateGas({ from:, to: @contract, data: }, 'latest').to_i(16)
+  def gas_estimate(from, to, data)
+    jsonrpc.eth_estimateGas({ from:, to:, data: }, 'latest').to_i(16)
   end
 
   def gas_best_price

data/test/erc20/test_fake_wallet.rb

@@ -33,10 +33,6 @@ require 'typhoeus'
 require_relative '../../lib/erc20/fake_wallet'
 require_relative '../test__helper'
 
-k = Eth::Key.new
-puts k.private_hex
-puts k.address
-
 # Test.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
@@ -47,6 +43,11 @@ class TestFakeWallet < Minitest::Test
     refute_nil(b)
   end
 
+  def test_checks_fake_eth_balance
+    b = ERC20::FakeWallet.new.eth_balance('0xEB2fE8872A6f1eDb70a2632Effffffffffffffff')
+    refute_nil(b)
+  end
+
   def test_returns_host
     assert_equal('example.com', ERC20::FakeWallet.new.host)
   end
@@ -59,6 +60,14 @@ class TestFakeWallet < Minitest::Test
     assert_match(/^0x[a-f0-9]{64}$/, txn)
   end
 
+  def test_pays_fake_eths
+    priv = '81a9b2114d53731ecc84b261ef6c0387dde34d5907fe7b441240cc21d61bf80a'
+    to = '0xfadef8ba4a5d709a2bf55b7a8798c9b438c640c1'
+    txn = ERC20::FakeWallet.new.eth_pay(Eth::Key.new(priv:), to, 555)
+    assert_equal(66, txn.length)
+    assert_match(/^0x[a-f0-9]{64}$/, txn)
+  end
+
   def test_accepts_payments_on_hardhat
     active = Primitivo.new([])
     addresses = Primitivo.new(['0xfadef8ba4a5d709a2bf55b7a8798c9b438c640c1'])

data/test/erc20/test_wallet.rb

@@ -54,6 +54,12 @@ class TestWallet < Minitest::Test
     assert_equal(8_000_000, b)
   end
 
+  def test_checks_eth_balance_on_mainnet
+    b = mainnet.eth_balance(STABLE)
+    refute_nil(b)
+    assert_equal(0, b)
+  end
+
   def test_checks_balance_of_absent_address
     a = '0xEB2fE8872A6f1eDb70a2632Effffffffffffffff'
     b = mainnet.balance(a)
@@ -95,6 +101,13 @@ class TestWallet < Minitest::Test
     end
   end
 
+  def test_checks_eth_balance_on_hardhat
+    on_hardhat do |wallet|
+      b = wallet.balance(Eth::Key.new(priv: WALTER).address.to_s)
+      assert_equal(456_000_000_000, b)
+    end
+  end
+
   def test_checks_balance_on_hardhat_in_threads
     on_hardhat do |wallet|
       Threads.new.assert do
@@ -118,6 +131,20 @@ class TestWallet < Minitest::Test
     end
   end
 
+  def test_eth_pays_on_hardhat
+    on_hardhat do |wallet|
+      to = Eth::Key.new(priv: WALTER).address.to_s
+      before = wallet.eth_balance(to)
+      sum = 42_000
+      from = Eth::Key.new(priv: JEFF).address.to_s
+      assert_operator(wallet.eth_balance(from), :>, sum * 2)
+      txn = wallet.eth_pay(JEFF, to, sum)
+      assert_equal(66, txn.length)
+      assert_match(/^0x[a-f0-9]{64}$/, txn)
+      assert_equal(before + sum, wallet.eth_balance(to))
+    end
+  end
+
   def test_pays_on_hardhat_in_threads
     on_hardhat do |wallet|
       to = Eth::Key.new(priv: WALTER).address.to_s
@@ -131,6 +158,19 @@ class TestWallet < Minitest::Test
     end
   end
 
+  def test_pays_eth_on_hardhat_in_threads
+    on_hardhat do |wallet|
+      to = Eth::Key.new(priv: WALTER).address.to_s
+      before = wallet.eth_balance(to)
+      sum = 42_000
+      mul = 10
+      Threads.new(mul).assert do
+        wallet.eth_pay(JEFF, to, sum)
+      end
+      assert_equal(before + (sum * mul), wallet.eth_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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: erc20
 version: !ruby/object:Gem::Version
-  version: 0.0.14
+  version: 0.0.16
 platform: ruby
 authors:
 - Yegor Bugayenko