Timestamp GIT

← All posts

2026-11-05

ブラウザでビットコインタイムスタンプ証明を検証する方法

ブラウザでビットコインタイムスタンプ証明を検証する方法
timestamp git blockchain proof

ブラウザでBitcoinタイムスタンプ証明を検証する方法

タイムスタンプ証明は、誰かが検証した瞬間に初めて価値を持ちます。それまでは、立派な名前の付いたファイルにすぎません — ブランチに置かれた.otsレシート、READMEのバッジ、誰も開かなかったPDF。あなたの先行技術が法務レビュー、支払い紛争、デューデリジェンス監査を生き残るかどうかを決める問いは、ごく狭いものです。第三者が、ベンダーに保証を求めることなく、この正確なコミットハッシュが特定の日付より前に存在していたことを確認できるか?

それを解決するのがブラウザベースの検証です。この記事では、Timestamp GIT証明をエンドツーエンドで検証する方法を解説します — 成果物に何が含まれているのか、どのページとエンドポイントを使うのか、そして結果が有効・保留中・失敗のいずれかのときにどう読み解くのか。これはBitcoinトランザクションの講義ではありません。マネージドワークフローの要点は、そのレイヤーに一切触れないことです。

ブラウザベースの検証が重要な理由

検証とは、暗号学的タイムスタンプが主張から証拠に変わる瞬間です。それ以前のすべて — コミットのハッシュ化、マニフェストのバッチ処理、BitcoinへのMerkleルートのアンカリング — は機械的な処理です。証明は受け手側で検証できるか、できないかのどちらかです。

そのチェックにブラウザが適している理由は2つの特性にあります。

計算はローカルに留まります。 Timestamp GITの検証ページは、Merkleチェーンのすべてのステップをあなたのブラウザ内で実行します。どのリポジトリ、どの日付、どのコミットを検証しているのかを誰も見ることはできません。ベンダーにとっては奇妙な設計ですが、ゼロ知識証明システムにとっては唯一正しい設計です。あなたは証拠を検証しているのであって、判定を求めているのではありません。

インストール不要、信頼の丸投げも不要。 コンプライアンスチームや外部弁護士は、ブランチをgit cloneしてツールをコンパイルしたりはしません。彼らが必要とするのは、毎回同じ答えを出す、独立して繰り返し可能なチェックです。URLとブラウザがあればそれができます。CIでチェックをスクリプト化したいなら、公開APIエンドポイントでも同じことができます。

これが重要なのは、代替手段 — ベンダーのダッシュボードを信頼すること — こそが、まさにあなたが逃れようとしているものだからです。内部ログがそもそも監査でなぜ退けられるのかについては、Git Commit Timestamps Aren’t Tamper-Proof — What Isを参照してください。

Bitcoinタイムスタンプ証明に実際に含まれるもの

何かを検証する前に、自分が何を手にしているのかを知っておきましょう。ある日のTimestamp GIT証明は、3つの階層化された成果物で構成されています。

  • 日次マニフェスト — あるリポジトリについてその日にアンカリングされたコミットハッシュを列挙した、プレーンな.txtファイル。ハッシュのみを含み、コードは決して含みません。
  • .otsレシート — マニフェストのSHA-256ハッシュを特定のBitcoinブロックに結びつけるOpenTimestamps証明。
  • Merkleチェーン — 両者を結ぶ構造。個々のコミットハッシュがリーフ、マニフェストがその1つ上のレベル、MerkleルートがBitcoinに埋め込まれる単一の値です。

つまり検証とは、そのチェーンを正しい方向に登っていくことです。コミットハッシュを取り、マニフェストの指定に従って兄弟ノードと結合し、マニフェストハッシュを生成し、その.otsレシートをBitcoinブロックヘッダーに対してチェックします。

決定的に重要な特性は、レシートがベンダー非依存であることです。SHA-256と公開されたBitcoinブロックデータのみを使用します。仮にTimestamp GITが明日消滅しても、レシートはオープンツールを使ってブロックチェーンに対して検証できます。これはマーケティングの決まり文句ではなく、証明フォーマットに対する制約であり、ブラウザ検証が誠実であり得る理由です。

これらのファイルは専用のtimestampsブランチ(または別のシャドウリポジトリ)に置かれるため、ソースの内容を一切公開することなく、コードと一緒にバージョン管理されます。

ステップバイステップ:ブラウザで証明を検証する

「リポジトリがある」から「これが監査人が保管できる成果物だ」までの全手順は次のとおりです。

