锁仓合约双钱包同地址:allocate() 对同一 allocations 槽位连续赋值,2.4 亿配额被 0.1 亿覆盖,解锁额与滞留资金错位
blockchain/solidity · verified
一句话结论
锁仓/归属合约的 allocate() 先把 2.4 亿写入 allocations[teamReserveWallet],再把 0.1 亿写入 allocations[finalReserveWallet];当两个角色钱包被配置成同一个地址时,第二次赋值覆盖同一 mapping 槽位,合约实际记录的锁仓配额只有 0.1 亿。团队解锁按被覆盖后的配额计算(每次 0.1 亿 ÷ 8 × 段数),合约里另外 2.4 亿既没有对应配额也没有回收路径,永久滞留;链上表现为“转账 2.5 亿进入合约、首次 claim 只出 375 万”。
原理
- mapping 以地址为键:
allocations[address]是单槽映射,同一地址两次赋值是覆盖而不是累加。allocate()依次执行allocations[teamReserveWallet] = 240M、allocations[finalReserveWallet] = 10M;若两个钱包地址相同(部署时都填了同一个 0xA),最终该槽位只保留 10M。 - 余额校验不能发现配额错误:
allocate()只require(token.balanceOf(address(this)) == totalAllocation)(合约确实持有 2.5 亿),没有校验allocations之和是否等于totalAllocation,也没有校验两个角色地址互不相同,因此覆盖后在链上“看起来锁仓成功”。 - 解锁金额由被覆盖的配额决定:
claimTeamReserve()计算totalUnlocked = vestingStage * allocations[teamReserveWallet] / teamVestingStages;配额 10M、8 段、每段约 91.25 天,3 段后应领3 * 10M / 8 = 3.75M,与现场首次 claim 实际到账 375 万完全吻合,而不是预期的3 * 240M / 8 = 90M。 - claim 状态也被同一地址共享:
claimed[address]只有一个槽位,团队领取会把claimed[0xA]置为非零;claimTokenReserve()要求claimed[reserveWallet] == 0,因此同一地址下团队领取与最终储备领取互斥,两条路径合计最多也只能领走 10M。 - 剩余 2.4 亿没有出口:
recoverFailedLock()带notLocked/notAllocated修饰器,设计用于“锁仓失败时退回”,allocate()/lock()成功后该路径不可用;合约又没有其他 sweep/救援函数,多转进去的 2.4 亿永远留在合约地址。 - “没收到解锁款”的常见前置原因是未主动 claim:这类锁仓合约不是按时间自动转账,需要持有对应角色钱包定期调用
claimTeamReserve()。链上只有“创建合约”和“allocate”两笔交易时,说明从未领取;先补调 claim,再核对到账数量,才能区分“没领”与“配额被覆盖”。
触发条件
- 部署时
teamReserveWallet与finalReserveWallet(或任何两个被分配配额的角色地址)填写为同一地址;且合约没有 setter 可在部署后修正。 - Owner 调用了
allocate()/lock(),合约已持有totalAllocation,进入已锁仓状态。 - 解锁为主动 claim 模式:没有人调用
claimTeamReserve()时余额不会自动变化;调用后按覆盖后的allocations计算金额。 - 合约没有独立的 emergency recover/sweep 路径,或该路径被
notLocked/notAllocated等状态修饰器挡住。
利用步骤
本场景是合约逻辑/部署事故的应急排查路径,不是攻击者利用链。
- 链上取证:在区块浏览器查看锁仓合约的交易列表与 ERC20 转账记录,确认是否只有“创建合约 + allocate”两笔交易,以及合约实际收到的代币数量(示例 2.5 亿)。
- 判断是否未领取:核对
claimed/lockedAt等状态与历史交易;若从未调用 claim,先按合约要求用角色钱包调用claimTeamReserve()(注意调用者必须是teamReserveWallet)。 - 核对到账数量:用
vestingStage()与实际到账反推allocations;若到账 =stage * 预期配额 / 8明显不符(示例为 375 万而非 9000 万),转查源码。 - 定位覆盖点:比较
teamReserveWallet与finalReserveWallet的赋值;若相同,确认allocate()中两次写同一 mapping 槽位,后写的较小配额覆盖前者。 - 评估可追回资产:计算合约余额与
allocations之和的差额(示例 2.5 亿 - 0.1 亿 = 2.4 亿),检查recoverFailedLock()等函数的修饰器与状态,确认是否还有任何提取路径。 - 处置:已部署合约无法修改代码;只能按现有 claim 路径领取被记录的配额(示例 0.1 亿,分 8 段),其余资产需与项目方/交易所协商或通过合约预留的治理/救援机制处理(若存在)。
PoC
最小复现(Solidity 语义,展示覆盖与解锁计算):
mapping(address => uint256) public allocations;
address teamReserveWallet = address(0xA);
address finalReserveWallet = address(0xA); // 同一地址
uint256 teamReserveAllocation = 240 * 10**6 * 10**18;
uint256 finalReserveAllocation = 10 * 10**6 * 10**18;
function allocate() external {
allocations[teamReserveWallet] = teamReserveAllocation; // 240M
allocations[finalReserveWallet] = finalReserveAllocation; // 同一槽位,覆盖为 10M
}
function unlockedAt(uint256 stage) public view returns (uint256) {
return stage * allocations[teamReserveWallet] / 8; // stage=3 -> 3.75M
}
排查用不变量:
require(teamReserveWallet != finalReserveWallet, "role address collision");
require(sum(allocations) == totalAllocation, "allocation invariant");
无独立链上 PoC;上述代码可在本地测试链复现覆盖行为。
变体与关联
- 角色地址碰撞:owner/operator、team/final、treasury/reward 等任意两个被分配配额的角色地址重复,都会触发同类覆盖;也可能出现在白名单、额度、质押份额等 mapping。
- 累加语义错误:把
=写成+=可避免覆盖;反之把本应+=的分配写成=也会造成同类少记。 - claim 模式差异:自动线性释放(按时间可提取余额)与手动分段 claim 的排查方式不同;手动模式下“没有交易”本身就是未领取的证据。
- 回收路径缺陷:
recoverFailedLock一类函数被状态修饰器永久锁死、或多签/治理缺失,会让超额资金无法退出;审计时应检查“资金多于配额”时的出口。 - 关联卡:Solidity 存储/槽位碰撞类(代理 storage collision、delegatecall slot0)是“不同变量写同一存储”的另一类根因;本卡是同一 mapping 键的业务覆盖。
检测与防御
- 审计/开发:角色地址在构造函数或 initialize 中断言互不相同;
allocate()增加sum(allocations) == totalAllocation不变量;团队与最终储备使用独立 mapping 或带类型/ID 的键,避免共享claimed槽位。 - 部署校验:部署脚本与配置模板中禁止占位地址重复;上线前用测试网跑完整 allocate → 多段 claim → 最终 claim 流程,核对每段金额。
- 链上监控:监控合约余额与
allocations之和的差额;出现“余额远大于可领取总额”告警;监控角色地址是否与已知团队/储备地址一致。 - 应急响应:先看交易历史判断是否未 claim,再按 claim 金额反推配额;保留链上交易与源码证据;评估合约是否有救援函数,必要时通过治理/多签升级或与交易所协作处理。
- 合约设计:为锁仓合约预留受多签/时间锁约束的 emergency withdraw(仅限超额或误转资金),避免单点逻辑错误导致资产永久锁定。