Agent Identity
Public agt_… IDs, Solana/Base wallets, and discovery cards for A2A — no API keys.
Overview
Executive Lounge supports agent-to-agent (A2A) workflows: autonomous software registers a stable identity, exposes wallet addresses for x402 USDC, and publishes a machine-readable agent card other agents can fetch.
- Agent ID —
agt_+ hex (e.g.agt_a1b2c3d4e5f67890) - Wallets — at least one of Solana or Base (EVM); used to sign x402 micropayments
- Server stores — name, description, public addresses only
- Registration — free; paid APIs still require x402 per call
Production base URL: https://conc-exe.xyz (replace with your deployment origin if self-hosting).
Lounge UI
- Open the Executive Lounge
- Sidebar → Navigate → Agent identity
- Enter a name (and optional description)
- Generate wallets — Solana + Base keypairs are created in your browser
- Save the secrets shown once (export to your vault)
- Register identity — server returns
agt_…and card URLs - Fund wallets with ≥0.1 USDC (and a little SOL on Solana for transaction fees when gas is not sponsored)
After registration, Concierge calls from the lounge automatically send X-Agent-Id when an identity is stored in the browser.
Discovery endpoints
| URL | Purpose |
|---|---|
GET /.well-known/agent-card.json | Service registry — how to register agents on this deployment |
POST /api/agent-identity | Register agent (public keys only) |
GET /api/agent-identity?id=agt_… | Profile + embedded card JSON |
GET /api/agent-identity-card?id=agt_… | Per-agent HTTP card (includes erc8004 when linked) |
GET /api/agent-identity-registration?id=agt_… | EIP-8004 registration file (agentURI) |
GET /api/agent-identity-erc8004?id=agt_… | Prepare Base Identity Registry register(agentURI) |
POST /api/agent-identity-erc8004 | Verify mint + link on-chain tokenId to agt_… |
GET /api/agent-identity?list=1&limit=24 | Public directory (latest agents) |
Also use GET /openapi.json, GET /.well-known/x402, and the MPPscan listing (npx agentcash add https://conc-exe.xyz) for paid Concierge routes.
Register (API)
Programmatic registration for bots that generate keys in your own infrastructure (not the lounge UI).
POST /api/agent-identity
Content-Type: application/json
{
"name": "Macro Scout",
"description": "Optional one-line purpose",
"solAddress": "7hum…",
"evmAddress": "0x…"
}
At least one of solAddress or evmAddress is required. Invalid addresses return 400.
Response (200)
{
"ok": true,
"agent": {
"id": "agt_a1b2c3d4e5f67890",
"name": "Macro Scout",
"cardUrl": "https://conc-exe.xyz/api/agent-identity-card?id=agt_…",
"profileUrl": "https://conc-exe.xyz/api/agent-identity?id=agt_…",
"registrationUrl": "https://conc-exe.xyz/api/agent-identity-registration?id=agt_…"
},
"card": { "...": "per-agent HTTP card" },
"message": "Identity registered. Store private keys only on the agent…"
}
Re-registering the same wallet pair is idempotent — you receive the existing agt_… id.
OOBE Synapse SAP (optional)
{
"name": "OOBE Trader",
"solAddress": "7xKX…",
"sapWallet": "7xKX…",
"sapAgentPda": "AgentPDA…"
}
Link later: PATCH /api/agent-identity with id, sapWallet, and/or sapAgentPda. See OOBE integration.
Pay Concierge as an agent
- Register identity and fund agent wallets with USDC
POST /api/conciergewithout payment → 402 +PAYMENT-REQUIRED- Sign USDC on Solana or Base with the agent wallet (not a human hot wallet unless intended)
- Retry with
PAYMENT-SIGNATURE - Optional header:
X-Agent-Id: agt_…— when the id exists, the 200 body includesagent: { id, name, solAddress, evmAddress }for attribution
Price: 0.1 USDC per successful Concierge call. See Concierge Chat and Quickstart.
Agent card format
Each agent exposes a machine-readable card (executive-lounge-agent-card-v1) including:
- accounts — Solana and/or Base addresses
- services — Concierge, news-open, and other x402 routes with USDC pricing
- discovery — links to
/.well-known/x402and/openapi.json
HTTP + optional on-chain. Register agt_… first, then mint into the canonical ERC-8004 Identity Registry on Base (0x8004A169…) with agentURI pointing at /api/agent-identity-registration?id=. Lounge UI: Mint ERC-8004 on Base (needs ETH on Base for gas).
Fetch HTTP card: GET /api/agent-identity-card?id=agt_… · Registration file: GET /api/agent-identity-registration?id=agt_…
Security
- Private keys — generated in the browser (
/js/agent-identity.mjs) or in your backend; never POST secrets to Executive Lounge - Server KV — stores public addresses and display metadata only
- Wallet hygiene — use dedicated agent wallets; fund with only what you need for micropayments
- On-chain — x402 payments are public; do not treat agent wallets as long-term custody
Registration is free. Compromised keys cannot be rotated in-place today — register a new agent with new wallets if needed.
Concierge · Agent identity