AESP - Agent Economic Sovereignty Protocol

Defining how AI agents operate economically under human sovereignty.

Sitio web | npm

¿Qué es AESP?

AESP es un SDK de TypeScript y una capa de integración MCP para pagos de agentes bajo control humano explícito. Está diseñado para que los agentes puedan ejecutar acciones económicas mientras los humanos conservan plena soberanía económica.

Principios fundamentales:

• Ejecución controlada por políticas -- cada acción de gasto está limitada por reglas de política configurables (límites por transacción, presupuestos diarios/semanales/mensuales, listas blancas de direcciones, ventanas de tiempo).

• Vía de anulación humana -- las acciones arriesgadas se escalan a una cola de revisión en lugar de aprobarse automáticamente.

• Compromisos verificables -- el contexto de ejecución puede vincularse a una intención firmada EIP-712, lo que permite garantías de liquidación en cadena.

• Integración práctica -- las herramientas MCP exponen operaciones de bóveda a los frameworks de agentes de IA; las exportaciones de subruta permiten importar solo lo que necesitas.

Related MCP server: AgentPay MCP Server

Instalación

npm install @yault/aesp

Requiere Node.js >= 18.

Inicio rápido

Añadir a Claude Desktop

Añade lo siguiente a la configuración de Claude Desktop (claude_desktop_config.json):

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

Añadir a Claude Code

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

Luego, define la variable de entorno YAULT_API_KEY en tu shell o en .claude/settings.json.

Ejecutar de forma independiente

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

Obtener tu clave de API

Ve a yault.xyz para crear una cuenta y obtener tu clave de API (sk-yault-*). La clave está vinculada a tu bóveda: cada usuario gestiona su propia clave. Los desarrolladores de agentes no necesitan una clave a menos que también sean usuarios de bóveda; es el usuario final quien configura su propia clave en el cliente MCP.

Usar los módulos del 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

Módulos

AESP está organizado en exportaciones de subruta para que puedas importar solo lo que necesites:

Herramientas MCP

El servidor stdio expone 6 herramientas conectadas al backend:

Requisitos del backend

El servidor MCP es un cliente de API ligero. Espera que un backend de Yault proporcione:

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

Autenticación: Authorization: Bearer sk-yault-* mediante la variable de entorno YAULT_API_KEY.

Modelo de seguridad

AESP está construido en torno a la "autonomía acotada":

• Las claves de API de los agentes deben estar vinculadas a políticas antes de la ejecución de gastos.

• Los controles de gasto deben incluir límites por transacción y límites renovables (diarios/semanales/mensuales).

• Las restricciones de destino deben basarse en listas blancas cuando corresponda.

• Las operaciones sensibles deben permanecer fuera de los ámbitos amplios de las claves de los agentes.

• La escalada humana sigue siendo el recurso de respaldo ante violaciones de políticas.

Para notificar vulnerabilidades, consulta SECURITY.md.

Paquetes relacionados

Desarrollo

Ejecutar las pruebas:

npm test

Compilar TypeScript:

npm run build:ts

Compilar con WASM (requiere acegf-wallet como repositorio hermano, o establecer ACEGF_ROOT):

npm run build:wasm
npm run build:ts

Consulta CONTRIBUTING.md para obtener la guía de desarrollo completa.

Licencia

Este proyecto está licenciado bajo la Apache License 2.0. Consulta LICENSE para ver el texto completo.