第五部分 · 证据与收尾

证据、源码匹配与 P0 收尾

整理:Kang页面发布:链上快照:,区块 12117419

「我有代码」和「我能证明链上运行的就是这份代码」是两回事;「测试全过」和「没有漏洞」也是两回事。

P0 是什么

Phase 0(P0)是对前面所有 Sepolia 实验的技术复核与收尾:链上只读核对、源码与存储布局审查、Foundry 测试、源码公开验证的准备,最后列出需要拍板的决策 D-01 到 D-05。它是项目自己做的复核,不是第三方专业审计证书。

结论:PASS WITH FINDINGS

级别 数量 条目
Critical 0 —
High 0 —
Medium 1 F-V3-001:type(uint256).max 授权溢出,没有无限授权
Low 3 F-V3-002 粉尘截断(当前链上未触发);F-V3-003 注入粉尘时可见之和可偏离;F-ALLOW-001 MBox-Burn 遗留授权(已由 D-01 撤销)
Info 6 事件单位(历史日志是旧单位);中心化升级权;未使用的 onlyOwner;V1/V2 源码无法按当前文件精确复现;npm audit(工具链);公共 RPC 无 archive

没有发现会导致当前测试资产被盗、被铸造或权限失控的 Critical / High 问题。

测试分层:每一层回答不同的问题

三层:单元测试 49/49 通过;Fuzz 9 项各 1000 次通过;Invariant 256 次运行乘 100 次调用共 25,600 次调用,4 条不变量通过。右侧提醒测试之外还要看链上证据和源码匹配。底部:全部通过不等于没有漏洞,仍有 1 Medium、3 Low、6 Info。
图 7|

P0 用了多层测试,但每一层都有边界和盲区。

在新窗口打开大图
类别 实际参数 结果 正确理解
单元测试 一次运行 49 / 49 通过(Counter 5、MBox 9、MBox-Burn 9、UBOX V1 6、V2 6、V3 14) 已经写下的具体用例通过
Fuzz 每项 1000 runs,seed 0x5030 9 / 9 通过 在大量随机输入下断言成立
Invariant 256 runs × 100 calls = 25,600 次调用 1 套 4 条不变量通过 在这套测试策略下,目标性质没有被打破

测试使用 Foundry 1.9.0,账户只用测试框架生成的地址,没有使用本地私钥;没有为了让测试变绿去修改生产合约逻辑。

两个值得讲的小插曲

  • Fuzz 曾失败两次:原因是测试预言机(测试里计算「期望结果」的代码)的断言顺序有问题。修好的是测试,合约没有改。这说明:测试失败不一定是合约有 bug,也可能是测试本身写错了。
  • 16 次 Handler 意外回退:Invariant 测试中,batchTransferFrom 被调用 3,166 次,其中 16 次(约 0.5%)出现了 Handler 没有预料到的回退。整笔 Handler 调用回滚,不变量仍然成立。P0 把它判断为测试脚手架(预言机边界)的残留,而不是合约漏洞;更稳妥的做法是以后做一个最小复现,确认它属于预期约束。

源码匹配:Sourcify 与 Etherscan

部署到链上的是字节码,不是源码。源码验证就是用同样的编译参数重新编译你提交的源码,如果得到的字节码与链上一致,就公开源码并标记已验证。(怎样申请 Etherscan API 密钥,见附录 B。)

Sourcify:8 个地址全部匹配

Sourcify 有两种常见结果:exact_match(完全匹配,连元数据都一致)和 match(字节码匹配,但元数据不完全一致)。8 个地址里 5 个 exact_match、3 个 match,不能统称「全部完全匹配」。

为什么 V1、V2 只能 match?因为第 14 章为了 V3 改过 V1 的源码,而当时工作区还没有 Git 历史,无法取回部署时的那一份。P0 重建了历史源码,使字节码主体与链上一致,但元数据(含源码哈希)对不上。重建的源码作为单独的历史快照保存,没有覆盖当前源码。

Etherscan:已提交,快照时仍在排队

8 个合约的源码都通过 Etherscan API V2(chainid=11155111)提交,都拿到了提交编号(GUID)。但到 2026-11-12 15:39(新加坡时间),状态查询仍然是 Pending in queue,getsourcecode 仍显示未验证。不能把它写成已经验证成功。 代理关联(verifyproxycontract)返回成功,识别出实现是 V3,但注明 implementation saved (unverified - without ABI)。

拿到 GUID 只代表「已经排队」,不代表「已经通过」。

V4:只在本地,没有上链

决策 D-04 在本地设计了 UBOX V4,用来修复 F-V3-001 和粉尘问题:

  • 存储兼容:_scale 仍在 slot 58,新变量 _v4Initialized 追加在 slot 59,不重排旧槽。
  • initializeV4() 只执行一次,不重新铸币;实现合约构造时锁定初始化。
  • type(uint256).max 作为无限授权的哨兵:存储时不缩放,使用时不递减。
  • 新增 dustOf 和 sweepDust:把不可见的粉尘挪到另一个地址,总供应不变。
  • 测试:单元 10/10 通过;Fuzz 3/3 × 1000(seed 0x5030)通过;对最新 Sepolia 状态的 fork 模拟通过(部署约 2,777,602 gas,升级约 72,181 gas;升级后供应 100、A 99.99、B 0.01,粉尘为 0)。

V4 没有部署、没有签名、没有广播。 Fork 模拟不产生真实交易,也没有交易哈希。快照时 UBOX 代理仍然指向 V3。

决策状态

决策 内容 结果
D-01 撤销 MBox-Burn 遗留授权 已上链完成(区块 12117312,第 11 章)
D-02 向 Etherscan 提交源码验证 8 份已提交;快照时仍在排队,未确认通过
D-03 用重建的历史源码验证 V1/V2 Sourcify match,非 exact
D-04 UBOX V4 仅本地开发、测试与 fork 模拟,未上链
D-05 本地 Git 归档 已建立本地仓库(根提交 516dcf6);没有 remote,没有推送

一条可重复的证据链

  1. 找到地址和部署/升级交易,确认网络是 Sepolia(chainId 11155111)。
  2. 找到对应的编译参数、源文件和元数据,理解 exact match 和 match 的差别。
  3. 读取代理当前的实现地址,不要把历史实现当成当前版本。
  4. 对需要证明的状态变化,在目标区块附近核对交易、事件和存储读取。
  5. 记录来源、时间、区块高度、命令、结果和不确定的地方。

这一步就像检查 App 升级:不只看安装包的版本,还要核对线上真正运行的版本、配置,以及迁移后的用户数据。

P0 的边界

  • 公共 RPC 没有 archive 数据,所以无法对升级前的历史区块做 fork;P0 改为在本地重建升级路径,并如实注明(没有把没做的 fork 写成通过)。
  • 静态分析工具 Slither 没有运行(未安装,属于可选项)。
  • 下一轮只需追踪 D-02 的最终结果,并复现那 16 次 Handler 回退,不必无限延长 P0。