Timestamp GIT

← All posts

2026-10-12

如何独立验证 Git 提交时间戳

如何独立验证 Git 提交时间戳
timestamp git blockchain proof

如何独立验证 Git 提交时间戳

无法自行核查的时间戳不是证明——而是供应商的承诺。一旦有人要求你证明代码在某个时间点就已存在,这一区别就至关重要:无论是合规审计员、专利纠纷中的对方律师,还是进行技术尽职调查的收购方。

本文介绍如何使用 Timestamp GIT 的证明产物和工具独立验证 Git 提交时间戳:公共状态页面、基于浏览器的 Merkle 验证页面、REST API、验证徽章以及可下载的报告。无需任何源代码离开你的代码仓库,也无需信任任何人——包括供应商——结果依然成立。

为什么独立验证很重要

每一个加密时间戳的强度,都取决于你能否按自己的方式审计它。

  • 验证不能依赖供应商是否存续。 Timestamp GIT 的证明仅依赖 SHA-256 和比特币区块数据。即使服务已不复存在,你也可以离线验证它们。
  • 监管机构、审计员和法院期望可复现的证据。 “仪表盘上是这么显示的”不是证据。与比特币区块匹配的 Merkle 根才是。
  • 尽职调查会提出尖锐的问题。 在收购或融资过程中,知识产权的成熟度会受到审查。能够交出可验证的证明链,与交出一张截图截然不同。
  • 你的源代码保持私密。 验证只需要两样东西:证明文件(清单和 .ots 收据)以及公开的区块链数据。不需要你的实现,也不需要你的商业机密。

本文的其余部分就是这份实用清单。

Timestamp GIT 证明是什么样的

一天的提交会产生一组小而明确的产物:

  • 每日清单文件(.txt),包含当天为该仓库收集的提交哈希。
  • Merkle 根,基于清单计算得出。该根是代表批次中每一个提交的单一值。
  • .ots 收据文件——一份 OpenTimestamps 证明,将该 Merkle 根以加密方式链接到特定的比特币区块。

这些产物存放在专用的 timestamps 分支或影子仓库中,刻意与你的源代码分离。这种分离正是关键所在:证明独立于它所保护的代码而流转。

除了这些文件,记录还包含锚定该批次的比特币区块高度和交易 ID。正是这两个值让任何人——你、律师、外部审计员——都能确认数据在该区块被挖出时就已存在。

分步指南:使用 Timestamp GIT 的工具进行验证

时间戳是自动生成的:安装一次 GitHub App,连接仓库,每晚每个提交都会被锚定,无需任何手动步骤。验证则是你接手的地方——你有五种方式可以完成。

1. 公共状态页面

打开 https://timestampgit.dev/status/{user}/{repo}。该仪表盘显示:

  • 证明的持久性和最早的锚定日期,
  • 每日规律性(日历热力图让缺口一目了然),
  • 每个锚定的比特币区块高度和交易 ID。

这是最快的健全性检查。如果对方质疑连续性,热力图就是答案。

2. 基于浏览器的验证页面

要查看特定某一天,请访问 https://timestampgit.dev/verification/{user}/{repo}/{date}。该页面逐步展示多级 Merkle 链,并且所有计算都在你的浏览器中本地进行——零知识。没有人能看到你验证了什么,这在仓库本身属于机密时非常有用。

这是可以在审计员面前打开的页面,因为链的每一级都被展示出来,而非仅仅给出摘要。

3. 验证 API

当验证需要脚本化或归档时,拉取原始链:

curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-10-05" \
  -H "Accept: application/json" | jq .

响应包含当天时间戳的完整 Merkle 链数据,因此你可以在本地重新计算,而不必信任渲染出来的页面。

4. 验证徽章

在仓库连接页面上,你会获得一个可嵌入的 Shields.io 徽章及其 markdown 代码片段。把它放进你的 README:

[![Timestamped with Bitcoin](BADGE_URL)](BADGE_LINK)

点击徽章的任何人都会进入你仓库的验证视图。这是一个公开的、始终最新的存在性证明声明——而且由于该链接指向可验证的数据而非静态图片,它不仅仅是装饰。

5. 报告和审计导出

两个端点覆盖了文书工作方面:

# Per-day PDF certificate
curl -sL "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-10-05" \
  -o certificate-2026-10-05.pdf

# Full audit ledger as CSV
curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
  -o audit-ledger.csv

PDF 是你附在法律文件上的东西。CSV 是你输入内部审计档案或交给尽职调查团队的电子表格的东西。

请注意,私有仓库会在其 URL 后附加加密的 HMAC,因此只有授权用户才能打开其状态和验证页面。底层的证明没有改变——它仍然锚定在比特币中,任何持有证明文件的人仍然可以验证。

解读验证结果和边缘情况

验证成功意味着一个具体的事情:你从清单重新计算出的 Merkle 根,与 .ots 收据所引用的比特币区块中锚定的值相匹配。这一匹配证明这组提交哈希在该区块的时间戳之前就已存在。谁运行检查、在哪里运行都无关紧要。

