Timestamp GIT

← All posts

2026-10-22

自動Gitタイムスタンプ:コミットをBitcoinにアンカー

自動Gitタイムスタンプ:コミットをBitcoinにアンカー
timestamp git blockchain proof

Gitタイムスタンプの自動化:コミットをビットコインにアンカリングする

先行技術の保護が「コミットのたびに誰かがツールを実行するのを忘れないこと」に依存しているなら、それは先行技術の保護ではなく、単なる習慣です。そして習慣は、監査の前週、リリースの追い込み中、あるいは「いつもそれをやっていた人」がチームを異動した直後に崩れます。

手動タイムスタンプには、予測可能な失敗のループがあります。コミットして、スタンプを押すのを思い出す。レシートを失くさない場所にコピーする。翌日も、その翌日も、重要なすべてのリポジトリでそれを繰り返す——そしてブランチの多いスプリントに入った瞬間、そのループは静かに止まります。1つのリポジトリならスケールします。しかし、それぞれ3人のコントリビューターがいる5つのリポジトリではそうはいきません。

この記事は、そのループを完全に排除することについてです:ビットコイン上でのGitタイムスタンプの自動化。そこでは、唯一の定期的なアクションは、あなたがもともと行うつもりだったコミットだけです。

OpenTimestampsのツールを自分で実行し、レシートファイルの面倒を見るという大変な方法でこれをやることもできます。Timestamp GITは、そうしなくて済むために存在します。プロトコルを完全に隠蔽するマネージドサービスです:GitHub Appを一度インストールすれば、監視対象リポジトリへのすべてのコミットが、毎晩自動的にビットコインにアンカリングされます。CLIツールも、プロトコルコマンドも、毎日のチェックリストも不要です。インストールの手順そのものについては、GitHub App Blockchain Timestamp Setup: Install Once, Timestamp Foreverを参照してください——この記事はインストール後に何が起こるかに焦点を当てています。

排除できる反復的な手作業

自動化に落ち着く前に、あなたの毎週から何が取り除かれるのかを正確に言葉にしておく価値があります:

  • コミットごとの儀式。 証明に値するすべてのコミットの後に、何かを実行しなければなりません。それは、すべてのコミットにおいて、永遠に、人間がループに入ることを意味します。
  • レシートの散乱。 証明ファイルは、個人フォルダ、共有ドライブ、あるいはSlackのスレッドに行き着きます。半年後には、誰もレシートを日付やリポジトリに紐付けられなくなります。
  • カバレッジの劣化。 あなたは主力リポジトリを保護します。社内ツールのリポジトリ、クライアントライブラリ、営業秘密のサービス——誰もそれらにスタンプを押しませんが、紛争で重要になるのは往々にしてそうしたものです。
  • 静かな空白。 1日を逃しても、証明が必要になるまで見えません。それはタイムラインの穴を発見するのに最悪のタイミングです。

ここで「自動化されたもの」が意味するのは、狭く具体的です。監視したいリポジトリにGitHub Appを一度インストールします。それ以降、すべてのコミットが検出され、バッチ処理され、開発者のアクションなしで毎晩ビットコインブロックチェーンにアンカリングされます。開発者は今日とまったく同じようにコミットし続けます。彼らのマシンにインストールするものは何もなく、pre-commitフックもなく、学ぶべき新しいワークフローもありません。

これが、プロセスと、あなたのリポジトリのバックグラウンド的な性質との違いです。

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

Timestamp GITは、リポジトリを接続する2つの方法を提供します。どちらも一度きりの設定です。

標準モード(GitHub App)。 監視したいリポジトリにGitHub Appをインストールします。監視対象の各リポジトリのHEADコミットハッシュのみを自動的に読み取ります。証明は専用のGitブランチに書き込まれます——ソースと同じリポジトリ内か、別のリポジトリ内のいずれかです。

権限モデルは、人々が期待するよりも少ないので、率直に理解しておく価値があります:

  • ソースリポジトリへの読み取り専用アクセス。 GitHubの権限システムには「コミットハッシュのみ」というスコープがないため、AppがHEADハッシュを見るために要求できる最小限は読み取り専用です。
  • ターゲットリポジトリへの読み書きアクセス。 ここにマニフェストとレシートファイルがプッシュされます。

