金库页面写着“存入 10,000 USDC,年化 6%”,但决定你到手份额的不是年化,而是一行除法:份额 = 存入资产 × 总份额 ÷ 总资产。这行除法的分母,可以被一笔与金库无关的普通转账抬高;抬高之后,下一个存入的人可能拿到 0 份额。
一、EIP-4626 只规定了一个除法,和两个取整方向
EIP-4626 把收益金库抽象成四个函数:deposit/withdraw 与 convertToShares/convertToAssets。核心换算式只有一个:份额 = 资产 × 总份额 ÷ 总资产;反解为资产 = 份额 × 总资产 ÷ 总份额。标准同时规定了取整方向,方向永远是“对用户不利、对金库有利”。差一两个 wei 时无所谓,但当分母远大于分子,向下取整就等于归零。
| 动作 | 换算 | 取整方向 | 偏差归谁 |
|---|---|---|---|
| deposit | 资产 → 份额 | 向下 | 金库 |
| mint | 资产 → 份额 | 向上 | 用户 |
| withdraw | 份额 → 资产 | 向上 | 金库 |
| redeem | 份额 → 资产 | 向下 | 用户 |
二、分母是余额,所以任何人都能改
多数实现里 totalAssets() 直接返回 asset.balanceOf(address(this)),所以任何人向金库地址做一次 ERC-20 transfer 就能抬高总资产,而总份额一枚不变。每份净资产(价格)随之跳升,不需要任何权限,也不会发出提示。
三、算例:9,999 USDC 换到 0 份额
| 步骤 | 动作 | 总资产 | 总份额 |
|---|---|---|---|
| 1 | 金库刚部署,空 | 0 | 0 |
| 2 | 攻击者 deposit 1 wei | 1 wei | 1 |
| 3 | 攻击者直接 transfer 10,000 USDC 到金库 | 10,000.000… | 1 |
| 4 | 受害者 deposit 9,999 USDC:份额 = floor(9999 × 1 ÷ 10000) = 0 | 19,999 | 1 |
| 5 | 攻击者 redeem 1 份额,拿走全部 | 0 | 0 |
受害者付出 9,999 得到 0 份额,资产已进金库,没有任何凭据可取回;攻击者本金 10,000 加 1 wei,收益就是这笔存款。
四、危险区不是“存得少”,是“捐赠额的量级”
份额 = floor(存入额 × 总份额 ÷ 总资产)。总份额为 1 时:存入额小于总资产,份额为 0,全损;存入额等于总资产,得 1 份额,赎回一半,损失约 50%;存入额是总资产的 10 倍,得 10 份额,损失约 9%。所以危险区集中在金库刚上线、TVL 还小、宣传却很猛的那几天。攻击成本与收益上限都约等于捐赠额,因此只在一笔远大于捐赠额的存款即将到来时才划算。
五、三种修法,和各自的代价
- 死份额 / 最小首存:Uniswap V2 就铸造 1,000 最小流动性并永久销毁,把分母锁在 1,000 以上。代价是一笔沉没成本。
- 虚拟份额:OpenZeppelin 5.x 的 _decimalsOffset() 把内部份额精度放大 10^offset,攻击成本同比放大 10^offset 倍。代价是 offset 越大,早期存款人的精度损失越明显。
- 内部记账:不用 balanceOf 当总资产,改用只由 deposit/withdraw 更新的会计变量,捐赠不进分母。代价是需要额外会计校验。
六、存款前自己验一遍的五步
- 读 totalAssets() 与 totalSupply(),手动算一次每份净资产。
- 看 totalAssets 的实现:是 balanceOf,还是会计变量。
- 看有没有最小首存、deadline、decimalsOffset。
- 用 convertToShares(你的金额) 先算一遍,确认结果大于 0 且不是 1 份额。
七、常见问题
为什么页面显示的 totalAssets 比我存进去的总额多?
因为有人直接向合约转账。ERC-20 转账不经过 deposit 逻辑,余额变了而会计变量没变,差额就是“捐赠”。
我只是存款,为什么会拿到 0 份额?
份额向下取整。当总份额很小而总资产被抬高时,存入额除以每份净资产不足 1,取整结果就是 0。
年化高是不是就更容易遇到这种问题?
年化来自策略与杠杆,与份额机制无关;但高年化金库往往上线不久、TVL 小,更容易落在前面说的危险区。
八、来源与更新
1. EIP-4626: Tokenized Vaults(换算公式与取整方向),https://eips.ethereum.org/EIPS/eip-4626 (访问日期:2026-10-26)。
2. OpenZeppelin Contracts 5.x,ERC-4626 文档(_decimalsOffset 与四舍五入说明),https://docs.openzeppelin.com/contracts/5.x/erc4626 (访问日期:2026-10-26)。
3. 站内对照:同一个协议三个 TVL、一份审计报告的 11 项检查;基础概念见加密学院,费率与成本速算用工具页。