在向任何人承诺验证结果之前,有四种边缘情况值得了解:

  • 当天很可能还无法验证。 锚定每晚运行,而比特币确认需要几个小时(通常约 3 小时)。今天提交的证明可能还不存在,前一晚的批次可能仍在等待确认。请围绕这个时间窗口安排审计。
  • 私有仓库需要 HMAC。 验证的工作方式与公共仓库完全相同,但 URL 带有特定于服务器实例的加密 HMAC。没有 HMAC,就没有状态页面。
  • 时间戳证明存在性,而非作者身份。 该证明表明某个提交哈希在特定时间存在。它本身并不能确定是谁编写了代码,也不能证明代码具有新颖性。请将其用作现有技术证据,而非所有权链的替代品。
  • 任何人都可以验证,即使没有 Timestamp GIT。 由于证明建立在开放标准之上,一个有足够动力的工程师可以用标准的 OpenTimestamps 工具对照比特币区块链验证 .ots 文件。这是一个特性:它意味着你的证据在供应商消失后依然有效。

不使用 SaaS 进行验证:困难的方式(以及为什么你不需要它)

原则上你可以自己搭建这条流水线——运行 OpenTimestamps 工具、查询比特币节点、手动核对 Merkle 证明。但在实践中,这意味着要为一个并非你产品的任务维护基础设施和专业知识。

Timestamp GIT 的存在就是为了让你不必这么做。在一个受监控的仓库上安装一次 GitHub App,每晚每个提交都会自动锚定到比特币中——无需 CLI,无需手动步骤,无需协议知识。验证则是一个链接、一个徽章或一次 API 调用。对于需要将所有内容保留在自己硬件上的组织,可以通过 Docker 镜像进行自托管:

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 并配置实例。

在工作流中自动化验证

手动验证对于纠纷来说没问题。对于持续的合规性,请将其自动化。

以锚定状态作为 CI/CD 的门禁。 组合摘要端点正是为此设计的:

curl -sf "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api" -o summary.json
cat summary.json

一个小检查脚本就能把它变成构建门禁:

import json
import sys
import urllib.request

URL = "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"

with urllib.request.urlopen(URL) as response:
    summary = json.load(response)

print(json.dumps(summary, indent=2))

# Fail loudly if the summary reports no anchored Bitcoin block yet.
if not any("block" in key.lower() for key in summary):
    sys.exit("No Bitcoin anchor reported for this repository yet.")

把它接入一个定时工作流,这样缺失的锚定就会变成一张工单,而不是审计期间的意外:

name: Timestamp anchor check
on:
  schedule:
    - cron: "0 8 * * *"
  workflow_dispatch:

jobs:
  verify-anchor:
    runs-on: ubuntu-latest
    steps:
      - name: Check anchor status
        run: |
          curl -sf "https://timestampgit.dev/api/statusSummary/${{ github.repository_owner }}/${{ github.event.repository.name }}" \
            -o summary.json
          cat summary.json

按计划归档证明。 每月拉取审计 CSV 并存储到你的记录系统中:

curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
  -o "audit-ledger-$(date +%Y-%m).csv"

发布徽章。 它只需在 README 中占一行,就能让对方向自助核查你的声明。

如果要求仓库内容不进入服务,Enterprise ZK 部署模式会在你自己的基础设施上运行一个简短的 GitHub Action,将提交哈希推送到 Timestamp GIT API。验证行为相同;只有摄取路径发生变化。

常见问题

我需要信任 Timestamp GIT 才能验证时间戳吗? 不需要。证明仅依赖 SHA-256 和比特币区块数据。即使 Timestamp GIT 已不复存在,你也可以使用 .ots 文件和标准 OpenTimestamps 工具对照比特币区块链独立验证它。

提交时间戳需要多久才能变得可验证? 在每晚的锚定过程之后,证明会被写入你的仓库。比特币确认通常需要约 3 小时,之后时间戳就不可变且可验证。

我可以验证私有仓库的时间戳吗? 可以。私有仓库使用附加在 URL 后的加密 HMAC,因此只有授权用户才能访问状态页面和验证工具。底层证明仍然锚定在比特币中,任何持有证明文件的人都可以验证。

Timestamp GIT 提供哪些验证工具? 一个公共状态页面、一个在本地计算一切的基于浏览器的验证页面、用于 Merkle 链数据和审计报告的 REST API 端点,以及可嵌入的 Shields.io 徽章。所有这些都设计用于无需供应商参与的独立验证。

结论

独立验证是时间戳与营销声明的分水岭。使用 Timestamp GIT,你可以从状态页面获取证明链,在浏览器中重新计算 Merkle 路径,在 CI 中脚本化同样的检查,并为文件导出 PDF 证书——所有这些都无需暴露一行源代码。

如果你希望在自己的仓库上运行这一切,托管服务只需一次性设置:安装 GitHub App,连接仓库,然后让每晚的锚定完成其余工作。对于气隙或自托管需求,Docker 自托管许可证也覆盖了这条路径。从 timestampgit.dev 开始,亲自验证一个仓库。

相关文章

EU label: AI-generated content