CLI不要のOpenTimestamps:マネージドBitcoinタイムスタンプ
あるコードが特定の日付に存在していたことを証明しようとしたことがあるなら、おそらくOpenTimestampsに行き着いたはずです。そしておそらく、見出しには決して書かれない部分にも行き着いたでしょう。コマンドライン、カレンダー、.otsファイル、そして今やBitcoinトランザクションを理解する必要があるのではないかという漠然とした感覚です。
この記事は、CLIなしでOpenTimestampsを説明するものです。プロトコルが悪いからではありません——実際、極めて優れています——が、コマンドラインは実装の詳細であり、要件ではないからです。GitHub Appがリポジトリを監視し、あなたが眠っている間にすべてのコミットをBitcoinにアンカーするマネージドな道筋があります。一度インストールすれば、タイムスタンプのコマンドを入力することは二度とありません。
ここでは、OpenTimestampsが実際に何をするのか、なぜ公証人のアナロジーがほぼ完璧に当てはまるのか、毎晩内部で何が起きているのか、そしてチームが導入をためらう誤解について扱います。生のプロトコル機構はここでは背景として扱い、焦点は自動化されたワークフローとそれがもたらすものに置きます。
CLIなしのOpenTimestampsとは?
OpenTimestampsは、あるデータが特定の時点またはそれ以前に存在していたことを証明するためのプロトコルです。データをMerkleツリーに集約し、ルートをハッシュ化し、そのルートをBitcoinブロックにコミットすることでこれを実現します。Bitcoinブロックは不変でグローバルに複製されるため、アンカーは存在の公的かつ改ざん検知可能な記録となります。
CLIはそのプロトコルへの一つのインターフェースにすぎません。Webサービス、GitHub App、またはスケジュールされたワーカーもまったく同じことができ、しかもよりうまくやれます。バッチ処理とカレンダー処理は人間が苦手とする部分だからです。
マネージドなアプローチは次のとおりです。リポジトリにTimestamp GIT GitHub Appをインストールします。それ以降、すべてのコミットが自動的に検出され、毎晩バッチ処理され、OpenTimestamps経由でBitcoinにアンカーされます。証明はレシートファイルとマニフェストとしてリポジトリに戻ってきます。コマンドも、ローカルツールも、Bitcoinノードも不要です。
範囲を明確にしておくと、この記事は概念とマネージドワークフローを説明するものです。生のプロトコル操作を順を追って解説するものではありません。関連トピックについてより深く知りたい場合は、ブラウザでBitcoinタイムスタンプ証明を検証する方法とGitログが証明にならない理由をご覧ください。
シンプルなアナロジー:あなたのコードのための公証人
公証人を想像してください。あなたは書類を手渡します。公証人はそれを読みません。改ざん検知可能な封印を計算し、日付を押し、その封印を誰でも検査できる公開台帳に記録します。後日、誰かが日付に異議を唱えたら、あなたは書類を提示し、封印を再計算し、台帳の記録を指し示します。
OpenTimestampsはその公証人であり、二つのアップグレードがあります:
- 「書類」はコードではなくハッシュです。 Gitはすでに各コミットに対して一意の一方向ハッシュ(SHA-1またはSHA-256)を生成しており、その時点のリポジトリの正確な状態を表しています。そのハッシュが指紋です。Timestamp GITは指紋のみを扱います。
- 台帳はBitcoinブロックチェーンです。 書庫の公証人の綴じ台帳の代わりに、封印は数千の独立したノードが複製するブロックに記録されます。あなたも、私たちも、裁判所命令も、それを書き換えることはできません。
日々の運用で重要なのは三つ目のアップグレードです。Timestamp GITを使えば、公証人が毎晩自動的にあなたを訪ねてきます。予約も、順番待ちも、書類仕事もありません。あなたがコードをコミットすれば、スタンプはあなたが意識することのないスケジュールで行われます。
内部の仕組み(簡単に)
三つのステップがあり、インフラらしきものが関わるのは真ん中だけです。
ステップ1 — 指紋。 コミットすると、Gitはそのコミットに対して一意のハッシュを生成します。Timestamp GITはこれらのハッシュのみを収集します。ソースコードが読まれたり、コピーされたり、保存されたりすることは決してありません。
ステップ2 — アンカー。 深夜のcronワーカーが保留中のすべてのハッシュをグループ化し、リポジトリごとにネイティブなMerkleツリーを構築し、マニフェスト.txtファイルを作成し、公開OpenTimestampsカレンダーを使ってMerkleルートをBitcoinにアンカーします。
ステップ3 — 証明。 マニフェストと.otsレシートファイルは、専用のtimestampsブランチまたは別のシャドウリポジトリとして、あなたのリポジトリにプッシュされます。そこから誰でもBitcoinブロックデータに対してオフラインで検証できます。
知っておく価値のある運用上の詳細が二つあります:
- Bitcoinの確認には数時間、通常は約3時間かかります。そのため証明の書き込みは、毎晩のバッチの数時間後に完了し、即時ではありません。
- 検証はベンダーに依存しません。証明はSHA-256とBitcoinブロックデータのみに依存します。独自形式も、ロックインもありません。
毎晩のバッチが生成するものの形は、概念的には次のとおりです:
timestamps/
├── 2026-11-05/
│ ├── manifest.txt # commit hashes for the day
│ └── manifest.txt.ots # OpenTimestamps receipt for the Merkle root
└── 2026-11-06/
├── manifest.txt
└── manifest.txt.ots
レシートこそがあなたが保持する成果物です。それ以外はすべて利便性にすぎません。
マネージドタイムスタンプが重要な理由
プロトコルを自分で運用することは可能です。しかしそれはメンテナンスプロジェクトでもあります。カレンダーの信頼性、バッチ処理ロジック、Bitcoin確認の処理、レシートの保存、そして監査人向けの検証ストーリーです。ほとんどのチームにとって、それは実際の製品から注意をそらすものです。
マネージドサービスはそれらの可動部分を取り除きます:
- プロトコルの知識は不要。 カレンダーサーバー、Merkle証明、Bitcoinトランザクション構造を学ぶ必要はありません。困難な道は存在しますが、それをスキップして構いません。
- 法廷で通用する、ベンダー非依存の証明。 証拠は私たちのデータベースではなくBitcoinに存在します。誰でも私たちを信頼せずに確認できます。
- ワークフローへの適合。 GitHub Appを一度インストールするだけです。以降のすべてのコミットは自動的にアンカーされます。習慣を変える必要も、開発者のマシンに何かをインストールする必要もありません。
- コンプライアンス面。 READMEファイル用の公開検証バッジ、ダウンロード可能な監査CSV、日付ごとのPDF証明書により、監査人が具体的に確認できるものを提供します。
代理店やフリーランサーにとって、最後の点は支払い紛争や著作権主張の際に実際に役立ちます。企業にとっては、すでに内部システムで稼働しているものに対して権利を主張するパテントトロールに対する盾となります。
OpenTimestampsに関するよくある誤解
「Bitcoinの専門家である必要がある。」 必要なのは専門知識ではなく、数学を信頼することです。マネージドサービスでは、複雑さは処理されます。バッチ処理、アンカリング、証明の配信はスケジュールに従って行われます。あなたが接するのはダッシュボードとリポジトリ内のブランチだけです。
「タイムスタンプはソースコードを公開してしまう。」 そうはなりません。アンカーされるのはコミットハッシュのみです。サービスがあなたのコードを見たり、コピーしたり、保存したりすることは決してありません——ゼロ知識の原則はポリシーの約束ではなく、アーキテクチャ上のものです。Enterprise ZKモードでは、ハッシュの送信はあなた自身のインフラ上でGitHub Actionとして実行され、ハッシュのみをAPIにプッシュするため、サービスはソースリポジトリへの読み取りアクセスをまったく持ちません。
「証明の信頼性はベンダー次第だ。」
証明はBitcoinネイティブです。.otsレシートファイルをダウンロードし、標準のOpenTimestamps検証を使ってブロックチェーンに対してオフラインで検証できます。もしTimestamp GITが明日消えても、あなたの証明は依然として有効です。
「高価で遅い。」 毎日のバッチ処理により、多くのコミットが一つのBitcoinアンカーを共有するため、経済性が成り立ちます。確認には数時間かかりますが、先行技術の証拠としては許容範囲です。それは分単位ではなく、月や年単位で判断されるものです。
CLIなしで始める
デプロイモードは二つあり、どちらも開発者のマシン上でターミナルを必要としません。
標準モード(GitHub App)。 監視したいリポジトリにGitHub Appをインストールします。HEADコミットハッシュを自動的に読み取り、証明を専用ブランチに書き込みます——同じリポジトリ内でも、別のターゲットリポジトリでも構いません。GitHubの権限モデルでは、ソースリポジトリへの少なくとも読み取り専用アクセス(コミットハッシュのみの権限は存在しません)と、ターゲットリポジトリへの読み書きアクセスが必要です。
Enterprise ZKモード。 12行のGitHub Actionがあなたのインフラ上で実行され、コミットハッシュのみをTimestamp GIT APIにプッシュします。ここではターゲットリポジトリへの読み書きアクセスのみが必要で、ソースへの読み取りアクセスは不要です。ハッシュの可視性さえも自社の境界内に保つ必要がある場合に選択してください。
どちらの場合も、インストール後の流れは平穏です。コミットが検出され、ハッシュがキューに入り、毎晩のワーカーがそれらをアンカーし、Bitcoin確認の数時間後に証明がtimestampsブランチに現れます。
Dockerによるセルフホスティング
エアギャップ環境や最大セキュリティ環境向けに、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ページで名前、会社、メールアドレス、任意の電話番号を入力して申請できます。ライセンスファイルはすぐにダウンロードできます。
稼働後に得られるもの
- リポジトリごとの公開ステータスダッシュボード:証明の寿命、最も早いアンカー日、毎日の規則性、Bitcoinブロックとトランザクションデータ、カレンダーヒートマップ、ダウンロード可能な監査CSVとPDF証明書。
- README用の検証バッジ:誰でもフォローできるリンク付きでタイムスタンプを確認できます。プライベートリポジトリではURLに暗号化されたHMACを付加するため、認可されたユーザーのみがステータスを確認できます。
- ブラウザベースの検証ツール:多段Merkleチェーン検証をローカルで実行するため、あなたが検証する内容を誰も見ることができません。
- REST API:ステータスチェックをスクリプト化したい場合に利用できます:
/api/statusLast/{user}/{repo}、/api/statusCount/{user}/{repo}、/api/audit/{user}/{repo}など。
# Check the last anchored Bitcoin block for a repo
curl https://timestampgit.dev/api/statusLast/youruser/yourrepo
プランは必要なプライバシーの度合いに応じて用意されています:公開リポジトリ向けのOpen Source、プライベートリポジトリ向けのPro Agency、GitHub Actionベースの分離を提供するEnterprise ZKです。詳細は料金ページをご覧ください。
FAQ
Timestamp GITでOpenTimestampsを使うには、ソフトウェアのインストールやコマンドの実行が必要ですか?
いいえ。Timestamp GITはマネージドなGitHub Appです。一度インストールすれば、毎晩自動的にコミットにタイムスタンプを付けます。インストールするCLIツールも、実行するコマンドもありません。
Timestamp GITはどのようにしてソースコードのプライバシーを確保していますか?
Timestamp GITはゼロ知識の原則で動作します。処理するのはGitコミットハッシュのみで、実際のソースコードは決して扱いません。Enterprise ZKモードでは、ハッシュさえもGitHub Action経由であなたのインフラからプッシュされるため、サービスがリポジトリへの読み取りアクセスを持つことはありません。
Timestamp GITを信頼せずにタイムスタンプを独立して検証できますか?
はい。証明はOpenTimestampsプロトコルを使ってBitcoinブロックチェーンにアンカーされています。.otsレシートファイルをダウンロードし、標準のOpenTimestamps検証を使ってオフラインで検証するか、ローカルで実行される組み込みのブラウザベース検証ツールを使用できます。
Timestamp GITが事業を停止したらどうなりますか?
証明はBitcoinブロックチェーンに埋め込まれているため、有効なままです。検証はBitcoinとSHA-256のみに依存するため、コードの存在を独立して証明し続けることができます。
結論
OpenTimestampsは実際の問題——データが特定の時点に存在していたことを証明すること——を解決し、ハッシュ化とBitcoinだけでそれを解決します。コマンドラインは決して本質ではありませんでした。それはただ最初のインターフェースにすぎなかったのです。
マネージドインターフェースは、チームが実際に働く方法により適しています。GitHub Appをインストールし、コミットを続け、毎晩のジョブにハッシュをアンカーさせるだけです。.otsレシート、マニフェストブランチ、検証バッジ、監査CSV、PDF証明書が得られ、そのすべてがベンダーを超えて存続する証明に裏付けられています。
自動化されたバージョンが必要なら、リポジトリにTimestamp GITをインストールして何かコミットしてください。セットアップはそれだけです。公証人は今夜やってきます。