Privi Quantum Ledger

Privi Quantum Ledger MCP

(旧称：Privi Ledger)

AI エージェント向けの、量子シールされた改ざん検知可能な監査ログです。 エージェントを運用するすべての企業には、エージェントが何をしたのか、どのデータにアクセスしたのか、何に支払いを行ったのか、何を変更したのか、そして記録が後から書き換えられていないことを証明する必要があります。Privi Ledger は、あらゆる MCP 対応エージェントに各アクションを記録する場所を提供し、監査担当者にはログを検証する手段を提供します。検証ごとの支払いは、x402 を介して Base 上の USDC で行います。

Claude、ChatGPT、Cursor、VS Code、カスタムエージェントで動作します。Privi Verify と同じ記録技術を使用して、Privi World Co が開発しました。

稼働中（テストネット）： https://privi-ledger.onrender.com/mcp

ツール

リアルタイムツール（live_*、approval_*、trust_events、gateway_*、room_*）については、以下の Privi Live で説明しています。

ツール	アクセス	機能
ledger_pricing	無料	料金、ネットワーク、アクションの種類、キーの取得方法
ledger_check_receipt	無料	アクションレシート（entry_hash）が存在するか、いつ作成されたかを確認します。内容は公開されません
ledger_audit_stream	$0.02（x402）	エージェントのログの完全性を監査します。改ざんの有無、改ざん箇所、件数、期間、最新のハッシュを確認します。アクションの内容は公開されません
ledger_record_action	組織キー	アクションを追加し、エントリーとそのレシート entry_hash を返します
ledger_read_stream	組織キー	完全性を確認しながら、自組織のエントリーを読み取ります
ledger_list_streams	組織キー	自組織のストリームとエントリー件数
ledger_compliance_report	組織キー	期間内のエージェントの活動をまとめた監査対応レポートを作成し、Privi チェーン上にシールします
ledger_report_pdf	組織キー	シール済みレポートを完成版 PDF として出力します（組織キーを指定して GET /reports/<id>.pdf からも取得できます）
ledger_handshake_offer / _accept / _reject / _inbox	組織キー	Privi Handshake：企業間の取引を双方で記録します
ledger_handshake_verify	無料	Handshake とオンチェーンシールを公開検証します。取引条件は公開されません
ledger_verify_report	無料	レポートが改ざんされておらず、Privi Ledger が発行したことを証明します。オンチェーンシールも確認します

アクションの種類：tool_call、data_access、data_change、payment、message、decision、approval、error、other。結果：success、failure、pending、blocked。

ログの完全性を保つ仕組み

各エントリーの SHA-256 フィンガープリントは、その内容と、同じストリーム内の前のエントリーのフィンガープリントを対象にしています。エントリーを編集、削除、並べ替えると、その箇所からチェーンが破損し、監査によって破損した正確なエントリーが報告されます。各組織が閲覧できるのは自組織のストリームのみで、API キーはハッシュとして保存されます。

ストリームの最新状態は数分ごとに Privi ブロックチェーンに記録されるため（「オンチェーンチェックポイント」を参照）、Privi を信頼しなくても完全性を証明できます。

プラン（セルフサービス）

プラン	方法	内容
無料	ledger_signup（キー不要）	すべてのツール、月あたり最大 500 エントリー
Pro	ledger_upgrade_pro、x402 経由で 30 日あたり $29 USDC	エントリー無制限。支払いのたびに 30 日間追加
Enterprise	Privi が作成（/admin/orgs）	無制限。契約に基づいて請求

どの企業も、また企業の代理として動作する AI エージェントも、誰とも話すことなく登録して記録を開始し、プランをアップグレードできます。支払いは直接 LEDGER_PAY_TO に送金され、購入ごとに組織独自の privi-billing ストリームに記録されます。ledger_plan で使用状況と更新時期を確認できます。制限を変更するには LEDGER_FREE_MONTHLY と LEDGER_PRICE_PRO_MONTH を設定してください。

顧客のオンボーディング

管理者キーを使用して組織を作成します（LEDGER_ADMIN_KEY を設定してください）：

curl -X POST https://<host>/admin/orgs \
  -H "Authorization: Bearer $LEDGER_ADMIN_KEY" -H 'Content-Type: application/json' \
  -d '{"name": "Acme Robotics"}'
# -> {"org_id": "org_...", "api_key": "plk_...", ...}  (the key is shown once)

