如何在浏览器中验证比特币时间戳证明
时间戳证明只有在被验证的那一刻才有价值。在此之前,它不过是一个名字好听的文件——分支里的一个 .ots 收据、README 里的一个徽章、一份没人打开过的 PDF。决定你的在先技术能否经受法律审查、付款纠纷或尽职调查审计的,是一个很具体的问题:第三方能否在不要求供应商背书的情况下,确认这个确切的提交哈希在某个特定日期之前就已存在?
这正是基于浏览器的验证所解决的问题。本文从头到尾演示如何验证一个 Timestamp GIT 证明——这些产物包含什么、使用哪些页面和端点,以及当结果为有效、待定或失败时该如何解读。这不是一堂比特币交易课;托管工作流的全部意义就在于你永远不需要接触那一层。
为什么基于浏览器的验证很重要
验证是密码学时间戳从一项声明变成证据的时刻。在此之前的一切——对提交进行哈希、批量处理清单、将 Merkle 根锚定到比特币——都只是机器运转。证明要么在另一端验证通过,要么不通过。
有两个特性使浏览器成为执行这项检查的合适场所:
计算在本地完成。 Timestamp GIT 的验证页面在你的浏览器中执行 Merkle 链的每一步。没有人知道你正在检查哪个仓库、哪个日期或哪个提交。对供应商来说这会是一种奇怪的设计;对零知识证明系统来说,这是唯一正确的设计。你是在验证证据,而不是在请求裁决。
无需安装,无需冒险信任。 合规团队和外部律师不会去 git clone 一个分支再编译工具。他们需要一种独立、可重复、每次都能得出相同答案的检查方式。一个 URL 加一个浏览器就能做到。如果你更愿意在 CI 中脚本化这项检查,公共 API 端点同样可以做到。
这一点很重要,因为替代方案——信任供应商的仪表盘——恰恰是你要摆脱的东西。关于内部日志为何在审计中一开始就会被驳回,请参阅 Git 提交时间戳并非防篡改——那什么才是。
比特币时间戳证明究竟包含什么
在验证任何东西之前,先弄清楚你手里拿的是什么。某一天的 Timestamp GIT 证明由三个分层产物组成:
- 每日清单——一个纯
.txt文件,列出某仓库当天被锚定的提交哈希。它只包含哈希,从不包含代码。 .ots收据——一份 OpenTimestamps 证明,将清单的 SHA-256 哈希与某个特定比特币区块关联起来。- Merkle 链——连接两者的结构。你的单个提交哈希是叶子节点,清单是上一层级,而 Merkle 根是被嵌入比特币的单一值。
因此,验证意味着沿正确方向攀爬这条链:取你的提交哈希,按清单的指定与其兄弟节点组合,生成清单哈希,然后对照比特币区块头检查 .ots 收据。
关键特性在于该收据是供应商无关的。它只使用 SHA-256 和公开的比特币区块数据。如果 Timestamp GIT 明天消失了,该收据仍可使用开放工具对照区块链进行验证。这不是营销口号——这是对证明格式的约束,也正是浏览器验证能够做到诚实的原因。
这些文件存放在一个专用的 timestamps 分支(或单独的影子仓库)中,因此它们与你的代码一起被版本控制,同时绝不会暴露源代码内容。
分步操作:在浏览器中验证证明
以下是从"我有一个仓库"到"这是审计人员可以留存的产物"的完整路径。
1. 从仓库状态页开始
打开该仓库的公共状态页:
https://timestampgit.dev/status/{user}/{repo}
这是你的概览页,能回答大多数首要问题:证明的存续时长(链能追溯到多久以前)、最早的锚定日期、锚定是否每日且规律,以及每天的比特币区块和交易数据。页面上有日历热力图,缺口一目了然,还可以下载完整的审计账本(CSV)和一份 PDF 证书。
如果你只需要机器可读的摘要,公共状态端点会返回相同的核心数字:
curl -s https://timestampgit.dev/api/statusLast/acme/payments-service
curl -s https://timestampgit.dev/api/statusCount/acme/payments-service
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-service
2. 打开特定日期的验证页面
要进行实际的证明检查,请前往你关心的日期:
https://timestampgit.dev/verification/{user}/{repo}/{date}
该页面会带你逐步走完 Merkle 链的每一层——从提交哈希到清单,从清单到 Merkle 根,从 Merkle 根到比特币区块。每个哈希都在你的浏览器中重新计算。关于你的检查的任何信息都不会被传输,这正是它可用于机密仓库的原因。
这就是可以发给律师的页面。它不需要账户、不需要 CLI,也不需要解释什么是 OpenTimestamps。
3. 使用徽章作为公共入口
可嵌入的徽章是同一功能的低门槛版本。在你的 README 中添加一个,任何人——审计人员、收购方、对方律师——都可以点击进入验证,而无需了解你的仓库结构。
位于 /connected/{user}/{repo} 的徽章嵌入组件会提供实时预览以及 Markdown 代码片段。徽章本身由摘要端点提供支持,因此它反映的是真实的锚定数据,而不是静态图片。
徽章是一个披露决策,而非安全决策:它们暴露的是你确实在做时间戳,而不是你写了什么。
4. 使用公共 API 以编程方式验证
对于 CI 流水线或合规脚本,拉取 Merkle 链数据并在本地验证:
curl -s "https://timestampgit.dev/api/verify/acme/payments-service/2026-10-14" \
-o chain.json
响应包含当天的完整链。你的脚本随后自行重新计算哈希——与浏览器页面运行的数学完全相同:
// Node 18+ — recompute each Merkle step locally, never trust the server's answer
import { createHash } from "node:crypto";
const sha256 = (hex) =>
createHash("sha256").update(Buffer.from(hex, "hex")).digest("hex");
const chain = JSON.parse(await readFile("chain.json", "utf8"));
// Walk leaf -> root. Each step concatenates the current hash with its sibling,
// hashes the pair, and continues. The final value must equal the anchored root.
let current = sha256(commitSha);
for (const step of chain.steps) {
const [left, right] = step.order === "lr" ? [current, step.sibling] : [step.sibling, current];
current = sha256(left + right);
}
console.log(current === chain.merkleRoot ? "PROOF OK" : "PROOF MISMATCH");
自己动手做的意义在于,脚本化的检查本身就是检查的可复现证据,而且它不依赖于仪表盘能否正确渲染。
5. 下载 PDF 证书
当你需要一些可以附在邮件或合同里的东西时,状态页提供按日期生成的 PDF 证书,也可以直接访问:
https://timestampgit.dev/api/report/{user}/{repo}/{date}
如果需要完整账本而非单日记录:
curl -s https://timestampgit.dev/api/audit/acme/payments-service -o audit.csv
解读结果与处理边界情况
有效的证明有精确的含义,而且比人们想象的要窄。
- 有效证明说明了什么: 这个提交哈希在该比特币区块的时间或之前就已存在。仅此而已,不多不少。它不说明代码能否编译、是否原创、是否优秀。在先技术关乎的是存在性和时间。
- "待定"是什么意思: 夜间任务在午夜后对哈希进行批量处理,构建 Merkle 树,并锚定根。随后比特币确认需要数小时——通常约 3 小时——确认后证明文件会被写回你的仓库。今天的提交通常要到第二天才会有最终证明。
- 私有仓库: 私有仓库的状态 URL 包含一个特定于服务器实例的加密 HMAC,因此只有授权用户才能读取状态。验证仍在浏览器本地运行,底层的
.ots收据和清单可以在不暴露仓库内容的情况下进行检查。 - 如果证明失败: 先检查那些不起眼的事情——仓库对不对、日期对不对、清单对不对。
.ots收据只能对照它创建时所针对的清单哈希进行验证;将其与另一天的清单配对会正确地失败,但失败得令人困惑。 - 气隙环境: Docker 自托管许可证在你自己的基础设施上运行整个技术栈——包括验证 UI 和 API——因此验证永远不会离开你的网络。
Timestamp GIT 如何让验证自动化
上述所有内容之所以只是一个页面而不是一个周末项目,是因为锚定是完全托管的。你在受监控的仓库上安装一次 GitHub App,之后每晚每个提交都会自动锚定到比特币中。无需 CLI 工具,无需手动协议步骤,开发者的机器上无需运行任何东西——这也是该工作流不依赖于任何人记得去执行的原因。
在这背后,流水线将提交哈希批量放入队列,在午夜将它们按仓库分组为清单文件,构建 Merkle 树,针对公共日历创建 OpenTimestamps 证明,并将根锚定到比特币中。随后证明文件被推回 timestamps 分支或影子仓库。对于需要源代码完全不被服务触及的团队,Enterprise ZK 模式使用一个 12 行的 GitHub Action,仅从你自己的基础设施推送提交哈希——服务在不具备源代码仓库读取权限的情况下生成可验证的证明。
如果你需要自托管验证,一个快速启动的 Docker Compose 配置如下:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
启动后应用可通过 http://localhost:8080 访问;首次启动时的设置向导会引导你连接 GitHub App 并配置实例。用于评估的限时演示许可证可从 Docker License 页面获取。
常见问题
验证比特币时间戳证明需要安装任何软件吗?
不需要。Timestamp GIT 的验证页面完全在你的浏览器中运行,公共 API 端点会返回 Merkle 链数据以供本地检查。如果你愿意,也可以下载 .ots 收据并使用标准 OpenTimestamps 工具离线验证。
我可以在不信任 Timestamp GIT 的情况下验证证明吗?
可以。证明仅依赖 SHA-256 和比特币区块数据,因此与供应商无关。即使 Timestamp GIT 不复存在,你也可以使用开放工具对照比特币区块链验证 .ots 收据。
如果我的证明对应的比特币交易尚未确认怎么办? 比特币确认通常需要约 3 小时。在交易被区块确认之前,证明处于待定状态;确认之后,它变得不可篡改,并可在你的浏览器中验证。
如何验证私有仓库的证明?
私有仓库的状态 URL 包含加密的 HMAC,因此只有授权用户才能查看。你也可以从 timestamps 分支下载 .ots 收据和清单,并在不暴露仓库数据的情况下本地验证。
结论
浏览器验证将时间戳从内部记录转变为可以交给不信任你的人的凭据——而在纠纷中,这是唯一重要的受众。这项检查只需要一个 URL、一个日期和几秒钟的本地哈希计算,它给出的答案锚定在比特币中,而不是供应商的数据库里。
如果你还没有设置好,流程很短:通过 GitHub App 将仓库连接到 Timestamp GIT,让夜间任务锚定你的提交,然后打开状态页并从头到尾验证一个日期。那一次成功的验证,就是"我们有日志"和"我们有证明"之间的区别。如果你想先了解无需 CLI 的设置,接下来请阅读 如何在没有命令行的情况下为 Git 提交打时间戳。