\n x402 · pay-per-request\n

Radicle × x402 API

A pay-per-call HTTP wrapper around a Radicle seed node. Each request to /api/* is gated by an x402 micropayment in USDC — no accounts, no API keys.

\n\n \n \n \n \n \n \n \n \n \n \n \n

Endpoint	Description	Price
`GET /api/projects`	List repos on the seed	$0.001
`GET /api/projects/:rid`	Repo metadata	$0.005
`GET /api/projects/:rid/issues`	Repo issues	$0.005
`GET /api/projects/:rid/patches`	Repo patches	$0.005
`GET /api/projects/:rid/commits`	Repo commits	$0.005

\n\n

Without a payment, these routes return 402 Payment Required with a PAYMENT-REQUIRED header. An x402-aware client (or AI agent) signs a USDC payment and retries automatically.

GET /health is free.

\n \n\n",[69],"b2b37717-43ec-41f8-9a03-d680e4477ada","README.md","aedd14a2-65b4-11f1-a5e3-1607ee4eb77e",4,["D",1781196212736],"# Radicle × x402 API\n\nA pay-per-request HTTP wrapper around a [Radicle](https://radicle.xyz) seed node. Every `/api/*` route is gated by an [x402](https://x402.org) micropayment in USDC — clients (humans or AI agents) pay per call with no accounts or API keys.\n\n## How it works\n\n```mermaid\nsequenceDiagram\n participant C as Client / Agent\n participant W as This Val (Hono + x402)\n participant F as x402 Facilitator\n participant R as Radicle Seed Node\n\n C->>W: GET /api/projects\n W-->>C: 402 Payment Required (PAYMENT-REQUIRED header)\n C->>W: retry + PAYMENT-SIGNATURE header (signed USDC)\n W->>F: verify & settle payment\n F-->>W: ok (on-chain)\n W->>R: proxy request to seed node\n R-->>W: repo data\n W-->>C: 200 OK + PAYMENT-RESPONSE header\n```\n\n## Endpoints\n\n| Route | Description | Price |\n| --- | --- | --- |\n| `GET /` | Landing page | free |\n| `GET /health` | Health + configured seed | free |\n| `GET /api/projects` | List repos on the seed | $0.001 |\n| `GET /api/projects/:rid` | Repo metadata | $0.005 |\n| `GET /api/projects/:rid/issues` | Repo issues | $0.005 |\n| `GET /api/projects/:rid/patches` | Repo patches | $0.005 |\n| `GET /api/projects/:rid/commits` | Repo commits | $0.005 |\n\n## Setup\n\nSet these environment variables in the Val Town UI:\n\n- **`PAY_TO_ADDRESS`** (required) — your `0x…` wallet that receives USDC. Until this is set, the paywall is disabled and `/api/*` returns `503`.\n- `X402_NETWORK` — defaults to `base-sepolia` (testnet). Use `base` for mainnet.\n- `FACILITATOR_URL` — defaults to `https://x402.org/facilitator`. Use the Coinbase CDP facilitator for Base mainnet.\n- `RADICLE_SEED` — the seed node API base. Defaults to `https://seed.radicle.garden/api/v1`.\n\n## Calling it\n\nAny x402-aware client works. With the TypeScript SDK:\n\n```ts\nimport { wrapFetchWithPayment } from \"x402-fetch\";\nimport { createWalletClient, http } from \"viem\";\n// ...build a wallet client, then:\nconst fetchWithPay = wrapFetchWithPayment(fetch, wallet);\nconst res = await fetchWithPay(\"https://.web.val.run/api/projects\");\n```\n\nA plain `fetch` (no payment) just returns `402` with the payment requirements in the `PAYMENT-REQUIRED` header.\n\n## Files\n\n- `main.ts` — Hono app, x402 paywall middleware, route definitions\n- `radicle.ts` — thin client for the Radicle seed node HTTP API\n- `landing.html` — landing page\n",[76],{"_36":75,"_13":76,"_39":77,"_41":-5,"_42":43,"_44":78,"_46":47,"_48":96,"_17":50,"_51":24,"_53":80,"_55":56,"_57":-5,"_87":97,"_18":98},{"_36":68,"_13":69,"_39":70,"_41":-5,"_42":43,"_44":71,"_46":47,"_48":93,"_17":50,"_51":24,"_53":73,"_55":56,"_57":-5,"_87":94,"_18":95},{"_36":59,"_13":60,"_39":61,"_41":-5,"_42":43,"_44":62,"_46":47,"_48":90,"_17":64,"_51":65,"_53":66,"_55":56,"_57":-5,"_87":91,"_18":92},{"_36":37,"_13":38,"_39":40,"_41":-5,"_42":43,"_44":45,"_46":47,"_48":86,"_17":50,"_51":52,"_53":54,"_55":56,"_57":-5,"_87":88,"_18":89},["D",1781196181946],"children",[],[38],["D",1781199893559],[],[60],["D",1781196197591],[],[69],["D",1781196212736],[],[76],"45a990b6-aa1a-4a00-8a28-dedf28cd2715",["D",1781196151409],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","x402-paywalled API wrapper around Radicle","imageUrl","userId","7ef72b40-61b9-43bc-9e94-6b38ea90dd55","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","orgId","019eb78f-db1d-71ba-9a41-e5ec9062cebc","tursoName","45a990b6aa1a4a008a28dedf28cd2715","tursoHostname","45a990b6aa1a4a008a28dedf28cd2715-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789497655664],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_156":152},"org",{"_11":12,"_149":150,"_151":152,"_109":110,"_153":154,"_155":56},"branch",{"_17":62,"_13":16,"_36":43,"_141":99,"_142":-5,"_143":-5,"_144":-5,"_145":-5,"_146":-5,"_147":14,"_148":12},"isOwned","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","Srijith Poduval","avatar","https://lh3.googleusercontent.com/a/ACg8ocLaQpR7SrqNmbmqTMzcxi9ZAJ5Fp2uHMXp5JjwiY-0kegELxMw=s96-c","tier","free","canRestrictVals","profileImageUrl","adoptOrgId",{"_36":99,"_13":14,"_48":205,"_101":-5,"_102":56,"_103":104,"_105":104,"_106":107,"_108":-5,"_109":110,"_111":61,"_112":47,"_113":-5,"_114":-5,"_115":50,"_116":117,"_118":119,"_120":121,"_122":206,"_124":-5,"_125":126,"_127":126,"_128":129,"_130":129,"_131":129,"_132":126,"_133":126,"_134":207,"_136":208,"_138":209,"_140":56},[193,194,195,196],"files",[193,194,195,196],"counts",{"_183":50,"_184":185,"_186":50,"_31":187,"_188":189},[175,176,177,178],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_36":75,"_13":76,"_39":77,"_41":-5,"_42":43,"_44":78,"_46":47,"_48":79,"_17":50,"_51":24,"_53":80,"_55":56,"_57":-5,"_18":182},{"_36":68,"_13":69,"_39":70,"_41":-5,"_42":43,"_44":71,"_46":47,"_48":72,"_17":50,"_51":24,"_53":73,"_55":56,"_57":-5,"_18":181},{"_36":59,"_13":60,"_39":61,"_41":-5,"_42":43,"_44":62,"_46":47,"_48":63,"_17":64,"_51":65,"_53":66,"_55":56,"_57":-5,"_18":180},{"_36":37,"_13":38,"_39":40,"_41":-5,"_42":43,"_44":45,"_46":47,"_48":49,"_17":50,"_51":52,"_53":54,"_55":56,"_57":-5,"_18":179},[38],[60],[69],[76],"pulls","branches",1,"forks",{"_190":185,"_192":50},"connections",{"_190":50,"_191":50},"count","unfilledCount","emptyCount",{"_36":75,"_13":76,"_39":77,"_41":-5,"_42":43,"_44":78,"_46":47,"_48":96,"_17":50,"_51":24,"_53":80,"_55":56,"_57":-5,"_87":203,"_18":204},{"_36":68,"_13":69,"_39":70,"_41":-5,"_42":43,"_44":71,"_46":47,"_48":93,"_17":50,"_51":24,"_53":73,"_55":56,"_57":-5,"_87":201,"_18":202},{"_36":59,"_13":60,"_39":61,"_41":-5,"_42":43,"_44":62,"_46":47,"_48":90,"_17":64,"_51":65,"_53":66,"_55":56,"_57":-5,"_87":199,"_18":200},{"_36":37,"_13":38,"_39":40,"_41":-5,"_42":43,"_44":45,"_46":47,"_48":86,"_17":50,"_51":52,"_53":54,"_55":56,"_57":-5,"_87":197,"_18":198},[],[38],[],[60],[],[69],[],[76],["D",1781196151409],["D",1789497655664],{"_11":12,"_156":152},{"_11":12,"_149":150,"_151":152,"_109":110,"_153":154,"_155":56},{"_17":62,"_13":16,"_36":43,"_141":99,"_142":-5,"_143":-5,"_144":-5,"_145":-5,"_146":-5,"_147":14,"_148":12},"ctx",{"_134":-5,"_172":243,"_244":245,"_246":247,"_248":56,"_249":56,"_250":56,"_251":47,"_252":-5,"_253":-7,"_254":-7,"_255":50,"_256":56,"_257":56,"_258":-5,"_259":56,"_260":56,"_261":56,"_262":-5},"ENV",{"_214":215,"_216":217,"_218":16,"_219":220,"_221":222,"_223":224,"_225":226,"_227":228,"_229":230,"_231":232,"_233":234,"_235":236,"_237":238,"_239":240,"_241":242},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Code