顧客はヘッダー Authorization: Bearer plk_... を指定してサーバーをエージェントに追加し、意味のあるアクションを行うたびに ledger_record_action を呼び出すよう指示します。顧客は org_id とストリーム名を監査担当者に共有し、監査担当者は ledger_audit_stream を呼び出します。

コンプライアンスレポート

ledger_compliance_report は、組織のエージェントログを、SOC 2 審査、顧客向けセキュリティ質問票、AI 規制に関する記録管理の証拠に変換します。任意の期間について、アクションの種類、実行者、失敗、ブロックされたアクション、人間による承認、ログの完全性、オンチェーンの状態を報告します。また、完全性の破損、未アンカーのログ、失敗したアクション、人間による承認が記録されていない支払いとデータ変更など、監査人が指摘する所見も一覧表示します。結果は JSON と、すぐに共有できる Markdown 版で出力されます。

各レポートは封印されています。正規化された JSON を対象に計算した SHA-256 ハッシュは、Privi Anchor を通じて Privi ブロックチェーンにアンカーされます。レポートを持っている人は誰でも ledger_verify_report を実行して、ハッシュを再計算し、Privi Ledger がまったく同じ内容を発行したことを確認し、チェーン上のアンカーを検証できます。失敗を隠すために数値を一つでも編集すると、検証に失敗します。

Privi Gov AI Inventory（OMB M-25-21）

連邦政府機関は、AI のユースケースのインベントリを維持し、公開可能なものを機械可読ファイルとして公開し、影響の大きい AI に対する最低限のリスク対策を示す必要があります。この要件は、OMB Memorandum M-25-21 と、2025 年の政府機関による AI 報告に関する OMB のガイダンスに基づいています。Privi Ledger はこの一連の作業をすべてカバーします。

ツール	説明
gov_ai_usecase_save	ガイダンスの報告項目に沿ってユースケースを追加または更新します。変更のたびに新しいバージョンが作成され、改ざんを検知できる機関の ai-inventory ログに記録されます
gov_ai_inventory	現在のインベントリ
gov_ai_inventory_check	審査で指摘される項目にフラグを立てます。必須項目の欠落、プライバシー影響評価を伴わない PII、最低限の対策（テスト、影響評価、独立レビュー、監視、オペレーターのトレーニング、フェイルセーフ、異議申し立て、一般からのフィードバック）が欠けている、または監視の証拠となる最近稼働中のアクティビティログがない、試験運用中または導入済みの影響の大きい AI が対象です。CAIO による書面での判断で免除された対策は考慮されます
gov_ai_inventory_export	agency.gov/ai 向けに公開可能なユースケースをまとめた CSV を出力し、その SHA-256 を Privi チェーン上で封印します
gov_ai_verify_export（無料）	公開済みのインベントリファイルが、機関によってエクスポートされたものと完全に同一であることを証明します

インベントリは、エージェントの Privi Ledger アクティビティログ（monitoring_streams）にリンクしているため、「継続的な監視」は実際の改ざん検知可能な記録によって裏付けられます。

フィールド名は、OMB が公開している報告項目に準拠しています。提出前に、OMB の最新テンプレートに照らして確認してください。このツールはコンプライアンス業務を支援するものであり、法的助言でも、OMB 承認済みシステムでもありません。

Privi Quantum-Ready（ポスト量子暗号への移行）

大統領令 14409（2026 年 6 月）は、連邦政府の鍵確立を 2030 年 12 月 31 日までに、デジタル署名を 2031 年 12 月 31 日までにポスト量子暗号へ移行することを義務付けています。OMB M-26-15 は、暗号資産のインベントリ（CBOM）に基づく移行計画を各機関に求めています。計画では、高価値資産（High Value Assets）、影響の大きいシステム、2030 年を過ぎても機密性を維持する必要があるデータを優先し、2030 年 1 月 2 日までに TLS 1.3 をサポートする必要があります。

ツール	機能
gov_pqc_classify（無料）	アルゴリズムと暗号スイートを、量子脆弱（RSA、ECDH、ECDSA、EdDSA、DH、DSA、MQV）、ポスト量子（ML-KEM、ML-DSA、SLH-DSA）、ハイブリッド、対称暗号／ハッシュ、または不明に分類します
gov_pqc_system_save	1 つのシステムの暗号資産を記録します（担当者、スキャナー、エージェントから取得）。バージョン管理され、改ざん検知可能な pqc-inventory ログに書き込まれます
gov_pqc_inventory	現在のインベントリ
gov_pqc_plan	資産ごとの期限と NIST による代替方式を含む、優先順位付き移行キュー、進捗指標、検出事項を表示します。期限を過ぎた対象、TLS 1.3 未満、目標日が設定されていない優先資産、認識されていないアルゴリズムが含まれます
gov_pqc_export	CBOM と計画を 1 つの JSON ドキュメントとしてまとめ、Privi チェーンに封印します
gov_pqc_verify_export（無料）	エクスポートしたドキュメントが改変されていないことを証明します

