API Server

REST API for intent resolution, analytics, fleet, and provider probe.

Run

cd packages/api && pnpm run build && node dist/index.js

Default port: 3847. Override: PORT, AEP_CONFIG_PATH.

Config

Uses ~/.aep/config.json (including optional Tempo fields when MPP is enabled — see monetization). Key env vars:

VariableDescription
AEP_TREASURY_ADDRESSEnable paywall (treasury / payee)
AEP_PAYWALL_BACKENDx402 (default) or mpp (Tempo session)
MPP_SECRET_KEY / AEP_MPP_SECRET_KEYRequired for MPP
AEP_TEMPO_*Tempo RPC, chain, currency, escrow — see monetization

Endpoints

See REST API for full endpoint reference.

AreaEndpoints
HealthGET /health
IntentPOST /resolve, POST /resolve/premium
AnalyticsGET /analytics/account/:address, etc.
FleetGET /fleet/:id/summary, /accounts, /alerts
ProbePOST /probe, POST /probe/batch
GraphQLPOST /graphql