Yault AESP

AESP - Agent 经济主权协议

定义 AI Agent 如何在人类主权之下开展经济活动。

网站 | npm

什么是 AESP

AESP 是一个 TypeScript SDK 和 MCP 集成层，用于在明确的人类控制下处理 Agent 付款。它旨在让 Agent 执行经济操作，同时由人类保有完整的经济主权。

核心原则：

• 策略门控执行 -- 每项支出操作都受到可配置策略规则的约束（单笔交易限额、每日／每周／每月预算、地址允许列表、时间窗口）。
• 人工干预路径 -- 高风险操作会升级到审核队列，而不是自动批准。
• 可验证的承诺 -- 执行上下文可以关联到 EIP-712 签名意图，从而为链上结算提供保障。
• 实用集成 -- MCP 工具向 AI Agent 框架开放金库操作；子路径导出让你只导入所需内容。

安装

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

然后在 shell 或 .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-*）。该密钥与您的金库绑定 — 每位用户都管理自己的密钥。Agent 开发者无需密钥，除非他们也是金库用户；由最终用户在 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	Agent 身份派生、证书创建和层级管理
@yault/aesp/negotiation	带会话管理的报价／反报价状态机
@yault/aesp/commitment	用于双方签名协议的 EIP-712 结构化承诺构建器
@yault/aesp/review	带冻结／解冻控制的人工介入审核队列
@yault/aesp/mcp	MCP 工具定义、参数验证和服务路由器
@yault/aesp/a2a	用于跨 Agent 发现的 Agent 卡片构建器（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 围绕“有界自主性”构建：

• Agent API 密钥应在执行支出前绑定策略。
• 支出控制应包含单笔交易限额和滚动限额（日/周/月）。
• 适用时，目的地约束应基于允许列表。
• 敏感操作应保持在宽泛的 Agent 密钥权限范围之外。
• 违反策略时，以人工升级处理作为后备方案。

漏洞报告请参阅 SECURITY.md。

相关软件包

软件包	描述
@yault/elizaos-plugin-aesp	为 Agent 框架封装 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。