API Reference

Base URL: http://localhost:3000 (or your deployed URL). All request/response bodies are JSON. Standard HTTP status codes apply.

---

Agents

Register an agent

POST /api/agents/register

Creates a new agent and a Solana wallet (or links an existing public key if provided).

Request body:

{
  "agentId": "string (required)",
  "publicKey": "string (optional, existing Solana public key)"
}

Response: 201 Created

{
  "id": "agent-id",
  "publicKey": "Base58SolanaPublicKey...",
  "createdAt": "ISO8601",
  "updatedAt": "ISO8601",
  "isActive": true
}

Errors: 400 if agentId missing; 500 if registration fails (e.g. duplicate agent).

---