# LiquidPad — Token launchpad with onchain provenance for agents

Curated meme-coin launchpad on Base, with ERC-8004 anchored agent provenance,
an open registry of every wallet that has shipped via Liquid Protocol, and
agent-payable read endpoints over the x402 protocol.

## Quick facts

- **Network:** Base mainnet (chainId 8453)
- **Onchain identity:** ERC-8004 Agent #50962
- **Identity registry:** `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432`
- **Operator wallet:** `0x188177dF522f81A9bEd88D25d1969A0B700b50E0`
- **Fee split (immutable):** 80% deployer · 15% \$LPAD burn · 5% \$LIQ buyback

## Free read endpoints (public, no auth)

```
GET https://www.liquidpad.site/api/verify/{address}
GET https://www.liquidpad.site/api/erc8004/provenance/{address}
GET https://www.liquidpad.site/api/agents
GET https://www.liquidpad.site/api/agents/{address}
GET https://www.liquidpad.site/api/burn
GET https://www.liquidpad.site/api/treasury
GET https://www.liquidpad.site/api/stats
```

CORS-enabled, JSON, sourced live from the Liquid Protocol factory contract.
Use these for reads that don't need an SLA.

## Agent-payable read endpoints (x402)

```
GET https://www.liquidpad.site/api/x402/verify/{address}        \$0.001 USDC
GET https://www.liquidpad.site/api/x402/provenance/{address}    \$0.001 USDC
GET https://www.liquidpad.site/api/x402/agents?limit=N          \$0.005 USDC
```

Spec-compliant x402 v1. Cold call returns HTTP 402 with payment requirements;
client signs an EIP-3009 `transferWithAuthorization` for USDC on Base, retries
with `X-PAYMENT` header, server settles via Coinbase CDP facilitator and
returns the data plus a settlement tx hash in `X-PAYMENT-RESPONSE`.

Discovery + payment flow: https://www.liquidpad.site/x402
Examples (real x402-fetch payments): https://github.com/liquidpadbot/liquidpad-x402-examples

## Deploy a token

Two paths:

### Telegram bot (managed, recommended for humans)

Open https://t.me/liquidpadbot, run:

```
/start
/setaddress 0xYOUR_WALLET
/launch
```

The bot handles concept curation, name + symbol, deploy, and ERC-8004
registration. Every deploy is anchored to LiquidPad's Agent #50962.

### MCP server (for AI assistants)

Add to Claude, Cursor, or Kiro:

```json
{
  "mcpServers": {
    "liquidpad": {
      "command": "npx",
      "args": ["-y", "liquidpad-mcp"],
      "env": { "LIQUIDPAD_API_KEY": "your-key" }
    }
  }
}
```

Get a key with `/apikey` in the Telegram bot. Public read tools work
without a key.

### aeon framework skill

```
./add-skill aaronjmars/aeon liquidpad-launch
```

Skill source: https://github.com/aaronjmars/aeon/tree/main/skills/liquidpad-launch

## Verify a token deployed by LiquidPad

```bash
curl https://www.liquidpad.site/api/verify/<address> | jq
```

Returns `{ verified, name, symbol, deployedAt, kind, erc8004AgentId }`.

## Cross-ecosystem agent registry

Every wallet that has shipped a token via Liquid Protocol on Base — sourced
live from the factory contract, not a private index. Includes deploy counts,
ERC-8004 verification status, and recent symbols.

```bash
curl 'https://www.liquidpad.site/api/agents?limit=100' | jq
```

Live UI: https://www.liquidpad.site/agents/all

## LiquidPad-curated launchpad token

\$LPAD is the curation token. It is not required to use the read endpoints,
the verify path, the registry, or the x402 endpoints. Holders unlock token
listing on the LiquidPad-curated launchpad and tier multipliers on the LLM
gateway when that goes live.

Token + addresses are deliberately not embedded in this file — surface them
via the verify endpoint or the live token page.

## Resources

- Discovery for x402 endpoints: https://www.liquidpad.site/x402
- MCP setup: https://www.liquidpad.site/mcp
- Manifesto: https://www.liquidpad.site/manifesto
- Source repos: https://github.com/liquidpadbot
- X bot: https://x.com/LiquidPadBot
- Telegram: https://t.me/liquidpadbot

## License

The platform code is open. Read endpoints are public. The agent-payable
endpoints settle in USDC on Base via the Coinbase CDP facilitator.