エンタープライズZKモード。 12行のGitHub Actionがあなた自身のインフラ上で実行され、コミットハッシュのみをTimestamp GIT APIにプッシュします。この構成では、ターゲットリポジトリへの読み書きアクセスのみが必要で、ソースリポジトリへの読み取りアクセスは不要であり、ソースがあなたの環境から出ることはありません。

どちらのモードを選んでも、チームにとっての開発者体験は同じです:開発者のマシンにインストールするものは何もなく、誰かのブランチ作成、コミット、マージの仕方を変えるものもありません。

セルフホストが必要な場合。 最大限のセキュリティやエアギャップ環境のために、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の接続とインスタンスの設定を案内します。ライセンス、デモライセンス申請フォーム、セルフホストの完全な手順はSelf-Hosted Git Timestamps: Docker Setup & License Guideにあります。

自動化パイプライン:コミットからビットコインアンカーまで

一度接続すれば、パイプラインはあなたなしで動きます。実際の流れは次のとおりです。

1. コミットの検出。 GitHub AppがWebhook経由で新しいコミットを検出するか、エンタープライズZKモードでは、あなたのGitHub ActionがコミットハッシュをAPIにプッシュします。

2. ハッシュキュー。 コミットハッシュはバッチ処理のためにインメモリのキーバリューストアに入ります。それ以外は何も保存されません。それ以外は何も送信されていないからです。

3. 深夜のcronワーカー。 毎晩、ワーカーが:

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

4. 証明の配信。 マニフェストと.otsレシートファイルが、専用のタイムスタンプブランチまたはシャドウリポジトリ内のあなたのリポジトリにプッシュされます。

フロー全体は次のようになります:

commit ──▶ hash queue ──▶ midnight cron ──▶ Merkle root ──▶ Bitcoin block
                                                 │
                                                 └──▶ manifest.txt + .ots receipt
                                                              │
                                                              ▼
                                                  timestamps branch / shadow repo

エンタープライズZKモードでは、あなたのGitHub ActionがZK Commit APIと通信します。これは、APIがあなたのリポジトリに対して返す署名付きURLからのHMACで認証されます:

# The signed URL (and its HMAC) is returned by the API for your repo.
# {target} is the destination repo, {hash} is the HMAC from that URL.
curl -X POST \
  "https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitHash>/<commitId>"

タイミングの目安。 ビットコインの確認には数時間——通常は約3時間——かかるため、証明の書き込みは深夜の実行の数時間後に完了し、真夜中ちょうどではありません。00:05にタイムスタンプブランチを確認して何も見えなくても、それは想定された動作であり、失敗ではありません。

監視と障害対応

観察できない自動化は、動かなくなった自動化と区別がつきません。Timestamp GITは公開ステータスエンドポイントを提供しているので、ログインせずにパイプラインを監視できます:

# Last anchored Bitcoin block
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api

# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api

# Combined summary (Shields.io friendly)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api

バッジ。 READMEに埋め込み可能な検証バッジが利用できるので、アンカーのステータスがリポジトリを閲覧する誰にでも見えます。誰でもバッジのリンクをたどってタイムスタンプを検証できます——専用のビューアとPDFレポートがあります。プライベートリポジトリもサポートされています:そのステータスURLにはサーバーインスタンス固有の暗号化されたHMACが付加されるため、許可されたユーザーだけがステータスを見られます。

リポジトリステータスダッシュボード。 /status/{user}/{repo}では、証明の寿命、最も早いアンカー日、毎日の規則性、ビットコインブロックとトランザクションデータ、カレンダーヒートマップが得られます——カバレッジの穴を視覚的に見つける最速の方法です。

監査とレポートのエンドポイント。 ダッシュボードではなく証拠が必要なとき:

# Full audit ledger as CSV
curl -sO https://timestampgit.dev/api/audit/acme/payments-api

# PDF certificate for one specific date
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-10-21

