policyvault

PolicyVault

Kaspa L1 上の、個人や AI エージェント向けの非カストディアル型委任支出ボールトです。

PolicyVault を使うと、ボールトのオーナーは、資金の管理権を渡すことなく、使用キーをエージェント（従業員、サービス、ボット、または AI エージェント）に渡せます。支出ポリシーは、コベナントを通じて Kaspa L1 のコンセンサスによって適用されます。アプリケーション全体を迂回して Kaspa ノードに直接アクセスするエージェントであっても、オーナーのポリシーに反する支出はできません。

権限モデルは次のとおりで、あらゆる場所でこの原則が適用されます。

AI はリクエストできます。PolicyVault が決定論的に判断します。 コベナントが適用します。署名者がカストディ権を保持します。

本番環境の状況（正直なラベル）

表示面	状況
Web／エージェントプラットフォーム	https://app.policy-vault.org でサービスを提供しています。配信されるヘルス情報でアクティブなビルドを確認できます。このツリーは、fullscale-rc44（df5b8de）の後継となる、照合とデリゲート期間開始の修正を含む fullscale-rc45 ビルド 1fa26b33 に対応します。
現在の本番ソース	このツリーは v1.10.11（fullscale-rc45）、イメージ sha256:32d45a3096b29eefc0dd97f2fc1e582ee00cb32236bbd7293c6626fd8bd4652d です。公開済みの前バージョンは v1.10.10 です。準備しただけではデプロイを意味しません。配信されるヘルス情報でアクティブなビルドを確認できます。
組織の M-of-N オーナールート（covenant v0.7）	既存の RC40 メインネット生成ポリシーを維持しています。このリリースでは、作成権限、covenant のバイト列、ネイティブ KAS のステータスラベルは変更しません。
ブラウザーでのルート付きボールトのオーナー操作（R7-05）＋予約／出金ガイダンス（F-6）	維持されます。署名しきい値の動作に変更はありません。このリリースでは、ルート付きボールトのオーナー操作と承認が変更されます。変更内容は changelog のデリゲート期間開始および組織ルート項目に記載されています。内容には、policyvault-0.7-kas トレジャリーのデリゲートルール変更では、すべてのオーナー承認を集め、ビルド時点での新規または変更されたデリゲートの予算期間終了の10分前までに確定する必要があること（1分未満にはならず、1時間の期間では50分）、ルートリクエストに確定期限が表示されること、その期限を過ぎると PolicyVault はリクエストを確定せず、取り下げて再ビルドすることしかできないこと（Web には後の開始時刻を入力する項目がありません）、オーナー承認が付いていても一度も試行されていないリクエストは取り下げられることが含まれます。また、policyvault-0.7-kas トレジャリーの新しいデリゲートは、Build を押した時点で読み取られたネットワーク位置から予算期間を開始すること、そのようなトレジャリーにインストール済みのデリゲートのウォレットを変更するには、デリゲートを削除して再追加すること、ノードが未使用と報告していない出力を使用するルートリクエストは拒否されること、Verify が UNRESOLVED としたトレジャリーでのホスト型ビルド、確定、ブロードキャストは拒否されること（既存のデリゲートリクエストへの承認は記録されますがチェーンには到達できず、そのリクエストの取り下げと Verify への応答は引き続き可能です）、Verify が PolicyVault の外部でブロードキャストされたルート移動を、その移動を生じさせたトランザクションを持つ記録済みリクエストに帰属させられること、確定済みルートリクエストの Submit はまず入力を読み取り、別のトランザクションによって入力が使用された後は、リクエストを2段階で取り下げられることが含まれます。配信対象の5つのアセット（app-v4.js、app.js、kas-vault-ui.js、org-root-ui.js、refusal-explain.js）が、v0.4 系の Verify、リクエスト、デリゲート期間開始、レガシーコンソール、組織ルートの表示を変更します。
すべてのルートファミリーを対象とするホスト型テナンシー＋生成ゲート（rc11 修正）	稼働中 — rc8 の指摘事項（認証なしのホスト型ビルド、プロトタイプ由来のバージョン選択、非標準の v0.4 生成方式による安全でないメインネット作成）を解消します。
リリース後の稼働スタックレビュー修正（rc29：Webhook の宛先ポリシー＋DNS トランスポート、SDK トランスポートの復旧キー、レガシーの同一効果の完了所有権、イメージ／パッケージの LICENSE＋NOTICE、プライバシーを保護したランタイムアーティファクト、復旧ガイダンス）	このソースおよび fullscale-rc29 イメージに含まれます — 稼働中の rc28 スタックに対する独立した読み取り専用レビューのすべての指摘事項を、RED ファーストで修正し、恒久的なリグレッションテストを追加しました。配信される buildId が f217011 になれば、ホスト型デプロイにも反映されます。インストール済みの SDK／モバイルクライアントは、トランスポート修正を取り込むためにアップグレードが必要です。
2回目のリリース後レビュー修正（rc30：Webhook 応答ソケットの存続時間上限、コンパイラーと参照プログラムの横に配置した上流 Silverscript ISC 表記）	このソースおよび fullscale-rc30 イメージに含まれます — 稼働中の rc29 スタックに対する独立した読み取り専用リリースレビューの両方の指摘事項を、RED ファーストで修正し、実ソケットを使った恒久的なリグレッションテストを追加しました。配信される buildId が 9dbc5f7 になれば、ホスト型デプロイにも反映されます。SDK／モバイルクライアントのバイト列に変更はありません。
組織 UI の可用性修正（rc31：機能検出で利用可能と示された場合にのみ組織ルート作成を提示、アドレス／金額を変更しても未対応のメインネット生成方式は有効にならないことを生成拒否メッセージで説明、ビルドエラーをウィザード内に限定）	このソースおよび fullscale-rc31 イメージに含まれます — オーナーが確認した RC30 の指摘事項を、実際のページとスクリプトを操作する13ケースの DOM リグレッションテスト（合成ウォレット、HTTP インターセプト）を用いて、RED ファーストで修正しました。ブラウザー表示のみの変更です。サーバー／SDK の生成ゲートに変更はなく、引き続き権限の基準となります。SDK／モバイルクライアントのバイト列に変更はありません。
MCP パッケージ（npm の policyvault-mcp）	[email protected] のまま変更ありません。SHA256 は 128403f81d4af7b73ae86a31a750d39ec21c28f518d214f4e678807c3dff0c14 です。genesis、署名、送信のツールは公開されません。このサーバーでは、不確実な結果の後に同じ MCP リクエストを再試行すると、操作を再実行せず、拒否（IDEMPOTENCY_OUTCOME_UNKNOWN、またはサーバー／ストア障害後は IDEMPOTENCY_IN_PROGRESS）されるか、保持された結果が返されます。資格情報のウォレットがボールトに参加していても、リクエストの署名者でもボールトのオーナーでもない場合、reject ツールは 403 REQUEST_FORBIDDEN を報告します。MCP 経由で送信されるデリゲート期間開始時刻は下限値です。422 PERIOD_START_REQUIRED は REFUSED エンベロープとして呼び出し元に返されます（MCP ツールからは、409 PERIOD_START_STALE を返す後続チェックに到達しません）。
主力 wave 1（v1.6.0／v1.7.0）および wave 2（v1.8.0）のソース	該当する箇所に含まれ、稼働中です（CHANGELOG の各項目を参照してください。v0.6 は FIXTURE VENUE ONLY／メインネットでのスワップなし、x402 facilitator は本番対応済みですが未デプロイ、MCP 使用状況テレメトリーは OFF）
Covenant protocol v0.6（アトミックなコンポーザビリティ）	COVENANT-BYTE-FROZEN（2026-09-03）：実エンジン上で本番バイト列を用いて VM 検証済みで、テストネットでも検証済みです（testnet-10 での実 SELL＋BUY）。FIXTURE VENUE ONLY — 実際の DEX 取引所はなく、メインネットでのスワップはなく、サーバー／Web／モバイル／MCP のサーフェスもありません。deadlineDaa は署名前の境界であり、コンセンサスによる有効期限ではありません。また、およそ 10 KAS 未満ではスワップは経済的に成立しません。PolicyVault は DEX ではなく、今後も DEX にはなりません。 docs/postlaunch/v0.6-covenant-byte-freeze.md を参照してください。
v0.5 トークンコントローラー covenant（バイト列凍結）＋最小権限の検出／コンソール修正＋MCP 1.4.2（v1.5.0）	稼働中 — 本番ランタイムの後継 fullscale-rc8（buildId 1c02162）を2026-09-02にデプロイし、自動受け入れテストを実施しました。プリンシパル単位の機能検出、本番環境での dev-signer プローブなし、サインアウト中の特権読み取りゼロ、オプトインのウォレット診断を含みます。[email protected] は資格情報のスコープで許可されるツールのみを提示します（サーバー側の強制に変更はありません）。v0.5 TOKEN CONTROLLER covenant（contracts/PolicyVault.v0.5.sil、sha256 c693aeff…）はソースとして提供されます — COVENANT-BYTE-FROZEN、実エンジン上で本番バイト列を用いて VM 検証済みで、1回の実ライフサイクルを通じてテストネット検証済みです。本番ではありません（v0.5 のサーフェスもメインネット v0.5 ボールトもありません）。図解付きオンボーディングガイド（表示のみ）。CHANGELOG を参照してください。
配布：MCP レジストリ、エージェントのサンプル、セルフホスティング（v1.4.0）	ソース／配布リリース — ランタイムの変更なし（本番は buildId 6c3177f を維持）：MCP サーバーを npm／レジストリパッケージ（policyvault-mcp、io.github.zapsoblige-hash/policyvault）として配布し、OpenAI-Agents-SDK／LangChain／CrewAI と接続する薄いサンプルを examples/agents/ に収録しました。また、1コマンドでのセルフホスティングを deploy/selfhost.sh ＋ docs/selfhost-quickstart.md で提供します。CHANGELOG を参照してください。
ベアラーウォレットセッション＋ネイティブモバイルトランスポート（v1.3.0）	稼働中：ブラウザ以外のクライアント向けに、オプトインのベアラートークンによるウォレットセッション認証を追加しました（認証のみであり、署名権限やカストディ権限はありません。Cookie による Web 認証に変更はありません）。ネイティブ Android トランスポートも追加しました（プラットフォーム境界で明示的に CapacitorHttp を使用。CORS の範囲は拡大せず、Web クライアントは引き続き厳密な同一オリジンです）。実際にパッケージ化された Android ランタイムから稼働中の本番環境に接続し、ベアラーの全ライフサイクルを検証しました。CHANGELOG を参照してください。
レスポンシブクライアント＋サインアウト中の控えめな UX（v1.2.0）	サインイン中のナビゲーションを高速化しました（状態の保持、並列読み取り、正確な進行状況表示 — 保留中の処理を成功として扱いません）。サインアウト中に不要なエラートーストも表示しません。CHANGELOG を参照してください。
ネットワーク識別バナーの修正（v1.1.1）	Web クライアントのネットワークバナーは、サーバーのノード検証済み /network/status に基づくようになりました。明示的な UNKNOWN 状態にフェイルクローズし、古いネットワーク情報や推定したネットワーク情報は表示しません。CHANGELOG を参照してください。
アプリ内ドキュメントの検出（v1.1.0）	Web クライアントにドキュメントリンクとコンテキストヘルプを追加し、https://docs.policy-vault.org にディープリンクします。表示のみの後継リリースです。CHANGELOG を参照してください。
外部承認者の検出修正（2026-08-27）	デプロイ済み＋自動受け入れテスト済み（フェイルクローズする可用性の不具合であり、資金／権限／プライバシーの露出はありません。CHANGELOG の「Fixed」を参照してください）。受け入れテストは自動化されており、人による受け入れテストを実施したとは主張していません。
Covenant protocol v0.4.1	メインネットで運用中（実際のメインネットライフサイクルの証拠があります。何がどのように検証済みかについては SECURITY.md を参照してください）。
Covenant protocol v0.5（トークンコントローラー）	COVENANT-BYTE-FROZEN（2026-09-02）：実エンジン上で本番バイト列を用いて VM 検証済みで、テストネット検証済みです（testnet-10 での実ライフサイクル、無効なケースはコンセンサスにより拒否）。本番ではありません — サーバー／API／Web のサーフェスもメインネットのインスタンスもありません。docs/postlaunch/v0.5-covenant-byte-freeze.md を参照してください。
Python クライアント、MCP サーバー、x402／AP2 アダプター、プラットフォームエージェント API	リリース済みです。このリポジトリの自動適合性／統合テストスイートでカバーされています。
ネイティブモバイル（iOS／Android）	開発中 — まだ本番運用に対応していません。 Android アプリ（ネイティブ本番トランスポートとベアラーサインインを含む Capacitor プロジェクト一式を mobile/ に収録）は、実際のエミュレーターから稼働中の本番環境に接続して検証済みです。読み取り、ベアラー認証の全ライフサイクル、フェイルクローズ時の負のケースを確認済みですが、本番署名、ストア向けパッケージ化、カメラ／QR キャプチャは未完了です。現時点では、これを基盤にカストディのワークフローを構築しないでください。
セキュリティ保証	内部の証拠にのみ基づきます：各候補の独立した内部 AI 反証レビュー（レビュー担当者が自身の候補を修正することはありません）、本番バイト列を用いた実際の Kaspa スクリプトエンジン上での敵対的テスト、RED ファーストの再現と恒久的なリグレッションテスト、本番環境を想定した機械的検証、testnet-10 の実証拠、アーティファクトおよび凍結済みバイト列の厳密な検証、各デプロイ後のオーナー自身によるメインネットでの実地検証を行っています。外部の専門家によるセキュリティ監査は実施されておらず、PolicyVault のプロセスにも含まれていません（オーナーポリシー、2026-09-05）。このリポジトリでは、これに反する主張は一切していません。

