Bitcoinタイムスタンプ証明をローカルで検証する方法
timestampsブランチに.otsファイルがあり、弁護士、監査人、あるいはあなた自身の懐疑的な頭脳が知りたがっている——これは実際に何かを証明しているのか、それともベンダーが渡してきた単なるファイルなのか?
この問いこそが暗号学的タイムスタンプの核心です。発行者のみが検証できる証明は証明ではなく、約束にすぎません。この記事では、Timestamp GITの組み込み検証ツールを使って、Bitcoinタイムスタンプ証明をローカルで検証する方法をステップバイステップで解説します。コマンドラインツールは不要、当社のサーバーを信頼する必要もなく、さらに踏み込みたいならTimestamp GITが存在することにまったく依存しない方法もあります。
なぜローカル検証が重要なのか
ほとんどのソフトウェア証明は「俺を信じろ」的な文書です。ベンダーが「はい、このコミットはこの日に存在していました」と書いたPDFに署名する。ベンダーが倒産したり、買収されたり、署名鍵をこっそり変更したりすれば、あなたの証拠は弱くなります。その証明は決して本当にあなたのものではなかったのです。
Bitcoinにアンカーされた証明は仕組みが異なります。Timestamp GITは、公開OTSカレンダーを使用してOpenTimestampsプロトコル経由でコミットハッシュをBitcoinブロックチェーンに埋め込みます。検証経路はSHA-256とBitcoinブロックデータのみを使用し、独自の暗号技術も秘密のソースもありません。つまり:
- 証明はベンダーより長生きする。 たとえTimestamp GITが明日消滅しても、
.otsレシートとそれが参照するBitcoinブロックは誰でも検証可能なままです。 - 検証はデフォルトでローカル。 Timestamp GITのWeb検証ツールはすべての計算をブラウザ内で実行します。誰もあなたが何を検証しているか見えず、結論に達するのにサーバーの応答も必要ありません。
- コンプライアンスチームも受け入れる。 法的監査において「社内ログにそう書いてある」は自己都合とみなされ却下されることがよくあります。特定のBitcoinブロックヘッダーで終端するMerkleパスは、別カテゴリの証拠です。
要するに、検証に発行者への信頼が必要なら存在証明の価値はすべて崩壊します。ここではそうではありません。
先行技術になぜ暗号学的アンカーが必要なのかという概念的背景については、暗号学的先行技術とは?ソフトウェアチームのためのガイドで扱っています。この記事は検証という機械的な行為についてです。
Timestamp GITの証明とはどのようなものか
GitHub Appをインストールしてリポジトリを接続すると、すべてのコミットが夜間バッチに取り込まれます。最終的に得られるものは:
.otsレシートファイル。 特定のGitコミットハッシュ——正確には、1日分のハッシュバッチをカバーするMerkleルート——が特定の時点で存在していたことを示すコンパクトな暗号学的証明。- リポジトリごとのマニフェスト
.txtファイル。 その日にバッチ処理されたコミットハッシュのリスト。 - 専用のtimestampsブランチまたはシャドウリポジトリ。 証明はソースリポジトリ内、または別のターゲットリポジトリ内のいずれか、あなた自身のインフラにプッシュバックされます。
各証明は日次バッチに対応します。パイプラインは保留中のすべてのコミットハッシュをグループ化し、Merkleツリーをネイティブに構築し、公開OTSカレンダーに対してOpenTimestamps証明を作成し、MerkleルートをBitcoinトランザクションにアンカーします。
.otsファイルは検証目的では自己完結しています。コミットハッシュからアンカーされたルートまでのMerkleパスと、アンカーを含むBitcoinブロックヘッダーへの参照が含まれています。チェックするのにTimestamp GITのデータベースは必要ありません。
人を戸惑わせるタイミングの注意点:Bitcoinの確認には数時間——通常3時間程度——かかります。そのため証明書き込みステップは深夜のcronワーカー実行の数時間後に完了します。新しいコミットは即座には検証できません。以下の結果の解釈とエッジケースを参照してください。
ステップバイステップ:証明をローカルで検証する
ステップ1:.otsファイルを入手する
それはすでにリポジトリにあります。timestampsブランチ、または証明をソースとは別に置くよう設定した場合はシャドウリポジトリを確認してください。Timestamp GITダッシュボードのリポジトリ一覧から取得することもできます。
ステップ2:ブラウザベースの検証ツールを使う
リポジトリと日付の検証ページに移動します:
https://timestampgit.dev/verification/{user}/{repo}/{date}
これはステップバイステップの多段Merkleチェーン検証です。すべてのハッシュ計算はブラウザ内でローカルに行われ、ページはあなたのデータをどこにも送信せず、誰もあなたが何を検証しているか見えません。コミットハッシュから中間Merkleノードを経てルートとBitcoinブロック参照までチェーンがほどけていくのが見えます。
これはほとんどの開発者とコンプライアンスレビュアーが取るべき経路です。CLIツール不要、Bitcoinノード不要。
ステップ3(任意):標準のOpenTimestampsツールで検証する
.ots形式はオープンです。あなたのプロセスが完全に独立したツールチェーンを要求する場合——あるいは単にそうしたい場合——レシートファイルを標準のOpenTimestamps検証ツールとBitcoinノードまたは軽量クライアントを使ってBitcoinブロックチェーンに対してチェックできます。これが「難しい方法」であり、完全に任意です。証明は設計上ベンダー非依存です。関与するのはSHA-256とBitcoinブロックデータのみです。
ステップ4:結果を確認する
チェックが成功すると2つの具体的な出力が得られます:
- MerkleルートがアンカーされたBitcoinブロック高。
- ブロックタイムスタンプ。これはあなたのコミットハッシュが存在し得た時点の上限を確立します。
これがあなたの証拠です。「Timestamp GITがそう言っている」ではなく、「このハッシュはBitcoinブロックNにルートがコミットされたMerkleツリーに証明可能に含まれている」ということです。
Timestamp GITの組み込み検証ツールを使う
日付ごとの検証ツール以外に、知っておく価値のあるツールが3つあります。
公開ステータスページ
https://timestampgit.dev/status/{user}/{repo}
これは証明の寿命、最古のアンカー日、日次の規則性、各アンカーの背後にあるBitcoinブロックとトランザクションデータ、カバレッジのカレンダーヒートマップを表示する公開ダッシュボードです。リポジトリのデューデリジェンスを行うなら——自分のものでも他人のものでも——ここから始めてください。ダウンロード可能な監査CSVとPDF証明書も公開しています。
検証ページ
上で扱いましたが、主要ツールとして再掲する価値があります:
https://timestampgit.dev/verification/{user}/{repo}/{date}
特定の1日のタイムスタンプに対する、ブラウザ内でのMerkleチェーン検証。
バッジと証明書
検証ステータスを公開表示するための埋め込み可能なバッジがREADME用に利用できます。誰でもバッジに添付されたリンクをクリックして、ウェブサイト経由でタイムスタンプを検証できます。監査パケット用には、特定の日付のPDF証明書をダウンロードしてください。
リポジトリがプライベートの場合、プライベートリポジトリはURLに暗号化されたHMACを付加することに注意してください——HMACはサーバーインスタンス固有であるため、認可されたユーザーのみがそのリポジトリのステータスを見られます。検証ワークフローは変わりません。URLのスコープが限定されるだけです。
結果の解釈とエッジケース
検証成功が実際に意味すること
それはコミットハッシュがBitcoinブロックのタイムスタンプ以前に存在していたことを証明します。「正確にその時」でも「その時にコードが書かれた」でもありません——そのハッシュが遅くともそのブロックまでに存在していたことを証明します。先行技術の目的には、これこそが必要な主張です。あなたはこの成果物を日付X以前に持っていた、と。
保留中の証明
コミットの翌朝にリポジトリをチェックして証明が不完全に見えても、それは想定内です。夜間のcronワーカーがハッシュをバッチ処理し、ツリーを構築し、アンカーします。その後Bitcoinの確認に数時間(通常3時間程度)かかります。一度確認されれば、タイムスタンプは不変です。待ってから再チェックしてください——何も壊れていません。
ゼロ知識の境界
検証はコミットハッシュに対して行われ、あなたのソースコードに対しては決して行われません。Timestamp GITはあなたの実際のソースを見たり、コピーしたり、保存したりしません。証明はハッシュが存在したことを確認するもので、コードの中身については何も明かしません。これは意図的なものであり、同じ検証フローがクローズドソースや営業秘密のリポジトリでも機能する理由です。
問題が起きたとき
.otsファイルが見つからない — timestampsブランチ、シャドウリポジトリ、またはダッシュボードから取得してください。- レシートが破損している — リポジトリまたはダッシュボードから再ダウンロードしてください。Bitcoin側のアンカーされたデータは影響を受けないため、レシートの新しいコピーで検証が復元されます。
さらに露出を減らしたいチーム
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ページで氏名、会社名、メールアドレス、任意の電話番号を入力して申請でき、発行され次第デモライセンスファイルをダウンロードできます。
FAQ
Timestamp GITの証明を検証するのにコマンドラインツールを実行する必要がありますか? いいえ。Timestamp GITはすべての計算をブラウザ内でローカルに実行するWebベースの検証ツールを提供しています。好みであれば標準のOpenTimestampsツールも使えますが、必須ではありません。
証明が検証可能になるまでどのくらいかかりますか? 夜間のアンカーリング後、Bitcoinトランザクションが確認されるまでに数時間(通常3時間程度)かかります。一度確認されれば、証明は即座に検証可能です。
Timestamp GITを信頼せずに証明を検証できますか?
はい。.otsファイルには必要な暗号学的データがすべて含まれており、オープンソースツールを使ってBitcoinブロックチェーンに対して検証できます。Timestamp GITの検証ツールもローカルで実行されるため、当社のサーバーへの信頼は不要です。
.otsファイルを失った場合はどうなりますか?
リポジトリのtimestampsブランチまたはシャドウリポジトリから取得できます。Timestamp GITユーザーであれば、ダッシュボードからダウンロードすることもできます。
結論
ローカル検証は「会社がそう言った」と「Bitcoinブロックチェーンに対して自分で確認した」の違いです。Timestamp GITなら、確認作業は4ステップ、CLIツールはゼロ:.otsファイルを取得し、検証ページを開き、ブロック高を読み取る、以上です。面倒な作業——コミット検出、夜間バッチ処理、Merkleツリー構築、OTSカレンダーへの送信、Bitcoinアンカーリング、証明のリポジトリへのプッシュバック——はGitHub Appをインストールすれば自動的に行われます。
timestampgit.devから始めて、1つのリポジトリにGitHub Appをインストールし、明日最初の証明を検証してください。プライベートリポジトリと継続的コンプライアンスワークフローについては、Pro AgencyとEnterprise ZKプランが残りをカバーします。