AESP - Agent Economic Sovereignty Protocol

인간의 주권 하에서 AI 에이전트가 경제적으로 작동하는 방식을 정의합니다.

웹사이트 | npm

AESP란 무엇인가

AESP는 명시적인 인간 통제 하에 에이전트 결제를 위한 TypeScript SDK 및 MCP 통합 레이어입니다. 에이전트가 경제적 행동을 실행할 수 있으면서도 인간이 완전한 경제적 주권을 유지하도록 설계되었습니다.

핵심 원칙:

• 정책 게이트 실행 -- 모든 지출 행동은 구성 가능한 정책 규칙(per-tx 한도, 일일/주간/월간 예산, 주소 허용 목록, 시간 창)에 의해 제한됩니다.

• 인간 개입 경로 -- 위험한 행동은 자동 승인 대신 검토 큐로 에스컬레이션됩니다.

• 검증 가능한 커밋먼트 -- 실행 컨텍스트를 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

그런 다음 셸 또는 .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는 '제한된 자율성(bounded autonomy)'을 중심으로 구축되었습니다:

• 에이전트 API 키는 지출 실행 전에 정책에 바인딩되어야 합니다.

• 지출 통제에는 per-tx 및 롤링 한도(일일/주간/월간)가 포함되어야 합니다.

• 대상 제약은 적용 가능한 경우 허용 목록 기반이어야 합니다.

• 민감한 작업은 광범위한 에이전트 키 범위 밖에 유지되어야 합니다.

• 정책 위반 시 인간 에스컬레이션이 폴백으로 유지됩니다.

취약점 신고는 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를 참조하세요.