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

配置测试网 RPC 与账户密钥

配置测试网 RPC 与账户密钥

部署 Solidity 合约前,需要准备能够访问 Sepolia 的 RPC 端点、正确的链 ID,以及持有测试 ETH 的部署账户。本课使用 Foundry 和加密 Keystore 完成配置,并验证网络、账户地址与余额,避免在源码和 Git 仓库中暴露私钥。

学习目标

  • 配置 Sepolia RPC 地址与链 ID,并通过链上查询确认连接正确。
  • 使用 Foundry 加密 Keystore 管理部署私钥,区分公开配置与敏感凭据。
  • 检查部署账户地址和测试 ETH 余额,排查常见连接与凭据问题。

确认开发环境与网络参数

以下操作以已安装 Foundry 的 Linux、macOS 或 Windows WSL2 环境为例,使用 Bash 执行命令。原生 Windows PowerShell 的环境变量加载语法不同,不应直接复制 Bash 的 source 命令。

进入已有的 Foundry 项目目录,确认 forge 和 cast 都能在当前终端调用。

bash
# 确认合约开发与链上查询工具均已安装
command -v forge >/dev/null && command -v cast >/dev/null && echo 'Foundry ready'

预期输出:

text
Foundry ready

如果命令找不到,应先安装 Foundry 或检查终端的 PATH 环境变量。安装后可使用 foundryup 更新工具链;项目若依赖特定版本,应采用项目约定的版本。

本次部署使用的网络参数如下。

参数 配置值 作用
网络名称 Ethereum Sepolia 以太坊应用开发测试网
Chain ID 11155111 标识交易签名对应的网络
Gas 代币 Sepolia ETH 支付测试网交易手续费
RPC 协议 HTTPS JSON-RPC 查询链状态、广播已签名交易
部署账户 独立测试账户 持有私钥并发起部署交易

必须区分 Chain ID 与区块高度。Chain ID 对 Sepolia 固定为 11155111,区块高度则持续增加。RPC 服务提供商通常通过控制台生成专属 HTTPS 地址,地址中可能包含项目 API Key。

保存 RPC 地址并验证链 ID

可以从提供 Sepolia 服务的 RPC 提供商获取 HTTPS 端点,例如 Alchemy 或 Infura。创建项目时应选择 Ethereum Sepolia,而不是 Ethereum Mainnet、Base Sepolia 或其他名称相近的网络。

在 Foundry 项目根目录创建 .env,以下为 Bash 兼容的配置文件内容。需要将示例中的 YOUR_API_KEY 替换成自己申请的有效密钥。

bash
# .env:仅保存网络访问配置,不保存部署私钥
SEPOLIA_RPC_URL="https://eth-sepolia.g.alchemy.com/v2/YOUR_API_KEY"
SEPOLIA_CHAIN_ID=11155111

这是配置文件片段,不是已经可访问的真实凭据。SEPOLIA_RPC_URL 用于定位远程执行节点,SEPOLIA_CHAIN_ID 用于本地检查目标网络。自定义变量不会自动让 Foundry 切换网络,调用命令时仍应明确传入 RPC 地址。

先确保 .env 不会被 Git 纳入版本控制,再加载配置并验证链 ID。以下命令在项目根目录执行,且仅应加载自己创建并检查过的 .env 文件。

bash
# 忽略本地配置,并把变量导出给子进程
printf '\n.env\n' >> .gitignore
set -a
source .env
set +a

# 验证忽略规则以及 RPC 实际连接的网络
 git check-ignore -q .env && echo '.env ignored'
 test "$(cast chain-id --rpc-url "$SEPOLIA_RPC_URL")" = "$SEPOLIA_CHAIN_ID" && echo 'Sepolia chain ID verified'

预期输出(.env 尚未被 Git 跟踪,且 RPC 配置正确时):

text
.env ignored
Sepolia chain ID verified

cast chain-id 实际读取远端节点返回的网络标识,而不是直接打印 .env 中写入的数值。也可以单独执行 cast chain-id --rpc-url "$SEPOLIA_RPC_URL",正常返回 11155111。

导入独立部署账户并保护私钥

部署交易需要私钥签名,但 JSON-RPC 查询链 ID、余额和区块数据时不需要私钥。建议创建只用于 Sepolia 的独立账户,不要导入存有真实资产的主网钱包。

