spec v0.1

Open standard

Agent-Token Provenance.

An open spec linking ERC-8004 agent identities to the tokens they deploy. Bridges the gap between identity registries (who an agent is) and onchain output (what an agent ships). MIT-licensed, free to adopt.

Why this exists

ERC-8004 standardizes identity, reputation, and validation for agents. Three excellent registries β€” but none of them answer the most practical question:

β€œWhat has this agent actually deployed onchain?”

And the reverse:

β€œWho deployed this token?”

Agent-Token Provenance fills that gap. Two endpoints, deterministic JSON, CORS-enabled. Works with any ERC-8004-registered agent that opts in.

The two endpoints

GET/api/erc8004/agents/[id]

Agent profile. Returns identity links + every token the agent has deployed (if known to LiquidPad's index).

curl https://www.liquidpad.site/api/erc8004/agents/50962
GET/api/erc8004/provenance/[address]

Reverse lookup. Given a token address, returns which agent deployed it (or null if unknown).

curl https://www.liquidpad.site/api/erc8004/provenance/0xBF0775cBCA2744549cD016DAb8D3B3403De58bBF

Both endpoints: CORS-enabled, no auth required, 60-second cache.

Response schema

Provenance lookup ( /api/erc8004/provenance/[address] ):

{
  "ok": true,
  "address": "0xbf0775...",
  "provenance": {
    "agentId": 50962,
    "launchpad": "LiquidPad",
    "identityRegistry": "0x8004A169FB...",
    "chainId": 8453,
    "deployedAt": "2026-04-15T...",
    "txHash": "0x..."
  },
  "token": { "name": "...", "symbol": "...", "tokenPage": "...", "verify": "..." },
  "agent":  { "profile": "...", "explorer": "..." },
  "feeSplit": { "deployerBps": 8000, "lpadBurnBps": 1500, "liqBuybackBps": 500 },
  "asOf": "..."
}

Use cases

Wallet badge

Show 'Verified by Agent #50962' tooltip on tokens in any wallet UI.

Indexer enrichment

Add launchpad provenance to token records in any DeFi indexer.

Anti-impersonation

Confirm a token claiming 'launched via XYZ launchpad' actually has matching agent provenance.

Agent leaderboards

Rank agents by deployment count, total volume routed, longevity.

For other launchpads

If you operate a launchpad with an ERC-8004 agent identity and want to be queryable through this spec, you have two paths:

Option A Β· Self-host

Implement the same JSON schema at /api/erc8004/provenance/... on your domain. Index will federate via a public registry of participating launchpads (coming).

Option B Β· Submit your registry

Open a PR to liquidpadbot/agent-token-provenance with your agent ID and a public token-list endpoint. We index it alongside LiquidPad. (Repo coming once we have one external participant ready.)

Reference data

Open spec, MIT-licensed.

No vendor lock-in. No central permission. Build with us β€” or fork and ship your own.