Timestamp GIT

← All posts

2026-10-26

GitHubのすべてのコミットにビットコインタイムスタンプを自動付与

GitHubのすべてのコミットにビットコインタイムスタンプを自動付与
timestamp git blockchain proof

すべてのGitHubコミットにBitcoinタイムスタンプを自動付与する

あなたのコミットには暗号学的な存在証明がふさわしいと判断したのですね。素晴らしい。ここからが退屈な部分です。明日も、明後日も、チームが触れるすべてのリポジトリに対して、それを繰り返さなければなりません。

タイムスタンプの取り組みの多くが静かに頓挫するのは、まさにここです。アイデアが間違っているからではなく、手作業の面倒事——コミットハッシュをバッチ化し、カレンダーサービスに送信し、証明ファイルを世話し、それをコミットし直す——が実際のスプリントと両立しないからです。GitHubリポジトリのブロックチェーンタイムスタンプを自動化したいなら、タイムスタンプはgit pushの副作用であるべきで、誰かが金曜日に思い出して行うタスクであってはなりません。

この記事では、自動化の道筋を最初から最後まで解説します。1回のインストール、触れることのない夜間パイプライン、そして証明が実際にBitcoinに記録されたかどうかを教えてくれるモニタリングです。

手動タイムスタンプがスケールしない理由

コミットにタイムスタンプを付ける面倒な方法は、毎回手作業で行うことです。あなたは以下に責任を負うことになります。

  • どのコミットにスタンプを付ける価値があるかを判断する(すべてに価値がある、それが問題なのです)。
  • コミットごとに1つのBitcoinトランザクションを作らないよう、自分でハッシュをバッチ化する。
  • 公開カレンダーに送信し、保留中の証明が確認されるまで追跡する。
  • 結果の証明ファイルを耐久性のある場所に保存し、正しいコミットに紐付ける。
  • 明日も、そしてforce-push、ホットフィックス、マージトレインのたびに、すべてを繰り返す。

スクリプト化したとしても、それは片手間の仕事です。誰かがスクリプト、cronランナー、保存場所、そして「先週の証明がなぜないのか」というインシデントを担当しなければなりません。そしてその人がチームを移った瞬間に、パイプラインは腐っていきます。

素のOpenTimestampsプロトコルは実にエレガントです——その仕組みはOpenTimestampsの代替: すべてのコミットに対応するマネージドGitHub Appで読むことができます。この記事が扱うのは別の問題、つまりそれを無人のまま永遠に動かし続けることです。

目標は設定して忘れることです。監視対象のリポジトリへのすべてのコミットが毎晩アンカーされ、開発者の介入も、誰かのラップトップへのインストールも不要です。

一度きりのセットアップ: GitHub Appをインストールする

Timestamp GITはGitHub Appを中心に構築されたマネージドサービスです。セットアップは数分で完了し、アカウントまたは組織ごとに一度だけ行います。

1. アプリをインストールする。 Timestamp GITのダッシュボードから、個人アカウントまたは組織にGitHub Appをインストールします。

2. リポジトリを選択する。 すべてのリポジトリか、特定のサブセットを選びます。選択は後から再インストールせずに調整できます。

3. 権限を確認する。 権限モデルは意図的に狭く設計されています。

アクセス スコープ 理由
読み取り専用 ソースリポジトリ GitHubの権限システムには「コミットハッシュのみ」というスコープがないため、アプリはHEADコミットハッシュを確認するために読み取りアクセスを必要とする
読み書き ターゲットリポジトリ 証明はマニフェストファイルと.otsレシートとして、専用ブランチまたはシャドウリポジトリに書き戻される

4. あとは放っておく。 追加するYAMLも、ローテーションするシークレットも、インストールするCLIもありません。開発者は今まで通りにコミットを続けるだけで、アプリがバックグラウンドでwebhookに反応します。

リポジトリが公開であれば、オープンソースティアがこれを標準でカバーします。プライベートリポジトリはPro Agencyティアから始まります——料金の内訳では、どのティアがどのようなチーム形態に合うかを解説しています。

より厳格な代替手段: Enterprise ZKモード

標準モードでは、ソースリポジトリへの読み取りアクセスが必要です。ポリシーがそれを禁じている場合、あるいは単に第三者がコードを読める状態を望まない場合は、Enterprise ZKモードが方向性を反転させます。プルする代わりに、あなたの側がプッシュします。12行のGitHub Actionが自社インフラ上で実行され、コミットハッシュのみをTimestamp GIT APIに送信します。ソースは環境の外に出ず、サービスはソースリポジトリへの読み取りアクセスを一切必要としません。書き込みアクセスが必要なのは(証明が書き込まれる)ターゲットリポジトリのみです。

自動パイプライン: コミットからBitcoinまで

