智能合约与以太坊 / 系统课时

启动 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 官方安装说明 完成安装,并重新打开终端。

打开第一个终端,执行:

bash
# 仅监听本机地址,启动独立的开发链
anvil --host 127.0.0.1 --port 8545 --chain-id 31337 --accounts 10 --balance 10000

预期输出包含以下监听信息:

text
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 指定目标节点,避免因为环境变量或默认配置而意外查询其他网络。

执行以下两个命令:

bash
# 查询节点的链 ID
cast chain-id --rpc-url http://127.0.0.1:8545

# 查询最新区块高度
cast block-number --rpc-url http://127.0.0.1:8545

预期输出按两条命令的执行顺序分别为:

text
31337
0

第一行 31337 与 Anvil 启动参数中的链 ID 一致,说明连接的是预期开发网络。链 ID 用于区分不同的 Ethereum 网络,并参与交易签名的重放保护。

第二行 0 表示刚创建的链目前只有创世区块,尚未产生后续区块。Anvil 默认按需自动挖矿,通常在收到有效交易后生成新区块,因此没有交易时高度可以保持为零。

如果节点已经处理过交易,区块高度可能大于零,这不代表查询失败。判断时应优先确认查询成功、链 ID 正确以及高度为非负整数。

查询测试账户余额

在未自定义助记词的独立 Anvil 开发链中,默认生成的第一个测试账户地址是:

0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266

使用 cast balance 查询该账户:

bash
# 查询账户原生 ETH 余额,默认单位为 wei
cast balance 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --rpc-url http://127.0.0.1:8545

在全新启动、未转账且初始余额为 10000 ETH 的环境下,预期输出为:

text
10000000000000000000000

Ethereum 使用 wei 作为 ETH 的最小计量单位,1 ETH 等于 101810^{18} 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:

bash
# 直接执行标准 JSON-RPC 方法 eth_chainId
cast rpc eth_chainId --rpc-url http://127.0.0.1:8545

预期输出:

text
0x7a69

0x7a69 是十六进制表示,对应十进制 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 查询链路均已正常工作。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

启动 Anvil 并用 Cast 查询

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通