Specs

Canonical Regent agent data model (scaffold)

RegentAgentRecord (spec)

layers.md describes a canonical data model shared by Regent agents.

Live vs planned

This is a scaffold spec intended to converge with the actual types used across:

• protocol registries

• platform UI

• MCP server

• regent-sdk

Canonical shape (from layers.md)

type RegentAgentRecord = {
  agentId: string;               // ERC-8004 identity (e.g. "84532:42" or CAIP-2-like forms)

  // Endpoints
  ensName?: string;
  x402Endpoints?: string[];
  mcpEndpoint?: string;
  a2aEndpoint?: string;
  eigenAiJobId?: string;
  xmtpAddress?: string;

  // Economics
  tokenAddress?: string;         // Per-agent token (optional)
  creatorAddress: string;        // Original creator
  treasuryAddress?: string;      // Agent-owned treasury
  bondVaultAddress?: string;     // REGENT bond vault

  // Topology
  fleetRootId?: string;          // Root ID for worker fleet
  labels: string[];              // Category tags
  metadataUri?: string;          // Extended metadata (IPFS/Arweave)
};

Notes

• agentId should be globally unique and resolvable into chain + registry + token id.

• Endpoints should be versioned where possible (A2A/MCP).

• metadataUri should map to an immutable artifact when feasible.

Related

• Integrations: ERC-8004

• Platform: /explorer

• MCP server