白链桥 UUPS 升级漏洞:存储碰撞致资金永久锁死与官方采纳的修复方案
本文分析了白链桥从v2.1.1升级至v3.0.0时因继承链变更且缺少reinitializer导致的UUPS存储槽碰撞漏洞。该缺陷使权限变量偏移导致所有角色失效,合约资金被永久锁死且无链上恢复路径。作者给出了包含状态迁移与原子化升级的修复方案并被官方采纳加固。
记录一次无赏金但被列为信息丰富采纳建议的历程
---
正文内容
前言
在对跨链桥项目(Whitechain Bridge)进行安全审计时,我发现了一个存在于 UUPS 代理升级路径中的严重逻辑缺陷(CWE-665:不正确的初始化)。
当合约从 v2.1.1 升级到 v3.0.0 时,由于底层继承链改变且缺失状态迁移入口(reinitializer),执行标准原地升级会导致灾难性的存储槽碰撞(Storage Slot Collision),进而引发权限全面丢失与资金永久死锁(Permanent DoS)。
虽然该漏洞因“需特权角色触发且线上暂无受影响的资金”被 HackenProof 判定为 Informative(信息性/无赏金),但这套从底层布局分析到 PoC 闭环验证的思路非常有分享价值,特此记录。
在此也记录一下在HackenProof要成功上交报告需要满足的条件:第一漏洞详细和验证步骤不写内容
就写详细请看附件之类的话 第二把报告截图poc等打包成zip交过去 第三 流量要能访问 第四无痕浏览模式
一、 源码定位与漏洞根因
目标仓库:
whitechain-labs/bridge-contracts旧版实现:release v2.1.1
新版实现:release 3.0.0
涉及合约:
ether/contracts/main/modules/bridge/Bridge.sol、ether/contracts/main/modules/mapper/Mapper.sol编译器环境:solc
0.8.30,optimizer enabled,runs = 200;@openzeppelin/*4.9.5。
漏洞根因定位:
在 v2.1.1 中,权限由 Ownable2StepUpgradeable 控制(单一 owner);而在 v3.0.0 中,改为了 AccessControlUpgradeable,四个核心角色(DEFAULT_ADMIN_ROLE、MULTISIG_ROLE 等)在 initialize() 中授予。
致命缺陷在于,initialize() 带有 initializer 修饰符,在旧代理上 _initialized 已为 1,永远不可能再次执行。且仓库没有提供任何 reinitializer(2) 的迁移函数。运维人员被迫只能使用不带 calldata 的 upgradeTo 进行升级,这直接导致授权入口丢失。
二、 底层数据对比:存储布局碰撞
用仓库自身的编译设置在同一工程内同时编译 v2.1.1 与 v3.0.0,导出的 storageLayout 揭示了一场灾难。
1. Bridge 合约(槽位重合,语义错乱)Ownable2Step 与 AccessControl 的总占用恰好相等,所以资金指针未被破坏。但角色映射落在了旧“待转交所有者”的标量槽上。
v2.1.1:Slot 513 存放
_pendingOwner。v3.0.0:Slot 513 存放
_roles(角色映射根槽)。
因为映射的数据位于keccak256(key . slot),旧标量值无法被角色读取,导致升级后所有hasRole查询全为false。
2. Mapper 合约(槽位严重偏移)Mapper 的基类体积变化更大,自有状态变量整体偏移了 176 个槽位:
变量 | v2.1.1 槽位 | v3.0.0 槽位 | 偏移量 |
|---|---|---|---|
| 769 | 593 | -176 |
| 770 | 594 | -176 |
| 771 | 595 | -176 |
| 772 | 596 | -176 |
这意味着,升级后 mapCounter() 会从 3 变为 0,所有路由表全部失联,且由于权限丢失,路由无法重建。
三、 工具链为何未能拦截?
代码仓库的部署脚本(ether/ignition/core/deployment.ts)仅使用了 @openzeppelin/hardhat-upgrades 的 deployProxy(全新代理),从未调用过 upgradeProxy 或 validateUpgrade。
因为 OpenZeppelin 的存储布局校验器从未参与交付,这种严重的继承链冲突一直未被发现。另外,Mapper 没有 receive/fallback,upgradeToAndCall(impl, "0x") 会因空 calldata 失败而回退,所以运维在真实操作中只能使用不带数据的裸 upgradeTo —— 恰好踩中最危险的路径。
四、 PoC 核心脚本与灾难性验证
测试流程:部署旧版代理并注入数据(mapCounter 为 3,桥内有 511 ETH 和 1000 代币) -> 旧版 Owner 执行 upgradeTo -> 验证状态。
PoC 核心逻辑 (Hardhat / JavaScript):
// 1. 部署 v2.1.1 代理并注册路由
const oldBridge = await deployProxy(OLD_BRIDGE, [...args]);
await oldMapper.connect(owner).registerMapping(dep);
// 2. 用户存款,让桥持有资金
await oldBridge.connect(user).bridgeTokens({...});
// 3. 旧版 Owner 执行裸升级到 v3.0.0
const newBridgeImpl = await (await ethers.getContractFactory(NEW_BRIDGE)).deploy();
await (await oldBridge.connect(owner).upgradeTo(await newBridgeImpl.getAddress())).wait();
// 4. 验证灾难:权限全部丢失
for (const [name, role] of Object.entries(ROLE)) {
console.log(`hasRole(${name}, owner) =`, await nb.hasRole(role, owner.address)); // 全 false
}
// 5. 验证灾难:数据错位与自救失败
console.log("mapper.mapCounter() =", (await nm.mapCounter()).toString()); // 0
try {
await nb.grantRole(ROLE.MULTISIG, owner.address);
} catch (e) {
console.log("grantRole ->", e.shortMessage); // AccessControl: account ... is missing role 0x0000...
}
终端实测输出(Expected vs Actual):
owner() = 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
mapCounter before = 3
BEFORE eth=511000000000000000000 token=1000 gasAccumulated=1000000000000000000 mapCounter=3
// 升级后:权限全部丢失
hasRole(DEFAULT_ADMIN_ROLE, owner) = false
hasRole(MULTISIG_ROLE, owner) = false
hasRole(EMERGENCY_ROLE, ...) = false
hasRole(RELAYER_ROLE, ...) = false
// 升级后:资金虽在,但已无法移动
AFTER eth=511000000000000000000 token=1000 gasAccumulated=1000000000000000000 Mapper=0x162A...
mapper.mapCounter() = 0
mapper.mapInfo(1).isAllowed = false
// 尝试自救:全部失败回退
initialize -> reverted with reason string 'Initializable: contract is already initialized'
grantRole -> reverted with reason string 'AccessControl: account ... is missing role 0x0000...0000'
upgradeToAndCall -> reverted with reason string 'AccessControl: account ... is missing role 0xa5a0b70b...'
withdrawCoinLiquidity -> reverted with reason string 'AccessControl: account ... is missing role 0xa5a0b70b...'
withdrawTokenLiquidity-> reverted with reason string 'AccessControl: account ... is missing role 0xa5a0b70b...'
receiveTokens -> reverted with reason string 'AccessControl: account ... is missing role 0xe2b7fb3b...'
bridgeTokens(真实中继器签名) -> reverted with reason string 'Bridge: Signer must have RELAYER_ROLE'
registerMapping -> reverted with reason string 'AccessControl: account ... is missing role 0xa5a0b70b...'
enableMapping -> reverted with reason string 'AccessControl: account ... is missing role 0xa5a0b70b...'
结论:资金余额和状态在升级前后逐位相同(未被黑客转走),但由于所有角色丢失,唯一的修复手段 upgradeToAndCall 又需要已消失的 MULTISIG_ROLE,资金陷入了真正的永久死锁,没有任何链上救援机制。
五、 修复方案与代码验证
在报告中,我给出了具体的代码级修复方案(Remediation),并进行了闭环验证。必须禁止裸升级,使用 upgradeToAndCall 并在同一笔交易中原子化地调用带有 reinitializer(2) 的迁移函数。
核心修复代码(Bridge.sol Diff):
+ /**
+ * @notice One-time migration for proxies created by the previous release.
+ * @dev The previous release granted every role from `initialize`, which can never run again on
+ * an already-initialized proxy. `reinitializer(2)` restores the authority.
+ */
+ function initializeV2(
+ address emergencyAddress,
+ address multisigAddress,
+ address relayerAddress
+ )
+ external
+ reinitializer(2)
+ nonZeroAddress(emergencyAddress)
+ nonZeroAddress(multisigAddress)
+ nonZeroAddress(relayerAddress)
+ {
+ _grantRole(DEFAULT_ADMIN_ROLE, multisigAddress);
+ _grantRole(MULTISIG_ROLE, multisigAddress);
+ _grantRole(EMERGENCY_ROLE, emergencyAddress);
+ _grantRole(RELAYER_ROLE, relayerAddress);
+ }
修复后的验证结果:
执行 (v2.1.1 Proxy -> upgradeToAndCall(impl with reinitializer(2), initializeV2(...))) 后:
四个角色完美恢复(
ADMIN=true, MULTISIG=true, EMERGENCY=true, RELAYER=true)。gasAccumulated、Mapper()指针、原生币及代币余额与升级前逐位一致。再次调用
initializeV2被拒绝(already initialized),证明迁移仅执行一次。多签成功取回流动性,资金重新可控。
六、 官方反馈与链上尽职调查
1. 平台反馈
提交至 HackenProof 后,高级审核团队确认了该缺陷的真实性,但最终判定为 Informative(信息性),无赏金。