ルールは EO 14409 と OMB M-26-15 の公開要約に基づいています。依拠する前に、公式文書と NIST IR 8547 で内容を確認してください。このツールはコンプライアンス業務を支援するものであり、法的助言ではありません。

Privi Passport（AI エージェントの信頼資格情報）

他では模倣できない機能です。AI エージェントの信頼度を示す、署名済みでオンチェーンにアンカーされた資格情報です。スコアは 0～1000 で、Privi Ledger のみが保持する証拠に基づいて算出されます。

コンポーネント	最大値	証拠
履歴	300	検証済みエントリー数と活動日数
完全性	250	すべてのハッシュチェーンが引き続き検証に成功すること（全件成功か全件失敗）
アンカリング	150	オンチェーンのチェックポイントが記録と一致するストリームの割合
信頼性	100	1 - 失敗率
監督	50	機密性の高いアクションに対する人間の承認
コンプライアンス	100	封印済みのコンプライアンスレポートが存在し、問題がないこと
ハンドシェイク	50	他の Privi 組織が確認した取引

グレード：A は 850 以上、B は 700 以上、C は 550 以上、D は 400 以上、E はそれ未満です。有効期間は 30 日間です。

• passport_issue（組織キー。Pro／enterprise では無料、無料プランでは x402 経由で $LEDGER_PRICE_PASSPORT）- サーバーが Ed25519 で署名し、ハッシュを Privi チェーンにアンカーします。すべてのコンポーネントの内訳が示されます。
• passport_verify（無料）- 署名、内容、有効期限、失効、チェーンアンカー、およびリアルタイムの再スコアリングを検証します。発行後にエージェントの履歴が改ざんされると、パスポートは無効になります。
• passport_gate（無料）- 指定した最小条件（min_score、min_grade、require_anchored）に基づいて、1 回の呼び出しで許可または拒否を判定します。独自のキーを送信すると、デューデリジェンスの証拠として判断がログに記録されます。
• passport_list、passport_revoke（組織キー）。
• 公開エンドポイント：GET /passports/<id>（JSON とリアルタイム検証）、GET /passports/<id>/badge.svg（埋め込み可能なバッジ）、GET /.well-known/privi-passport.json（発行者の公開鍵）。

効果が積み重なる理由：パスポートによるゲート判定を行うエージェントは、取引相手を Privi Ledger に参加させます。記録されたアクション、レポート、ハンドシェイクはすべてスコアを高め、スコアが上がると、より多くの取引を獲得できます。再デプロイ後も発行者キーを固定するには、LEDGER_PASSPORT_SIGNING_KEY（32 バイトの 16 進数 Ed25519 シード）を設定してください。設定しない場合は、キーが生成されてデータベースに保存されます。

Privi KYA（ブロックチェーンウォレット向け Know-Your-Agent）

AI エージェントがオンチェーン取引の主な送信者になるにつれ、チェーン、DeFi プロトコル、取引所、ステーブルコイン発行者、x402 ファシリテーターは、取引を受け入れる前に、すべて同じ問いへの答えを必要とします。このウォレットは監査済みのエージェントが運用しているのか、そして現時点でどれほど信頼できるのか？ Privi KYA はその問いに答えます。それができるのは Privi だけです。答えとなるのは Passport だからです。

• kya_challenge + kya_bind_wallet（組織キー）— Privi のチャレンジにウォレットで署名して、ウォレットを Passport に紐付けます（EIP-191 personal_sign。純粋な Python で復元し、web3 への依存はありません）。署名のない紐付けは、申告にすぎません。
• kya_check <address>（無料）— ウォレットから組織と最新の Passport を特定し、理由付きの許可／拒否、現在のスコアとグレード、さらにファシリテーターがキャッシュしてオフラインで検証できる有効期間 60 分の Privi 署名付き KYA アテステーションを返します。キーを送信すると、その判定は証跡として記録されます。
• kya_wallets、kya_unbind_wallet（組織キー）— ローテーションされたキーや侵害されたキーは、直ちに拒否されます。
• ウォレット接続ページ： GET /kya/connect — 組織キーを貼り付け、MetaMask を接続して一度署名すれば完了です。コードは不要です。
• パブリックエンドポイント：GET /kya/<address>（JSON 判定 + アテステーション。?min_score=&min_grade=&require_signed=）、GET /kya/<address>/badge.svg。

