智能合约与以太坊 / 系统课时
部署合约到 Sepolia 测试网
部署合约到 Sepolia 测试网
把 Solidity 合约部署到 Sepolia,需要准备测试账户、RPC 节点和用于支付 Gas 的测试 ETH。本课使用 Foundry 编译一个计数合约,通过 Forge 签名并广播部署交易,最后检查交易回执、合约字节码和链上初始状态,确认部署真正完成。
学习目标
- 配置 Sepolia RPC 和专用测试账户,检查网络 Chain ID 与 ETH 余额。
- 使用
forge create广播带构造参数的合约部署交易。 - 根据交易回执、合约代码和只读调用判断部署是否成功。
检查 Foundry 与 Sepolia 配置
Sepolia 是面向智能合约和应用开发的 Ethereum 测试网络,Chain ID 为 11155111。部署交易虽然不消耗真实主网 ETH,但仍需使用 Sepolia ETH 支付 Gas。
以下命令以 Bash 终端为例,适用于支持 forge create --broadcast 和 cast wallet import 的 Foundry 版本。Windows 用户可以通过 WSL 运行相同命令。
先确认已安装 Forge 和 Cast,再创建独立项目:
forge --version
cast --version
forge init sepolia-demo
cd sepolia-demo预期结果:终端显示 Forge、Cast 的版本信息,并成功创建 sepolia-demo 目录,其中包含 foundry.toml、src 等项目文件。版本号随安装环境变化。
准备一个只用于测试网的新账户,将其私钥交互式导入 Foundry 加密密钥库:
cast wallet import sepolia-deployer --interactive
cast wallet address --account sepolia-deployer第一条命令会提示输入私钥和密钥库密码,第二条命令显示对应的 0x 开头账户地址。实际地址因账户而异,应复制并妥善保存。
接下来从可信 RPC 服务提供方获取支持 Sepolia 的 HTTPS RPC 地址。为避免把包含 API Key 的 URL 写进 Shell 历史记录,使用交互输入:
read -r -p "Sepolia RPC URL: " SEPOLIA_RPC_URL
export SEPOLIA_RPC_URL
cast chain-id --rpc-url "$SEPOLIA_RPC_URL"预期输出:
11155111如果返回 1,说明连接到了 Ethereum 主网;如果返回 31337,通常连接到了本地开发链。必须先修正 RPC 地址,不要继续广播交易。RPC 请求超时或返回未授权错误时,应检查服务商的网络选择、API Key 和访问权限。
领取测试 ETH 并校验余额
测试 ETH 可以从 Sepolia Faucet 领取,例如 Chainlink Sepolia Faucet。水龙头的登录条件、领取额度和冷却时间可能调整,应以页面实际规则为准。
领取步骤如下:
- 打开支持 Sepolia 的水龙头,选择 Sepolia ETH。
- 使用测试钱包连接网站,或按页面要求输入上一步得到的账户地址。
- 提交领取请求,等待水龙头发送交易并获得链上确认。
- 回到终端,查询部署账户余额。
DEPLOYER=$(cast wallet address --account sepolia-deployer)
cast balance "$DEPLOYER" --rpc-url "$SEPOLIA_RPC_URL"预期结果:返回一个大于零的 Wei 整数。例如账户持有 0.05 ETH 时,余额为:
50000000000000000这里的 0.05 ETH 只是余额换算示例,不代表水龙头固定发放额度。实际数值取决于到账金额和此前支付的手续费。
部署前应确保余额能够覆盖预计费用。假设部署消耗 180000 Gas,有效 Gas 单价为 2 Gwei,手续费约为 0.00036 ETH。这只是计算示例,实际 Gas 用量及价格由合约字节码和网络状态决定。
编译一个带构造参数的合约
为了验证部署参数确实写入链上状态,创建 src/SepoliaCounter.sol。它在构造函数中写入初始计数值,并提供只读 Getter 和递增方法。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract SepoliaCounter {
uint256 public count;
// 部署时写入初始状态,后续通过 count() 读取。
constructor(uint256 initialCount) {
count = initialCount;
}
function increment() external {
count += 1;
}
}这是完整合约源码,应保存到当前 Foundry 项目的指定路径。public 状态变量会自动生成 count() 读取函数;部署后无需发送交易即可查询它。
执行编译:
forge build预期结果:编译命令正常退出,不出现 Solidity 编译错误,并生成 out/SepoliaCounter.sol/SepoliaCounter.json 构建产物。编译器版本和终端消息可能因本机配置而变化。
如果提示找不到源文件,先核对路径及大小写;如果编译失败,应先解决 Solidity 错误,不能依赖部署命令自动修复源码。
用 Forge 签名并广播部署
forge create 将合约创建字节码和 ABI 编码后的构造参数组成部署交易,再使用指定账户签名,经 RPC 节点广播至 Sepolia。交易进入区块后,网络执行构造函数并在新合约地址保存运行时代码和初始状态。

