[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_194":195,"_196":197},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":-7,"_18":19,"_17":-7,"_147":-5,"_20":148,"_22":149,"_150":151,"_152":153,"_26":154,"_24":155,"_156":-5,"_157":-5,"_158":51,"_159":160,"_161":43,"_162":-5,"_163":-5,"_164":165},"routes/_app.x.$handle.$name.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27,"_28":-5,"_29":-5,"_30":-5,"_31":-5,"_32":-5},"handle","sr33j","name","radicle-x402-api","branchName","main","version","path","landing.html","project",{"_33":89,"_13":14,"_44":90,"_91":-5,"_92":51,"_93":94,"_95":94,"_96":97,"_98":-5,"_99":100,"_101":70,"_102":43,"_103":-5,"_104":-5,"_105":46,"_106":107,"_108":109,"_110":111,"_112":113,"_114":-5,"_115":116,"_117":116,"_118":119,"_120":119,"_121":119,"_122":116,"_123":116,"_124":125,"_126":127,"_128":129,"_130":51},"tree",[54,55,56,57],"file",{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":45,"_17":46,"_47":24,"_48":49,"_50":51,"_52":-5,"_18":53},"contents",[],"upstream","pull","ahead","behind","envVars","id","bb5909a5-7ad1-49b8-989c-758dc5e00d18","fileId","a5d5fca2-65b4-11f1-a63f-1607ee4eb77e","parentId","branchId","3bb85909-1e34-40a1-aabf-8f14bb3713f1","branchVersion",3,"latest",true,"createdAt",["D",1781196197591],0,"fileType","content","\n\n \n \n \n Radicle × x402 API\n \n \n \n

