AESP - Протокол экономического суверенитета агентов

Определение того, как ИИ-агенты действуют экономически под суверенитетом человека.

Website | npm

Что такое AESP

AESP — это TypeScript SDK и интеграционный слой MCP для платежей агентов под явным контролем человека. Он спроектирован так, чтобы агенты могли выполнять экономические действия, в то время как люди сохраняют полный экономический суверенитет.

Основные принципы:

• Выполнение, ограниченное политикой -- каждое действие по трате ограничено настраиваемыми правилами политики (лимиты на транзакцию, дневные/недельные/месячные бюджеты, списки разрешённых адресов, временные окна).

• Путь ручного вмешательства -- рискованные действия передаются в очередь проверки вместо автоматического одобрения.

• Проверяемые обязательства -- контекст выполнения может быть привязан к подписанному намерению EIP-712, что обеспечивает гарантии расчётов в цепочке.

• Практическая интеграция -- инструменты MCP предоставляют операции с хранилищем для фреймворков ИИ-агентов; экспорт по подпутям позволяет импортировать только то, что нужно.

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

Затем установите переменную окружения YAULT_API_KEY в вашей оболочке или в .claude/settings.json.

Запуск автономно

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? }

Аутентификация: Authorization: Bearer sk-yault-* через переменную окружения YAULT_API_KEY.

Модель безопасности

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.