コードのBitcoinタイムスタンプ証明を検証する方法
自分で確認できないタイムスタンプ証明は、ブランディングを強化しただけのベンダーの約束事にすぎません。遅かれ早かれ誰か — 特許紛争の弁護士、デューデリジェンス中の監査人、あるいはあなたの「独立した実装」が独立していないと疑うCTO — が、特定のコミットハッシュが特定の日付に存在したことを示せと要求してきます。その瞬間が検証ステップであり、ほとんどのチームが一度もリハーサルしないステップです。
良いニュースがあります。Timestamp GITを使えば、検証は研究プロジェクトではありません。GitHub Appが毎晩コミットハッシュをアンカリングし、証明の確認はワンクリック、1つのURL、または1回のcurlで済みます。この記事では、正確な検証パス、結果の意味、そしてエッジケースが潜む場所を順に説明します。
検証が重要な理由:信頼から証明へ
主張と証拠には違いがあります:
- 主張とは「これを3月に書いた」というものです。それはあなたが管理するデータベースに存在し、編集できます。
- 証拠とは「この特定のコミットハッシュが、ルートがBitcoinブロックNに埋め込まれたMerkleツリーに含まれていた」というものです。誰でも再計算できます。
コンプライアンス、監査、訴訟においては、証拠にはもう1つ要件があります。それは再現可能で、ベンダーから独立していることです。特定の企業のサーバーが稼働している間しか検証できない証明は、本当の証明ではなく、サブスクリプションです。
Timestamp GITの設計はこれを考慮しています。.otsレシートと公開Bitcoinブロックデータが証明のすべてです。検証パスにプロプライエタリな要素はなく、開発者のマシンにインストールするものもありません。この記事は検証ステップに焦点を絞ります。タイムスタンプを付けるべきかどうかをまだ検討中の場合は、戦略的な根拠は創業者のための先行技術ガイドにあります。
Bitcoinタイムスタンプ証明に実際に含まれるもの
1日分の証明は2つの成果物で構成され、コードと一緒にバージョン管理されるよう専用のtimestampsブランチまたはシャドウリポジトリに保存されます:
- その日にそのリポジトリで収集されたコミットハッシュを列挙したマニフェストファイル(
.txt)。 - あなたのハッシュをBitcoinにアンカリングされたMerkleルートへ結びつけるMerkleパスを含む**
.otsレシートファイル**。
チェーンは次のようになります:
commit hash ─┐
commit hash ─┼─ Merkle tree ─ Merkle root ─ Bitcoin transaction ─ block
commit hash ─┘ │
.ots receipt (Merkle path from your hash to the root)
検証時に重要な2つの性質があります:
- マニフェストはどのハッシュが含まれていたかを証明します。
.otsレシートはMerkleルートがいつチェーンに入ったかを証明します。
アンカリングはOpenTimestampsプロトコルのみを使用し、プロプライエタリなものは一切使わないため、証明は当社がなくなっても存続します。それはSHA-256とBitcoinブロックデータであり、オフラインで永久に検証可能です。
ステップバイステップ:Timestamp GITでタイムスタンプ証明を検証する
1. READMEのバッジから始める
監視対象の各リポジトリは、Shields.ioの検証バッジを表示できます。それは静的な画像ではなくライブポインタであり、そのリポジトリの公開ステータスページにリンクします。埋め込みスニペットはリポジトリ接続ページ(https://timestampgit.dev/connected/{user}/{repo})で生成され、貼り付ける前にライブプレビューが表示されます。
<!-- Paste the snippet generated at /connected/{user}/{repo} -->
[](https://timestampgit.dev/status/OWNER/REPO)
レビュアーがバッジをクリックすると、マーケティングページではなく証拠にたどり着きます。
2. リポジトリのステータスページを読む
次を開きます:
https://timestampgit.dev/status/{user}/{repo}
この公開ダッシュボードは、監査に適したサマリーを提供します:
- 証明の存続期間 — アンカリング履歴がどこまで遡るか。
- 最古のアンカー日 — ハッシュが最初にBitcoinに到達した日。
- 毎日の規則性 — 夜間ジョブが毎日実際に実行されたことの証明。
- アンカーのBitcoinブロックとトランザクションデータ。
- カレンダーヒートマップにより、欠落が視覚的に明らかになります。
- ダウンロード:監査CSVとPDF証明書。
監査人にとって、ヒートマップとCSVがあれば通常は最初のパスには十分です。調査すべきは欠けているマス目です。
3. 特定の日をローカルで検証する
日付レベルの証明には、次を開きます:
https://timestampgit.dev/verification/{user}/{repo}/{date}
このページはMerkleチェーンをステップごとにたどり、あなたのブラウザ内でローカルに計算を実行します。検証する内容は一切送信されません。ゼロ知識の性質は取り込みだけでなく検証にも適用されます。
これは聞こえる以上に重要です。コンプライアンスレビュアーは、ベンダーに追加情報を一切渡すことなく、機密の内部リポジトリを含む証明を確認できます。
4. API経由でMerkleチェーンを取得する
プログラムで検証したい場合(または証拠を自社のコンプライアンスシステムに保存したい場合)、APIは特定の日の完全なMerkleチェーンデータを返します:
curl -s "https://timestampgit.dev/api/verify/OWNER/REPO/2026-11-18" | jq
最後にアンカリングされたブロックと実行中のコミット数も取得できます:
curl -s "https://timestampgit.dev/api/statusLast/OWNER/REPO" | jq
curl -s "https://timestampgit.dev/api/statusCount/OWNER/REPO" | jq
CLIツールも、プロトコルコマンドも、ウォレットソフトウェアも不要です。面倒な処理 — GitHub App Webhookによるコミット検出、バッチ処理、Merkleツリー構築、Bitcoinアンカリング — は夜間にすでに完了しています。
結果の読み方 — そしてエッジケース
有効な証明が意味するのは、狭くて強いことです:このコミットハッシュが、このBitcoinブロックのタイムスタンプ以前に存在したということです。コードが良いこと、すべての行をあなたが書いたこと、誰が入力したかは示しません。ハッシュを超えた authorship は別の問いです。Gitコミットのタイムスタンプは証拠として通用するかの解説でその区別を扱っています。
その他に留意すべき点:
- ブロックタイムスタンプのばらつき。 Bitcoinブロックのタイムスタンプは実時間からわずかにずれることがあります。ブロック自体が不変であるため、証明は暗号学的に強固なままです — 誰も履歴を再マイニングしてあなたのアンカーを動かすことはできません。
- ある日付の証明が欠けている場合。 証明は真夜中から数時間後に書き込まれます:cronワーカーがハッシュをバッチ処理し、Merkleツリーを構築し、公開OTSカレンダーに送信し、Bitcoinの確認を待ちます — 通常は約3時間です。ある日の証明は単にまだ書き込まれていないだけかもしれません。それより古い場合は、その期間にリポジトリが実際に監視されていたかを確認してください。
- プライベートリポジトリ。 プライベートリポジトリのステータスURLには暗号化されたHMACが付与され、そのURLの保有者だけがステータスを閲覧できます。検証自体は引き続きブラウザ内でローカルに行われます。
- セルフホストインスタンス。 各インスタンスは独自のHMACを生成します。SaaSインスタンスから自社のDockerデプロイへバッジを移行する場合は、バッジリンクを再生成してください — あるインスタンスのHMACは別のインスタンスでは検証できません。
SaaSなしでの検証: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ページから期間限定のデモライセンスを利用できます。
セルフホストしても検証の計算は変わりません。.otsファイルとBitcoinブロックデータは同じ成果物であり、オフラインで検証できます。完全に手動で行い、.otsファイルをローカルのBitcoinノードに対して標準のOpenTimestamps検証ツールに渡すこともできます — それは大変な方法ですが、証明がベンダー非依存であるからこそ機能します。製品のビューアとAPIは、それを週末のプロジェクトではなくワンクリックの作業にするだけです。
コンプライアンスのための検証の自動化
検証が四半期レビューのチェックボックスであるなら、自動化しましょう:
- 台帳をエクスポートする。
GET /api/audit/{user}/{repo}は完全な監査台帳をCSVで返します — 監査人がファイルルームで実際に求める成果物です。 - 日次証明書を生成する。
GET /api/report/{user}/{repo}/{date}は特定の日付のPDF証明書を生成します。単一の証明を契約書や紛争申立書に添付する必要がある場合に便利です。 - 鮮度をポーリングする。 あなた側の短いcronジョブが、重要な障害モードを捕捉します:アンカリングが静かに停止すること。
#!/usr/bin/env bash
set -euo pipefail
REPOS=("acme/api" "acme/web" "acme/infra")
for repo in "${REPOS[@]}"; do
printf '%-14s ' "$repo"
curl -s "https://timestampgit.dev/api/statusLast/${repo}" | jq -c '.'
done
毎日実行しましょう。最後にアンカリングされたブロックが進まなくなれば、監査人より先に気づけます。
- ステータスを公開表示する。 Shields.ioバッジを埋め込み、下流のユーザーやクライアントがあなたに何も尋ねることなく検証ステータスを確認できるようにします。
最大限の分離を求めるチーム向けに、Enterprise ZKプランには、あなた自身のCI内で実行されコミットハッシュ以外は何も送信しない短いGitHub Actionが付属します — アンカリングと検証のモデルは同じままで、検証は引き続きローカルで行われます。
FAQ
証明を検証するためにOpenTimestampsコマンドを実行する必要はありますか?
いいえ。Timestamp GITはチェック全体を処理するWebベースの検証ページとREST APIを提供します。希望すれば.otsファイルをダウンロードして標準の検証ツールを使うこともできますが、必須ではありません。
証明が検証可能になるまでどのくらいかかりますか?
証明は毎晩アンカリングされ、数時間後 — 通常は約3時間後 — にBitcoinブロックチェーンで確認されます。今日行ったコミットは翌日には検証可能な証明を持ちます。
プライベートリポジトリの証明を検証できますか?
はい。ただしプライベートリポジトリのステータスページには、URLに付加された暗号化HMACが必要です。認可されたユーザーはアクセスでき、検証自体は引き続きブラウザ内でローカルに行われます。
Timestamp GITがなくなったら?それでも検証できますか?
はい。証明はベンダー非依存です:SHA-256とBitcoinブロックデータのみに依存します。当社のサービスがなくなっても、標準のOpenTimestampsツールで.otsファイルをオフラインで検証できます。
結論
検証とは、タイムスタンプが単なる良いアイデアから防御可能な証拠になる場所です。ワークフローは短いものです:バッジをクリックし、ステータスページを読み、日レベルの検証ビューを開くか、/api/verify/{user}/{repo}/{date}を叩いてMerkleチェーンを自分で確認します。どのパスも同じ結論に至ります — 特定のBitcoinブロックより前に存在したコミットハッシュであり、誰のデータベースも信頼することなく、永久に証明可能です。
まだ始めていなければ、セットアップは退屈な部分です:リポジトリにGitHub Appをインストールし、夜間ジョブを実行させるだけです。明日には最初の検証可能な証明が手に入ります。timestampgit.devにアクセスして、最初のリポジトリを接続してください。