智能合约与以太坊 / 系统课时
启动 Anvil 并用 Cast 查询
启动 Anvil 并用 Cast 查询
使用 Anvil 在本机启动一条独立的 Ethereum 开发链,再通过 Cast 调用 JSON-RPC,读取区块高度、链 ID 和测试账户余额。完成后,你将得到一个无需连接公共网络、可用于后续合约部署与交易测试的本地环境。
学习目标
- 启动 Anvil 本地节点,识别 RPC 地址、链 ID 和预置测试账户。
- 使用 Cast 查询区块高度、链 ID 与账户 ETH 余额。
- 根据命令结果判断节点是否正常运行,并排查常见连接错误。
检查工具并启动 Anvil
Anvil 和 Cast 都属于 Foundry 工具链。Anvil 提供本地 Ethereum 节点及 JSON-RPC 服务,Cast 是向节点发送查询和交易请求的命令行工具。二者可以在不同终端中配合使用,无需先创建 Solidity 项目。
开始前确认已经安装 Foundry。在终端分别执行 anvil --version 和 cast --version,两条命令均应返回版本信息。如果出现命令未找到,应先按照 Foundry 官方安装说明 完成安装,并重新打开终端。
打开第一个终端,执行:
# 仅监听本机地址,启动独立的开发链
anvil --host 127.0.0.1 --port 8545 --chain-id 31337 --accounts 10 --balance 10000预期输出包含以下监听信息:
Listening on 127.0.0.1:8545启动日志还会列出测试账户地址及其私钥、链 ID 等信息。此次启动参数含义如下:
| 参数 | 设置值 | 作用 |
|---|---|---|
--host |
127.0.0.1 |
只接受本机连接 |
--port |
8545 |
HTTP JSON-RPC 监听端口 |
--chain-id |
31337 |
本地开发链标识 |
--accounts |
10 |
生成十个测试账户 |
--balance |
10000 |
每个账户初始拥有 10000 ETH |
本次使用的 RPC 地址为 http://127.0.0.1:8545。它是本机访问地址,不是公共 Ethereum RPC 服务。第一个终端必须保持运行;关闭它就会终止节点。
查询链 ID 与区块高度
打开第二个终端。Cast 通过 --rpc-url 指定目标节点,避免因为环境变量或默认配置而意外查询其他网络。
执行以下两个命令:
# 查询节点的链 ID
cast chain-id --rpc-url http://127.0.0.1:8545
# 查询最新区块高度
cast block-number --rpc-url http://127.0.0.1:8545预期输出按两条命令的执行顺序分别为:
31337
0第一行 31337 与 Anvil 启动参数中的链 ID 一致,说明连接的是预期开发网络。链 ID 用于区分不同的 Ethereum 网络,并参与交易签名的重放保护。
第二行 0 表示刚创建的链目前只有创世区块,尚未产生后续区块。Anvil 默认按需自动挖矿,通常在收到有效交易后生成新区块,因此没有交易时高度可以保持为零。
如果节点已经处理过交易,区块高度可能大于零,这不代表查询失败。判断时应优先确认查询成功、链 ID 正确以及高度为非负整数。
查询测试账户余额
在未自定义助记词的独立 Anvil 开发链中,默认生成的第一个测试账户地址是:
0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
使用 cast balance 查询该账户:
# 查询账户原生 ETH 余额,默认单位为 wei
cast balance 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --rpc-url http://127.0.0.1:8545在全新启动、未转账且初始余额为 10000 ETH 的环境下,预期输出为:
10000000000000000000000Ethereum 使用 wei 作为 ETH 的最小计量单位,1 ETH 等于 wei。因此上面的余额对应 10000 ETH。还可以在 cast balance 命令中添加 --ether,让 Cast 将结果直接格式化为 ETH,避免手动换算。
这里查询的是节点记录的账户原生 ETH 余额,并非 ERC-20 代币余额。ERC-20 余额存放在代币合约状态中,需要调用对应合约的 balanceOf(address) 方法。
如果修改了 Anvil 的 --mnemonic 参数,应改用启动日志中实际列出的账户地址;如果修改了 --balance,实际余额也应以新参数为准。
验证 RPC 并处理连接错误
Cast 的查询命令最终都通过 JSON-RPC 与节点通信。除了专用子命令,还可以使用 cast rpc 直接调用标准 Ethereum RPC 方法。下面查询节点的链 ID:
# 直接执行标准 JSON-RPC 方法 eth_chainId
cast rpc eth_chainId --rpc-url http://127.0.0.1:8545预期输出:
0x7a690x7a69 是十六进制表示,对应十进制 31337。因此 cast chain-id 与 cast rpc eth_chainId 查询的是同一项链配置,只是输出形式不同。
若查询失败,优先按下表定位:
| 现象 | 可能原因 | 处理方法 |
|---|---|---|
Connection refused |
Anvil 未启动或端口错误 | 检查第一个终端仍在运行,核对端口 8545 |
Address already in use |
端口已被其他进程占用 | 停止冲突进程,或将 Anvil 与 Cast 的端口统一修改为其他未占用端口 |
链 ID 不是 31337 |
查询到了其他节点 | 显式指定 --rpc-url,检查 Anvil 启动参数 |
| 账户余额为零 | 使用了错误地址或不同的链状态 | 从当前 Anvil 启动日志复制账户地址,再次查询 |
command not found |
Foundry 未安装或不在 PATH 中 | 检查安装和终端环境,重新运行版本检查 |
这里还要区分 RPC 地址与链 ID:127.0.0.1:8545 决定请求发送到哪个服务,31337 则用于标识节点所属的链。端口相同不保证链 ID 相同,链 ID 相同也不意味着两个节点共享区块和账户状态。
完成以下三项验收即可继续后续合约开发:cast chain-id 返回 31337,cast block-number 返回有效高度,默认测试账户在未发生交易时拥有 10000 ETH。这三项同时成立,说明 Anvil 节点、JSON-RPC 服务和 Cast 查询链路均已正常工作。