• x402 FACILITATOR（integrations/x402-facilitator/、2026-09-02）： 設計凍結（オーナー承認済み。docs/postlaunch/x402-facilitator-design-freeze.md） · 実装済み · 単体テスト済み · 敵対的テスト済み · 統合テスト済み （実際の HTTP サービス＋実際の PostgreSQL クレームストア） · テストネット検証済み （testnet-10 上の実際の KAS と凍結済み v0.5 トークン決済。 docs/testnet-x402-facilitator-evidence.json）。提案中の Kaspa 方式 pv-x402-kaspa-exact-upfront/1 に対する、独立してデプロイされる 権限を持たない読み取り専用のチェーン検証／決済確認 サービスです（ネットワーク識別子 kaspa:mainnet／kaspa:testnet-10 は PolicyVault による CAIP-2 構文上の暫定識別子であり、上流への 登録を主張するものではありません）。署名、ブロードキャスト、エスクロー、 課金は一切行いません。本番のホスト型サービスではありません （別途オーナーの承認が必要です）。上流に Kaspa x402 方式は存在しないため、 その点を明記せずに「x402 互換」とは言えません。

コベナントが強制すること（ソフトウェアではなくコンセンサス）

• 所有者が管理するボールト — 作成、管理、一時停止、復旧、閉鎖ができます。
• 支出の委任 — 1 つのボールトにつき最大 10 個の独立したエージェントを設定でき、それぞれが独自のポリシーに従い、所有者が定めた上限内で実際の KAS を支出します。
• トランザクションごとの上限および定期的な累積予算 （DAA スコアベースの会計をコンセンサスで検証します）。
• 宛先の許可リスト — Merkle ツリーでコミットされ、エージェントは所有者が承認した宛先にのみ支払えます。
• 所有者が設定したしきい値を超える場合の M-of-N 承認。
• コベナントが管理する手数料リザーブ — エージェントにガス用ウォレットは不要です。ネットワーク手数料は、コベナントが正確に会計処理するリザーブから支払われます。
• 所有者による緊急一時停止と最終的な復旧 — ホストされたワークフローによって妨げられることはありません。

