AESP - Agent Economic Sovereignty Protocol

定义 AI 代理如何在人类主权下进行经济活动。

网站 | npm

什么是 AESP

AESP 是一个 TypeScript SDK 和 MCP 集成层，用于在人类明确控制下进行代理支付。它旨在让代理能够执行经济操作，同时人类保留完整的经济主权。

核心原则：

• 策略门控执行 -- 每笔支出操作都受可配置策略规则约束（每笔交易限额、每日/每周/每月预算、地址白名单、时间窗口）。

• 人工干预路径 -- 高风险操作会被升级到审查队列，而不是自动批准。

• 可验证承诺 -- 执行上下文可绑定到 EIP-712 签名意图，从而提供链上结算保证。

• 实用集成 -- MCP 工具将保险库操作暴露给 AI 代理框架；子路径导出让你只导入所需内容。

Related MCP server: AgentPay MCP Server

安装

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-*）。该密钥与你的保险库绑定——每个用户管理自己的密钥。代理开发者无需密钥，除非他们同时也是保险库用户；由最终用户在自己的 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 按子路径导出组织，让你只需导入所需内容：

MCP 工具

stdio 服务器暴露了 6 个与后端连接的工具：

后端要求

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。

相关包

开发

运行测试：

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。