1. リポジトリのステータスページから始める

リポジトリの公開ステータスページを開きます。

https://timestampgit.dev/status/{user}/{repo}

ここが概要であり、最初の疑問のほとんどに答えてくれます。証明の寿命(チェーンがどこまで遡れるか)、最も早いアンカリング日、アンカリングが毎日規則的に行われてきたかどうか、そして各日のBitcoinブロックとトランザクションデータです。カレンダーヒートマップがあるので、欠落は一目でわかります。さらに、完全な監査台帳(CSV)とPDF証明書のダウンロードも可能です。

機械可読なサマリーだけが必要なら、公開ステータスエンドポイントが同じ主要な数値を返します。

curl -s https://timestampgit.dev/api/statusLast/acme/payments-service
curl -s https://timestampgit.dev/api/statusCount/acme/payments-service
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-service

2. 特定の日付の検証ページを開く

実際の証明チェックには、関心のある日付に移動します。

https://timestampgit.dev/verification/{user}/{repo}/{date}

このページは、Merkleチェーンの各レベルをステップごとに案内します — コミットハッシュからマニフェストへ、マニフェストからMerkleルートへ、MerkleルートからBitcoinブロックへ。すべてのハッシュはあなたのブラウザ内で再計算されます。あなたのチェックに関する情報は一切送信されないため、機密リポジトリにも使えます。

これは弁護士に送るべきページです。アカウントもCLIも不要で、OpenTimestampsとは何かの説明も要りません。

3. バッジを公開エントリーポイントとして使う

埋め込み可能なバッジは、同じことの手間の少ない版です。READMEに1つ追加すれば、監査人、買収企業、相手方弁護士など誰でも、あなたのリポジトリ構造を知らなくても検証へクリックでたどり着けます。

/connected/{user}/{repo}のバッジ埋め込みウィジェットでは、ライブプレビューとMarkdownスニペットが得られます。バッジ自体はサマリーエンドポイントに裏打ちされているため、静的な画像ではなく実際にアンカリングされたデータを反映します。

バッジはセキュリティ上の判断ではなく、開示に関する判断です。タイムスタンプを取得していることを公開するのであって、あなたが何を書いたかを公開するのではありません。

4. 公開APIでプログラム的に検証する

CIパイプラインやコンプライアンススクリプト向けに、Merkleチェーンデータを取得してローカルで検証します。

curl -s "https://timestampgit.dev/api/verify/acme/payments-service/2026-10-14" \
  -o chain.json

レスポンスにはその日の完全なチェーンが含まれます。あとはスクリプトがハッシュを自身で再計算します — ブラウザページが実行するのと同じ計算です。

// Node 18+ — recompute each Merkle step locally, never trust the server's answer
import { createHash } from "node:crypto";

const sha256 = (hex) =>
  createHash("sha256").update(Buffer.from(hex, "hex")).digest("hex");

const chain = JSON.parse(await readFile("chain.json", "utf8"));

// Walk leaf -> root. Each step concatenates the current hash with its sibling,
// hashes the pair, and continues. The final value must equal the anchored root.
let current = sha256(commitSha);
for (const step of chain.steps) {
  const [left, right] = step.order === "lr" ? [current, step.sibling] : [step.sibling, current];
  current = sha256(left + right);
}

console.log(current === chain.merkleRoot ? "PROOF OK" : "PROOF MISMATCH");

これを自分で行う意味は、スクリプト化されたチェックがチェック自体の再現可能な証拠になることであり、ダッシュボードが正しく描画されるかに依存しないことです。

5. PDF証明書をダウンロードする

メールや契約書に添付するものが必要な場合、ステータスページは日付ごとのPDF証明書を提供しており、直接取得することもできます。

https://timestampgit.dev/api/report/{user}/{repo}/{date}

また、単一日ではなく完全な台帳が必要な場合:

curl -s https://timestampgit.dev/api/audit/acme/payments-service -o audit.csv

結果の解釈とエッジケースへの対応