セットアップ後、あなたが何もせずとも次のことが起こります。

1. コミットの検出。 新しいコミットは、GitHub Appのwebhook(標準モード)またはGitHub Actionがプッシュしたハッシュ(Enterprise ZKモード)のいずれかを通じて到着します。

2. ハッシュキュー。 コミットハッシュはインメモリのキーバリューストアに格納され、夜間バッチを待ちます。そのストアにないものに注意してください。あなたのコードです。ハッシュのみです。

3. 深夜のcronワーカー。 一晩に一度、ワーカーが以下を行います。

  • 保留中のすべてのハッシュをグループ化する。
  • リポジトリごとのマニフェスト(.txt)を構築する。
  • バッチ上にネイティブにMerkleツリーを構築する。
  • 公開OTSカレンダーに対してOpenTimestamps証明を生成する。
  • MerkleルートをBitcoinブロックチェーンにアンカーする。

4. 証明の配信。 マニフェストと.otsレシートファイルは、あなたのリポジトリにプッシュで戻されます——コードと並ぶ専用のtimestampsブランチか、別のシャドウリポジトリのいずれかです。

タイミングの目安。 Bitcoinは即座には確認されません。アンカートランザクションは通常およそ3時間で確認されるため、証明はUTC午前0時から数時間後に現れると想定してください。UTC 00:05に確認して何も見えなくても、何も問題はありません。

カスタムワークフロー向けのAPIサーフェス

パイプラインは自走しますが、APIを使えば証明データを独自のツールに組み込めます。記載のあるエンドポイントはすべて認証が必要です。

# Last anchored Bitcoin block for a repository (public)
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api

# Total stamped commits (public)
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api

# Combined summary, handy for Shields.io
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api

# Full Merkle chain data for a specific day, for local verification
curl -s https://timestampgit.dev/api/verify/acme/payments-api/2026-10-25

# Audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/acme/payments-api

# PDF certificate for one date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/acme/payments-api/2026-10-25

Enterprise ZKインストールでは、HMAC認証されたコミットエンドポイントも使用します。ここで{hash}は、あなたのActionが要求した署名付きURLによって返されるHMAC値です。

curl -X POST \
  "https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitId>"

統合サーフェスはこれで全部です。「バッチを開始する」呼び出しをスケジュールする必要はありません——バッチ処理はサービスの仕事です。

モニタリングと障害対応

監視しない自動化は、単なる楽観主義です。Timestamp GITは、パイプラインが健全であることを確認する3つの独立した手段を提供します。

公開ステータスダッシュボード

各リポジトリには/status/{user}/{repo}で公開ダッシュボードが提供され、以下が表示されます。

  • 証明の寿命と最も早いアンカー日——証明の連鎖がどこまで遡るか。
  • 毎日の規則性をカレンダーヒートマップとして表示するため、抜けた夜は一目で明らかになります。
  • 各アンカーのBitcoinブロックとトランザクションデータ。

検証バッジ

READMEにShields.ioバッジを埋め込んで、証明を公開できます。