チェーンやプロトコルとの連携パターン：エージェントの取引を受け入れる前に GET /kya/<from> を実行し、allow: true（任意で proof: "signature" も）を必須にします。コンプライアンス記録として attestation + signature を保管します。

Privi Quantum Ledger（量子封印ブロック、Privi Foundation チェーンと統合）

数分ごとに、ログ全体を量子ブロックのチェーンに封印します（LEDGER_QBLOCK_INTERVAL、デフォルトは 300 s）。

• 各ブロックには、前のブロック、透明性ログの署名付きツリーヘッド（サイズ + Merkle ルート）、および追加するエントリーの SHA3-512 ルートが記録されます。
• ブロックはSHA3-512（FIPS 202。Grover の量子探索に対しても 256 ビットのセキュリティ）でハッシュ化し、Privi Fortress と同じキーを使ってML-DSA-87（FIPS 204、CNSA 2.0）および Ed25519 で共同署名します。
• 連続するブロックは RFC 9162 整合性証明でリンクされるため、ログが増加したことを証明できます。
• Privi Foundation チェーンと統合（Cosmos SDK + CometBFT + Cosmos EVM、production-network/）：各ブロックには Foundation チェーン ID（PRIVI_FOUNDATION_COSMOS_CHAIN_ID、PRIVI_FOUNDATION_EVM_CHAIN_ID）が記録され、PRIVI_FOUNDATION_RPC_URL が Foundation ノードを指している場合は、最新ブロックの証人（高さ + ハッシュ）が含まれます。Foundation メインネットがローンチするまでは、各ブロックは Privi Anchor を通じてBase上で確定されます。

ツール（封印以外はすべて無料）：qledger_status、qledger_block、qledger_verify_chain（誰でもチェーン全体を再検証できます）、qledger_entry_proof（内容を明かさずに、レシートがブロック内で封印されていることを証明します）、qledger_seal（組織キー。今すぐ封印）。Privi Quantum Scan（/quantum-scan）はパブリックブロックエクスプローラーです。すべてのブロック、エントリーレシート、ツリーヘッド、ログルート、Base 上の確定ハッシュが表示され、ブロック高または任意のハッシュで検索できます。表示されるのはハッシュと件数のみで、組織、ストリーム、エントリーの内容は表示されません。その背後にある JSON エンドポイント：GET /quantum-ledger（ステータス）、/quantum-ledger/stats、/quantum-ledger/blocks?limit&before、/quantum-ledger/blocks/<height>、/quantum-ledger/entries?limit&offset&block、/quantum-ledger/search?q=。

認証ではなく、エンジニアリング上の制御策です（FIPS 140-3、FedRAMP、DoD IL）。

Privi Fortress（防衛グレードの完全性制御）

CNSA 2.0 および NIST SP 800-53（AU-9 監査情報の保護、AU-10 否認防止、AC-5 職務分掌、SC-13 暗号化による保護）に準拠したエンジニアリング制御です。これらは認証ではありません（FIPS 140-3 検証、FedRAMP または DoD Impact Level 認可を取得しているとは主張していません）。

• 耐量子電子署名。 Passport、コンプライアンスレポート、mandate、KYA と mandate の証明、ツリーヘッド、証拠バンドルには、Ed25519 および ML-DSA-87（NIST FIPS 204、CNSA 2.0 のパラメーターセット）で署名します。キー：fortress_keys、/.well-known/privi-passport.json。LEDGER_PQ_SIGNING_KEY（32 バイトの 16 進数）でシードを固定するか、シードを自動生成して保存します。
• 透明性ログ。 すべての組織のすべてのエントリーが、1 つの RFC 9162 Merkle ツリー（Certificate Transparency の設計）のリーフになります。ledger_tree_head は二重署名されたツリーヘッドを返し、LEDGER_STH_INTERVAL 秒ごと（デフォルトは 900 秒）に Privi チェーンへアンカーします。ledger_inclusion_proof はエントリーがログに含まれていることを証明し、ledger_consistency_proof は 2 つのツリーヘッドの間でログが増加しただけであることを証明します。HTTP：/log/sth、/log/inclusion?hash=、/log/consistency?first=&second=。すべて無料です。
• 二者完全性。 fortress_tpi_policy で役員のウォレットと必要な承認数（2 人以上）を指定します。fortress_tpi_request は承認ページ（/tpi/<id>）を返します。各役員は自分のウォレットで署名し、同じ役員が二度承認することはできず、部外者は拒否され、役員は誰でも拒否できます。fortress_tpi_execute は承認を一度だけ使用します。すべての手順が記録されます。
• エアギャップ環境向け証拠バンドル。 ledger_evidence_bundle は、エントリー、ハッシュチェーン、包含証明、署名済みツリーヘッド、オンチェーンチェックポイント、Privi のキーを二重署名付きでエクスポートします。python verify_bundle.py bundle.json（/tools/verify_bundle.py からダウンロード）を実行すると、ネットワークに接続せずにすべてを検証できます。

