智能合约与以太坊 / 系统课时
编写可复现的部署脚本
编写可复现的部署脚本
手动部署合约容易遗漏构造参数、使用错误账户,或无法追溯交易。本课使用 Foundry Script 把部署步骤写成 Solidity 脚本,先在 Anvil 本地模拟,再广播到本地链,最后核对合约地址、交易回执和初始化状态,为后续部署到 Sepolia 做准备。
学习目标
- 编写可传入构造参数的 Foundry 部署脚本,并控制需要广播的交易范围。
- 区分本地模拟与真实广播,理解部署地址和交易哈希何时有效。
- 从部署记录提取合约地址、交易哈希,并通过链上读取验证部署结果。
准备合约与编译环境
本例使用 Foundry 的 forge、anvil 和 cast,以及 forge-std 脚本库。需要已经安装 Foundry,命令行能够执行上述工具。以下步骤适用于支持 forge script、vm.envUint 和 vm.startBroadcast 的现代 Foundry 版本。
在终端创建独立项目:
forge init reproducible-deploy
cd reproducible-deploy
forge --version预期结果:项目包含 foundry.toml、src/、script/ 和 lib/forge-std/,最后一条命令显示当前 Forge 版本。具体版本号随安装环境变化。
将 src/Counter.sol 改为以下完整合约:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
contract Counter {
address public immutable owner;
uint256 public count;
constructor(address initialOwner, uint256 initialCount) {
// 部署阶段拒绝无效管理员地址。
require(initialOwner != address(0), "zero owner");
owner = initialOwner;
count = initialCount;
}
}合约需要两个构造参数:initialOwner 指定管理员地址,initialCount 指定初始计数。部署完成后,可以分别调用自动生成的 owner() 和 count() 读取结果。
为了使重新编译时采用相同编译参数,在 foundry.toml 的 [profile.default] 段设置:
solc_version = "0.8.24"
optimizer = true
optimizer_runs = 200这是配置片段,应合并到已有段落,不要重复创建 [profile.default]。锁定编译器和优化参数可减少编译产物差异;实际项目还应固定 Foundry 版本及依赖提交版本。随后执行 forge build,预期编译成功且没有 Solidity 错误。
编写带构造参数的部署脚本
在 script/DeployCounter.s.sol 创建以下脚本:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {Script} from "forge-std/Script.sol";
import {console2} from "forge-std/console2.sol";
import {Counter} from "../src/Counter.sol";
contract DeployCounter is Script {
function run() external returns (Counter deployed) {
// 参数来自环境变量,避免每次部署都修改源码。
address initialOwner = vm.envAddress("INITIAL_OWNER");
uint256 initialCount = vm.envUint("INITIAL_COUNT");
uint256 privateKey = vm.envUint("PRIVATE_KEY");
require(initialOwner != address(0), "zero owner");
// 只记录广播区间内的合约创建交易。
vm.startBroadcast(privateKey);
deployed = new Counter(initialOwner, initialCount);
vm.stopBroadcast();
console2.log("Counter address:", address(deployed));
}
}run() 是 Forge Script 默认调用的入口。vm.envAddress 和 vm.envUint 从执行环境读取参数,避免将管理员地址、初始计数或私钥硬编码进部署脚本。
vm.startBroadcast(privateKey) 指定部署交易的发送者,并让 Forge 收集合约创建交易;vm.stopBroadcast() 结束收集范围。它们本身不会立即向网络发送交易,实际发送由命令行的 --broadcast 决定。
这里使用同一个私钥配置模拟与广播发送者,有助于减少地址预测差异。console2.log 用于显示地址,不会额外生成链上交易。

