すべてのGitコミットにBitcoinタイムスタンプを自動付与する
手動のタイムスタンプ付与には、手動バックアップと同じ失敗のパターンがあります。忙しい週が来るまでは完璧に機能するのです。そして、忙しい週とは、後で「出荷した」ことを証明する必要が生じる機能を出荷する、まさにその週なのです。
この記事は、そのループから人間を排除することについてです。「マージする前にスタンプするのを忘れないで」ということでも、リリース手順書のチェックリスト項目でもありません。一度インストールすれば、監視対象リポジトリのすべてのコミットが、チームの誰かがIP保護について考えているかどうかに関係なく、毎晩自動的に、Merkleバッチ処理されたBitcoinアンカーの証明に変わるのです。
暗号学的な先行技術があなたの状況にとって重要かどうかをまだ判断中の方は、出願前に先行技術を証明する:創業者のためのガイドをご覧ください。この記事は、あなたが判断を済ませ、今それを自動運転で動かしたいと考えていることを前提としています。
手動タイムスタンプの罠(そして自動化が勝つ理由)
これを手作業で行うのは、一見すると簡単そうに見えます。しかし実際には、手動のワークフローとは、チームの誰かが以下を行わなければならないことを意味します。
- 意味のあるコミットのたびに、ブランチが書き換えられたり、squashされたり、force-pushされたりする前に、タイムスタンプを付けることを覚えておく。
- 鍵素材と証明ファイルをローカルで、ラップトップの故障や人員の入れ替わりに耐えられる場所で管理する。
- 結果として得られるレシートを、デューデリジェンスの際に2年後でも見つけられる、耐久性がありバージョン管理された場所に保存する。
- すべてのコミットについて、すべてのリポジトリで、永遠に繰り返す。
最後の項目こそが、手動プロセスが破綻する場所です。カバレッジは一貫性を欠き、一貫性のないカバレッジは聞こえ以上に悪いものです。紛争になれば、証拠チェーンの隙間は、このコミット——重要なあのコミット——こそが例外だったという主張を招くのです。金曜日の午後に1回プッシュを忘れるだけで、きれいなタイムラインが疑問符に変わってしまいます。
基盤となるOpenTimestampsプロトコルは本当によく設計されており、生のコマンドラインツールと手動のBitcoinアンカーリングで自分で動かすこともできます——難しい方法で、自腹と自分の時間を費やして。毎日リリースし、専任の暗号担当者がいないチームにとって、それはセキュリティ管理を装ったメンテナンスプロジェクトなのです。
自動化が勝つのは、繰り返し発生する意思決定を一度きりの設定に変えるからです。GitHub Appを一度インストールすれば、その瞬間から監視対象リポジトリへのすべてのコミットが、開発者が何も触れることなく、キャプチャされ、キューに入れられ、バッチ処理され、アンカーリングされ、あなたのリポジトリに戻されるのです。
一度きりのセットアップ:GitHub Appをインストールして忘れる
セットアップはこの記事で最も短い部分です。それが要点なのです。
- Timestamp GIT GitHub Appをインストールします。 単一のリポジトリを選ぶか、組織全体に付与します——監視対象の各リポジトリは独自の独立した証明を持ちます。
- ソースとターゲットを選択します。 Appはソースリポジトリからコミットハッシュを読み取り、証明をターゲットリポジトリに書き込みます。同じリポジトリ内の専用の
timestampsブランチか、別個のシャドウリポジトリのいずれかです。 - 権限を確認します。 標準モードではソースリポジトリへの読み取り専用アクセスが必要です。GitHubの権限モデルには「コミットハッシュのみ」というスコープがないためです。証明をコミットして戻すために、ターゲットリポジトリへの書き込みアクセスが必要です。権限の範囲はこれだけです。
開発者のマシンには何もインストールされません。CLIツールも、pre-commitフックも、配布する鍵ファイルも、新入社員のオンボーディング手順もありません。開発者はこれまで通りgit commitとgit pushを実行するだけです。
ホスト型サービスにソースコードへの読み取りアクセスを一切持たせたくない組織向けに、Enterprise ZKモードがあります。短いGitHub Action(12行)があなた自身のインフラ内で実行され、コミットハッシュのみをAPIに送信するため、ソースコードがあなたの環境から出ることはありません。このモードでは、Appはソースリポジトリへの読み取りアクセスを必要としません——Actionをインストールするだけです。ほとんどのチームは標準のマネージドモードから始め、ZKモードを最も機密性の高いリポジトリ向けのオプションとして扱います。権限の詳細な手順は単一のGitHub AppインストールでIP保護を設定するにあります。
自動化パイプラインの内部:コミットからBitcoinアンカーまで
インストールされると、パイプラインは独自のスケジュールで実行されます。git pushから検証可能な証明までの間に何が起こるかを以下に示します。
- コミット検出。 GitHub AppがWebhook経由で新しいコミットを取得します。Enterprise ZKモードでは、代わりにあなたのGitHub ActionがコミットハッシュをAPIにプッシュします。
- ハッシュキュー。 コミットハッシュはインメモリのキーバリューストアに格納され、夜間バッチを待ちます。ここに届くものに注目してください。コードではなく、ハッシュです。
- 深夜のcronワーカー。 ワーカーが起動し、保留中のすべてのハッシュをグループ化し、リポジトリごとに1つのマニフェスト
.txtファイルを書き込みます。 - Merkleツリーの構築。 ワーカーはその日のバッチ上にネイティブにMerkleツリーを構築し、公開OTSカレンダーに対してOpenTimestamps証明を生成します。
- Bitcoinアンカーリング。 MerkleルートがBitcoinブロックにアンカーリングされます。確認には通常約3時間かかるため、証明の配信はバッチ実行の数時間後になります。
- 証明の配信。 マニフェストと
.otsレシートファイルがターゲットリポジトリに自動的にコミットされます。
この設計の2つの特性は、仕組み以上に重要です。
- 構造上ゼロ知識。 サービスはあなたのソースコードを一切見たり、コピーしたり、保存したりしません。扱うのはコミットハッシュとMerkleルートです。あなたのリポジトリの状態がパイプラインに入ることはありません。
- ベンダー非依存。 証明はSHA-256とBitcoinのブロックデータのみに依存します。仮にTimestamp GITが明日消えても、リポジトリ内のレシートは標準のOpenTimestampsツールを使ってBitcoinブロックチェーンに対して検証可能なままです。日々の作業では、代わりに検証ページやAPIを使用します——コードのBitcoinタイムスタンプ証明を検証する方法をご覧ください。
監視と障害処理:すべてのコミットがアンカーリングされることを確実にする
監視しない自動化は、ただの楽観的なcronジョブにすぎません。Timestamp GITは、カバレッジを観測可能にする十分な範囲を公開しています。
ステータスダッシュボード。 監視対象の各リポジトリには、https://timestampgit.dev/status/{user}/{repo}で公開ステータスページがあり、証明の寿命、最も早いアンカー日、毎日の規則性、Bitcoinのブロックとトランザクションデータ、アンカーリングされた日のカレンダーヒートマップ、ダウンロード可能な監査エクスポートを表示します。
埋め込み可能なバッジ。 Shields.ioバッジはREADMEに直接貼り付けられ、リポジトリを接続した直後にmarkdownスニペットが生成されます。誰でもクリックしてタイムスタンプを公開検証できます。
カスタムアラート用のAPI。 独自のツールからステータスをポーリングし、カウントを照合します。
# Latest anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq
# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq
# Combined summary (what the badge uses)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api | jq
ギャップが証拠上の問題になる前にフラグを立てる、最小限の夜間チェックです。
import datetime, requests
REPO = "https://timestampgit.dev/api"
USER, SLUG = "acme", "payments-api"
summary = requests.get(f"{REPO}/statusSummary/{USER}/{SLUG}", timeout=30).json()
last = requests.get(f"{REPO}/statusLast/{USER}/{SLUG}", timeout=30).json()
# Alert if nothing has been anchored in the last 48 hours
print("summary:", summary)
print("last anchor:", last)
これをアラートチャネルに向ければループは閉じます——逃した日は、デューデリジェンス中の発見ではなく、通知になるのです。
障害シナリオ。 Webhookは落ち、カレンダーは時々ダウンし、ネットワークは一時的に不調になります。ハッシュはインラインでスタンプされるのではなくキューに入るため、アンカーリングされていないハッシュは単に次の夜間バッチに繰り越されます。何も失われず、延期されるだけです。目に見える症状は、ヒートマップ上の欠けた日やstatusLast値の停滞であり、これはまさに上記のチェックが捉えるものです。
コンプライアンスエクスポート。 監査のために、全台帳をCSVまたは日次PDF証明書として取得します。
curl -sO https://timestampgit.dev/api/audit/acme/payments-api
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-11-22
プライベートリポジトリはステータスURLに暗号化されたHMACを付加するため、認可されたユーザーのみがステータスを読めます——HMACはサーバーインスタンス固有です。
自動タイムスタンプのベストプラクティス
- ダッシュボードだけでなく、timestampsブランチを監視しましょう。 新しいマニフェストと
.otsファイルが現れることが、配信がエンドツーエンドで機能したことのグラウンドトゥルースです。 - 可能な限り、証明用に専用のターゲットリポジトリを使用しましょう。 ソース履歴をきれいに保ち、コードベースをエクスポートすることなく、証拠を弁護士に渡しやすくします。
- 一度だけでなく、定期的に検証しましょう。 公開検証ページまたは
/api/verify/{user}/{repo}/{date}に対して四半期ごとのチェックをスケジュールします。すべての検証計算はブラウザ内でローカルに行われます——あなたが何を検証しているかを誰も見ることはありません。 - カバレッジを記憶ではなくプロセスに根付かせましょう。 リポジトリがビジネスクリティカルなら、リポジトリごとではなく組織全体にAppをインストールします。選択的インストールの失敗パターンは、誰もオンボーディングを覚えていないリポジトリです。
- デプロイを脅威モデルに合わせましょう。 エアギャップ環境や最大セキュリティ環境では、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はGitHub AppまたはGitHub Actionを介して完全に動作します。開発者はいつも通りコミットするだけで、自動化が残りを処理します。
夜間の締め切り後にコミットされた場合はどうなりますか? 翌晩のバッチに含まれます。システムは保留中のすべてのハッシュをキューに入れ、まとめてアンカーリングします。
複数のリポジトリでタイムスタンプを自動化できますか? はい。GitHub Appを複数のリポジトリまたは組織全体にインストールでき、各リポジトリは独自の証明を持ちます。
コミットにタイムスタンプが付与されたことをどう検証しますか? 公開検証ページまたはAPIを使用して、Merkle証明をBitcoinブロックチェーンに対して確認できます。バッジもステータスを表示します。
1日に複数のコミットをプッシュした場合はどうなりますか? それらはすべてその日のバッチに集められ、単一のMerkleツリーに折り込まれ、1つのBitcoinトランザクションの下でまとめてアンカーリングされます。リポジトリごとのマニフェストは引き続き生成されるため、個々のコミットハッシュはバッチ内で追跡可能なままです。
プライベートリポジトリのコミットにタイムスタンプを付与できますか? はい——プライベートリポジトリはPro Agencyプラン($49/月)とEnterprise ZK($199/月、GitHub Actions)でサポートされています。パブリックリポジトリはOpen Sourceティアで無料です。
コミットがアンカーリングされるまでどのくらいかかりますか? 通常、夜間バッチの実行から数時間後です。Bitcoinの確認自体には通常約3時間かかるため、証明は深夜から数時間後にリポジトリに届きます。
Timestamp GITなしで証明を検証できますか? はい。証明はSHA-256とBitcoinのブロックデータのみに依存するため、ブロックチェーンに対して独立して検証できます——独自技術もロックインもありません。
結論
先行技術の証明の価値はカバレッジから生まれ、カバレッジは自動化から生まれます。誰かが何かを実行するのを覚えていることに依存するタイムスタンププロセスには穴ができ、その穴こそが相手方弁護士が探すものなのです。
Timestamp GITはOpenTimestampsプロトコルをあなたに代わって処理します。GitHub Appを一度インストールし、夜間のcronにすべてのコミットをBitcoinにアンカーリングさせ、バッジとステータスエンドポイントを監視し、.otsレシートをあなたが管理するリポジトリに保管するだけです。セットアップは数分で完了し、その後は、決して発火しないはずのアラートをちらりと見るだけが継続的なタスクです。
パブリックリポジトリで無料のOpen Sourceティアから始めるか、Pro Agencyでプライベートリポジトリを接続して今夜最初のバッチを実行させましょう。これにかかるコストと自作との比較についてのより広い視点は、コードタイムスタンプのコスト比較:マネージド vs DIYをお読みください。