Yault AESP

AESP - エージェント経済主権プロトコル

人間の主権のもとで、AI エージェントが経済活動を行う方法を定義します。

ウェブサイト | npm

AESP とは

AESP は、明示的な人間の管理下でエージェントによる支払いを実現するための TypeScript SDK および MCP 統合レイヤーです。人間が完全な経済的主権を維持しながら、エージェントが経済的な操作を実行できるように設計されています。

主な原則：

• ポリシーに基づく実行 -- すべての支出操作は、設定可能なポリシールール（1 件あたりの上限、日次・週次・月次予算、アドレスの許可リスト、時間帯）によって制限されます。
• 人間による介入経路 -- リスクの高い操作は自動承認されず、審査キューにエスカレーションされます。
• 検証可能なコミットメント -- 実行コンテキストを EIP-712 署名付きインテントに紐づけることで、オンチェーン決済の保証を実現できます。
• 実用的な統合 -- MCP ツールによって、AI エージェントのフレームワークからボールト操作を利用できます。サブパスエクスポートを使えば、必要なものだけをインポートできます。

インストール

npm install @yault/aesp

Node.js >= 18 が必要です。

クイックスタート

Claude Desktop に追加する

以下を Claude Desktop の設定（claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "yault": {
      "command": "npx",
      "args": ["-y", "@yault/aesp"],
      "env": {
        "YAULT_API_KEY": "sk-yault-..."
      }
    }
  }
}

Claude Code に追加する

claude mcp add yault -- npx -y @yault/aesp

次に、シェルまたは .claude/settings.json で環境変数 YAULT_API_KEY を設定します。

スタンドアロンで実行する

export YAULT_API_KEY="sk-yault-..."
yault-mcp                  # if installed globally
npx @yault/aesp            # via npx

API キーを取得する

yault.xyz にアクセスしてアカウントを作成し、API キー（sk-yault-*）を取得します。このキーはボールトに紐づいており、各ユーザーが自分のキーを管理します。エージェント開発者がキーを必要とするのは、自身もボールトのユーザーである場合のみです。MCP クライアントで自分のキーを設定するのはエンドユーザーです。

SDK モジュールを使用する

import { PolicyEngine } from '@yault/aesp/policy';
import { getAllMCPTools } from '@yault/aesp/mcp';
import { NegotiationStateMachine } from '@yault/aesp/negotiation';

const engine = new PolicyEngine(storageAdapter);
await engine.load();

const tools = getAllMCPTools(); // 6 MCP tool definitions

モジュール

AESP はサブパスエクスポートで構成されているため、必要なものだけをインポートできます。

サブパス	説明
@yault/aesp	すべてのモジュールをまとめて再エクスポート
@yault/aesp/types	共通の型定義（AgentExecutionRequest、TransferPayload、ChainId など）
@yault/aesp/policy	8 項目のチェックによる評価、予算追跡、ポリシー変更の分類を備えたポリシーエンジン
@yault/aesp/identity	エージェント ID の導出、証明書の作成、階層管理
@yault/aesp/negotiation	セッション管理を備えたオファー／カウンターオファーのステートマシン
@yault/aesp/commitment	双方署名による合意向けの EIP-712 構造化コミットメントビルダー
@yault/aesp/review	凍結／凍結解除の制御機能を備えた、人間参加型の審査キュー
@yault/aesp/mcp	MCP ツール定義、引数検証、サーバールーター
@yault/aesp/a2a	エージェント間の検出に使用するエージェントカードビルダー（A2A プロトコル）
@yault/aesp/crypto	署名、暗号化、ハッシュ化、ZK 証明ブリッジなどの暗号ヘルパー
@yault/aesp/privacy	コンテキストのタグ付け、一時アドレスプール、統合スケジュール設定

MCP ツール

stdio サーバーは、バックエンドに接続する以下の 6 つのツールを公開します。

ツール	メソッド + エンドポイント	目的
yault_check_balance	GET /api/vault/balance/:address	ウォレットボールトの残高を読み取る
yault_deposit	POST /api/vault/deposit	原資産をボールトに預け入れる
yault_redeem	POST /api/vault/redeem	ボールトのシェアを償還する
yault_transfer	POST /api/vault/transfer	ボールトの割当額を転送する（親アカウントからサブアカウントへ）
yault_check_authorization	GET /api/vault/agent-authorization	オペレーター／許可額の状態を読み取る
yault_get_balances	GET /api/vault/balances/:address	複数残高の内訳を読み取る

バックエンド要件

MCP サーバーは薄い API クライアントです。以下を提供する Yault バックエンドを必要とします。

• GET /api/vault/balance/:address
• GET /api/vault/balances/:address
• GET /api/vault/agent-authorization
• POST /api/vault/deposit -- { address, amount }
• POST /api/vault/redeem -- { address, shares }
• POST /api/vault/transfer -- { from_address, to_address, amount, currency? }

認証：環境変数 YAULT_API_KEY を介した Authorization: Bearer sk-yault-*。

セキュリティモデル

AESP は「制限付き自律性」を中心に構築されています。

• 支出を実行する前に、エージェントの API キーをポリシーに紐付けてください。
• 支出制御には、取引ごとの上限と一定期間ごとの上限（日次／週次／月次）を含めてください。
• 該当する場合、送金先の制約には許可リストを使用してください。
• 機密性の高い操作は、広範なエージェントキーのスコープ外に置いてください。
• ポリシー違反時には、人間へのエスカレーションを最終手段とします。

脆弱性の報告については、SECURITY.md を参照してください。

関連パッケージ

パッケージ	説明
@yault/elizaos-plugin-aesp	エージェントフレームワーク向けに AESP をラップする ElizaOS プラグイン

開発

テストを実行します。

npm test

TypeScript をビルドします。

npm run build:ts

WASM を使ってビルドします（兄弟リポジトリとして acegf-wallet が必要です。または ACEGF_ROOT を設定してください）。

npm run build:wasm
npm run build:ts

開発ガイド全体については、CONTRIBUTING.md を参照してください。

ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。全文については LICENSE を参照してください。