智能合约与以太坊 / 系统课时
断言未授权操作必须回滚
断言未授权操作必须回滚
修复智能合约的访问控制漏洞后,不能只验证管理员可以操作,还要证明普通账户、伪造签名和重复领取请求一定会回滚。本课使用 Solidity、Hardhat 3 和 Ethers.js 6 编写负向测试,检查回滚原因、状态不变性以及正常授权路径,防止修复后仍存在绕过入口。
学习目标
- 使用
revertedWithCustomError断言未授权调用发生预期回滚。 - 覆盖管理员角色、签名校验和重复领取三类负向场景。
- 验证失败交易不会改变合约状态,并保留成功路径作为对照。
明确负向测试的判断标准
在 EVM 中,执行期间触发 revert 会撤销该调用事务产生的合约状态变更。测试不能只检查调用失败,因为余额不足、参数编码错误或者其他漏洞同样可能导致失败。
针对三个常见入口,分别定义可验证的安全不变量:
| 测试入口 | 非法输入 | 必须满足的结果 |
|---|---|---|
| 管理员操作 | 普通账户调用 setLimit |
回滚 Unauthorized,限额不变 |
| 签名授权 | 使用其他领取人的有效签名 | 回滚 InvalidSignature,领取状态不变 |
| 重复领取 | 同一账户再次提交已用授权 | 回滚 AlreadyClaimed,不得再次转账 |
这里采用自定义错误而不是依赖字符串消息。自定义错误能够通过错误选择器与参数进行精确匹配,且通常比字符串回滚原因更节省 Gas。
对于签名授权,还需要把领取人地址、金额、链 ID 和合约地址纳入签名摘要,防止授权被转移给其他账户或在不同部署之间重放。本例额外设置一次性领取标志,不允许同一账户再次领取。
编写可测试的安全合约
示例使用 Solidity 0.8.24,签名校验采用 OpenZeppelin Contracts 5.x 的 ECDSA。测试环境需要提供一个具有 Ether 余额的管理员账户。以下是完整的 contracts/SecureVault.sol:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {ECDSA} from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
contract SecureVault {
error Unauthorized();
error InvalidSignature();
error AlreadyClaimed();
error LimitExceeded();
error TransferFailed();
address public immutable admin;
uint256 public limit = 1 ether;
mapping(address => bool) public claimed;
constructor() payable {
admin = msg.sender;
}
function setLimit(uint256 newLimit) external {
if (msg.sender != admin) revert Unauthorized();
limit = newLimit;
}
function claim(uint256 amount, bytes calldata signature) external {
// 将调用者、金额和部署上下文绑定到授权摘要。
bytes32 digest = keccak256(
abi.encode(address(this), block.chainid, msg.sender, amount)
);
bytes32 ethHash = keccak256(
abi.encodePacked("\x19Ethereum Signed Message:\n32", digest)
);
if (ECDSA.recover(ethHash, signature) != admin) {
revert InvalidSignature();
}
// 先检查并更新领取状态,再执行外部转账。
if (claimed[msg.sender]) revert AlreadyClaimed();
if (amount > limit) revert LimitExceeded();
claimed[msg.sender] = true;
(bool ok, ) = payable(msg.sender).call{value: amount}("");
if (!ok) revert TransferFailed();
}
}这份实现有两处值得关注:admin 在部署时固定,普通用户不能改变管理员;claimed 在转账前设为 true,避免外部转账期间再次进入领取逻辑。
claim 将领取人绑定为 msg.sender。因此,拿到别人的签名并不意味着可以代替对方领取。示例假设管理员可信,且管理员只签发符合业务规则的授权。生产项目还应考虑签名有效期、授权撤销及可升级合约的域分隔规则。
使用 Hardhat 编写负向测试
采用 Hardhat 3 的 Ethers.js 与 Mocha 测试组合,安装对应依赖后执行测试。下面使用 Hardhat 3 官方插件体系中的 @nomicfoundation/hardhat-toolbox-mocha-ethers,并显式安装 OpenZeppelin 5.x。
npm install --save-dev hardhat@^3 @nomicfoundation/hardhat-toolbox-mocha-ethers
npm install @openzeppelin/contracts@^5预期结果:依赖安装成功,npm 以退出码 0 结束。安装输出中的包数和审计提示取决于本地依赖树,不作为安全断言。
项目根目录创建 hardhat.config.ts:
import { defineConfig } from "hardhat/config";
import hardhatToolboxMochaEthers from "@nomicfoundation/hardhat-toolbox-mocha-ethers";
export default defineConfig({
plugins: [hardhatToolboxMochaEthers],
solidity: "0.8.24",
});该配置启用 Ethers.js 和 Mocha 测试能力。下面的测试使用 Hardhat 3 的 network.connect() 创建隔离的模拟网络连接,代码放入 test/SecureVault.ts:
import { expect } from "chai";
import { network } from "hardhat";
const { ethers } = await network.connect();
describe("SecureVault authorization", function () {
async function fixture() {
const [admin, alice, bob] = await ethers.getSigners();
const vault = await ethers.deployContract("SecureVault", [], {
value: ethers.parseEther("5"),
});
await vault.waitForDeployment();
// 签名摘要必须与 Solidity 的 abi.encode 完全一致。
async function authorize(user: string, amount: bigint) {
const chainId = (await ethers.provider.getNetwork()).chainId;
const digest = ethers.keccak256(
ethers.AbiCoder.defaultAbiCoder().encode(
["address", "uint256", "address", "uint256"],
[await vault.getAddress(), chainId, user, amount]
)
);
return admin.signMessage(ethers.getBytes(digest));
}
return { admin, alice, bob, vault, authorize };
}
it("rejects non-admin limit changes", async function () {
const { alice, vault } = await fixture();
const before = await vault.limit();
await expect(
vault.connect(alice).setLimit(ethers.parseEther("3"))
).to.be.revertedWithCustomError(vault, "Unauthorized");
expect(await vault.limit()).to.equal(before);
});
it("rejects signatures bound to another recipient", async function () {
const { alice, bob, vault, authorize } = await fixture();
const amount = ethers.parseEther("0.5");
const signature = await authorize(alice.address, amount);
const before = await ethers.provider.getBalance(await vault.getAddress());
// Bob 重用 Alice 的签名,不能让合约支付给 Bob。
await expect(
vault.connect(bob).claim(amount, signature)
).to.be.revertedWithCustomError(vault, "InvalidSignature");
expect(await vault.claimed(bob.address)).to.equal(false);
expect(await ethers.provider.getBalance(await vault.getAddress()))
.to.equal(before);
});
it("rejects a second claim without transferring again", async function () {
const { alice, vault, authorize } = await fixture();
const amount = ethers.parseEther("0.5");
const signature = await authorize(alice.address, amount);
await expect(vault.connect(alice).claim(amount, signature))
.to.not.be.reverted;
expect(await vault.claimed(alice.address)).to.equal(true);
const balanceAfterFirst = await ethers.provider.getBalance(
await vault.getAddress()
);
await expect(
vault.connect(alice).claim(amount, signature)
).to.be.revertedWithCustomError(vault, "AlreadyClaimed");
expect(await ethers.provider.getBalance(await vault.getAddress()))
.to.equal(balanceAfterFirst);
});
});运行测试:
npx hardhat test test/SecureVault.ts预期结果:三个测试均通过,Mocha 报告 3 passing。如果其中任何一项断言失败,命令应以非零退出码结束。实际执行时间与测试报告细节可能不同。
为什么还要检查回滚后的状态
单独使用 reverted 只证明发生了回滚,无法区分是预期的权限检查,还是意外的转账失败。因此,本例同时使用精确错误断言和状态断言:
- 管理员入口:检查
limit()没有变化,避免未授权交易意外修改业务参数。 - 签名入口:检查
claimed(bob)仍为false,并比较合约的 Ether 余额。 - 重复领取入口:先证明首次领取成功,再检查第二次交易的错误类型和余额不变性。
对同一笔 EVM 交易而言,真正回滚会撤销该交易对合约存储、余额和日志的状态影响。额外的状态断言能够锁定业务不变量,防止后续修改把安全测试弱化成只接受任何失败。
本例使用 ECDSA.recover,对畸形签名可能抛出 OpenZeppelin 自身的 ECDSA 错误,而非 InvalidSignature。因此,这里的错误断言专门针对格式有效但签名者无权的情况。如果业务要求统一错误类型,可在合约中使用 ECDSA.tryRecover 并显式处理恢复失败。
检查修复是否真正有效
建议在代码评审中做一次受控的回归检查:临时在测试分支移除 setLimit 的管理员校验,然后重新执行测试。预期第一条测试失败,因为未授权调用不再回滚。恢复校验后,三个测试应再次通过。
还应增加两项实际边界检查:合法签名对应的金额被篡改时必须失败;不同链 ID 或不同合约地址下生成的授权不得被当前部署接受。测试时必须确保授权域实际不同,而不是只更换变量名称。
最终验收标准是:合法管理员能够修改限额;合法用户能够首次领取;未授权操作、跨账户签名复用和重复领取均触发指定错误;失败交易不会改变相关业务状态。负向测试只有同时约束错误类型与业务结果,才能有效守住已经修复的安全边界。