Bitcoinへの毎晩の自動Gitコミットアンカリング、手動ステップはゼロ
チームがコミットを「タイムスタンプ」する最も一般的な方法は、人間がそれをやることを覚えておくことです。
誰かが機能を完成させ、そのコミットをアンカリングすべきだと覚えていて、手作業で(面倒な方法で)OpenTimestampsワークフローを実行し、その後レシートをどこかに保存します。2週間後には、あの火曜日のレシートが存在するかどうかを誰も覚えていません。別の開発者が参加し、その儀式を知らず、6か月分のコミットがスタンプされないままになります。
これが手動タイムスタンプの罠です。記憶に依存する証明カバレッジです。デモでは問題なく機能しますが、チーム、スプリントのサイクル、そして1年間の人員入れ替わりを経ると崩壊します。Bitcoinへの毎晩の自動Gitコミットアンカリングは、この問題を逆転させます。アンカリングは人が実行するタスクであることをやめ、リポジトリの特性になります。GitHub Appを一度インストールすれば、あなたが眠っている間にすべてのコミットがバッチ処理され、アンカリングされます。
この記事では、その自動化された道のりを端から端まで — セットアップ、パイプライン、モニタリング、セルフホスティング — 解説します。cronジョブの世話をすることを気にかけるのではなく、監査に耐える証明を気にかける開発者とコンプライアンス担当者向けに書かれています。
手動タイムスタンプの罠(そして自動化がそれをどう排除するか)
コミットを手動でスタンプすることには3つの失敗モードがあり、そのすべてが個人的なものではなく構造的なものです。
- 記憶への依存。 誰かが適切なタイミングで、理想的には作業が公開される前に、ツールを実行することを覚えておかなければなりません。先行技術の目的では、遅いことはやらなかったことと同じです。
- サイレント障害。 手動実行が失敗したとき — ネットワークの不調、期限切れのカレンダー、間違ったディレクトリ — 何もクラッシュしません。単にカバレッジに穴が空くだけで、それを発見するのは1年後、まさにその証明が必要だった紛争の最中です。
- レシートの散乱。 レシートはノートPC、Slackのスレッド、誰も所有していない共有ドライブに行き着きます。見つけられない証明は、持っていない証明です。
これはどれもスケールしません。個人の開発者なら数か月は儀式を続けられるかもしれません。10人のチームには無理ですし、何十ものリポジトリにまたがってクライアントワークを回すエージェンシーには見込みがありません。逃した夜はそれぞれ記録に永続的な穴となります。なぜなら、決してキャプチャされなかったハッシュを遡ってアンカリングすることはできないからです。
Timestamp GITは、ゼロセットアップのマネージドな代替手段です。コミットハッシュを自動的にキャプチャし、バッチ処理し、毎晩OpenTimestampsプロトコル経由でBitcoinブロックチェーンにアンカリングするGitHub Appです。CLIツールも、手動のレシートも、開発者のマシンにインストールするものもありません。基盤となるプロトコルを自分で実行することなく、暗号学的な特性 — 不変で、独立して検証可能な日付 — を得られます。
より深い掘り下げはこのブログの別の場所にあります。GitリポジトリのBitcoinタイムスタンプを検証する方法は検証側を扱い、特許紛争のためのGitコミットタイムスタンプ証明は法的な枠組みを扱っています。この記事は自動化そのものにとどまります。
一度きりのセットアップ:GitHub Appをインストールして忘れる
セットアップは単一の操作で、リポジトリごとに一度、または組織ごとに一度行います。
- Timestamp GITのGitHub Appをリポジトリに(または組織全体に、そうすれば新しいリポジトリもデフォルトでカバーされます)インストールします。
- コードを保持するソースリポジトリを選択します。
- 証明が書き込まれるターゲットリポジトリを選択します — 専用ブランチ上の同じリポジトリか、別のシャドウリポジトリのいずれかです。
設定はこれで全部です。開発者マシンの要件はありません。デーモンも、各エンジニアがインストールしなければならないフックも、オンボーディングチェックリストもありません。カバレッジはリポジトリの特性であり、個人のものではないため、新入社員は最初のコミットからカバーされます。
権限モデル。 Standard Modeは、ソースリポジトリへの読み取り専用アクセスと、ターゲットリポジトリへの読み書きアクセスを必要とします。読み取り専用要件が存在するのは、GitHubの権限システムがコミットハッシュ専用のスコープを提供していないためです。ソースへの読み取りアクセスは、AppがHEADコミットハッシュを見ることを可能にする最小限の付与です。Appはそのハッシュを読むだけです。
ハッシュさえあなたの環境から出てはいけない場合、 Enterprise ZK Modeは、Appのポーリングを、あなた自身のインフラ上で実行され、コミットハッシュだけをTimestamp GIT APIにプッシュする12行のGitHub Actionに置き換えます。そのモードでは、サービスはターゲットリポジトリへの読み書きアクセスのみを必要とし、ソースリポジトリへの読み取りアクセスはまったく不要です — 代わりにActionをインストールします。
いずれにせよ、保証は同じです。私たちはあなたの実際のソースコードを見ることも、コピーすることも、保存することも決してありません。関与するのは常にハッシュだけです。
自動パイプラインの内部:コミットからBitcoinアンカーまで
一度インストールされれば、パイプラインは介入なしで実行されます。あなたのgit pushと、リポジトリに置かれた不変の証明の間で何が起こるかを示します。
1. コミット検出。 Standard Modeでは、GitHub AppがWebhookを通じて新しいコミットを検出します。Enterprise ZK Modeでは、あなたのGitHub ActionがコミットハッシュをAPIにプッシュします。どちらの経路も同じ成果物を生み出します。コミットハッシュのリストです。
2. ハッシュキュー。 入ってくるハッシュは、純粋にバッチ処理のために使われるインメモリのキーバリューストアに格納されます。ここが待合室です — コミットは次のバッチウィンドウまでここに蓄積されます。
3. 深夜のcronワーカー。 毎晩、ワーカーが保留中のすべてのハッシュを取得し、以下を行います。
- リポジトリごとにグループ化し、
- 各リポジトリのマニフェストファイル(
.txt)を書き込み、 - バッチ上にネイティブにMerkleツリーを構築し、
- 公開OTSカレンダーを使ってOpenTimestamps証明を作成し、
- MerkleルートをBitcoinブロックチェーンにアンカリングします。
バッチ処理がこれを安価で継続的にします。その日に1つのコミットをプッシュしたか400をプッシュしたかにかかわらず、コストとサイクルは同じです。
4. 証明の配信。 マニフェストと.otsレシートファイルは、あなたのリポジトリに — 専用のtimestampsブランチ上か、あなたのシャドウリポジトリに — 自動的にプッシュバックされます。
計画に入れておく価値のあるタイミングの詳細が1つあります。Bitcoinブロックチェーンでの確認には数時間、通常は3時間ほどかかります。つまり、今日プッシュされたコミットは今夜キューに入れられ、一晩でアンカリングされ、証明ファイルは数時間後に現れます。それを待つ必要はありません。翌朝そこにあるのを見つけるだけです。
結果として、1日ごと、リポジトリごとに、改ざん検知可能なチェーンが得られます。あなたのコミットハッシュ → マニフェスト → Merkleツリー → Merkleルート → OpenTimestamps証明 → Bitcoinブロック。
モニタリングと障害処理:チェーンを途切れさせない
監視しない自動化は、手動の罠をより見栄えよくしただけのものです。Timestamp GITは公開ステータスエンドポイントを公開しているので、ダッシュボードにログインすることなく自分でチェーンを確認できます。
# Last anchored Bitcoin block info for a repo
curl -s https://timestampgit.dev/api/statusLast/{user}/{repo}
# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/{user}/{repo}
# Combined summary, used for Shields.io badges
curl -s https://timestampgit.dev/api/statusSummary/{user}/{repo}
どんなスケジューラにも合う簡単な継続性チェック:statusLastを1日1回呼び出し、生のレスポンスを保存し、昨日から変わっていなければアラートを出します。新しいアンカーが着地していなければ、そのギャップを10年後ではなく同じ週に捕まえられます。
それを自分で構築したくないなら、https://timestampgit.dev/status/{user}/{repo}の公開ステータスダッシュボードが視覚的にその作業を行います — 証明の寿命、最も早いアンカー日、毎日の規則性、各アンカーの背後にあるBitcoinブロックとトランザクションデータ、そして逃した夜を即座に明らかにするカレンダーヒートマップ。同じページから監査CSVとPDF証明書をダウンロードできます。
プライベートリポジトリはプライベートのまま。 プライベートリポジトリのステータスURLは、サーバーインスタンスに固有の暗号化されたHMACを伴うため、認可されたユーザーだけがそれらのリポジトリのステータスを読めます。証明はBitcoinの意味では依然として公開検証可能です — ハッシュはオンチェーンにあります — が、周囲のメタデータは開かれた本ではありません。
検証バッジ。 公開リポジトリでは、埋め込み可能なバッジが検証ステータスをREADMEに直接表示し、誰でもサイトでタイムスタンプを検証できるリンクを伴います。バッジは、あなたが何かを提示することなく、クライアント、買収企業、または相手方弁護士に証明を見えるようにします。
Appが再接続するとき。 リポジトリが切断され再接続された場合、接続済みページがライブプレビュー付きのバッジ埋め込みウィジェットを提供するので、リンクが無傷であることを再検証できます。
信頼できる毎晩のアンカリングのためのベストプラクティス
- 週に一度は人間がヒートマップを見る。 毎晩の自動化は日々のタスクをなくしますが、説明責任はなくしません。週に5分ステータスダッシュボードをちらりと見れば、アラートが見逃すかもしれないものを捕まえられます。
- エラーだけでなく不在にアラートを出す。 危険な状態は沈黙です。アンカー日付が進まなくなったときにアラートを出します。
- 専用の
timestampsブランチまたはシャドウリポジトリを使う。 証明をデフォルトブランチの外に置くことは、マージノイズなし、CIへの偶発的な干渉なし、そしてレビュアーがあなたのアプリケーションをクローンせずに閲覧できる監査証跡を意味します。 - 買い手が見る場所にバッジを埋め込む。 READMEに、ライセンスヘッダーの近くに。存在の公開証明は安価な信頼性です。
- 監査台帳を定期的にエクスポートする。 CSVを定期的に取得してコンプライアンス資料とともにアーカイブし、各リリースマイルストーンごとにPDF証明書を生成します。コンプライアンスチームは日付の入った文書を求めます。聞かれる前に渡しましょう。
- 「誰が何を見られるか」の話を書き留めておく。 あなたのモード — StandardかEnterprise ZKか — と付与された正確な権限を文書化します。調達や法務が尋ねてきたとき、あなたはすでに答えた質問に答えているのです。
エアギャップ環境向けのセルフホスティング:Docker Composeクイックスタート
あなたの制約がマネージドサービスを排除する場合 — 規制された環境、エアギャップネットワーク、厳格なデータレジデンシールール — 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ページのリクエストフォームに名前、会社、メール、任意で電話番号を記入して送信すると、開始するためのデモライセンスファイルをダウンロードできます。
セルフホスティングは、同じ毎晩のバッチ処理とアンカリング動作 — Merkleツリー、OTS証明、あなたのリポジトリに書き戻される.otsファイル — を備えた最大限のセキュリティと制御を提供します。
FAQ
マシンでコマンドを実行したりツールをインストールしたりする必要がありますか? いいえ。Timestamp GITはマネージドサービスです。GitHub Appを一度インストールすれば、すべてのコミットが毎晩自動的にアンカリングされます。開発者マシンには何もインストールされません。
コミットがBitcoinにアンカリングされるまでどのくらいかかりますか?
毎晩のcronワーカーがコミットをバッチ処理し、MerkleルートをOpenTimestamps経由でBitcoinにアンカリングします。確認には通常約3時間かかり、その後.ots証明ファイルがあなたのリポジトリにプッシュバックされます。
タイムスタンプを独立して検証できますか?
はい。.otsファイルをダウンロードして標準のOpenTimestamps検証ツールをBitcoinブロックチェーンに対して使うか、https://timestampgit.dev/verification/{user}/{repo}/{date}の公開検証ページを使えます。これは多段Merkleチェーン検査のすべてのステップをあなたのブラウザ内でローカルに実行します — あなたが何を検証するかを誰も見ません。
ソースコードを完全にプライベートに保つ必要がある場合は? Enterprise ZKモードを使ってください。あなたのインフラ上のGitHub ActionがコミットハッシュだけをTimestamp GIT APIにプッシュするので、あなたのソースはあなたの環境から出ません。あるいは、完全な制御のためにDockerでセルフホストしてください。
アンカーはその規則性と同じくらいしか良くない
一度だけ作ったタイムスタンプは、ある瞬間について1つのことを証明します。毎晩自動的に作られるタイムスタンプは、リポジトリが特定の状態で連続したタイムライン上に存在したことを証明します — そしてそれが、18か月後に誰かがあなたに異議を唱えたときに耐えるバージョンです。手動スタンプはその記録を生み出せません。なぜなら、記録はあなたが逃さなかった日々によって定義されるからです。
Timestamp GITはまさにそのために作られています。あなたのリポジトリまたは組織にGitHub Appをインストールし、証明がどこに着地するかを選び、毎晩のワーカーにあなたのコミットハッシュをバッチ処理、Merkleツリー化、Bitcoinへのアンカリングを任せてください。バッジ、ダッシュボード、または.otsファイルそのもので検証できます。あなた自身のネットワーク内で実行したいなら、Dockerセルフホストライセンスが対応します。
一度インストールすれば、あとは考えるのをやめられます。