如何在本地验证比特币时间戳证明
你的时间戳分支里躺着一个 .ots 文件,而一位律师、一位审计员,或者你自己那颗怀疑的心想知道:这东西真的能证明什么吗,还是只是供应商塞给你的一个文件?
这个问题正是密码学时间戳的全部意义所在。一份只有签发者才能验证的证明算不上证明——那只是一个承诺。本文逐步介绍如何使用 Timestamp GIT 内置的验证工具在本地验证比特币时间戳证明。无需命令行工具,无需信任我们的服务器,而且——如果你想更进一步——完全无需依赖 Timestamp GIT 的存在。
为什么本地验证很重要
大多数软件存证都是"信我就行"式的文件。供应商签一份 PDF,声明"是的,这个提交在该日期存在"。如果供应商倒闭、被收购,或者悄悄更换了签名密钥,你的证据就变弱了。那份证明从来就不真正属于你。
比特币锚定的证明运作方式不同。Timestamp GIT 通过 OpenTimestamps 协议,使用公共 OTS 日历,将提交哈希嵌入比特币区块链。验证路径只使用 SHA-256 和比特币区块数据——没有专有密码学,没有秘密配方。这意味着:
- 证明比供应商更长寿。 即使 Timestamp GIT 明天消失,
.ots收据及其引用的比特币区块仍然可以被任何人验证。 - 验证默认在本地进行。 Timestamp GIT 的网页验证器在你的浏览器中运行全部计算。没有人能看到你验证了什么,也无需任何服务器响应即可得出结论。
- 合规团队认可它。 在法律审计中,"我们的内部日志是这么说的"往往被视为自说自话而不予采信。一条终止于特定比特币区块头的 Merkle 路径则是另一类证据。
简而言之:如果验证需要信任签发者,那么存在性证明的全部价值就崩塌了。而在这里并非如此。
如果你想了解为什么现有技术需要密码学锚定的概念背景,请参阅什么是密码学现有技术?软件团队指南。本文讲的是验证这一机械动作本身。
Timestamp GIT 证明长什么样
当你安装 GitHub App 并连接一个仓库后,每个提交都会进入夜间批次。最终你会得到:
- 一个
.ots收据文件。 一份紧凑的密码学证明,证明某个 Git 提交哈希——或者更准确地说,覆盖一天批次哈希的 Merkle 根——在某个特定时间点存在。 - 每个仓库一份清单
.txt文件。 当天批处理的提交哈希列表。 - 一个专用的时间戳分支或影子仓库。 证明会被推送回你自己的基础设施中,可以放在源仓库内,也可以放在单独的目标仓库中。
每份证明对应一个每日批次。流水线将所有待处理的提交哈希分组,原生构建 Merkle 树,针对公共 OTS 日历创建 OpenTimestamps 证明,并将 Merkle 根锚定到一笔比特币交易中。
就验证而言,.ots 文件是自包含的:它包含从你的提交哈希一直到被锚定的根的 Merkle 路径,以及对包含该锚定的比特币区块头的引用。你不需要 Timestamp GIT 的数据库就能检查它。
有一个容易让人困惑的时间问题:比特币确认需要几个小时——通常大约 3 小时。因此证明写入步骤会在午夜 cron worker 运行几小时后完成。刚提交的提交无法立即验证。请参阅下文的解读结果与边缘情况。
分步指南:在本地验证你的证明
第 1 步:获取 .ots 文件
它已经在你的仓库里了。查看时间戳分支,或者如果你配置了证明与源代码分开存放,就查看影子仓库。你也可以通过仓库列表从 Timestamp GIT 仪表板中拉取它。
第 2 步:使用基于浏览器的验证器
导航到你的仓库和日期对应的验证页面:
https://timestampgit.dev/verification/{user}/{repo}/{date}
这是一个分步、多层次的 Merkle 链验证。每一次哈希计算都在你的浏览器中本地进行——页面不会把你的数据发送到任何地方,也没有人能看到你验证了什么。你会看到链条从你的提交哈希展开,经过中间 Merkle 节点,一直到根和比特币区块引用。
这是大多数开发者和合规审查者应该走的路径。无需 CLI 工具,无需比特币节点。
第 3 步(可选):使用标准 OpenTimestamps 工具验证
.ots 格式是开放的。如果你的流程要求完全独立的工具链——或者你只是更喜欢这样——你可以拿收据文件,使用标准 OpenTimestamps 验证工具和比特币节点或轻客户端对照比特币区块链进行检查。这是"硬核方式",而且完全可选。该证明在设计上就是供应商无关的:只涉及 SHA-256 和比特币区块数据。
第 4 步:确认结果
一次成功的检查会给你两个具体输出:
- 你的 Merkle 根被锚定所在的比特币区块高度。
- 区块时间戳,它确定了你的提交哈希可能存在的时间上限。
这就是你的证据:不是"Timestamp GIT 这么说",而是"这个哈希可证明地包含在一棵 Merkle 树中,而该树的根被提交在比特币区块 N 中"。
使用 Timestamp GIT 的内置验证工具
除了按日期验证器之外,还有三个工具值得了解。
公共状态页面
https://timestampgit.dev/status/{user}/{repo}
这是一个公共仪表板,显示证明的存续时间、你最早的锚定日期、每日规律性、每个锚定背后的比特币区块和交易数据,以及覆盖情况的日历热力图。如果你正在对一个仓库做尽职调查——无论是你自己的还是别人的——从这里开始。它还提供可下载的审计 CSV 和 PDF 证书。
验证页面
上文已介绍,但作为主要工具值得再次强调:
https://timestampgit.dev/verification/{user}/{repo}/{date}
针对某一天时间戳的 Merkle 链验证,在浏览器中进行。
徽章和证书
可嵌入的徽章可用于你的 README,公开显示验证状态。任何人都可以点击徽章附带的链接,通过网站验证时间戳。对于审计材料包,可下载特定日期的 PDF 证书。
如果你的仓库是私有的,请注意私有仓库会在 URL 后附加一个加密的 HMAC——该 HMAC 特定于服务器实例,因此只有授权用户才能看到该仓库的状态。你的验证流程不变;只是 URL 被限定了范围。
解读结果与边缘情况
成功验证究竟意味着什么
它证明该提交哈希在比特币区块时间戳之时或之前存在。不是"恰好在那时",也不是"代码是那时写的"——它证明该哈希不晚于那个区块就已经存在。对于现有技术目的而言,这正是你需要的断言:你在日期 X 当天或之前就拥有这个制品。
待处理的证明
如果你在提交后的第二天早上检查仓库,发现证明看起来不完整,这是正常的。夜间 cron worker 会批处理哈希、构建树并锚定它;随后比特币确认需要几个小时(通常约 3 小时)。一旦确认,时间戳就不可更改。等一等,然后再检查——没有任何东西坏掉。
零知识边界
验证操作的是提交哈希,从不涉及你的源代码。Timestamp GIT 从不会看到、复制或存储你的实际源代码。证明确认某个哈希存在;它不会透露代码内容的任何信息。这是有意为之的,也正是为什么同一套验证流程对闭源和商业秘密仓库同样适用。
出问题时
- 缺少
.ots文件 —— 从时间戳分支、影子仓库或你的仪表板中取回它。 - 收据损坏 —— 从仓库或仪表板重新下载;比特币一侧的锚定数据不受影响,因此收据的新副本即可恢复验证。
希望暴露面更小的团队
Timestamp GIT 的托管 GitHub App 是零配置路径——对源仓库只读访问,对目标仓库读写访问,证明自动落地。对于连提交哈希都不想让服务读取的团队,Enterprise ZK 模式走的是另一条路:一个 12 行的 GitHub Action 在你的基础设施上运行,只把提交哈希推送到 Timestamp GIT API。你的源代码永远不会离开你的环境。
为合规自动化验证
对于一次性审计,手动检查就够了。如果你在做持续合规,就把它接入 CI 或你的内部工具。
通过 API 获取验证数据
特定日期的完整 Merkle 链:
curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-09-14" \
-o verify-2026-09-14.json
公共状态端点(无需认证):
# Last anchored Bitcoin block info
curl -s "https://timestampgit.dev/api/statusLast/acme-corp/payments-api"
# Total stamped commit count
curl -s "https://timestampgit.dev/api/statusCount/acme-corp/payments-api"
# Combined summary, useful for Shields.io badges
curl -s "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"
拉取审计账本和证书
# Full audit ledger as CSV
curl -s "https://timestampgit.dev/api/audit/acme-corp/payments-api" -o audit.csv
# PDF certificate for a single date
curl -s "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-09-14" \
-o certificate-2026-09-14.pdf
一个最小的 CI 护栏——如果最近的锚定已过期就让构建失败——看起来是这样的:
#!/usr/bin/env bash
set -euo pipefail
REPO_PATH="acme-corp/payments-api"
LAST=$(curl -s "https://timestampgit.dev/api/statusLast/${REPO_PATH}")
BLOCK=$(echo "$LAST" | python3 -c "import sys,json; print(json.load(sys.stdin).get('blockHeight',''))")
if [ -z "$BLOCK" ]; then
echo "No anchored Bitcoin block found for ${REPO_PATH}. Check nightly anchoring."
exit 1
fi
echo "Latest anchor confirmed in Bitcoin block ${BLOCK}"
使用 Docker 进行气隙验证
为了最高安全性和气隙环境,Timestamp GIT 提供 Docker 镜像。一个快速入门的 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 证明需要运行任何命令行工具吗? 不需要。Timestamp GIT 提供一个基于网页的验证器,在你的浏览器中本地执行所有计算。如果你愿意,也可以使用标准 OpenTimestamps 工具,但这不是必需的。
一份证明需要多长时间才能变得可验证? 在夜间锚定之后,比特币交易需要几个小时(通常约 3 小时)才能确认。一旦确认,证明立即可验证。
我可以在不信任 Timestamp GIT 的情况下验证证明吗?
可以。.ots 文件包含所有必要的密码学数据,你可以使用开源工具对照比特币区块链进行验证。Timestamp GIT 的验证器也在本地运行,因此无需信任我们的服务器。
如果我丢失了 .ots 文件怎么办?
你可以从仓库的时间戳分支或影子仓库中取回它。如果你是 Timestamp GIT 用户,也可以从你的仪表板下载它。
结论
本地验证就是"一家公司这么告诉我的"和"我自己对照比特币区块链检查过了"之间的区别。使用 Timestamp GIT,检查部分只需四步、零 CLI 工具:拿到 .ots 文件,打开验证页面,读取区块高度,完成。繁重的工作——提交检测、夜间批处理、Merkle 树构建、OTS 日历提交、比特币锚定,以及将证明推送回你的仓库——在安装 GitHub App 后都会自动进行。
从 timestampgit.dev 开始,在一个仓库上安装 GitHub App,明天验证你的第一份证明。对于私有仓库和持续合规工作流,Pro Agency 和 Enterprise ZK 计划涵盖了其余部分。