ある夜が欠けているように見えるときは、この順序で確認してください:

  1. statusLastとstatusCountを確認します。最後のアンカーが予想より数時間古ければ、確認がまだ進行中である可能性があります。
  2. GitHub Appがまだリポジトリへのアクセス権を持っているか確認します。アンインストールされたApp、取り消された権限、名前が変更されたリポジトリは、検出を静かに停止させます。
  3. エンタープライズZKモードでは、あなた側のActionの実行履歴を確認します——APIへのプッシュが、ローカルで壊れうる唯一のリンクです。
  4. 何かが失われたと決めつける前に、ビットコインの確認が完了した後に再確認します。

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

  • 重要なすべてのリポジトリを監視する。主力だけでなく。カバレッジこそが自動化の価値のすべてです。1つの保護されたリポジトリでは、あなたの作業の残りは依然として露出したままです。
  • コミットを意味のあるものに保つ。 自動化はあなたがコミットしたものをタイムスタンプするので、コミットの衛生状態は、アンカリングされた履歴が語る物語を依然として形作ります。100個の「wip」コミットは、クリーンで説明的な履歴よりも証明するものが少なくなります。
  • READMEにバッジを置き、監査CSVと日付ごとのPDFレポートをあなたのIP記録とともに保管します。それらの成果物こそが、監査人や相手方弁護士に手渡すものです。
  • 重要なときは独立して検証する。 .otsファイルをダウンロードし、標準のOpenTimestampsツールでビットコインに対して確認します。証明は設計上ベンダー非依存です——SHA-256とビットコインブロックデータのみを使用します。手順の詳細はHow to Verify a Bitcoin Timestamp Proof Locallyにあります。
  • ゼロ知識の保証を忘れない。 スタンプされるのはコミットハッシュのみで、ソースコードは決してスタンプされません。したがって、すべてのリポジトリにわたって自動化しても、露出が広がることはまったくありません——1つのリポジトリでも50でも同じハッシュです。

FAQ

自動Gitタイムスタンプは、私のソースコードを読んだり保存したりすることがありますか?

いいえ。Timestamp GITはコミットハッシュのみを処理します。標準モードではGitHub AppがHEADコミットハッシュを読み取り、エンタープライズZKモードではあなたのインフラ上のGitHub ActionがハッシュのみをAPIにプッシュします。ZKモードではソースコードがあなたの環境から出ることはなく、サービスによってコピーまたは保存されることもありません。

コミットしてからビットコインアンカーが確認されるまでどのくらいかかりますか?

コミットは深夜のcronワーカーによってバッチ処理され、アンカリングされます。ビットコインの確認には数時間、通常は約3時間かかるため、.otsレシートとマニフェストファイルは深夜の実行の数時間後に、あなたのタイムスタンプブランチまたはシャドウリポジトリに現れます。

Timestamp GITがサービスを終了したら、私の証明はどうなりますか?

証明は有効なままです。それらはOpenTimestampsプロトコルを介してSHA-256とビットコインブロックデータのみに依存しているため、誰でも.otsファイルをダウンロードし、標準のOpenTimestampsツールを使ってビットコインブロックチェーンに対して独立して検証できます——独自技術も、ロックインもありません。

プライベートリポジトリで自動タイムスタンプを使用できますか?

はい。プライベートリポジトリはサポートされており、ステータスURLにはサーバーインスタンス固有の暗号化されたHMACが付加されるため、許可されたユーザーだけがステータスを閲覧できます。公開検証バッジとステータスダッシュボードも、アクセスが許可されれば同じように機能します。

結論:一度設定すれば、永遠に証明できる

ここでの変化は、労力としては小さく、結果としては大きいものです。あなたは毎日の雑用を維持するのをやめ、リポジトリの性質を所有し始めます:すべてのコミットが、毎晩自動的にビットコインにアンカリングされ、弁護士、監査人、あるいは法廷に手渡せるレシートが付きます。証明はビットコインに埋め込まれ、法廷で使える形であり、独自ツールなしで誰でも検証できます——そしてそのすべては、あなたの開発者ではなく、バックエンドのTimestamp GITによって駆動されています。

あなたのチームがマネージドサービスをまったく使えない場合、Dockerセルフホストオプションが、上記のComposeセットアップで最大セキュリティとエアギャップ環境をカバーします。

今日、最初のリポジトリにGitHub Appをインストールし、今夜パイプラインを走らせましょう。明日、statusLastを確認してください——そうでなければ、作成するのを思い出すのに1年を費やしていたであろうアンカーが手に入ります。

関連記事

EU label: AI-generated content