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

用 Foundry 初始化漏洞复现工程

用 Foundry 初始化漏洞复现工程

本课使用 Foundry 建立一个可重复运行的智能合约漏洞实验工程。你将编写最小 ETH 金库、创建存款人与攻击者账户,通过测试夹具准备资金,并运行一个通过的正常用例和一个失败的安全用例,确认环境能够暴露真实的访问控制缺陷。

学习目标

  • 初始化 Foundry 项目,理解合约、测试和依赖目录的职责。
  • 使用 setUp()、vm.deal() 和 vm.prank() 构造可重复的资金与账户状态。
  • 编写正常存款测试和攻击者越权提款测试,识别预期安全行为与实际执行结果的差异。

初始化 Foundry 项目

Foundry 是以 Solidity 编写和执行测试的以太坊开发工具集,其中 forge 负责项目管理、编译和测试。本课使用 Foundry 稳定版工具链以及 Solidity 0.8.20 语法,不依赖公网 RPC 或真实 ETH。

在 macOS 或 Linux 的终端中安装 Foundry。如果已经安装,可以跳过安装命令。

bash
# 安装 Foundry 工具链管理器
curl -L https://foundry.paradigm.xyz | bash
# 按安装器提示使 foundryup 进入 PATH,然后执行
foundryup
forge --version

预期结果:forge --version 显示已安装的 Forge 版本号。具体版本号因安装日期而异。Windows 用户建议使用 WSL2 的 Ubuntu 环境执行相同命令。

创建实验工程:

bash
forge init vault-security-lab
cd vault-security-lab
forge build

预期结果:初始化命令创建项目目录,forge build 在默认示例文件未修改时成功编译并以 Compiler run successful! 结束。首次初始化需要网络下载 forge-std 等依赖。

主要目录用途如下:

目录或文件 作用
src/ 存放待验证的金库合约
test/ 存放 Solidity 测试和攻击复现用例
script/ 存放部署或链上操作脚本
lib/forge-std/ 提供测试断言和虚拟机作弊码
foundry.toml 配置编译器、测试等项目参数

实现存在访问控制缺陷的金库

在 src/ 目录中新建 VulnerableVault.sol。合约允许任何地址存入 ETH,也允许调用者指定提款金额。这里故意省略存款人余额记录及提款授权检查,用来制造可验证的越权提款漏洞。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract VulnerableVault {
    // 接收用户存入的 ETH
    function deposit() external payable {
        require(msg.value > 0, "Zero deposit");
    }

    function withdraw(uint256 amount) external {
        require(amount > 0, "Zero withdrawal");
        require(address(this).balance >= amount, "Insufficient funds");

        // 漏洞:只验证金库总余额,没有验证提款人的所有权
        (bool success, ) = payable(msg.sender).call{value: amount}("");
        require(success, "Transfer failed");
    }
}

这里的 address(this).balance 表示金库实际持有的 ETH 数量,并不代表当前调用者可以提取的金额。攻击者即使从未存款,也能够调用 withdraw() 转走其他用户存入的资金。

例如 Alice 存入 5 ETH,攻击者存款为 0 ETH。按照安全要求,攻击者能够提取的金额应该是 0 ETH;但当前合约只检查金库是否拥有至少 1 ETH,因此攻击者可以提取 1 ETH。

创建攻击者账户和测试夹具

Foundry 使用继承 forge-std/Test.sol 的 Solidity 合约编写测试。setUp() 会在每个测试执行前重新运行,使测试用例从独立的初始状态开始。

本实验涉及三个主体:存款人 Alice、持有资金的 Vault、没有存款记录的攻击者。正常用例验证 Alice 的存款;安全用例验证攻击者是否可以动用 Alice 的资金。

金库测试中正常存款与越权提款的资金关系

删除初始化项目附带的示例测试,或确保后续测试筛选只选择本实验。在 test/ 目录中新建 VulnerableVault.t.sol:

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {Test} from "forge-std/Test.sol";
import {VulnerableVault} from "../src/VulnerableVault.sol";

contract VulnerableVaultTest is Test {
    VulnerableVault internal vault;
    address internal alice = address(0xA11CE);
    address internal attacker = address(0xB0B);

    function setUp() public {
        // 每个测试重新部署金库,确保状态互不污染
        vault = new VulnerableVault();
        vm.deal(alice, 10 ether);
        vm.deal(attacker, 1 ether);

        // 模拟 Alice 存入 5 ETH
        vm.prank(alice);
        vault.deposit{value: 5 ether}();
    }

    function testAliceDeposit() public view {
        assertEq(address(vault).balance, 5 ether);
        assertEq(alice.balance, 5 ether);
    }

    function testAttackerCannotWithdraw() public {
        // 安全预期:未存款的攻击者提款应当回滚
        vm.prank(attacker);
        vm.expectRevert();
        vault.withdraw(1 ether);
    }
}

