记录一次无赏金但被列为信息丰富采纳建议的历程

---



正文内容

前言

在对跨链桥项目(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 槽位

偏移量

mapCounter

769

593

-176

withdrawAllowedTokens

770

594

-176

depositAllowedTokens

771

595

-176

mapInfo

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(...))) 后:

  1. 四个角色完美恢复(ADMIN=true, MULTISIG=true, EMERGENCY=true, RELAYER=true)。

  2. gasAccumulated、Mapper() 指针、原生币及代币余额与升级前逐位一致。

  3. 再次调用 initializeV2 被拒绝(already initialized),证明迁移仅执行一次。

  4. 多签成功取回流动性,资金重新可控。


六、 官方反馈与链上尽职调查

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 并发放赏金的核心原因。


七、 总结与踩坑经验

  1. 底层布局的“隐形杀手”:在可升级合约(UUPS/Transparent)中,基础继承链的改变是极度危险的。任何面向已有代理的新实现,必须使用 validateUpgrade 校验存储布局。

  2. 闭环修复是敲门砖:哪怕因为平台规则未获赏金,提供带有真实 Diff 和运行结果的修复补丁,依然能赢得项目方的尊重(被记录为官方加固标准)。

  3. 防御性审计的价值:在提交报告前,主动做链上尽职调查,评估真实受影响的范围。这不仅能让报告显得极其专业,也能提前预测赏金平台的判定标准,避免做无用功。