AESP - Agent Economic Sovereignty Protocol

Wie KI-Agenten unter menschlicher Souveränität wirtschaftlich agieren.

Website | npm

Was ist AESP?

AESP ist eine TypeScript-SDK- und MCP-Integrationsschicht für Agentenzahlungen unter ausdrücklicher menschlicher Kontrolle. Es ist darauf ausgelegt, dass Agenten wirtschaftliche Handlungen ausführen können, während Menschen die volle wirtschaftliche Souveränität behalten.

Kernprinzipien:

• Policy-gesteuerte Ausführung – jede Zahlungsaktion ist durch konfigurierbare Policy-Regeln begrenzt (Limits pro Transaktion, Tages-/Wochen-/Monatsbudgets, Adress-Allowlisten, Zeitfenster).

• Manuelle Übersteuerung – risikobehaftete Aktionen werden nicht automatisch genehmigt, sondern in eine Review-Warteschlange eskaliert.

• Überprüfbare Commitments – der Ausführungskontext kann an eine per EIP-712 signierte Absicht gebunden werden, was on-chain Abwicklungsgarantien ermöglicht.

• Praktische Integration – MCP-Tools stellen Vault-Operationen für KI-Agenten-Frameworks bereit; Subpath-Exports ermöglichen es, nur das zu importieren, was benötigt wird.

Related MCP server: AgentPay MCP Server

Installation

npm install @yault/aesp

Erfordert Node.js >= 18.

Schnellstart

Zu Claude Desktop hinzufügen

Fügen Sie Folgendes zur Claude-Desktop-Konfiguration (claude_desktop_config.json) hinzu:

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

Zu Claude Code hinzufügen

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

Setzen Sie danach die Umgebungsvariable YAULT_API_KEY in Ihrer Shell oder in .claude/settings.json.

Standaline ausführen

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

API-Schlüssel abrufen

Gehen Sie auf yault.xyz, um ein Konto zu erstellen und Ihren API-Schlüssel (sk-yault-*) zu erhalten. Der Schlüssel ist an Ihren Vault gebunden – jeder Benutzer verwaltet seinen eigenen Schlüssel. Agentenentwickler benötigen keinen Schlüssel, außer wenn sie selbst Vault-Benutzer sind; der Endbenutzer konfiguriert seinen eigenen Schlüssel im MCP-Client.

SDK-Module verwenden

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

Module

AESP ist in Subpath-Exports organisiert, sodass Sie nur das importieren können, was Sie benötigen:

MCP-Tools

Der stdio-Server stellt sechs an das Backend angebundene Tools bereit:

Backend-Anforderungen

Der MCP-Server ist ein schlanker API-Client. Er erwartet ein Yault-Backend, das Folgendes bereitstellt:

• 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, sharesx }

• POST /api/vault/transfer – { from_address, to_address, amount, currency? }

Authentifizierung über: Authorization: Bearer sk-yault-* via Umgebungsvariable YAULT_API_KEY.

Sicherheitsmodell

AESP ist um das Konzept der „begrenzten Autonomie“ herum aufgebaut:

• API-Schlüssel von Agenten sollten vor der Ausführung von Zahlungen an eine Policy gebunden sein.

• Ausgabenkontrollen should include per-transaction limits and weekly, weekly, monthly Limits.

• Zieladressen-Einschränkungen sollten, wo aufwendbar, über Allowlist gesteuert werden.

• Sensible Vorgänge sollten außerhalb weit gefasster Geltungsbereiche von Agentenschlüsseln bleiben.

• Die menschliche Eskalation bleibt der Fallback bei Policy-Verstößen.

Für Rissséverwaltung siehe SECURITY.md.

Verwandte Pakete

Entwicklung

Tests ausführen:

npm test

TypeScript-Build:

npm run build:ts

WASM-Build (erfordert acegf-wallet als Geschwisterrepository oder das Setzen von ACEGF_ROOT):

npm run build:wasm
npm run build:ts

Siehe CONTRIBUTING.md für den vollständigen Entwicklungsleitfaden.

Lizenz

Dieses Projekt ist unter der Apache License 2.0 lizenziert. Siehe LICENSE für den vollständigen Lizenztext.