如何在浏览器中验证比特币时间戳证明
时间戳证明只有在有人验证的那一刻才有价值。在那之前,它只是一个名字好听的文件——分支里的一份 .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 提交打时间戳。