vm.deal() 直接设置测试账户的 ETH 余额,不需要真实私钥或链上转账。vm.prank() 将下一次目标调用的 msg.sender 设置为指定地址,用来模拟不同用户。

vm.expectRevert() 声明后续被监测的调用应当回滚。此处故意要求攻击者提款失败,因此漏洞未修复前,安全测试应当报告失败。

执行通过与失败的测试

先编译工程,检查 Solidity 导入路径和语法是否正确。

bash
forge build

预期结果:编译成功,没有 Solidity 编译错误。若编译器尚未缓存且默认配置允许自动安装,首次编译可能需要下载对应版本。

运行正常存款用例:

bash
forge test --match-test testAliceDeposit -vv

预期输出(省略版本相关的编译信息与耗时):

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

这说明夹具成功创建了初始资金状态:Alice 原有 10 ETH,存入 5 ETH 后剩余 5 ETH,金库持有 5 ETH。

然后运行攻击者提款用例:

bash
forge test --match-test testAttackerCannotWithdraw -vv

预期结果:测试失败,报告中会出现类似以下关键信息,完整格式可能随 Foundry 版本变化。

text
[FAIL: next call did not revert as expected] testAttackerCannotWithdraw()
Suite result: FAILED. 0 passed; 1 failed

这里的失败不是运行环境故障,而是安全断言发现了缺陷。withdraw(1 ether) 没有按预期回滚,说明未存款的攻击者能够提款。由于 vm.expectRevert() 的断言不满足,测试最终失败,测试事务的状态不会被提交到其他测试用例。

使用更详细的调用追踪查看执行过程:

bash
forge test --match-test testAttackerCannotWithdraw -vvvv

预期结果:调用追踪中能够看到攻击者身份下的 withdraw(1000000000000000000) 调用,以及未发生预期回滚的失败信息。1 ETH 对应 101810^{18} wei。

-vvvv 适合定位失败用例中的调用顺序;普通日常测试使用 -vv 通常已经足够。

修复漏洞并验证测试夹具

确认失败用例能够揭示漏洞后,可以进行一次最小修复验证。生产级金库需要记录每个账户的存款余额,并在转账前完成余额扣减。

将 src/VulnerableVault.sol 替换为以下版本。本次保留原合约名称,以便原测试无需修改即可重复执行。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract VulnerableVault {
    mapping(address => uint256) public balances;

    function deposit() external payable {
        require(msg.value > 0, "Zero deposit");
        balances[msg.sender] += msg.value;
    }

    function withdraw(uint256 amount) external {
        require(amount > 0, "Zero withdrawal");
        require(balances[msg.sender] >= amount, "Insufficient balance");

        // 先更新用户余额,再执行外部 ETH 转账
        balances[msg.sender] -= amount;
        (bool success, ) = payable(msg.sender).call{value: amount}("");
        require(success, "Transfer failed");
    }
}

修复后,Alice 存入 5 ETH 会增加她的内部余额;攻击者没有存款,其 balances[attacker] 默认为 0,提款 1 ETH 时会触发 Insufficient balance 回滚。若外部转账失败,整个交易回滚,之前的余额扣减也会撤销。

执行两个用例:

bash
forge test --match-contract VulnerableVaultTest -vv

预期结果(省略耗时与编译信息):

text
[PASS] testAliceDeposit()
[PASS] testAttackerCannotWithdraw()
Suite result: ok. 2 passed; 0 failed

这一结果验证了夹具能区分漏洞版本和修复版本。它只覆盖当前两个安全断言,并不代表合约通过完整安全审计。

排查常见环境问题

如果 forge 命令不存在,首先检查安装过程是否已经将 Foundry 的可执行文件目录加入 PATH,重新加载终端环境后再执行 forge --version。

如果出现 Source forge-std/Test.sol not found,检查 lib/forge-std/ 是否存在,并在工程根目录执行:

bash
forge install foundry-rs/forge-std
forge build

预期结果:依赖安装成功后,编译器可以解析 forge-std/Test.sol。如果项目已经存在该依赖但仍无法导入,应检查当前工作目录和 foundry.toml 的依赖路径配置。依赖安装需要能够访问对应 Git 仓库。

如果安全测试意外显示通过,应先确认是否已经替换成修复后的合约;如果正常存款测试失败,则检查 setUp() 是否执行、存款调用是否使用 vm.prank(alice),以及是否正确附带 5 ether。

最终保留漏洞版本和修复版本的代码差异,以及两次测试的通过与失败记录,就形成了一份最小可审计复现材料。后续添加新漏洞时,继续使用独立测试夹具,并让安全断言在漏洞版本上失败、在修复版本上通过。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Foundry 初始化漏洞复现工程

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

登录哪都通