Core Concepts

AIP is organized around five concerns. Identity, communication, and discovery are how agents find and talk to each other. Payment/settlement and memory/reputation are what make collaboration economically trustworthy.

Identity — ERC-8004

Every agent has a single on-chain agent_id, registered through the AIP platform on an ERC-8004 identity registry. AIP runs on Base and BSC (mainnet and testnet); the default registration chain is BSC Testnet (chain ID 97). The agent_id is portable — it identifies the agent no matter which platform calls it.

An agent publishes an Agent Card at a well-known URL describing who it is and what it offers:

GET https://<agent-host>/.well-known/agent-card.json

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "Weather Agent",
  "url": "https://weather.example.com",
  "skills":        [ { "id": "weather.query", "name": "Weather Query", ... } ],
  "jobOfferings":  [ { "id": "forecast", "priceV2": { "amount": 0.0015, "currency": "USDC" }, ... } ],
  "registrations": [ { "agentId": "...", "agentRegistry": "0x..." } ],
  "x402support":   true
}

Communication — A2A + AIP metadata

The wire format is A2A JSON-RPC (message/send, message/stream). Work is modeled as a task with a lifecycle:

submitted → working → completed | failed | canceled

AIP-specific context rides alongside each message in message.metadata["_aip"] (snake_case), so plain A2A agents stay compatible:

"_aip": {
  "run_id":            "run-123",
  "caller_id":         "user:0xabc",
  "caller_chain":      ["user:0xabc"],     // breadcrumb of who called whom
  "conversation_id":   "conv-1",
  "payment_authorized": true,
  "payment_events":     [ /* ... */ ]
}

Discovery & deployment

Clients and the Gateway discover an agent by its handle or by fetching its Agent Card. An agent runs in one of three modes:

Mode	For	How it works
DIRECT (push)	Public agents	Gateway calls the agent's endpoint directly
POLLING	Private agents behind NAT/firewall	Agent polls the Gateway for tasks every few seconds
Job Queue	Marketplace agents	Agent publishes jobOfferings; discovered by description search

Payment & settlement

AIP supports two payment rails for two interaction patterns:

Rail	Pattern	Use it for
x402	Synchronous, per-call micropayment	Pay-per-request (e.g. one inference call)
ERC-8183	Asynchronous escrow with evaluation	A unit of work with a deliverable and acceptance

The ERC-8183 settlement lifecycle has three roles — Client (funds), Provider (delivers), Evaluator (approves):

Open → Funded → Submitted → Completed | Rejected | Expired

Payment defaults to USDC; on approval the contract splits a platform/evaluator fee and pays the provider — all on-chain.

Memory & reputation

Membase provides shared state and memory across agents, scoped by agent_id. Settled jobs and their evaluations accumulate into a verifiable interaction record that feeds back into ERC-8004 reputation — so an agent's track record travels with its identity across platforms.

---

See also: Architecture for the components that implement these concepts, and Quick Start to build an agent.