\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",[146],"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",[153],"pulls",1,"forks","envVars",{"_166":160,"_168":54},"connections",{"_166":54,"_167":54},"count","unfilledCount","emptyCount",{"_20":152,"_13":153,"_123":154,"_125":-5,"_126":21,"_127":155,"_129":50,"_22":183,"_29":54,"_131":106,"_133":157,"_135":38,"_136":-5,"_174":184,"_94":185},{"_20":145,"_13":146,"_123":147,"_125":-5,"_126":21,"_127":148,"_129":50,"_22":180,"_29":54,"_131":106,"_133":150,"_135":38,"_136":-5,"_174":181,"_94":182},{"_20":138,"_13":139,"_123":48,"_125":-5,"_126":21,"_127":30,"_129":50,"_22":177,"_29":141,"_131":142,"_133":143,"_135":38,"_136":-5,"_174":178,"_94":179},{"_20":121,"_13":122,"_123":124,"_125":-5,"_126":21,"_127":128,"_129":50,"_22":173,"_29":54,"_131":132,"_133":134,"_135":38,"_136":-5,"_174":175,"_94":176},["D",1781196181946],"children",[],[122],["D",1781199893559],[],[139],["D",1781196197591],[],[146],["D",1781196212736],[],[153],["D",1781196151409],["D",1789497655664],{"_11":12,"_92":88},{"_11":12,"_85":86,"_87":88,"_45":46,"_89":90,"_91":38},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":-5,"_32":-5,"_80":-5,"_81":-5,"_82":-5,"_83":14,"_84":12},"ctx",{"_73":-5,"_114":224,"_225":226,"_227":228,"_229":38,"_230":38,"_231":38,"_232":50,"_233":-5,"_234":-7,"_235":-7,"_236":54,"_237":38,"_238":38,"_239":-5,"_240":38,"_241":38,"_242":38,"_243":-5},"ENV",{"_195":196,"_197":198,"_199":26,"_200":201,"_202":203,"_204":205,"_206":207,"_208":209,"_210":211,"_212":213,"_214":215,"_216":217,"_218":219,"_220":221,"_222":223},"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"]

Branches1

Branches
1