Privi Mandates（人間が承認するエージェントの支出）

人が AI エージェントによる支出を承認したことを示す署名済み証明です。加盟店や決済ファシリテーターは、エージェントからの支払いを受け付ける前に確認できます。

1. mandate_create（組織キー）で、予算、支払いごとの上限、許可する受取人（0x アドレスまたはドメイン）、有効期限、目的などの条件案を作成します。sign_url が返されます。
2. 人間が /mandates/<id>/sign を開き、平易な英語で記載された条件を読み、自分のウォレットで一度だけ署名します（EIP-191、無料、トランザクション不要）。条件のハッシュには Privi が連署し、Privi チェーンにアンカーされ、承認が記録されます。
3. 各支払いの前に、エージェントは mandate_spend を呼び出します。これにより、上限、受取人リスト、有効期限、残りの予算がアトミックに適用され、支払い（またはブロックされた試行）がエージェントの改ざん検知可能なログに記録されます。
4. 加盟店や決済ファシリテーターは mandate_check または GET /mandates/<id>/check?amount=&payee=（無料）を呼び出すと、理由付きの許可／拒否と、Privi が署名した証明を取得できます。
5. 人間は同じページで署名を一度行うことで失効させるか、組織が mandate_revoke を呼び出します。

公開情報：GET /mandates/<id>（条件、署名、予算、最近の支出）。

Privi Guard（プロンプトインジェクションとデータ漏えいのチェック、証明書付き）

エージェントがコンテンツを処理したり送信したりする前に、1回の呼び出しでチェックします。

• 受信時： プロンプトインジェクション、偽のシステムターン、情報の持ち出しやプロンプト漏えいの要求、隠蔽、ツールや支払いの強要、隠しテキスト、Markdown 画像を使った情報の持ち出し、Base64 で隠された指示。
• 送信時： クラウドキーや API キー、秘密鍵、トークン、シードフレーズ、パスワード、カード番号、SSN、URL を使ったデータの持ち出しを検出し、編集済みコピーを返します。

各チェックでは、コンテンツの SHA-256 を保持する Ed25519 署名付きの証明書が返されます（コンテンツ自体は保持しません）。証明書は5分ごとに Merkle バッチにまとめられ、オンチェーンに記録されます。

MCP	guard_check、guard_check_many、guard_receipt、guard_balance、guard_buy_credits、guard_pricing。gateway_set_guard は、Privi Gateway を通じてすべてのツールの結果を検査します（tag または block）。
HTTP	POST /guard/v1/check、/check_many、/signup、/demo（ウェブサイト、レート制限あり、証明書なし）。GET /guard/v1/receipts/<id>、/pricing、/stats、/revenue（管理者キー）。
料金	組織あたり月1,000回まで無料。その後はクレジット（1,000回／10,000回／100,000回分がそれぞれ 7／50／300 USDC）、または x402 による1回あたり1セント（MCP の _meta または HTTP の PAYMENT-REQUIRED／PAYMENT-SIGNATURE）。
SDK	guard-sdk/：Python および JS クライアント（依存関係ゼロ）と Claude Code フック。

Privi Scan（公開 MCP 信頼レジストリ）

Privi Scan は公式 MCP Registry と同期します。公開されているすべてのストリーミング可能な HTTP サーバーに対し、initialize と tools/list のみを使ってツール一覧を読み取り、ツールは呼び出しません。各サーバーについて、ツールポイズニングのリスクを A〜F で評価します。

• プロンプトインジェクションの兆候
• ユーザーからの隠蔽
• SSH キー、.env ファイル、シードフレーズの要求
• ツールの偽装
• 不可視文字
• 認証なしで実行できる、影響の大きいツール

