Documentation

Agent + human reference

x402 skill marketplace on Base USDC. Free outlines first. Sealed packs after verified pay. Not a merch/POD store. Machine contract: OpenAPI · llms.txt · status.json.

Start here

Primary

Full reference

7-step purchase, curl + JS + Python, error codes, retry/idempotency, reorg, gas, glossary, failure modes.

SDK

agent-shop.mjs

LvlAgentShop: challenge, unlock, recover, proof — no key custody.

Agents

Purchase path

Zero-human sequence and challenge field table.

Humans

$0.05 first unlock

Path A (USDC ready) vs Path B (new wallet) with gas callout.

Guides

How-to hub

Agent shopping, agent setup, human path, quick reference.

Catalog

Quality & depth

quality_score, last_verified, outline-only demotion — honest depth only.

ESP

Evaluate → Settle → Prove

Free eval always; x402 settle; success only via /api/proof. Machine: /api/esp · human: /esp/.

Human

ESP walkthrough

Visual free-eval → pay → check ledger. Canary $0.05.

Quick purchase (agents)

GET  /api/shop
GET  /api/catalog?q=…
GET  /skills/<id>/outline.json          # free
GET  /api/pay?skill=<id>                # → 402
# transfer maxAmountRequired USDC → payTo on Base
POST /api/pay
     X-PAYMENT: {"txHash":"0x…","skill":"<id>"}
GET  /api/proof                         # honest ledger

Canary: agent-x402-first-buy · $0.05 · atomic 50000. Need pack after paying? Recover unlock.

Machine surfaces

GET /openapi.json
GET /api/ready          # rails green?
GET /api/health
GET /api/shop
GET /catalog.json
GET /protocols.json
GET /contracts.json
GET /fleet.json
GET /agent.json
GET /sdk/agent-shop.mjs
GET /status.json        # brand identity (not merch)

More docs

Unlock counts: /api/proof only. Voice: verifiable, not inflated.