anvil
名称
anvil - 创建一个本地测试网节点，用于部署和测试智能合约。它也可以用来分叉其他与 EVM 兼容的网络。
简介
anvil [options]
描述
创建一个本地测试网节点，用于部署和测试智能合约。它也可以用来分叉其他与 EVM 兼容的网络。
本节涵盖了关于挖矿模式、支持的传输层、支持的 RPC 方法、Anvil 标志及其用法。你可以在同一时间运行多个标志。
挖矿模式
挖矿模式指的是使用 Anvil 开采区块的频率。默认情况下，一旦有交易提交，它就会自动生成一个新区块。
如果你愿意，你可以把这个设置改成定期挖矿，这意味着在用户选择的特定时间段内会产生一个新区块。如果你想采用这种挖矿方式，你可以通过添加 --block-time <block-Time-in-seconds> 标志来实现，就像下面的例子一样。
# 每 10 秒产生一个新的区块
anvil --block-time 10
还有第三种挖矿模式，叫做永不挖矿模式。在这种情况下，它禁用自动和间隔采矿，而是按需采矿。你可以通过输入以下内容来做到这一点
# 启用永不挖矿模式
anvil --no-mining
为了加速区块的最终确定，你可以使用 --slots-in-an-epoch 标志，例如设置为 1。这将导致高度为 N-2 的区块被最终确定，其中 N 是最新的区块。
支持的传输层
支持 HTTP 和 Websocket 连接。服务器的默认监听端口为 8545，但可以通过运行以下命令来改变：
anvil --port <PORT>
默认的 CREATE2 部署器
Anvil 在没有分叉的情况下，包含地址为 0x4e59b44847b379578588920ca78fbf26c0b4956c 的默认 CREATE2 部署器代理 。
这使你可以在本地测试 CREATE2 部署，而无需进行分叉。
支持的 RPC 方法
标准方法
标准方法是基于 此处 作为参考。
-
web3_clientVersion -
web3_sha3 -
eth_chainId -
eth_networkId -
eth_gasPrice -
eth_accounts -
eth_blockNumber -
eth_getBalance -
eth_getStorageAt -
eth_getBlockByHash -
eth_getBlockByNumber -
eth_getTransactionCount -
eth_getBlockTransactionCountByHash -
eth_getBlockTransactionCountByNumber -
eth_getUncleCountByBlockHash -
eth_getUncleCountByBlockNumber -
eth_getCode -
eth_sign -
eth_signTypedData_v4 -
eth_sendTransaction -
eth_sendRawTransaction -
eth_call -
eth_createAccessList -
eth_estimateGas -
eth_getTransactionByHash -
eth_getTransactionByBlockHashAndIndex -
eth_getTransactionByBlockNumberAndIndex -
eth_getTransactionReceipt -
eth_getUncleByBlockHashAndIndex -
eth_getUncleByBlockNumberAndIndex -
eth_getLogs -
eth_newFilter -
eth_getFilterChanges -
eth_newBlockFilter -
eth_newPendingTransactionFilter -
eth_getFilterLogs -
eth_uninstallFilter -
eth_getWork -
eth_subscribe -
eth_unsubscribe -
eth_syncing -
eth_submitWork -
eth_submitHashrate -
eth_feeHistory -
eth_getProof -
debug_traceTransaction使用anvil --steps-tracing来获取structLogs -
debug_traceCall请注意，尚不支持非标准的跟踪。这意味着你不能向trace参数传递任何参数。 -
trace_transaction -
trace_block
自定义方法
anvil_* 命名空间是 hardhat 的别名。更多信息请参考 Hardhat 文档。
anvil_impersonateAccount
发送交易以外部拥有的账户或合约的身份。
anvil_stopImpersonatingAccount
如果之前设置过 anvil_impersonateAccount 则停止冒充账户或合约。
anvil_autoImpersonateAccount
接受 true 以启用自动冒充账户，接受 false 以禁用它。启用后，任何交易的发送方将自动被冒充。与 anvil_impersonateAccount 相同。
anvil_getAutomine
如果启用了自动挖矿模式，则返回 true，否则返回 false。
anvil_mine
开采一系列的区块
anvil_dropTransaction
将交易从池中移除
anvil_reset
重置分叉到一个新的分叉状态，并可选地更新分叉配置
anvil_setRpcUrl
设置后端 RPC URL
anvil_setBalance
修改一个账户的余额
anvil_setCode
设置一个合约的源代码
anvil_setNonce
设置一个地址的 nonce
anvil_setStorageAt
写入账户的单个存储槽
anvil_setCoinbase
设置 coinbase 地址
anvil_setLoggingEnabled
开启或关闭日志
anvil_setMinGasPrice
设置节点的最小 Gas 费用
anvil_setNextBlockBaseFeePerGas
设置下一个区块的基础费用
anvil_setChainId
设置当前 EVM 实例的链 ID
anvil_dumpState
返回一个代表链的完整状态的十六进制字符串。可以重新导入一个新的/重新启动的 Anvil 实例，以重新获得相同的状态。
anvil_loadState
当给定一个由 anvil_dumpState 返回的十六进制字符串时，将其内容合并到当前的链状态。将覆盖任何相同的账户/存储槽。
anvil_nodeInfo
检索当前运行的 Anvil 节点的配置参数。
特殊方法
特殊方法来自 Ganache。你可以看一下文档 这里。
evm_setAutomine
根据单一的布尔参数，启用或禁用在每个提交给网络的新交易中自动挖掘新区块的功能。
evm_setIntervalMining
设置采矿行为的间隔，给定间隔时间（秒）。
evm_snapshot
对区块链在当前区块的状态进行快照
evm_revert
将区块链的状态恢复到之前的快照。接收一个参数，即要恢复的快照 ID。
evm_increaseTime
在时间上向前跳转给定的时间量，以秒为单位
evm_setNextBlockTimestamp
与 evm_increaseTime 类似，但在下一个区块中获取你想要的确切时间戳。
anvil_setBlockTimestampInterval
类似于 evm_increaseTime，但设置一个区块的时间戳 interval。下一个区块的时间戳将被计算为 lastBlock_timestamp + interval。
evm_setBlockGasLimit
设置接下来的区块的 Gas 限制
anvil_removeBlockTimestampInterval
如果 anvil_setBlockTimestampInterval 存在则删除
evm_mine
挖掘一个单独的区块
anvil_enableTraces
打开对用户执行交易时返回的交易的调用跟踪（而不仅仅是交易哈希/交易收据）。
eth_sendUnsignedTransaction
无论签名状态如何，都执行一项交易
对于接下来的三种方法，请务必阅读 Geth 文档。
txpool_status
返回当前等待列入下一个区块的交易数量，以及安排在未来执行的交易。
txpool_inspect
返回当前等待列入下一个区块的所有交易的摘要，以及安排在未来执行的交易的摘要。
txpool_content
返回所有目前等待列入下一个区块的交易的细节，以及安排在未来执行的交易的细节。
Otterscan 方法
ots_* 命名空间实现了Otterscan 规范
ots_getApiLevel
被 Otterscan 用来检查是否连接到兼容的节点，并在不兼容时显示友好消息。
ots_getInternalOperations
返回交易内部的以太坊转账。
ots_hasCode
检查特定地址是否包含部署的代码。
ots_getTransactionError
提取交易的原始错误输出。
ots_traceTransaction
提取所有调用、合约创建和自毁的各种变化，并返回调用树。
ots_getBlockDetails
为 Otterscan 中的区块详情页面量身定制和扩展的 eth_getBlock 版本。
ots_getBlockTransactions
获取特定区块的分页交易，并删除一些冗长的字段，如日志。
ots_searchTransactionsBefore
分页获取特定地址在给定目标区块之前的出入交易调用。
ots_searchTransactionsAfter
分页获取特定地址在给定目标区块之后的出入交易调用。
ots_getTransactionBySenderAndNonce
根据发送者地址和 nonce 获取交易哈希。
ots_getContractCreator
获取创建合约的交易哈希和地址。
选项
一般选项
-a, --accounts <ACCOUNTS>
设置账户的数量 [默认: 10]
--auto-impersonate
在启动时启用 autoImpersonate
-b, --block-time <block-time>
间隔挖掘的区块时间，以秒为单位
--balance <BALANCE>
设置账户的余额 [默认: 10000]
--derivation-path <DERIVATION_PATH>
设置要派生的子密钥的派生路径 [默认: m/44'/60'/0'/0/]
-h, --help
打印帮助信息
--hardfork <HARDFORK>
选择要使用的 EVM 硬分叉
选择硬分叉的名称, 例如 shanghai, paris, london, 等等...
[默认: latest]
--init <PATH>
用给定的 genesis.json 文件初始创世块。
-m, --mnemonic <MNEMONIC>
用于生成账户的 BIP39 助记词组
--no-mining
禁用自动和间隔开采，改为按需开采
--order <ORDER>
交易在内存池中的排序方式 [默认: fees]
-p, --port <PORT>
监听的端口号 [默认: 8545]
--steps-tracing
启用用于调试调用的步骤跟踪，返回 geth 风格的跟踪 [别名: tracing]
--ipc [<PATH>]
在给定的 PATH 参数或默认路径下启动一个 IPC 端点: unix: tmp/anvil.ipc, windows: \\.\pipe\anvil.ipc
--silent
启动时不要打印任何东西
--timestamp <TIMESTAMP>
设置创世块的时间戳
-V, --version
打印版本信息
--disable-default-create2-deployer
在不进行分叉的模式下运行 Anvil 时禁用部署默认的 CREATE2 工厂
EVM 选项
-f, --fork-url <URL>
通过远程端点获取状态，而不是从一个空的状态开始
--fork-block-number <BLOCK>
通过一个远程端点从一个特定的区块号中获取状态（必须在同一个命令行中传递 --fork-url）。
--fork-retry-backoff <BACKOFF>
初始化遇到错误时的重试退避。
--fork-transaction-hash <TRANSACTION>
通过远程端点从特定交易哈希获取状态（必须在同一命令行中传递 --fork-url）。
--retries <retries>
虚拟网络（超时请求）的重试次数。[默认值：5］
--timeout <timeout>
在分叉模式下向远程 JSON-RPC 服务器发送请求的超时，单位为ms。[默认值： 45000]
--compute-units-per-second <CUPS>
设置该 provider 假设每秒可用的并发数量[默认值：330] 。
另请参阅， Alchemy 速率限制
--no-rate-limit
禁用该节点 provider 的速率限制。如果存在的话，将总是覆盖 ---compute-units-per-second。[默认值： false]
另请参阅， Alchemy 速率限制
--no-storage-caching>
明确地禁止使用 RPC 缓存。所有的存储槽都完全从端点读取。这个标志覆盖了项目的配置文件（必须在同一命令行中传递 --fork-url）。
执行器环境配置
--base-fee <FEE>
--block-base-fee-per-gas <FEE>
区块的基础费用
--chain-id <CHAIN_ID>
链 ID [默认: 31337]
--code-size-limit <CODE_SIZE>
EIP-170: 以字节为单位的合约代码大小限制。由于测试的原因，增加这一点很有用。
默认情况下，它是 0x6000 (~25kb)
--gas-limit <GAS_LIMIT>
区块的 Gas 限制
--gas-price <GAS_PRICE>
Gas 价格
服务器选项
--allow-origin <allow-origin>
设置 CORS 允许来源 [默认：*] 。
--no-cors
关闭 CORS
--host <HOST>
服务监听的 IP 地址
--config-out <OUT_FILE>
将 anvil 的输出作为 json 写入用户指定的文件中。
--prune-history
不要保留完整的链条历史
例子
- 设置账户数为 15，账户余额为 300 ETH
anvil --accounts 15 --balance 300
- 选择要执行测试的地址
anvil --sender 0xC8479C45EE87E0B437c09d3b8FE8ED14ccDa825E
- 将交易在内存池中的排序方式改为先进先出
anvil --order fifo
Shell 自动补全
anvil completions shell
为给定的 shell 生成一个 shell 自动补全脚本。
支持的 shells 有:
- bash
- elvish
- fish
- powershell
- zsh
例子
- 为 zsh 生成 shell 自动补全脚本：
anvil completions zsh > $HOME/.oh-my-zsh/completions/_anvil
在Docker中的使用
为了在 Github Actions 中使用 Docker容器 作为服务运行 anvil，在不能向入口命令传递参数的情况下，使用 ANVIL_IP_ADDR 环境变量来设置主机的 IP。ANVIL_IP_ADDR=0.0.0.0 等同于提供 --host <ip> 选项。
使用 genesis.json
Anvil 中的 genesis.json 文件与 Geth 中的作用类似，定义了网络的初始状态、共识规则以及预分配账户，以确保所有节点一致启动并保持网络完整性。包括余额、gas 限制等在内的所有数值都需要定义为十六进制。
chainId：区块链的标识符，每个网络唯一。nonce：在哈希算法中使用的计数器，以确保数据完整性。timestamp：创世区块的创建时间，以 Unix 时间表示。extraData：创世区块创建者可以包含的附加数据。gasLimit：区块中可以使用的最大 gas 量。difficulty：挖掘新区块的难度程度。mixHash：证明区块有足够计算量的唯一标识符。coinbase：挖出此区块的矿工的以太坊地址。stateRoot：状态树的根，反映所有交易后的最终状态。alloc：允许为一组地址预分配具有预定义余额的以太币。number：区块编号，创世区块为 0。gasUsed：区块中使用的总 gas 量。parentHash：父区块的哈希值，创世区块为零值，因为没有父块。
模拟主网的创世文件示例可以在此处找到。
{
"chainId": "0x2323",
"nonce": "0x42",
"timestamp": "0x0",
"extraData": "0x11bbe8db4e347b4e8c937c1c8370e4b5ed33adb3db69cbdb7a38e1e50b1b82fa",
"gasLimit": "0x1388",
"difficulty": "0x400000000",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"coinbase": "0x0000000000000000000000000000000000000000",
"stateRoot": "0xd7f8974fb5ac78d9ac099b9ad5018bedc2ce0a72dad1827a1709da30580f0544",
"alloc": {
"000d836201318ec6899a67540690382780743280": {
"balance": "0xad78ebc5ac6200000"
}
},
"number": "0x0",
"gasUsed": "0x0",
"parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
}