Web3

rpc_call

发起 RPC 调用。 支持的方法可参考以太坊 Json RPC 文档 和 Geth RPC 文档

peth > rpc_call eth_getBalance 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 latest
"0x27a578953ce8145c92641"

peth > rpc_call eth_chainId
"0x1"

peth > rpc_call eth_blockNumber
"0x129cee9"

peth > rpc_call web3_clientVersion
"erigon/2.59.0/linux-amd64/go1.21.6"

peth > rpc_call eth_gasPrice
"0x3c432256c"

peth > rpc_call txpool_status
{
  "pending": "0x389aa",
  "queued": "0xde1"
}

call

通过 eth_call 发起合约调用。其中函数签名使用如下形式：

<method name>(<arg type>,<arg type>, ...)->(<return type>,<return type>, ...)

peth > call 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 symbol()->(string)
WETH

peth > call 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 balanceOf(address)->(uint) 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
748101950687662255047

eth_call

使用原始的 calldata 发起 eth_call 调用

peth > abi_encode balanceOf(address)->(uint) 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
0x70a08231000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

peth > eth_call 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 0x70a08231000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
returns:
0x0000000000000000000000000000000000000000000000288e00088952e72bc7

estimate_gas

估计 gas 消耗

peth > estimate_gas 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 0x70a08231000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
gas:
23966

address

打印地址常用信息

peth > address 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
Balance: 2996232794632355541811083 Wei( 2996232.7946 Ether)
Nonce: 1
Code Size: 3124

storage

查看合约 storage 数据

peth > storage 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
0x0 : 0x577261707065642045746865720000000000000000000000000000000000001a
0x1 : 0x5745544800000000000000000000000000000000000000000000000000000008
0x2 : 0x0000000000000000000000000000000000000000000000000000000000000012
0x3 : 0x0000000000000000000000000000000000000000000000000000000000000000
...

peth > storage 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 1
0x1 : 0x5745544800000000000000000000000000000000000000000000000000000008

status

监控出块信息及相关数据。

peth > status
2024-03-26 15:52:07.190743
        latest - Block 19517246, 167 txns, gas 162235/21000/2000000, 46.06% used rate, price 21/19/47 gwei
        pending - Block 19517247, 97 txns, gas 130751/21000/891576, 19.22% used rate, price 23/19/85 gwei
        pending - Block 19517247, 97 txns, gas 130751/21000/891576, 19.22% used rate, price 23/19/85 gwei
        pending - Block 19517247, 157 txns, gas 132415/21000/891576, 32.49% used rate, price 22/19/85 gwei
        pending - Block 19517247, 157 txns, gas 132415/21000/891576, 32.49% used rate, price 22/19/85 gwei
2024-03-26 15:52:14.316545
        latest - Block 19517247, 200 txns, gas 148473/21000/891576, 50.37% used rate, price 23/19/123 gwei
        pending - Block 19517248, 66 txns, gas 338304/21000/1786064, 14.93% used rate, price 20/19/22 gwei
        pending - Block 19517248, 66 txns, gas 338304/21000/1786064, 14.93% used rate, price 20/19/22 gwei
        pending - Block 19517248, 138 txns, gas 269707/21000/4381659, 42.65% used rate, price 20/19/23 gwei
        pending - Block 19517248, 138 txns, gas 269707/21000/4381659, 42.65% used rate, price 20/19/23 gwei
        pending - Block 19517248, 164 txns, gas 248094/21000/4381659, 50.50% used rate, price 20/19/31 gwei
....

send_tx

发送交易。以下使用测试环境运行。

$ ganache-cli
ganache v7.8.0 (@ganache/cli: 0.9.0, @ganache/core: 0.9.0)
Starting RPC server

Available Accounts
==================
(0) 0x36dD31837e6DF2717af500eccb0D3966541486A6 (1000 ETH)
(1) 0x0Cfcb5a6B7a2c917D1e1BF0A23e627Bd8aC13cb7 (1000 ETH)
....

Private Keys
==================
(0) 0x267bb9b0ca46b453c6185d7a50f7481978a2fe8dac7dd3f49dacd1d7e25f5897
(1) 0xdc8be184684b6c2f8b9853b638b3efb15d00634742f91465c7bae9eed58f81ec
....

使用 peth 发送交易.

  1. 切换到目标链。

peth > chain local
Current:
  Chain: eth
     Chain ID: 1
     Block number: 19517329
  RPC: https://rpc.ankr.com/eth
  API: https://api.etherscan.io/api?apikey=TDMPDZU8RD4V9FVB66P5S47QETEJ6R61UY&
  Address: https://etherscan.io/address/
Changed:
  Chain: local
     Chain ID: 1337
     Block number: 0
  RPC: http://127.0.0.1:8545
  API: https://api.etherscan.io/api?
  Address: https://etherscan.io/address/

  1. 设置 signer 的私钥