コベナントの範囲を超えてプラットフォームが提供するもの（権限ではなく、ホストされた調整機能）

• インテントマニフェストと独立したブラウザー検証 — 署名を行う前に、ブラウザーが署名対象となる正確なバイト列からトランザクションの内容を再導出し、不一致があれば拒否します（web/verify-intent.js、docs/postlaunch/intent-manifest-spec.md、docs/postlaunch/browser-verification.md）。
• ガバナンス — 権限を拡大するポリシー変更のための、提案／承認の手続き（Schnorr 検証済み、ドメイン分離）（docs/postlaunch/governance-spec.md）。
• リスクパイプライン — 制限のみを行う、設定可能なレビュー／拒否アダプター（docs/postlaunch/risk-adapter-spec.md）。
• 予算の予約、ハッシュチェーン監査、Webhook／通知、マシン ID とスコープ付きケイパビリティ、冪等性、ドライランシミュレーション （docs/postlaunch/*）。
• KasWare マッピングとオフライン CLI 署名ツールのリファレンスを備えた ユニバーサル署名インターフェース （docs/postlaunch/signer-interface-spec.md、 signer-kasware-mapping.md、signer-cli-reference.md）。
• エージェント向けインターフェース：REST プラットフォーム API、MCP サーバー、Python クライアント、x402 および AP2 決済プロトコルアダプター。すべて単一の決定論的コアを利用する薄いクライアントであり、独自の金銭的権限を持つものはありません。

PolicyVault の API と提供される MCP ツールでは、スコープ付きの読み取り、サポート対象のシミュレーション、未署名リクエストを利用できます。MCP ツールは署名鍵を保持せず、署名や送信の操作も公開しません。PolicyVault の検証ツールを使えば、外部の署名者が署名する前に正確な操作内容を確認できます。より広範な API では、外部で生成された署名の添付と、別途認可された送信をサポートしています。また、ブラウザーも外部ウォレットを使用します。外部ウォレットまたは署名者を利用するエージェントを含む認可済みの委任先は、コベナントの制限、許可された宛先、予算、必須の承認の範囲内で操作します。リクエスト、署名、送信、オンチェーンでの検証済み受け入れは、それぞれ異なる段階です。コベナントは Kaspa のコンセンサスによって強制されます。

リポジトリの構成

パス	内容
contracts/	コベナントのソース（v0.1…v0.6）。tools/gen_v3.js、gen_v4.js、gen_v4_1.js、gen_v5.js、gen_v6.js を使って、バイト単位で完全に同一の状態に再生成できます
core/	移植可能で決定論的なコア：モデル、インテントマニフェスト、説明、ガバナンス、リスク、署名者（v1 と追加の v2 インターフェース）、実行証明、ランタイム間の同等性
sdk/	Node SDK：ビルダー、凍結／署名／確定、VM の事前チェック、送信とチェーン証明、照合、ストア（JSON と PostgreSQL）
server/	ホスト型ランタイム：API、認証／テナント管理／リクエスト保護、ガバナンス／リスクの適用、監査チェーン、Webhook、通知、証明のエクスポート、オプションの MCP テレメトリ（無効）、マイグレーション 001–010
web/	ブラウザークライアントとブラウザー内の独立した検証（verify-intent.js、core-bundle.js）
mcp/、python/、integrations/	MCP サーバー、Python クライアント、x402 と AP2 のアダプター
conformance/	JS、Python、MCP、x402、AP2 を同一のシナリオで実行する単一のマトリクス（経路間のバイト単位の同等性）
security/	エージェント向け境界を対象とする、内部の敵対的（悪意ある AI）テストスイート
mobile/	ネイティブモバイルアプリ（Capacitor Android プロジェクトと移植可能な Web ペイロード、ネイティブの本番環境向けトランスポート、ベアラー認証によるサインイン）— 開発中（上記を参照）
tests/vm/	Kaspa VM コベナントの実検証ワークスペース（Rust；TxScriptEngine）
deploy/	コンテナーのビルドと、ステージング／本番／セルフホスト向け compose の例、環境テンプレート、再現可能なデプロイパイプライン（deploy/pipeline/、ローカル証明のみ）
docs/	プロトコル仕様、アーキテクチャ、脅威モデル、不変条件、ホスト型設計、各サーフェスの仕様、コベナントの凍結記録
tools/、release-signers.json	コベナント生成ツール、受け入れテストハーネス、証明検証ツール、リリースマニフェスト／署名／検証ツール（署名者の公開鍵は未入力の OWNER-TO-FILL プレースホルダーです。署名済みのリリースはありません）

クイックスタート（セルフホスト、testnet-10）

# prerequisites: Node 20.x; a local Kaspa testnet-10 node with --utxoindex
#   (rusty-kaspa; JSON wRPC on ws://127.0.0.1:18210)
cd sdk && npm ci && npm test          # the SDK suite (serialized)
cd ../server && node src/server.js    # self-hosted mode, JSON persistence
# open http://127.0.0.1:3080 — connect a testnet KasWare wallet

PostgreSQL を利用したホスト型モード、コンテナビルド、コベナントの再生成とバイト単位での同一性検証、VM テストスイートを含む詳しい手順については、次を参照してください： docs/deployment.md、docs/hosted-deployment.md、docs/test-plan.md。 VM ワークスペースでは、公開されている silverscript と rusty-kaspa プロジェクトのチェックアウトが同階層にあることを想定しています（tests/vm/ と tools/stage-vendor.sh を参照）。

製品ポリシー（恒久）

フリーソフトウェアとセルフホスト — 商用利用を含む Apache 2.0。 公式のホスト型アクセスは現在無料です。Kaspa ネットワークの取引手数料は引き続き適用されます。 プロトコルおよびその仕組みに関する特許はありません。開発とホスティングの継続は、任意の KAS 寄付によって支えられています： kaspa:qyppakv5y7kmeynffldl9zshwgkjrl3fy9jjj8wf24v7f64v0gnuragz7ehdqhn （公開の受取アドレスです。このソフトウェアが寄付ウォレットの鍵を要求したり、取り扱ったりすることはありません）。詳細は docs/product-policy.md を参照してください。

セキュリティ

セキュリティモデル、主張 → 適用 → テスト → 証拠を厳密に結び付ける方針、PROVEN と DESIGN TARGET の違い、脆弱性の報告方法については、SECURITY.md をお読みください。