份额是一行除法:ERC-4626 金库怎么被一笔转账掏空

金库页面写着“存入 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 项检查;基础概念见加密学院,费率与成本速算用工具页。

安装 App