比特币研究快照验证器

「比特币研究快照验证器」使用说明

比特币研究快照验证器让服务器重新读取一个不可变的研究快照，将其 JSON 规范化，重新计算 SHA-256 哈希，并与发布时存储的哈希比较。在引用、重新发布或打包快照之前运行它，以确认记录未被改动。

需要输入

• bir_... 格式的快照 ID（前缀之后为 18–32 个字母、数字、连字符或下划线），或包含该 ID 的链接

会显示什么

• VERIFIED 或 FAILED 结论，以及标题和 ID
• 服务器重新计算的 SHA-256
• 八项检查：JSON 可读、规范化哈希匹配、ID 有效、研究类型有效、存在数据版本、存在方法论版本、创建时间有效、schemaVersion ≥ 1
• 可下载的验证回执，以及打开原始快照链接

使用步骤

1. 粘贴 ID 或快照链接。
2. 点击重新计算并验证。
3. 确认每一项检查都通过。
4. 下载回执并与报告一起保存。

计算公式

规范化 JSON = 在每一层按字母顺序排序键、删除 undefined 值并将非有限数值设为 null 后的载荷。重新计算的哈希 = SHA-256(规范化 JSON) 的十六进制形式。只有重新计算的哈希 = 存储的哈希且全部 8 项检查通过时，结论才为 VERIFIED。

计算示例

你粘贴了一个幂律回测快照的链接。七项检查通过，但 canonicalHashMatches 未通过，因此结论为 FAILED：8 项必须全部通过。全部通过时，下载 ID-verification.json 回执并附在报告中。

如何解读结果

• canonicalHashMatches 是核心检查，确认载荷与记录的哈希一致。
• 其他检查验证元数据，例如 ID 格式以及是否属于 5 种研究类型之一。
• 回执中的哈希必须与引用的哈希逐字符一致。

限制与注意事项

• 哈希匹配只能证明完整性，不能证明模型或结论正确。
• 它不会重新运行回测或任何计算。
• 错误包括 invalid_snapshot_id 和 snapshot_not_found；API 允许每个 IP 每分钟 120 次请求。

常见问题

它会重新运行回测吗？

不会。它只重新规范化、重新计算哈希并检查元数据。

什么是规范化 JSON？

在每一层都对键进行排序的 JSON，使相同内容始终得到相同的哈希。

可以通过 API 验证吗？

可以：GET /api/bitcoin-research-verify?id=bir_... 返回相同的回执，无需密钥。