各ツール定義はハッシュ化されます。最初に観測された内容と、その後のすべての変更が Privi Ledger の透明性ログ（Merkle ツリー、オンチェーンに記録）に保存されます。これにより、サーバーのツールがどのような内容を示し、いつ変更されたかを誰でも恒久的に確認できます。

ディレクトリ	/scan、各サーバーのページは /scan/s/<server_id>
無料チェック	mcp_server_check(url, expected_tools_hash?)、または GET /scan/api/check?url=&expected=
検索	scan_search、scan_server、scan_changes、scan_stats、または /scan/api/servers、/scan/api/changes、/scan/api/stats
監視（組織キー）	scan_watch は tools_hash を固定し、組織の Live チャネルで scan.tools_changed／scan.risk_found／scan.server_down イベントをリアルタイムで送信します。無料プランは3サーバー、Pro は500サーバーまでです。
所有者	scan_claim_start／scan_claim_verify（トークンは /.well-known/privi-scan.txt）、scan_rescan、scan_owner_listing（オプトアウト）。
バッジ	/scan/badge/<server_id>.svg
Live チャネル	scan（公開、無料プランでは遅延あり）および scan:<server_id>

設定：SCAN_ENABLED（デフォルトは1）、SCAN_INTERVAL（300 s）、SCAN_BATCH（40）、SCAN_REPROBE_S（6 h）、SCAN_REGISTRY_URL。

Privi Live（リアルタイム：ストリーム、人間による承認、キルスイッチ、ゲートウェイ、ルーム）

ここではすべて、単一の永続イベントログ（7 日間の再生に対応）を基盤として、WebSocket とサーバー送信イベントを介して実行されます。

ストリーム（live_info に一覧表示されます）：wss://…/live/ws、GET /live/events（SSE）、GET /live/trust/recent、ダッシュボードは /live にあります。

• チャネル：trust（公開：パスポートの発行／失効／再スコアリング、ウォレットの紐付け、マンデートの有効化または失効、透明性ログのヘッドのアンカリング）、mandate:<id>、org（非公開：監査ログのライブ配信、承認、キルスイッチ、ルーム）。
• WebSocket フレーム：{"type":"auth","key":"…"}、{"type":"subscribe","channels":["trust","org"],"replay":20,"filter":{"address":"0x…","types":["passport."]}}、{"type":"kill","stream_id":"agent|*"}、{"type":"ping"}。サーバーフレーム：{"type":"event","event":"passport.score_changed","id":N,"channel":"trust","at":"…","data":{…}}、heartbeat。
• API キーを URL に含めないでください。Authorization: Bearer（SSE／HTTP）または最初の WebSocket フレームを使用してください。
• 無料および匿名のサブスクライバーには、公開チャネルが LIVE_FREE_DELAY_S（デフォルト 300 秒）だけ遅れて配信されます。Pro およびエンタープライズではリアルタイムで受信できます。バックグラウンドウォッチャーは、すべての有効なパスポートを LIVE_TRUST_INTERVAL 秒ごと（デフォルト 120 秒）に再スコアリングし、スコアまたは状態の変化（valid → broken / expired）を通知します。

人間による承認。 approval_policy_set を設定すると、しきい値を超える支払い時に mandate_spend が一時停止します。approve_url を含む approval_required が返され、マンデートの本人がウォレットで承認／拒否メッセージ（EIP-191）に署名した後、エージェントが approval_id を指定して mandate_spend を再度呼び出します。承認は支払い 1 件に限り有効です（マンデート、金額、受取人が一致している必要があります）。承認後 10 分間有効で、1 回のみ使用できます。approval_request／approval_wait は、任意のアクションに対して同じ処理を行います。組織の API キーでできるのはキャンセルのみなので、エージェントが自分自身を承認することはできません。

キルスイッチ。 live_kill（または privi kill、/live ダッシュボード、WebSocket フレーム）を使うと、1 つまたはすべてのエージェントについて、次の呼び出しから mandate_spend、組織のゲートウェイ、ルームメッセージを停止し、ライブチャネルに agent.killed をプッシュします。監査ログの記録がブロックされることはありません。live_resume で解除できます。