\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","deleted",false,"label",[19],{"_33":81,"_13":82,"_35":83,"_37":-5,"_38":39,"_40":84,"_42":43,"_44":85,"_17":46,"_47":24,"_48":86,"_50":51,"_52":-5,"_65":87,"_18":88},{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":78,"_17":46,"_47":24,"_48":49,"_50":51,"_52":-5,"_65":79,"_18":80},{"_33":68,"_13":69,"_35":70,"_37":-5,"_38":39,"_40":71,"_42":43,"_44":72,"_17":73,"_47":74,"_48":75,"_50":51,"_52":-5,"_65":76,"_18":77},{"_33":58,"_13":59,"_35":60,"_37":-5,"_38":39,"_40":61,"_42":43,"_44":62,"_17":46,"_47":63,"_48":64,"_50":51,"_52":-5,"_65":66,"_18":67},"72712676-0fcd-4b5c-a268-09b84d9d346a","radicle.ts","9c837b20-65b4-11f1-a63f-1607ee4eb77e",2,["D",1781196181946],"script","// Thin client for a Radicle seed node's HTTP API (radicle-httpd / radicle-explorer).\n// Defaults to the public seed node; override with the RADICLE_SEED env var.\nexport const RADICLE_SEED =\n Deno.env.get(\"RADICLE_SEED\") ?? \"https://seed.radicle.garden/api/v1\";\n\nexport async function fetchRadicle(path: string): Promise {\n const url = `${RADICLE_SEED}${path}`;\n const res = await fetch(url, {\n headers: { Accept: \"application/json\" },\n });\n\n if (!res.ok) {\n const body = await res.text().catch(() => \"\");\n throw new Error(`Radicle seed responded ${res.status}: ${body.slice(0, 300)}`);\n }\n return res.json();\n}\n","children",[],[59],"9285982d-f1d8-4073-afd4-19867f7f25b4","main.ts","9a54b490-65b4-11f1-8f76-1607ee4eb77e",9,["D",1781199893559],5,"http","import { Hono } from \"npm:hono@4\";\nimport { paymentMiddleware, Network } from \"npm:x402-hono@1.2.0\";\nimport { fetchRadicle, RADICLE_SEED } from \"./radicle.ts\";\nimport { readFile } from \"https://esm.town/v/std/utils/index.ts\";\n\nconst app = new Hono();\n\n// ---- Config (set these as Val Town environment variables) ----\n// PAY_TO_ADDRESS: your 0x... wallet that receives USDC\n// FACILITATOR_URL: x402 facilitator (defaults to Coinbase CDP)\nconst PAY_TO = (Deno.env.get(\"PAY_TO_ADDRESS\") ?? \"\") as `0x${string}`;\nconst NETWORK = (Deno.env.get(\"X402_NETWORK\") ?? \"base\") as Network;\nconst FACILITATOR_URL = Deno.env.get(\"FACILITATOR_URL\") as\n | `${string}://${string}`\n | undefined;\n\n// ---- Free routes ----\napp.get(\"/\", async (c) => c.html(await readFile(\"/landing.html\", import.meta.url)));\napp.get(\"/health\", (c) => c.json({ ok: true, seed: RADICLE_SEED }));\n\n// ---- Paywall: every /api/* route below requires an x402 payment ----\nif (PAY_TO) {\n app.use(\n paymentMiddleware(\n PAY_TO,\n {\n \"/api/projects\": {\n price: \"$0.001\",\n network: NETWORK,\n config: { description: \"List Radicle repositories on the seed node\" },\n },\n \"/api/projects/*\": {\n price: \"$0.005\",\n network: NETWORK,\n config: { description: \"Read a Radicle repo, its issues, patches, or commits\" },\n },\n },\n FACILITATOR_URL ? { url: FACILITATOR_URL } : undefined,\n ),\n );\n}\n\n// ---- Wrapped Radicle endpoints (only reachable after payment) ----\n\n// List repos on the seed node\napp.get(\"/api/projects\", async (c) => {\n const page = c.req.query(\"page\") ?? \"0\";\n const perPage = c.req.query(\"perPage\") ?? \"20\";\n const data = await fetchRadicle(`/projects?page=${page}&perPage=${perPage}`);\n return c.json(data);\n});\n\n// Get a single repo\napp.get(\"/api/projects/:rid\", async (c) => {\n const data = await fetchRadicle(`/projects/${c.req.param(\"rid\")}`);\n return c.json(data);\n});\n\n// Issues for a repo\napp.get(\"/api/projects/:rid/issues\", async (c) => {\n const data = await fetchRadicle(`/projects/${c.req.param(\"rid\")}/issues`);\n return c.json(data);\n});\n\n// Patches for a repo\napp.get(\"/api/projects/:rid/patches\", async (c) => {\n const data = await fetchRadicle(`/projects/${c.req.param(\"rid\")}/patches`);\n return c.json(data);\n});\n\n// Commits for a repo\napp.get(\"/api/projects/:rid/commits\", async (c) => {\n const data = await fetchRadicle(`/projects/${c.req.param(\"rid\")}/commits`);\n return c.json(data);\n});\n\nif (!PAY_TO) {\n app.all(\"/api/*\", (c) =>\n c.json(\n { error: \"PAY_TO_ADDRESS env var not set — paywall disabled. Set it to enable x402.\" },\n 503,\n ));\n}\n\nexport default app.fetch;\n",[],[69],["D",1781196197591],[],[19],"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",[],[82],"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,"_146":142},"org",{"_11":12,"_139":140,"_141":142,"_99":100,"_143":144,"_145":51},"branch",{"_17":71,"_13":16,"_33":39,"_131":89,"_132":-5,"_133":-5,"_134":-5,"_135":-5,"_136":-5,"_137":14,"_138":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",{"_33":89,"_13":14,"_44":189,"_91":-5,"_92":51,"_93":94,"_95":94,"_96":97,"_98":-5,"_99":100,"_101":70,"_102":43,"_103":-5,"_104":-5,"_105":46,"_106":107,"_108":109,"_110":111,"_112":190,"_114":-5,"_115":116,"_117":116,"_118":119,"_120":119,"_121":119,"_122":116,"_123":116,"_124":191,"_126":192,"_128":193,"_130":51},[177,178,179,180],"files",[177,178,179,180],"counts",{"_167":46,"_168":169,"_170":46,"_32":171,"_172":173},[],{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":45,"_17":46,"_47":24,"_48":49,"_50":51,"_52":-5,"_18":166},"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},[19],"pulls","branches",1,"forks",{"_174":169,"_176":46},"connections",{"_174":46,"_175":46},"count","unfilledCount","emptyCount",{"_33":81,"_13":82,"_35":83,"_37":-5,"_38":39,"_40":84,"_42":43,"_44":85,"_17":46,"_47":24,"_48":86,"_50":51,"_52":-5,"_65":187,"_18":188},{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":78,"_17":46,"_47":24,"_48":49,"_50":51,"_52":-5,"_65":185,"_18":186},{"_33":68,"_13":69,"_35":70,"_37":-5,"_38":39,"_40":71,"_42":43,"_44":72,"_17":73,"_47":74,"_48":75,"_50":51,"_52":-5,"_65":183,"_18":184},{"_33":58,"_13":59,"_35":60,"_37":-5,"_38":39,"_40":61,"_42":43,"_44":62,"_17":46,"_47":63,"_48":64,"_50":51,"_52":-5,"_65":181,"_18":182},[],[59],[],[69],[],[19],[],[82],["D",1781196151409],["D",1789497655664],{"_11":12,"_146":142},{"_11":12,"_139":140,"_141":142,"_99":100,"_143":144,"_145":51},{"_17":71,"_13":16,"_33":39,"_131":89,"_132":-5,"_133":-5,"_134":-5,"_135":-5,"_136":-5,"_137":14,"_138":12},"ctx",{"_124":-5,"_163":227,"_228":229,"_230":231,"_232":51,"_233":51,"_234":51,"_235":43,"_236":-5,"_237":-7,"_238":-7,"_239":46,"_240":51,"_241":51,"_242":-5,"_243":51,"_244":51,"_245":51,"_246":-5},"ENV",{"_198":199,"_200":201,"_202":16,"_203":204,"_205":206,"_207":208,"_209":210,"_211":212,"_213":214,"_215":216,"_217":218,"_219":220,"_221":222,"_223":224,"_225":226},"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"]