在项目根目录执行:
forge create src/SepoliaCounter.sol:SepoliaCounter \
--rpc-url "$SEPOLIA_RPC_URL" \
--account sepolia-deployer \
--broadcast \
--constructor-args 7命令会按需提示输入密钥库密码,完成签名与交易发送。其中:
src/SepoliaCounter.sol:SepoliaCounter指定部署目标。--account从 Foundry 加密密钥库读取签名账户。--broadcast明确要求广播交易,而不是只执行模拟。--constructor-args 7将构造函数参数initialCount设置为7。
预期结果:部署成功时终端会包含部署账户、合约地址和交易哈希等信息,典型字段包括 Deployer、Deployed to 和 Transaction hash。实际十六进制地址和交易哈希均不同,不应复制其他人的示例值。
保存这三个信息,特别是部署交易哈希与新合约地址。它们分别用于核对交易执行过程和查询已经部署的合约。
从交易回执验收部署
Forge 返回合约地址后,还要确认交易成功执行、目标地址存在运行时代码,并验证构造参数已经写入链上状态。仅看到广播成功或交易哈希,不足以证明部署完成。
把部署命令显示的实际交易哈希和合约地址输入终端:
read -r -p "部署交易哈希: " DEPLOY_TX_HASH
read -r -p "合约地址: " COUNTER_ADDRESS
# 检查链上回执和实际部署代码。
cast receipt "$DEPLOY_TX_HASH" --rpc-url "$SEPOLIA_RPC_URL"
cast code "$COUNTER_ADDRESS" --rpc-url "$SEPOLIA_RPC_URL"预期结果:交易回执包含成功状态 status=1(不同显示格式也可能写成 0x1),contractAddress 对应部署地址,并提供实际消耗的 Gas 等信息。cast code 应返回非空的十六进制运行时代码,而不是单独的 0x。
随后通过只读调用检查构造函数的结果:
cast call "$COUNTER_ADDRESS" \
"count()(uint256)" \
--rpc-url "$SEPOLIA_RPC_URL"预期输出:
7只有交易状态成功、目标地址存在运行时代码、count() 返回 7,才能完成本例的部署验收。也可以在 Sepolia Etherscan 输入交易哈希,交叉检查链上记录。
交易回执的成功状态表示该交易在所查询区块链视图中执行成功,并不等同于交易已达到最终确定状态。对资金敏感的业务,还需根据确认数与最终确定性要求决定何时向用户展示不可逆的业务结果。
出错时按阶段定位
部署问题应先判断失败发生在广播之前、交易发送过程中,还是链上执行之后。以下情况可以直接按照现象处理。
| 现象 | 常见原因 | 检查与修正 |
|---|---|---|
cast chain-id 不是 11155111 |
RPC 指向错误网络 | 更换 Sepolia RPC,重新核对 Chain ID |
insufficient funds |
测试 ETH 不足以支付预计 Gas 费用 | 查询账户余额,补充测试 ETH 后重新估算 |
RPC 返回 401、403 或 429 |
API Key、服务权限或请求频率问题 | 核对服务商控制台配置,降低请求频率或更换端点 |
| 没有真实交易哈希 | 可能未广播,或签名及 RPC 请求未完成 | 检查 --broadcast、密钥库密码和终端错误信息 |
| 回执暂时查询不到 | 交易尚未入块、传播失败或查询节点不同步 | 核对网络及交易哈希,等待后再次查询 |
回执状态为 0 |
交易执行回滚 | 检查构造函数、Gas 设置及执行错误,不要当作成功部署 |
cast code 返回 0x |
地址错误、网络错误或没有部署代码 | 比对回执中的 contractAddress 与当前 RPC |
若账户在水龙头领取后余额依然为零,应先检查水龙头发出的交易是否发送到正确地址,并确认它使用的是 Ethereum Sepolia,而不是其他名称相似的 L2 测试网。
最后应记录 Chain ID 11155111、合约源码版本、部署账户、合约地址、交易哈希、回执状态与构造参数 7。这些信息可以用于后续合约调用、区块浏览器核验和部署记录审计,而不是只依赖终端中一次性的成功提示。