Filecoin 共识罚没条件取反:time-offset fault 误判正常出块并漏判真实故障
blockchain/consensus · verified
一句话结论
Filecoin(lotus)的共识罚没校验在判断 time-offset mining fault 时把“两个区块的 parents 相同”写成了 !CidArrsEqual(...),导致不同 parents、不同高度的正常出块被误判为故障而可能被罚没,同时真正的同 parents 不同高度故障被漏判;lotus v1.3.0 将条件修正为 CidArrsEqual 并修正另一处错误提示。
原理
- Filecoin 的
VerifyConsensusFault识别三类矿工故障: - double-fork mining fault:同一矿工在相同高度产生两个不同 CID 的区块;
- time-offset mining fault:同一矿工在不同高度出块,但两个区块有相同的 parent tipset(相当于在同一父集上分叉出不同高度);
- parent-grinding fault:A、C 同高同 parents,B 的 parents 包含 C 不包含 A,用来证明 B 漏掉了 A。
- 正确判断 time-offset 的条件是
CidArrsEqual(blockA.Parents, blockB.Parents) && blockA.Height != blockB.Height:parents 相同才说明是在同一父集上“时间偏移”出块。 - 漏洞代码写成
!CidArrsEqual(blockA.Parents, blockB.Parents) && blockA.Height != blockB.Height:只要 parents 不同且高度不同就判 fault,而这是正常链上出块的常见形态;同时真正同 parents 不同高度的故障因为条件取反而漏判。 - 后果:诚实矿工可能被错误罚没(损失质押/算力),真实作恶者反而逃过罚没,属于共识层罚没逻辑的完整性问题。修复提交为 lotus
8354bd91...(PR #1988,目标分支 v1.3.0),并顺带把 blockB 校验失败提示中的first改为second。
触发条件
- 目标 Filecoin 节点/lotus 版本存在该条件取反缺陷(v1.3.0 之前的相关版本)。
- 存在
VerifyConsensusFault调用路径(罚没举证/仲裁),且提交的 blockA/blockB 满足 parents 不同、高度不同。 - 罚没逻辑被链上/仲裁方采信,错误扣罚矿工抵押。
利用步骤
- 审计目标 lotus 版本
chain/vm/syscalls.go的VerifyConsensusFault,确认 time-offset 条件是否为!CidArrsEqual。 - 构造/选取两个 parents 不同、高度不同的正常区块作为 blockA、blockB,调用罚没举证流程。
- 观察仲裁结果:若被判定为
ConsensusFaultTimeOffsetMining,说明误判成立,可按流程罚没诚实矿工。 - 反向验证:构造同 parents、不同高度的真实 time-offset 故障,观察是否漏判(未被罚没)。
- 修复验证:升级到 v1.3.0 后重复步骤,条件应恢复正确行为。
PoC
原文给出修复 diff:
// 修复前
if !types.CidArrsEqual(blockA.Parents, blockB.Parents) && blockA.Height != blockB.Height {
consensusFault = &runtime.ConsensusFault{
Target: blockA.Miner,
Epoch: blockB.Height,
Type: runtime.ConsensusFaultTimeOffsetMining,
}
}
// 修复后
if types.CidArrsEqual(blockA.Parents, blockB.Parents) && blockA.Height != blockB.Height {
...
}
- 原文未给出链上罚没交易的完整复现;需在本地 lotus 测试网构造区块与举证交易。
- 三类 fault 的判定代码(double-fork/time-offset/parent-grinding)均可在
syscalls.go中对照审计。
变体与关联
- 同类“条件取反/漏判”在共识罚没、Slash 逻辑中危害大:误罚没诚实节点会破坏经济安全,漏判会纵容双签/分叉。
- 共识层逻辑缺陷可对照 [[blockchain-consensus-rpc-setminercoinbase-address-validation-missing]]、[[blockchain-consensus-dpos-deterministic-shuffle-ddos-consecutive-fork-double-spend]]。
检测与防御
- 升级到修复版本;对罚没判定条件做单元测试覆盖三类 fault 的正反例。
- 罚没前增加人工复核/多实现交叉校验,避免单点逻辑错误直接扣罚质押。
- 监控异常罚没事件与漏罚没案例,保留举证区块与判定日志。