有効な証明には正確な意味があり、それは一般に想定されているより狭いものです。

  • 有効な証明が示すこと: このコミットハッシュが、そのBitcoinブロックの時刻以前に存在していたこと。それ以上でもそれ以下でもありません。コードがコンパイルできること、独創的であること、優れていることを示すものではありません。先行技術とは存在とタイミングに関するものです。
  • 「保留中」の意味: 夜間ワーカーが真夜中以降にハッシュをバッチ処理し、Merkleツリーを構築し、ルートをアンカリングします。その後Bitcoinの承認に数時間 — 通常は約3時間 — かかり、承認されると証明ファイルがあなたのリポジトリに書き戻されます。今日のコミットは通常、翌日まで最終的な証明を持ちません。
  • プライベートリポジトリ: プライベートリポジトリのステータスURLには、サーバーインスタンス固有の暗号化されたHMACが含まれるため、認可されたユーザーのみがステータスを読めます。検証は引き続きブラウザ内でローカルに実行され、基になる.otsレシートとマニフェストはリポジトリの内容を公開せずにチェックできます。
  • 証明が失敗した場合: まず当たり前のことを確認しましょう — 正しいリポジトリ、正しい日付、正しいマニフェスト。.otsレシートは、それが作成されたマニフェストハッシュに対してのみ検証されます。別の日のマニフェストと組み合わせると、正しく、かつ紛らわしく失敗します。
  • エアギャップ環境: Dockerセルフホストライセンスは、検証UIとAPIを含むスタック全体をあなた自身のインフラ上で実行するため、検証がネットワーク外に出ることはありません。

Timestamp GITが検証を自動化する仕組み

上記のすべてが週末のプロジェクトではなく1つのページで済むのは、アンカリングが完全にマネージドだからです。監視対象のリポジトリにGitHub Appを一度インストールすれば、毎晩すべてのコミットが自動的にBitcoinへアンカリングされます。CLIツールも、手動のプロトコル手順も、開発者のマシンで実行するものもありません — だからこそこのワークフローは、誰かがやるのを覚えているかどうかに依存しないのです。

その背後では、パイプラインがコミットハッシュをキューでバッチ処理し、真夜中にリポジトリごとのマニフェストファイルにグループ化し、Merkleツリーを構築し、公開カレンダーに対してOpenTimestamps証明を作成し、ルートをBitcoinにアンカリングします。その後、証明ファイルはtimestampsブランチまたはシャドウリポジトリにプッシュされます。ソースをサービスから完全に遠ざけておく必要があるチーム向けに、Enterprise ZKモードでは、あなた自身のインフラからコミットハッシュのみをプッシュする12行のGitHub Actionを使用します — サービスはソースリポジトリへの読み取りアクセスなしで検証可能な証明を生成します。

セルフホスト検証が必要な場合、クイックスタートの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

Bitcoinタイムスタンプ証明を検証するためにソフトウェアをインストールする必要はありますか? いいえ。Timestamp GITの検証ページは完全にブラウザ内で動作し、公開APIエンドポイントはローカルチェック用のMerkleチェーンデータを返します。希望すれば、.otsレシートをダウンロードして標準のOpenTimestampsツールでオフライン検証することもできます。

Timestamp GITを信頼せずに証明を検証できますか? はい。証明はSHA-256とBitcoinブロックデータのみに依存するため、ベンダー非依存です。Timestamp GITがもはや存在しなくても、オープンツールを使って.otsレシートをBitcoinブロックチェーンに対して検証できます。

証明のBitcoinトランザクションがまだ承認されていない場合はどうなりますか? Bitcoinの承認には通常約3時間かかります。トランザクションがブロックで承認されるまで証明は保留中であり、承認後は不変となり、ブラウザで検証できるようになります。

プライベートリポジトリの証明を検証するにはどうすればよいですか? プライベートリポジトリのステータスURLには暗号化されたHMACが含まれるため、認可されたユーザーのみが閲覧できます。また、timestampsブランチから.otsレシートとマニフェストをダウンロードし、リポジトリデータを公開せずにローカルで検証することもできます。

まとめ

ブラウザ検証は、タイムスタンプを内部記録から、あなたを信頼しない人に手渡せるものへと変えるものです — 紛争において重要なのは、まさにそういう相手だけです。チェックにはURLと日付、そして数秒のローカルハッシュ計算が必要なだけで、ベンダーのデータベースではなくBitcoinにアンカリングされた答えを生み出します。

まだ設定していない場合、手順は短いものです。GitHub App経由でリポジトリをTimestamp GITに接続し、夜間ジョブにコミットをアンカリングさせ、ステータスページを開いて1つの日付をエンドツーエンドで検証します。その1回の検証成功が、「ログはある」と「証明がある」の違いです。まずCLIなしのセットアップを知りたい場合は、次にHow to Timestamp Git Commits Without the Command Lineをお読みください。

関連記事

EU label: AI-generated content