审核员原话回复:
"已核实。你描述的存储碰撞是一个真实且已被确认的缺陷。但这属于运维风险(需授权操作员特定操作),我们通过枚举生产部署的链上历史,确认没有任何代理执行过此操作(团队习惯部署新代理)。归类为信息性……执行
reinitializer迁移是正确的修复(the right fix),并且已被记录为安全加固反馈(hardening feedback)。没有奖励。"
2. 链上尽职调查(为什么判为 Informative)
在报告的安全反驳(Counterevidence)部分,我主动通过 Etherscan 只读调研了生产网现状:
以太坊主网唯一的生产级 v2.1.1 实例(代理地址 0x154d0ec5...5491),其原生币、USDC、WBT 余额全部为 0,末次活动在 24,233,577 区块,已被两座并行运行的 v3.0.0 新桥取代。其余链(Whitechain 主网、TRON 主网)全部是全新 v3.0.0 部署。
因此,该缺陷虽然机制成立、后果严重(一旦原地升级必定永久死锁),但当前链上不存在因其被冻结的真实资金。这也是平台未将其列为 Critical 并发放赏金的核心原因。
七、 总结与踩坑经验
底层布局的“隐形杀手”:在可升级合约(UUPS/Transparent)中,基础继承链的改变是极度危险的。任何面向已有代理的新实现,必须使用
validateUpgrade校验存储布局。闭环修复是敲门砖:哪怕因为平台规则未获赏金,提供带有真实 Diff 和运行结果的修复补丁,依然能赢得项目方的尊重(被记录为官方加固标准)。
防御性审计的价值:在提交报告前,主动做链上尽职调查,评估真实受影响的范围。这不仅能让报告显得极其专业,也能提前预测赏金平台的判定标准,避免做无用功。