\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",[140],"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",[147],"pulls","branches",1,"forks","envVars",{"_161":155,"_163":42},"connections",{"_161":42,"_162":42},"count","unfilledCount","emptyCount",{"_18":146,"_20":147,"_117":148,"_119":-5,"_120":71,"_121":149,"_123":38,"_22":178,"_68":42,"_125":100,"_127":151,"_129":26,"_130":-5,"_169":179,"_89":180},{"_18":139,"_20":140,"_117":141,"_119":-5,"_120":71,"_121":142,"_123":38,"_22":175,"_68":42,"_125":100,"_127":144,"_129":26,"_130":-5,"_169":176,"_89":177},{"_18":132,"_20":133,"_117":36,"_119":-5,"_120":71,"_121":69,"_123":38,"_22":172,"_68":135,"_125":136,"_127":137,"_129":26,"_130":-5,"_169":173,"_89":174},{"_18":115,"_20":116,"_117":118,"_119":-5,"_120":71,"_121":122,"_123":38,"_22":168,"_68":42,"_125":126,"_127":128,"_129":26,"_130":-5,"_169":170,"_89":171},["D",1781196181946],"children",[],[116],["D",1781199893559],[],[133],["D",1781196197591],[],[140],["D",1781196212736],[],[147],["D",1781196151409],["D",1789497655664],{"_16":17,"_87":83},{"_16":17,"_80":81,"_82":83,"_33":34,"_84":85,"_86":26},{"_68":69,"_20":70,"_18":71,"_72":19,"_73":-5,"_74":-5,"_75":-5,"_76":-5,"_77":-5,"_78":21,"_79":17},"ctx",{"_61":-5,"_108":219,"_220":221,"_222":223,"_224":26,"_225":26,"_226":26,"_227":38,"_228":-5,"_229":-7,"_230":-7,"_231":42,"_232":26,"_233":26,"_234":-5,"_235":26,"_236":26,"_237":26,"_238":-5},"ENV",{"_190":191,"_192":193,"_194":70,"_195":196,"_197":198,"_199":200,"_201":202,"_203":204,"_205":206,"_207":208,"_209":210,"_211":212,"_213":214,"_215":216,"_217":218},"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"]

Search