{
  "schema": "lvl-how-to-v1",
  "name": "LVL LTD How To",
  "url": "https://lvlltd.com/how-to/",
  "updated_at": "2026-07-27T16:30:00.000Z",
  "description": "Practical guides for humans and agents to discover, evaluate, and unlock skills on the x402 Base USDC market. Radical honesty: public proof ledger never invents volume.",
  "site": "https://lvlltd.com",
  "markdown": "https://lvlltd.com/how-to/index.md",
  "canary": {
    "skill_id": "agent-x402-first-buy",
    "price_usd": 0.05,
    "outline": "https://lvlltd.com/skills/agent-x402-first-buy/outline.json",
    "sample": "https://lvlltd.com/skills/agent-x402-first-buy/sample.md",
    "challenge": "https://lvlltd.com/api/pay?skill=agent-x402-first-buy",
    "human": "https://lvlltd.com/first-unlock/"
  },
  "pages": [
    {
      "id": "hub",
      "title": "How To hub",
      "url": "https://lvlltd.com/how-to/",
      "audience": ["human", "agent"]
    },
    {
      "id": "human",
      "title": "Human path",
      "url": "https://lvlltd.com/how-to/human/",
      "audience": ["human"],
      "topics": [
        "browse",
        "outline",
        "wallet",
        "canary",
        "redownload",
        "activity_evidence_metrics",
        "flagships",
        "depth_badges",
        "recover",
        "sisters"
      ]
    },
    {
      "id": "agent-setup",
      "title": "Agent setup",
      "url": "https://lvlltd.com/how-to/agent-setup/",
      "audience": ["agent", "developer"],
      "topics": [
        "capabilities",
        "discovery",
        "evaluation",
        "402",
        "settle",
        "unlock",
        "proof",
        "errors",
        "idempotent_redownload",
        "sdk"
      ]
    },
    {
      "id": "agent-shopping",
      "title": "Full agent shopping flow",
      "url": "https://lvlltd.com/how-to/agent-shopping/",
      "audience": ["agent"],
      "sequence": [
        "GET /api/shop or /catalog.json",
        "GET /skills/{id}/outline.json",
        "GET /api/pay?skill={id} → HTTP 402",
        "Transfer maxAmountRequired USDC on Base to payTo",
        "POST /api/pay with X-PAYMENT {txHash, skill}",
        "Receive sealed_pack.files",
        "Optional GET /api/proof"
      ]
    },
    {
      "id": "quick-reference",
      "title": "Quick reference",
      "url": "https://lvlltd.com/how-to/quick-reference/",
      "audience": ["human", "agent"]
    }
  ],
  "endpoints": {
    "health": "https://lvlltd.com/api/health",
    "shop": "https://lvlltd.com/api/shop",
    "catalog": "https://lvlltd.com/catalog.json",
    "pay": "https://lvlltd.com/api/pay",
    "proof": "https://lvlltd.com/api/proof",
    "recover": "https://lvlltd.com/api/recover",
    "llms": "https://lvlltd.com/llms.txt",
    "agent": "https://lvlltd.com/agent.json",
    "fleet": "https://lvlltd.com/fleet.json",
    "sdk_js": "https://lvlltd.com/sdk/agent-shop.mjs"
  },
  "payment": {
    "network": "base",
    "chain_id": 8453,
    "asset": "USDC",
    "asset_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "protocol": "x402",
    "apex_x402_version": "2",
    "note": "Always read x402Version / x402_version and payTo from the live 402 challenge body."
  },
  "honesty": {
    "proof_ledger": "https://lvlltd.com/api/proof",
    "never_invent_volume": true,
    "swarm_smoke_not_ledger": true
  },
  "related_learn": [
    "https://lvlltd.com/learn/x402-explained/",
    "https://lvlltd.com/learn/agents-buy-skills-http/",
    "https://lvlltd.com/learn/buy-first-skill-metamask/",
    "https://lvlltd.com/learn/on-chain-proof/",
    "https://lvlltd.com/learn/sealed-packs-redeem/"
  ]
}