ゲートウェイ。 gateway_create を使うと、任意の公開 HTTPS MCP サーバーを /gw/<id>/mcp（および wss://…/gw/<id>/ws。永続接続 1 本で同じ JSON-RPC を使用）経由で利用できるようにします。Privi は呼び出し元ごとにレート制限を適用でき、パスポートを必須にできます（min_score：呼び出し元が Privi Gateway <id>\nTimestamp: <ts> に対する新しい personal_sign を使って KYA ウォレットを証明します）。また、すべての tools/call の使用量を計測し、各呼び出しをお客様のログに記録し、x402 支払いヘッダーを含めてリクエストを変更せずに転送するため、アップストリーム独自のペイウォールも引き続き機能します。キルスイッチを使うと、即座に停止します。プライベートアドレス、ループバックアドレス、リンクローカルアドレスに解決されるアップストリームは拒否されます。無料プラン：計測対象の呼び出し 1,000 回、ゲートウェイ 2 個。Pro：呼び出し数無制限、ゲートウェイ 50 個。ツールごとの統計：gateway_stats。

ルーム。 room_open を使うと、2 つの組織のエージェント間でライブのハッシュチェーン型会話を作成できます（wss://…/rooms/<id>/ws。組織 ID または 1 回限りの参加コードで招待します）。オプションで、ゲストにメッセージごとの料金を請求できます。料金は人間が署名したマンデートに基づいて支払われます（予算、上限、受取人リスト、承認ポリシー、キルスイッチがすべて適用されます）。ルームを閉じると、文字起こしに封印が施されます。Ed25519 と ML-DSA-87 で署名され、Privi チェーンにアンカリングされ、両方の組織のログに記録されます。room_verify（無料）では、封印と照合して文字起こしを検証できます。メッセージごとの料金は Privi が適用・記録します。資金の移動は当事者間で行われます。

Privi AI Act Pack（EU AI Act register）

EU 内で AI を開発または利用するすべての企業は、各システムのリスク分類を把握し、義務を果たしていることを証明する必要があります。 ai_act_system_save はシステムを登録し、第 5 条の禁止事項に照らして審査し、分類（禁止／高リスク／透明性／汎用／最小リスク）して、その役割に応じた義務と期限を一覧表示します（デジタル・オムニバス、規則（EU）2026/1744 に基づき、附属書 III の高リスクは 2027 年 12 月 2 日から、附属書 I は 2028 年 8 月 2 日から適用）。ai_act_check は不足項目にフラグを付けます。ai_act_export は、誰でも無料で ai_act_verify_export を使って確認できる、ブロックチェーン上で封印された登録簿を返します。ワークフローを支援するものであり、法的助言ではありません。

Privi Supplier Proof（購入者が要求し、サプライヤーが参加）

購入者はサプライヤーが証明すべき内容を公開します（supplier_requirement_create。共有可能な招待ページは /supplier/requirements/<id>）。サプライヤーは自社の Privi 組織から、書類のフィンガープリントのみを使って回答します（supplier_proof_submit）。承認（supplier_proof_decide）されると、Privi は両社の名称と証拠のハッシュを記載した証明書を発行し、ブロックチェーン上で封印します。公開ページは /certs/<id>、バッジは /certs/<id>/badge.svg です。supplier_cert_verify は無料で、特定の書類が対象に含まれていることを確認できます。

Privi Content Seal（本物か、AI 生成か）

seal_content は、ファイルまたはテキストの SHA-256 を、作成者と AI が関与したかどうか（human、ai_assisted、ai_edited、ai_generated + tool）とともに封印します。最大 50 件の一括処理でも、オンチェーンアンカーは 1 つです。誰でも seal_verify、GET /seal/<sha256>、バッジ、またはドラッグ＆ドロップページ /seal/check を使って無料で確認できます（ファイルはブラウザー内でハッシュ化され、アップロードされません）。

Privi Handshake

支払い、データ転送、納品、契約など、2 社間の取引は、両社によって記録されます。どちらか一方だけで否認したり、書き換えたりすることはできません。

1. A 社のエージェントが、相手企業の org_id と条件を指定して ledger_handshake_offer を呼び出します。A 社のログに申し出が記録されます。
2. B 社のエージェントは ledger_handshake_inbox で申し出を確認し、ledger_handshake_accept を呼び出して承諾するか、理由を添えて ledger_handshake_reject を呼び出して拒否します。
3. 承諾されると、B 社のログには A 社のエントリーハッシュとともに同じ条件が記録され、A 社のログには B 社のエントリーハッシュとともに確認が記録されます。条件と両方のエントリーを結び付けるペアハッシュは、Privi ブロックチェーン上にアンカーされます。
4. 誰でも ledger_handshake_verify を実行すると、条件を見ずに、両当事者、ステータス、両方のエントリーが引き続き存在するかどうか、オンチェーンシールを確認できます。