![Timestamped](https://timestampgit.dev/api/statusSummary/acme/payments-api)

/connected/{user}/{repo}ページでは、ライブプレビュー付きのバッジ埋め込みウィジェット(markdownスニペットを含む)が提供されます。プライベートリポジトリの場合、ステータスURLはサーバーインスタンス固有の暗号化されたHMACを伴うため、ステータスは署名付きリンクを持つ人にのみ表示されます。

セルフホストのヘルスチェック

ステータスエンドポイントはプレーンなJSONなので、自社のCI内の小さなスクリプトが、監査人より先に停止したパイプラインを検出します。

import requests

BASE = "https://timestampgit.dev"
USER, REPO = "acme", "payments-api"

r = requests.get(f"{BASE}/api/statusLast/{USER}/{REPO}", timeout=15)
r.raise_for_status()

last = r.json()  # last anchored Bitcoin block info for this repository
print(last)
# Compare against yesterday's stored value in your own job to detect a stalled batch.

夜間バッチが完了しなかった場合はどうなるでしょうか。観測可能なシグナルはどの場合も同じです。ヒートマップに空白が現れ、最後にアンカーされたブロックが進まなくなります。アンカーリングは日単位でバッチ化されるため、実行の抜けは監査時ではなく24時間以内に可視化されます。また、ハッシュキューとマニフェストは日付をキーにしているため、再実行は曖昧なものではなく、日付の付いた別個の証明を生成します。まずダッシュボードを確認し、次にリポジトリのtimestampsブランチを確認して、マニフェストとレシートが書き込まれたかどうかを確かめてください。

監査証跡

コンプライアンスレビューでは、2つの成果物が重要な役割を果たします。

  • GET /api/audit/{user}/{repo} — CSV形式の完全な台帳。
  • GET /api/report/{user}/{repo}/{date} — 単一日付のPDF証明書。

そして、PDFを信頼するのではなく計算を確認したい人がいる場合、/verification/{user}/{repo}/{date}ページが多段Merkleチェーンを段階的にたどります。計算はすべてブラウザ内でローカルに行われ、検証内容がサーバーに送信されることはありません。

自動タイムスタンプのベストプラクティス

パイプラインが稼働したら、いくつかの習慣が証拠を有用なものに保ちます。

  • 早く、頻繁にコミットする。 すべてのコミットが先行技術のデータポイントです。申請直前に1か月分の作業を1つのコミットにsquashすると、40個ではなく1個のアンカーしか得られません。
  • 証明は専用ブランチに置く。 自動化されたtimestampsブランチは機械が書き込むものです。フィーチャーブランチと分けておけば、git logが読みやすく保たれ、マージノイズを避けられます。
  • 紛争時だけでなく定期的に検証する。 四半期ごとに、Webベースの検証ツールで直近の日付を抜き打ち確認してください。訴訟中に壊れた検証チェーンを発見するのは、発見するには最悪のタイミングです。
  • リリースとともに証明を配布する。 リリース日のマニフェストとレシートをリリース成果物に添付し、法務文書でその日付を参照してください。
  • 特許を取る可能性のあるものにはタグを付ける。 コミットは自動的に捕捉されます。特許性のあるアイデアを議論し始めた瞬間に、作業がローカルブランチに置かれたままではなくコミットされていることを確認してください。

Dockerによるセルフホスト自動化

マネージドホスティングが既定ですが、利用できない環境もあります。エアギャップネットワーク、厳格なデータレジデンシー要件、リポジトリのメタデータに外部サービスが触れることを禁じる内部ポリシーなどです。

そのような場合のために、Timestamp GITはDockerイメージとして提供されます。自動化は同一です——同じ夜間バッチ処理、Merkleツリー構築、Bitcoinアンカーリングが、ただあなたのインフラ上で動くだけです。

クイックスタートの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ライセンスページから期間限定のデモライセンスを申請してください——名前、会社名、メールアドレス、任意の電話番号が必要です。期間限定のデモライセンスファイルがダウンロード可能で、オンプレミスセットアップの段階でアップロードします。

FAQ

開発者のマシンでコマンドを実行したりツールをインストールしたりする必要はありますか? いいえ。Timestamp GITは完全にGitHub App経由で動作します。インストール後、監視対象リポジトリへのすべてのコミットは毎晩自動的にタイムスタンプされます。CLIツールも、OpenTimestampsコマンドも、手動の手順もありません。

コミットにタイムスタンプが付くまでどのくらいかかりますか? コミットは一晩に一度バッチ化されアンカーされます。Bitcoinトランザクションは通常約3時間以内に確認されるため、証明は通常UTC午前0時から数時間後に利用可能になります。

Timestamp GITを信頼せずにタイムスタンプを独立して検証できますか? はい。.otsレシートファイルは、標準のOpenTimestampsツールを使ってBitcoinブロックチェーンに対して検証できます。証明はSHA-256とBitcoinブロックデータのみに依存するため、当社のサービスが消えてもオフラインで検証できます。

ソースコードを完全に非公開に保つ必要がある場合はどうすればよいですか? Enterprise ZKモードを使用してください。あなたのインフラ上のGitHub Actionがコミットハッシュのみを当社のAPIにプッシュします。当社がソースコードへの読み取りアクセスを持つことはありません。あるいは、完全な制御のためにDockerでセルフホストしてください。

タイムスタンプパイプラインはソースコードに触れますか? いいえ。標準モードはコミットハッシュを読み取ります。Enterprise ZKモードはリポジトリの内容を一切見ません。サービスはSHA-256ハッシュとBitcoinブロックデータのみを扱います。

意識する必要のないタイムスタンプ

暗号学的な先行技術の価値は、単一の印象的な証明ではなく、カバレッジから生まれます。英雄的な午後の作業でスタンプされた1つのコミットはほとんど何も証明しませんが、18か月にわたる毎晩のアンカーはタイムラインを証明します。それはボリュームの問題であり、ボリュームの問題は自動化によって解決されます。

これがTimestamp GITの提案のすべてです。GitHub Appを一度インストールし、リポジトリを選び、あとは夜間ジョブに任せるだけです。証明はtimestampsブランチに届き、バッジはREADMEに届き、法務から求められたときには監査CSVがそこにあります。分離が必要なら、Enterprise ZKモードまたはDockerが自動化を諦めずにそれを実現します。

アプリをインストールし、コミットをプッシュし、明日の朝ダッシュボードを確認してください。


関連記事

EU label: AI-generated content