Timestamp GIT

← All posts

2026-10-16

如何在本地验证比特币时间戳证明

如何在本地验证比特币时间戳证明
timestamp git blockchain proof

如何在本地验证比特币时间戳证明

你的时间戳分支里躺着一个 .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 任务运行几小时后才完成。刚提交的提交无法立即验证。请参阅下方的解读结果与边缘情况。

分步操作:在本地验证你的证明

第 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 任务会批处理哈希、构建树并锚定它;随后比特币确认需要几个小时(通常 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 计划涵盖了其余部分。

相关文章

EU label: AI-generated content