在 Anvil 上执行部署模拟
先启动一个本地以太坊开发节点。在第一个终端执行:
anvil --chain-id 31337预期结果:Anvil 启动本地 RPC 服务,通常监听 127.0.0.1:8545,显示测试账户和开发用私钥。保持这个终端运行。
在第二个终端进入项目目录,执行以下 Bash 命令。将 Anvil 输出的一个已预充值账户私钥粘贴到隐藏输入提示中:
cd reproducible-deploy
# 隐藏输入,仅使用 Anvil 提供的本地测试私钥。
read -rsp "Anvil 测试私钥:" PRIVATE_KEY
echo
export PRIVATE_KEY
# 构造参数与部署环境显式分离。
export INITIAL_OWNER="$(cast wallet address --private-key "$PRIVATE_KEY")"
export INITIAL_COUNT=7
export RPC_URL=http://127.0.0.1:8545
forge build
forge script script/DeployCounter.s.sol:DeployCounter --rpc-url "$RPC_URL"预期结果:编译成功,部署脚本通过模拟,控制台出现 Counter address: 及模拟得到的合约地址,Forge 展示模拟执行和 Gas 相关信息。具体地址与 Gas 数值由部署者、nonce、字节码及节点状态决定。
由于没有使用 --broadcast,这次运行不会向 Anvil 发送真实部署交易。因此,模拟中显示的地址并不证明该地址已有合约代码,也不会产生一个已经上链确认的部署交易哈希。
广播到本地链并记录交易信息
确认模拟成功后,在第二个终端执行相同脚本,这次增加 --broadcast:
forge script script/DeployCounter.s.sol:DeployCounter \
--rpc-url "$RPC_URL" \
--broadcast预期结果:Forge 提交合约创建交易,等待相关交易执行结果,并显示部署成功信息。在 Anvil 自动出块的默认环境中,成功交易通常很快获得回执。
对于链 ID 为 31337 的本地网络,Foundry 默认在以下位置保留广播记录:
broadcast/DeployCounter.s.sol/31337/run-latest.json
安装了 jq 的环境可以直接读取交易回执中的关键字段:
jq '.receipts[0] | {
transactionHash,
contractAddress,
status,
gasUsed
}' broadcast/DeployCounter.s.sol/31337/run-latest.json预期结果:返回包含四个字段的 JSON 对象。transactionHash 是该次部署交易的真实哈希,contractAddress 是回执中的新合约地址,成功执行时 status 为 0x1,gasUsed 是实际消耗的 Gas。交易哈希、地址和用量均为动态值,不应在教程中预设固定结果。
可以从这份记录中提取合约地址,并调用部署后的合约:
CONTRACT_ADDRESS="$(jq -r '.receipts[0].contractAddress' \
broadcast/DeployCounter.s.sol/31337/run-latest.json)"
cast call "$CONTRACT_ADDRESS" "count()(uint256)" --rpc-url "$RPC_URL"
cast call "$CONTRACT_ADDRESS" "owner()(address)" --rpc-url "$RPC_URL"
cast code "$CONTRACT_ADDRESS" --rpc-url "$RPC_URL"预期结果:第一条链上读取返回数值 7;第二条返回与 INITIAL_OWNER 对应的账户地址;第三条返回以 0x 开头的非空合约运行时代码,而不是 0x。这些检查分别证明构造参数生效、管理员正确、合约代码确实存在。
如需形成便于审计的简短部署清单,可以从回执生成独立文件:
jq --arg owner "$INITIAL_OWNER" \
--argjson initialCount "$INITIAL_COUNT" \
'{
chainId: 31337,
transactionHash: .receipts[0].transactionHash,
contractAddress: .receipts[0].contractAddress,
status: .receipts[0].status,
owner: $owner,
initialCount: $initialCount
}' broadcast/DeployCounter.s.sol/31337/run-latest.json \
> deployment-local.json预期结果:生成 deployment-local.json,保留链 ID、交易哈希、合约地址、执行状态和构造参数,不包含私钥。可以结合 foundry.toml、源码提交版本和编译器版本归档,用于复查具体部署过程。
复现部署与迁移 Sepolia 的边界
可复现的部署流程不等于每次生成相同合约地址。 普通 CREATE 部署地址由发送者地址及其 nonce 决定。相同源码和构造参数在同一账户 nonce 变化后重新部署,通常会得到不同地址;如果需要预先确定部署地址,应另行设计 CREATE2 部署方案。
在迁移到 Sepolia 前,至少检查三项:
- RPC 指向目标测试网,Sepolia 的链 ID 应为
11155111。 - 部署账户具有足够的 Sepolia 测试 ETH,并确认其地址与预期部署者一致。
- 构造参数、编译版本和部署脚本与已验证的版本一致,使用专门的测试网签名账户而不是 Anvil 默认私钥。
设置好 SEPOLIA_RPC_URL 并更换成受控的 Sepolia 测试账户签名配置后,先执行网络检查及无广播模拟:
cast chain-id --rpc-url "$SEPOLIA_RPC_URL"
forge script script/DeployCounter.s.sol:DeployCounter \
--rpc-url "$SEPOLIA_RPC_URL"预期结果:第一条命令输出 11155111;第二条在账户余额、参数和模拟条件满足时成功运行,但不向 Sepolia 发送交易。如果模拟出现余额不足或构造函数回滚,应修复后再考虑实际广播。