peth > signer 0x267bb9b0ca46b453c6185d7a50f7481978a2fe8dac7dd3f49dacd1d7e25f5897
Current: Not set.
New:     0x36dD31837e6DF2717af500eccb0D3966541486A6

  1. 发送交易。此时程序会等待，直接到收到交易 receipt。

peth > send_tx 0x0000 0x36dD31837e6DF2717af500eccb0D3966541486A6 100000
TX info:
  from :         0x36dD31837e6DF2717af500eccb0D3966541486A6
  to :   0x36dD31837e6DF2717af500eccb0D3966541486A6
  value :        100000
  chainId :      1337
  nonce :        0
  gas :  25200
  gasPrice :     2400000000
Sig info:
  Hash:  0xb151c07780e848d7b4459aba28dda6bc0a0040fa3efc34a9f93e0217b14856f6
  Raw Transaction:       0xf86880848f0d18008262709436dd31837e6df2717af500eccb0d3966541486a6830186a080820a96a0755a6fceed81c3eba86f7f43fc8a1c9e238150229bf97f625cb0c10d5296fa5fa06fad02abee3088ea341c73cda46af1bc08a0057b9af09026fde8f10ecf6d87af
  r:     53080391192678124694542854255230213858293389325864476756251831706085219564127
  s:     50512409173677094747841923700433357480448116896786676839214343048172512577455
  v:     2710
RPC: http://127.0.0.1:8545
Enter YES to send:YES
Sent 0xb151c07780e848d7b4459aba28dda6bc0a0040fa3efc34a9f93e0217b14856f6. Current block 0
New block 1
From: 0x36dD31837e6DF2717af500eccb0D3966541486A6
To: 0x36dD31837e6DF2717af500eccb0D3966541486A6
No signature found for selector 0x.
Full Receipt:
  transactionHash :      0xb151c07780e848d7b4459aba28dda6bc0a0040fa3efc34a9f93e0217b14856f6
  transactionIndex :     0
  blockNumber :  1
  blockHash :    0x6096bc1880226b4c91891a8a5974218f700e111215e0d111ce1c82cd503ce734
  from :         0x36dD31837e6DF2717af500eccb0D3966541486A6
  to :   0x36dD31837e6DF2717af500eccb0D3966541486A6
  cumulativeGasUsed :    21000
  gasUsed :      21000
  contractAddress :      None
  logs :         []
  logsBloom :    0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
  status :       1
  effectiveGasPrice :    2400000000
  type :         0x0

log

搜索 event logs。从最新的区块向前搜索，可以指定搜索步长与循环次数。

peth >  log 0xdAC17F958D2ee523a2206206994597C13D831ec7 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef 1 1
Search start
 - log 1 blocks * 1 times
 - address 0xdAC17F958D2ee523a2206206994597C13D831ec7
 - topics 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef:
txid 0x783f09d45c738ddc7b78b5081ea29fdbbf38cb0c99da79e9b4a5bbc160ef7ca8
         address 0xdAC17F958D2ee523a2206206994597C13D831ec7
         topic[0] 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
         topic[1] 0x00000000000000000000000075e89d5979e4f6fba9f97c104c2f0afb3f1dcb88
         topic[2] 0x000000000000000000000000612791ab70cb156f1e0cb59d430fdeff99fa94d5
         data 0x0000000000000000000000000000000000000000000000000000000009e35861
txid 0x37948f1613eae871e19c7058d70cccef16780cf6d71749adcf6004b2f54a565a
         address 0xdAC17F958D2ee523a2206206994597C13D831ec7
         topic[0] 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
         topic[1] 0x000000000000000000000000f544aec5fc048df2a4c1e03c186b0c1e1675a519
         topic[2] 0x000000000000000000000000c7bbec68d12a0d1830360f8ec58fa599ba1b0e9b
         data 0x000000000000000000000000000000000000000000000000000000003b9aca00
...

run

执行 Solidity 代码。需要文件中实现 Executor 合约及 run() 方法。run() 返回值类型不做限制。该命令会编译并执行相应的 solidity 文件。进行复杂的链上数据查询及计算时可以使用这个方法。

peth > ! cat ethcall_executor.sol
pragma solidity ^0.8.13;
interface ERC20{
    function balanceOf(address a) external returns (uint);
}
contract Executor {
    function run() external returns(uint){
        return ERC20(0xdAC17F958D2ee523a2206206994597C13D831ec7).balanceOf(0x5754284f345afc66a98fbB0a0Afe71e0F007B949);
    }
}

peth > run ethcall_executor.sol
993515703046496

peth > call 0xdAC17F958D2ee523a2206206994597C13D831ec7 balanceOf(address)->(uint256) 0x5754284f345afc66a98fbB0a0Afe71e0F007B949
993515703046496