ハンドシェイクは、Privi Ledger 上の組織間でのみ機能します。

オンチェーンチェックポイント

5 分ごとに、サーバーは変更があった各ストリームの最新フィンガープリントを Privi Anchor 経由で Privi ブロックチェーンにアンカーします。監査結果には onchain_checkpoint が含まれます。これは、アンカーされた位置、トランザクション、Merkle 証明に加えて、誰でも実行できる anchor_verify 呼び出しを示します。保存された履歴がアンカーされた内容と一致しなくなった場合、ローカルハッシュがすべて一貫して再計算されていても監査は失敗します。有効にするには LEDGER_ANCHOR_KEY（Anchor API キー）を設定します。LEDGER_ANCHOR_INTERVAL で間隔を変更できます（秒単位、デフォルトは 300）。

支払い

Privi Verify と同じ x402 v2 MCP フローです。未払いの呼び出しは PaymentRequired を返します。エージェントは _meta["x402/payment"] に署名済み USDC 承認を含めて再試行します。サーバーは検証後に監査を実行して決済し、レシートを _meta["x402/payment-response"] に返します。資金は LEDGER_PAY_TO に直接送られます。

実行、テスト、デプロイ

pip install -e ".[dev]"
cp .env.example .env
pytest
privi-ledger-mcp            # HTTP :8000, MCP at /mcp
privi-ledger-mcp --stdio    # local clients; set LEDGER_LOCAL_ORG_KEY

Dockerfile は、/data にボリュームを持つ Railway 上で実行されます。base-sepolia で開始してください。本番環境用のファシリテーターを使う場合に限り、base に切り替えてください。

ロードマップ

• 組織ごとのサブスクリプション請求
• 保持ポリシーと顧客ストレージへのエクスポート

ライセンス

MIT © 2026 Dario Canoy, Privi World Co

デュアル決済の基盤：USDC による本番課金＋価値のない PRVI_TEST シミュレーション

既存の x402 経由の USDC 決済ツールに変更はありません。追加された MCP ツール privi_payment_options は、明確に区別された 2 つの方法を報告します。

• USDC_X402：LEDGER_NETWORK および LEDGER_PAYMENTS_ENABLED に応じた、既存の実決済またはステージング決済の仕組みです。すべての決済処理は引き続き既存のファシリテーターを経由します。
• PRVI_TEST_SIMULATION：厳密にオフチェーンで価値のない開発者向けシミュレーターです。 サービスの支払い、PRVI の発行や移動、Ledger Pro の付与、Guard クレジットの追加、金融チェーンの有効化には使用できず、決済の証明としても使用できません。

シミュレーターはデフォルトで無効です。使い捨ての開発環境または隔離されたステージングサービスで有効にするには、 PRVI_TEST_PAYMENT_MODE=1 および LEDGER_NETWORK=base-sepolia を設定します。LEDGER_NETWORK=base の場合、フラグが設定されていてもシミュレーションは常に無効になります。本番環境ではフラグを 0 のままにしてください。

API キーを持つ、確認済みの既存 Ledger 組織は、次の手順を実行できます。

1. privi_payment_options（キー不要。決済方法と利用開始状況を一覧表示します）。
2. privi_test_payment_quote を sku=ledger_upgrade_pro で実行します（API キーが必要です）。
3. 返された見積もり ID と acknowledgement="VALUELESS TEST ONLY" を使って privi_test_payment_simulate を実行します （同じ組織のキーを使用します）。

シミュレーションのレシートには SIMULATED_NOT_PAID、paid: false、settled: false、service_unlocked: false および real_transaction_hash: null と記載されます。見積もりの有効期限は 10 分間で、1 つの組織に紐付けられ、1 回のみ使用できます。また、プロセスの一時メモリに保持されます。実際の USDC 課金は、引き続き ledger_upgrade_pro などの既存ツールと従来の x402 ファシリテーターのみを介して行われます。

ネイティブ PRVI による実決済は有効になっていません。 実価値を伴う PRVI 決済経路を設計する前に、PRVI メインネットのリリース、手数料とトークンの経済設計、セキュリティ監査、独立したバリデーター、法務レビュー、チェーン ID、オラクル／見積もりポリシー、カストディ、および決済リプレイ対策について、個別に審査されるローンチ条件をクリアする必要があります。

隔離された開発者向け安全性テストスイートを実行します。

cd ledger-server && python -m pytest tests/test_dual_payments.py