第五部分 · 证据与收尾
证据、源码匹配与 P0 收尾
「我有代码」和「我能证明链上运行的就是这份代码」是两回事;「测试全过」和「没有漏洞」也是两回事。
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 问题。
测试分层:每一层回答不同的问题
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,不能统称「全部完全匹配」。
| 合约 | 地址 | 结果 |
|---|---|---|
| Counter | 在 Sepolia Etherscan 查看地址(新窗口打开): 0xAf6f88Cf8bf6e9211CD11B375AECBa37d61CD00f | exact_match |
| MBox | 在 Sepolia Etherscan 查看地址(新窗口打开): 0xc4B187783f074111EbeFC50B9a1901f2a4F94630 | exact_match |
| MBox-Burn | 在 Sepolia Etherscan 查看地址(新窗口打开): 0x2AE6BbE8b524381535D1f443fe95018b1f64e3F2 | exact_match |
| UBOX V3 实现 | 在 Sepolia Etherscan 查看地址(新窗口打开): 0x16E3D2f25e28253b467C66c462973e4ca86fad28 | exact_match(用部署时的源码快照) |
| UBOX 代理 | 在 Sepolia Etherscan 查看地址(新窗口打开): 0xc3F20D5488784D922aC3428a54125715fA98db04 | exact_match |
| ProxyAdmin | 在 Sepolia Etherscan 查看地址(新窗口打开): 0x6DEAe6C7fAa9fabe1983082277922CDcf90BBEE9 | match |
| UBOX V1 实现 | 在 Sepolia Etherscan 查看地址(新窗口打开): 0xdaBaDC03042B010eFF67Bf2553798d75e817300a | match(用重建的历史源码) |
| UBOX V2 实现 | 在 Sepolia Etherscan 查看地址(新窗口打开): 0x0711Ef7C97b061fd3C87026ad38703dd253E779F | 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,没有推送 |
一条可重复的证据链
- 找到地址和部署/升级交易,确认网络是 Sepolia(chainId 11155111)。
- 找到对应的编译参数、源文件和元数据,理解 exact match 和 match 的差别。
- 读取代理当前的实现地址,不要把历史实现当成当前版本。
- 对需要证明的状态变化,在目标区块附近核对交易、事件和存储读取。
- 记录来源、时间、区块高度、命令、结果和不确定的地方。
这一步就像检查 App 升级:不只看安装包的版本,还要核对线上真正运行的版本、配置,以及迁移后的用户数据。
P0 的边界
- 公共 RPC 没有 archive 数据,所以无法对升级前的历史区块做 fork;P0 改为在本地重建升级路径,并如实注明(没有把没做的 fork 写成通过)。
- 静态分析工具 Slither 没有运行(未安装,属于可选项)。
- 下一轮只需追踪 D-02 的最终结果,并复现那 16 次 Handler 回退,不必无限延长 P0。