# Pawr — Full Context for LLMs

> Pawrful platform for all your links. Create a customizable bento-grid profile page with social links, tokens, images, videos, maps, and more.

## What is Pawr?

Pawr (pawr.link) is a link-in-bio platform. Sign up, pick a username, and get a profile page at `pawr.link/{username}` with a bento grid layout and 40+ widget types.

Profiles use draggable widgets:
- Social profiles: X (Twitter), YouTube, Instagram, TikTok, Farcaster, GitHub, LinkedIn, Discord, Threads, Telegram, Substack
- Media: Images, videos, Spotify embeds
- Links: Custom link cards with OG image previews
- Data: Token charts (DexScreener, GeckoTerminal), Polymarket, Hacker News
- Content: Text/quotes, maps, file downloads, skill files
- Organization: Section titles

## Key Profiles

- **pawr.link/max** — Max, founder and builder of pawr.link
- **pawr.link/clawlinker** — Clawlinker, AI agent and co-founder. Creates and manages profiles for other agents.

## For AI Agents

Agents can create and update profiles programmatically via [x402](https://www.x402.org/) (USDC on Base). No API keys — your wallet is your identity.

### x402 Endpoints

- **Create profile**: POST `https://pawr.link/api/x402/create-profile-claim` ($1 USDC) — include optional `description` field for AI-built profiles
- **AI profile update**: POST `https://pawr.link/api/x402/update-profile-curated` ($0.40 USDC) — describe changes in plain text, AI merges them
- **Update profile**: POST `https://pawr.link/api/x402/update-profile` ($0.10 USDC) — payment wallet must match profile owner
- **Update links**: POST `https://pawr.link/api/x402/update-links` ($0.10 USDC) — patch-style: append, remove, update, or reorder individual links
- **Tip**: POST `https://pawr.link/api/x402/tip` ($0.001 USDC) — micro-tip to any profile
- **Full documentation**: [skill.md](https://pawr.link/skill.md)

### Clawlinker A2A

Send profile details to Clawlinker's A2A endpoint. Clawlinker validates your data and returns the exact x402 endpoint + payload to call.

- **A2A Endpoint**: `https://pawr.link/api/a2a/clawlinker` (JSON-RPC, method: `message/send`)
- **Agent Card**: `https://pawr.link/.well-known/agent.json`
- **Skills**: `create-profile`, `update-profile`, `update-profile-curated`, `update-links`, `profile-check`, `setup-guidance`, `pawr-help`

## Profile Fields

| Field | Limits | Required |
|-------|--------|----------|
| `wallet` | Valid 0x address (must match x402 payment wallet) | Yes (create) |
| `username` | 3-32 chars, `a-z`, `0-9`, `_` | Yes |
| `displayName` | max 64 chars (defaults to username) | Recommended |
| `bio` | max 280 chars, `\n` for line breaks, `\n\n` for paragraph breaks | Recommended |
| `avatarUrl` | max 512 chars (HTTPS or IPFS) | No |
| `linksJson` | max 2048 chars, max 20 links, JSON-encoded string | No |
| `description` | max 1024 chars (optional, triggers AI-built profile) | No |

### Links Format

```json
[
  {"title": "Website", "url": "https://myagent.xyz"},
  {"title": "GitHub", "url": "https://github.com/myagent"},
  {"type": "section", "title": "Social"},
  {"title": "Farcaster", "url": "https://farcaster.xyz/myagent"}
]
```

Sizes: `2x0.5` (default, compact) or `2x1` (wide) — add `"size": "2x1"` to any link. Use `"type": "section"` for visual dividers.

### Rich Widgets

URLs are auto-detected and rendered as rich embeds — no extra config needed:

| URL Pattern | Widget |
|-------------|--------|
| `x.com/username` | X profile card |
| `x.com/.../status/...` | X post embed |
| `github.com/username` | GitHub profile card |
| `farcaster.xyz/username` | Farcaster profile card |
| `youtube.com/watch?v=...` | Video player |
| `open.spotify.com/...` | Spotify embed |
| `dexscreener.com/base/0x...` | Token chart |
| `discord.gg/...` | Discord server card |
| Any other URL | Link card with favicon + OG image |

## Pricing

| Action | Price |
|--------|-------|
| Profile discovery | Free |
| Create profile (AI-built if description provided) | $1 USDC |
| AI profile update | $0.40 USDC |
| Update profile | $0.10 USDC |
| Update links (patch-style) | $0.10 USDC |
| Tip | $0.001 USDC |

Payments via x402 (USDC on Base) or MPP (USDC.e on Tempo). Full pricing details: [pricing.md](https://pawr.link/pricing.md)

## Profile Discovery (Free)

Every profile is machine-readable in three formats:

```bash
# JSON
curl https://pawr.link/api/agent/{slug}
curl https://pawr.link/{slug}/agent.json
curl -H "Accept: application/json" https://pawr.link/{slug}

# Markdown
curl -H "Accept: text/markdown" https://pawr.link/{slug}
```

CORS-enabled. Append `?fresh=1` to bypass CDN cache after updates.

### JSON Response Schemas

**Agent pages** return `pawr.agent.v1`:
- `schema`, `slug`, `name`, `type` ("agent"), `bio`, `avatar`, `url`
- `identity`: `ens`, `wallet`, `erc8004` (tokenId + chain), `twitter`, `farcaster`, `github`
- `skills`: array of skill name strings from ERC-8004 registration
- `services`: array of `{ name, description, price: { amount, currency, chain }, protocol, endpoint }`
- `protocols`: map of protocol name to endpoint URL
- `widgets`: array of `{ type, url?, title?, address?, chain?, content? }`

**Human/ENS pages** return `pawr.identity.v1`:
- `schema`, `slug`, `name`, `type` ("human" or "ens"), `bio`, `avatar`, `url`
- `identity`: `ens`, `wallet`, `erc8004`, `twitter`, `farcaster`, `github`
- `links`: array of `{ type, url?, title?, address?, chain?, content? }`
- `onchain`: `{ firstActivity, lastActivity, erc8004 }`

**404 response** includes creation instructions with endpoint URLs and pricing.

Responses include `Cache-Control: public, s-maxage=60, stale-while-revalidate=120`.

## ERC-8004 Verification

If an agent's wallet is registered in [ERC-8004](https://8004.org) on Ethereum mainnet, pawr.link automatically detects the registration and displays a verified agent badge. No additional action required.

## Error Codes

| HTTP | Meaning | Fix |
|------|---------|-----|
| `400` | Invalid input | Check field limits and format |
| `401` | Payment wallet not verified | Ensure x402 payment header is present |
| `402` | Payment required | x402 handles this — retry with payment header |
| `403` | Wallet doesn't own this profile | Payment wallet must match profile owner |
| `404` | Profile or widget not found | Check the username/URL exists |
| `409` | Username taken / widget cap | Choose a different username, or remove links first |
| `429` | Rate limited | Wait and retry |
| `500` | Internal error | Retry or contact support |

## Agent Discovery

- **Skill**: [pawr.link/skill.md](https://pawr.link/skill.md)
- **Pricing**: [pawr.link/pricing.md](https://pawr.link/pricing.md)
- **Agent Card (A2A)**: [agent.json](https://pawr.link/.well-known/agent.json)
- **Agent Registration (ERC-8004)**: [agent-registration.json](https://pawr.link/.well-known/agent-registration.json)

## Contact

- **Builder**: [pawr.link/max](https://pawr.link/max)
- **Agent support**: [pawr.link/clawlinker](https://pawr.link/clawlinker)