Foundry 的 cast wallet import 可以通过交互提示导入私钥,并使用密码加密保存到本地 Keystore,避免在 Shell 命令参数和历史记录中出现明文私钥。

bash
# 交互输入测试账户私钥及 Keystore 加密密码
cast wallet import sepolia-deployer --interactive

# 查看本机已导入的账户名称
cast wallet list

预期结果:终端要求交互输入私钥与加密密码。导入成功后,账户列表包含 sepolia-deployer。具体提示文案可能随 Foundry 版本变化。

默认 Keystore 目录是 ~/.foundry/keystores/,其中的 sepolia-deployer 文件保存加密后的密钥材料。Keystore 密码用于解密本地文件,不是钱包助记词,也不是 Sepolia RPC 的 API Key。应分别保管 Keystore 及其密码,避免将二者同时上传到代码仓库或共享存储。

Sepolia RPC 与本地签名账户的数据流

在实际部署时,可让 Foundry 使用 --account sepolia-deployer 引用该 Keystore,并在需要签名时输入密码。相较于在命令行使用 --private-key 直接传递明文,这种方式减少了私钥出现在终端历史、脚本或日志中的风险,但仍需保护运行环境和 Keystore 密码。

验证账户地址和测试 ETH 余额

配置完成后,应分别验证远端网络与本地账户。网络连接正常不代表账户拥有部署资金;同样,能够从 Keystore 读取地址也不代表 RPC 连接的是 Sepolia。

下面读取本地账户地址,并通过 Sepolia RPC 查询余额。

bash
# 从加密 Keystore 恢复公有地址,不打印私钥
DEPLOYER_ADDRESS="$(cast wallet address --account sepolia-deployer)"
printf '%s\n' "$DEPLOYER_ADDRESS"

# 以 ETH 为单位查询该地址的 Sepolia 余额
cast balance "$DEPLOYER_ADDRESS" --ether --rpc-url "$SEPOLIA_RPC_URL"

预期输出格式:

text
0x<ID>
<BALANCE>

其中 <ID> 代表实际账户地址中 0x 后面的 40 位十六进制字符,<BALANCE> 代表动态查询到的 ETH 余额。新账户余额为 0 是正常情况,并不表示账户或 RPC 配置失败。

获得地址后,可通过 Sepolia 水龙头申请测试 ETH。水龙头可能要求账户登录、完成验证或持有少量主网资产,具体领取规则以服务方当前页面为准。

例如,当账户收到 0.02 Sepolia ETH 后,再次查询应显示约 0.02 ETH(前提是期间没有其他转账)。测试 ETH 没有主网 ETH 的资产价值,但真实发送部署交易仍会消耗测试 ETH 作为 Gas 费用。

建议在正式部署前确认以下条件:

  1. cast chain-id 返回 11155111。
  2. cast wallet address 返回预期部署账户地址。
  3. cast balance 能查询到该地址的 Sepolia 余额。
  4. 账户余额足以覆盖预计部署 Gas 费用,并留有一定余量。

如果尚未领取测试 ETH,也可以完成 RPC 和账户的只读验证,无需为了检查配置而发送任何链上交易。

排查连接失败与凭据泄露

当配置没有通过验证时,应根据失败所在步骤缩小问题范围,而不是立即更换私钥或重新创建钱包。

现象 常见原因 检查与处理
RPC 返回 401 或 403 API Key 无效、权限不足或服务配额限制 检查提供商控制台和端点权限,重新生成有效凭据
连接超时 URL 错误、网络不通或服务端不可用 检查 HTTPS 地址,确认服务状态或更换有效 Sepolia 端点
Chain ID 不等于 11155111 连接到了主网或其他测试网 停止部署,重新选择 Ethereum Sepolia RPC
Keystore 账户无法读取 账户别名错误、Keystore 不存在或密码不正确 通过 cast wallet list 核对名称,检查密码与文件位置
余额为 0 尚未领取测试 ETH 或查询了其他账户 核对地址及链 ID,再申请测试 ETH

完成以上检查后,项目应具备一个已验证的 Sepolia RPC 地址、固定的目标链 ID、可由本地 Keystore 解锁的独立部署账户,以及可查询的测试 ETH 余额。后续合约部署只需引用相同的 RPC 配置与账户别名,无需把私钥写进 Solidity 源码或提交到 Git。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置测试网 RPC 与账户密钥

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

登录哪都通