智能合约与以太坊 / 系统课时
配置测试网 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 都能在当前终端调用。
# 确认合约开发与链上查询工具均已安装
command -v forge >/dev/null && command -v cast >/dev/null && echo 'Foundry ready'预期输出:
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 替换成自己申请的有效密钥。
# .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 文件。
# 忽略本地配置,并把变量导出给子进程
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 配置正确时):
.env ignored
Sepolia chain ID verifiedcast chain-id 实际读取远端节点返回的网络标识,而不是直接打印 .env 中写入的数值。也可以单独执行 cast chain-id --rpc-url "$SEPOLIA_RPC_URL",正常返回 11155111。
导入独立部署账户并保护私钥
部署交易需要私钥签名,但 JSON-RPC 查询链 ID、余额和区块数据时不需要私钥。建议创建只用于 Sepolia 的独立账户,不要导入存有真实资产的主网钱包。
Foundry 的 cast wallet import 可以通过交互提示导入私钥,并使用密码加密保存到本地 Keystore,避免在 Shell 命令参数和历史记录中出现明文私钥。
# 交互输入测试账户私钥及 Keystore 加密密码
cast wallet import sepolia-deployer --interactive
# 查看本机已导入的账户名称
cast wallet list预期结果:终端要求交互输入私钥与加密密码。导入成功后,账户列表包含 sepolia-deployer。具体提示文案可能随 Foundry 版本变化。
默认 Keystore 目录是 ~/.foundry/keystores/,其中的 sepolia-deployer 文件保存加密后的密钥材料。Keystore 密码用于解密本地文件,不是钱包助记词,也不是 Sepolia RPC 的 API Key。应分别保管 Keystore 及其密码,避免将二者同时上传到代码仓库或共享存储。

在实际部署时,可让 Foundry 使用 --account sepolia-deployer 引用该 Keystore,并在需要签名时输入密码。相较于在命令行使用 --private-key 直接传递明文,这种方式减少了私钥出现在终端历史、脚本或日志中的风险,但仍需保护运行环境和 Keystore 密码。
验证账户地址和测试 ETH 余额
配置完成后,应分别验证远端网络与本地账户。网络连接正常不代表账户拥有部署资金;同样,能够从 Keystore 读取地址也不代表 RPC 连接的是 Sepolia。
下面读取本地账户地址,并通过 Sepolia RPC 查询余额。
# 从加密 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"预期输出格式:
0x<ID>
<BALANCE>其中 <ID> 代表实际账户地址中 0x 后面的 40 位十六进制字符,<BALANCE> 代表动态查询到的 ETH 余额。新账户余额为 0 是正常情况,并不表示账户或 RPC 配置失败。
获得地址后,可通过 Sepolia 水龙头申请测试 ETH。水龙头可能要求账户登录、完成验证或持有少量主网资产,具体领取规则以服务方当前页面为准。
例如,当账户收到 0.02 Sepolia ETH 后,再次查询应显示约 0.02 ETH(前提是期间没有其他转账)。测试 ETH 没有主网 ETH 的资产价值,但真实发送部署交易仍会消耗测试 ETH 作为 Gas 费用。
建议在正式部署前确认以下条件:
cast chain-id返回11155111。cast wallet address返回预期部署账户地址。cast balance能查询到该地址的 Sepolia 余额。- 账户余额足以覆盖预计部署 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。