[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_330":331,"_332":333},"routes/_app.x.$handle.$name",{"_101":100,"_32":46,"_109":91,"_27":110,"_13":14,"_111":-5,"_11":112,"_113":114,"_115":116,"_117":118,"_119":120,"_20":-5,"_121":-5,"_122":-5,"_123":25,"_124":125,"_126":60,"_127":-5,"_128":-5,"_129":130},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_44":45,"_32":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":84,"_85":86,"_87":88,"_89":25},"version",109,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","frontend/components/Sections.tsx","latestPath","fileId","fdf73a3a-5b6a-11f1-aa1f-ee650bb23af1","name","Sections.tsx","fileType","script","content","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport {\n Card,\n type Cfg,\n CodeBlock,\n Eyebrow,\n Mono,\n Pill,\n Section,\n} from \"./ui.tsx\";\n\nexport function HowItWorks() {\n const steps = [\n {\n n: \"01\",\n t: \"Ask\",\n d: \"Your agent POSTs a number and document to /v1/fax. With no payment attached, it gets back HTTP 402 — exactly what to pay and where.\",\n },\n {\n n: \"02\",\n t: \"Pay\",\n d: \"The agent's wallet pays and retries with an Authorization: Payment header. We verify the payment on-chain — no facilitator, no keys.\",\n },\n {\n n: \"03\",\n t: \"Fax\",\n d: \"We send the fax, return a job id, and drop the payload. Poll /v1/fax/{id} for status.\",\n },\n ];\n return (\n

\n How it works\n

\n Ask → pay → fax, in one request loop.\n

\n {steps.map((s) => (\n \n

{s.n}

{s.t}

{s.d}

\n \n ))}\n

\n );\n}\n\nexport function Networks() {\n return (\n

\n Payments\n

\n Pay from any MPP client.\n

\n Paid in USDC.e on Tempo mainnet, verified on-chain — no facilitator, no\n keys. tempo request pays in one line, and any MPP-aware\n agent can pay with no SDK lock-in.\n

\n );\n}\n\nexport function Shingle() {\n return (\n

\n Want to hang a shingle?\n

\n Start making money by accepting payments on Tempo MPP.\n

\n Immediately — no marketplace, no approval. This app is open source and\n runs on Val Town.\n

\n \n Remix on Val Town\n \n \n Read the source\n \n

\n );\n}\n\nexport function Privacy() {\n return (\n

\n \n Zero data retention\n

\n We keep nothing. Not the number, not the document.\n

\n Your document and destination go straight to the fax network and are\n dropped — no database, no logs. The payment settles on-chain; the\n document lives only at the carrier. The job id we return is just a\n pointer.\n

\n no DB\n no content logs\n on-chain settlement\n

\n \n

\n );\n}\n\nexport function TryIt({ cfg }: { cfg: Cfg }) {\n return (\n

\n Try it\n

\n See the 402 challenge live.\n

\n Send a real request with no payment attached and see the exact 402 an\n agent would get.\n

\n \n Send a test request\n \n \n \n {`// press the button to call ${cfg.baseUrl}/v1/fax`}\n \n \n

\n Want to watch a real{\" \"}\n fax arrive? Have an agent fax +19725329272 —{\" \"}\n \n Faxbeep\n 's free public test line — then find your pages in its gallery.\n (That's how the demo above was verified.)\n

\n );\n}\n\nexport function Footer() {\n return (\n \n );\n}","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport {\n Card,\n type Cfg,\n CodeBlock,\n Eyebrow,\n Mono,\n Pill,\n Section,\n} from \"./ui.tsx\";\n\nexport function HowItWorks() {\n const steps = [\n {\n n: \"01\",\n t: \"Ask\",\n d: \"Your agent POSTs a number and document to /v1/fax. With no payment attached, it gets back HTTP 402 — exactly what to pay and where.\",\n },\n {\n n: \"02\",\n t: \"Pay\",\n d: \"The agent's wallet pays and retries with an Authorization: Payment header. We verify the payment on-chain — no facilitator, no keys.\",\n },\n {\n n: \"03\",\n t: \"Fax\",\n d: \"We send the fax, return a job id, and drop the payload. Poll /v1/fax/{id} for status.\",\n },\n ];\n return (\n

\n How it works\n

\n Ask → pay → fax, in one request loop.\n

\n {steps.map((s) => (\n \n

{s.n}

{s.t}

{s.d}

\n \n ))}\n

\n );\n}\n\nexport function Networks() {\n return (\n

\n Payments\n

\n Pay from any MPP client.\n

\n Paid in USDC.e on Tempo mainnet, verified on-chain — no facilitator, no\n keys. tempo request pays in one line, and any MPP-aware\n agent can pay with no SDK lock-in.\n

\n );\n}\n\nexport function Shingle() {\n return (\n

\n Want to hang a shingle?\n

\n Start making money by accepting payments on Tempo MPP.\n

\n Immediately — no marketplace, no approval. This app is open source and\n runs on Val Town.\n

\n \n Remix on Val Town\n \n \n Read the source\n \n

\n );\n}\n\nexport function Privacy({ stats }: { stats: { faxes: number; pages: number } }) {\n return (\n

\n \n What we store\n

\n Your documents are never stored.\n

\n The document goes straight to the fax network and is dropped — it never touches our database.\n We keep only minimal send metadata: destination, page count, amount, and the paying wallet.\n {stats.faxes > 0\n ? ` So far we've relayed ${stats.faxes.toLocaleString()} faxes (${stats.pages.toLocaleString()} pages).`\n : \"\"}\n

\n documents never stored\n metadata only\n on-chain settlement\n

\n \n

\n );\n}\n\nexport function TryIt({ cfg }: { cfg: Cfg }) {\n return (\n

\n Try it\n

\n See the 402 challenge live.\n

\n Send a real request with no payment attached and see the exact 402 an\n agent would get.\n

\n \n Send a test request\n \n \n \n {`// press the button to call ${cfg.baseUrl}/v1/fax`}\n \n \n

\n );\n}\n\nexport function Footer() {\n return (\n \n );\n}","createdAt",["D",1780075961277],"branchVersion","branchId","dbdd6128-5b69-11f1-a7a0-ee650bb23af1","id","dbdc95e0-5b69-11f1-a7a0-ee650bb23af1","agentfax",["D",1780064564355],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Fax API for AI agents — paid per fax over x402 (USDC)","imageUrl","a0bf3b31-15a5-4d5c-880e-4b1e22c9bc18","pinnedFileId","dbe07a02-5b69-11f1-a7a0-ee650bb23af1","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","e81e7335-6d4c-4764-a902-d0962bbfa9f7","tursoName","dbdc95e05b6911f1a7a0ee650bb23af1","tursoHostname","dbdc95e05b6911f1a7a0ee650bb23af1-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789500689328],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_101":100,"_108":104},"org",{"_101":100,"_102":-5,"_103":104,"_18":56,"_105":106,"_107":25},"branch",{"_13":90,"_32":91,"_44":43,"_92":45,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":46,"_99":100},"isOwned",150,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","stevekrouse","handle","displayName","avatar","https://images.clerk.dev/uploaded/img_2PqHa2Gsy93xQrjh2w78Xu0cChW.jpeg","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_44":45,"_32":46,"_39":325,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":326,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":327,"_85":328,"_87":329,"_89":25},"tree",[214,224,225,226,227,228,229,230],"files",[214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230],"counts",{"_202":64,"_203":204,"_205":146,"_206":207,"_208":209},"contents",[131,132,133,134,135,136,137,138],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":195,"_32":196,"_30":197,"_142":-5,"_42":43,"_41":198,"_144":60,"_39":199,"_13":64,"_34":200,"_36":-5,"_24":25,"_148":-5,"_27":201},{"_44":187,"_32":188,"_30":189,"_142":-5,"_42":43,"_41":190,"_144":25,"_39":191,"_13":192,"_34":20,"_36":193,"_24":25,"_148":-5,"_27":194},{"_44":180,"_32":181,"_30":182,"_142":-5,"_42":43,"_41":183,"_144":25,"_39":184,"_13":64,"_34":35,"_36":185,"_24":25,"_148":-5,"_27":186},{"_44":173,"_32":174,"_30":175,"_142":-5,"_42":43,"_41":176,"_144":25,"_39":177,"_13":146,"_34":35,"_36":178,"_24":25,"_148":-5,"_27":179},{"_44":165,"_32":166,"_30":58,"_142":-5,"_42":43,"_41":167,"_144":25,"_39":168,"_13":169,"_34":170,"_36":171,"_24":25,"_148":46,"_27":172},{"_44":158,"_32":159,"_30":160,"_142":-5,"_42":43,"_41":161,"_144":60,"_39":162,"_13":155,"_34":35,"_36":163,"_24":25,"_148":-5,"_27":164},{"_44":150,"_32":151,"_30":152,"_142":-5,"_42":43,"_41":153,"_144":60,"_39":154,"_13":155,"_34":35,"_36":156,"_24":25,"_148":-5,"_27":157},{"_44":139,"_32":140,"_30":141,"_142":-5,"_42":43,"_41":143,"_144":60,"_39":145,"_13":146,"_34":35,"_36":147,"_24":25,"_148":-5,"_27":149},"e9c5fbcc-5b75-11f1-97dd-ee650bb23af1","payment.ts","0e7d6c72-5b6a-11f1-9d84-ee650bb23af1","parentId",42,"latest",["D",1780069741640],2,"// x402 payment wiring.\n//\n// One standard x402 endpoint (USDC, `exact` scheme) is payable by Coinbase\n// x402 agents, Circle agent wallets, and Tempo/MPP agents alike. We gate\n// `POST /v1/fax` with the official x402-hono middleware, which encodes the\n// correct per-network USDC EIP-712 domain so any compliant client can pay.\n//\n// Config (all optional — sane defaults so it runs out of the box):\n// FAX_PAYMENT_MODE \"x402\" (default) | \"sandbox\" (skip payment, for testing)\n// FAX_NETWORK \"base-sepolia\" (default, keyless facilitator) | \"base\"\n// FAX_PRICE_USD \"$0.50\" (default), price per fax\n// FAX_PAYTO_ADDRESS 0x... wallet that receives the USDC\n// CDP_API_KEY_ID / CDP_API_KEY_SECRET required only when FAX_NETWORK=\"base\"\nimport type { Hono } from \"npm:hono\";\nimport { paymentMiddleware } from \"npm:x402-hono\";\n\nexport type PaymentMode = \"x402\" | \"sandbox\";\n\nexport const USDC: Record = {\n \"base\": { address: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\", decimals: 6 },\n \"base-sepolia\": { address: \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\", decimals: 6 },\n};\n\nexport function paymentMode(): PaymentMode {\n return (Deno.env.get(\"FAX_PAYMENT_MODE\") || \"x402\").toLowerCase() === \"sandbox\"\n ? \"sandbox\"\n : \"x402\";\n}\n\nfunction hasUsableCdpKey(): boolean {\n const id = Deno.env.get(\"CDP_API_KEY_ID\");\n const secret = Deno.env.get(\"CDP_API_KEY_SECRET\") || \"\";\n // Real CDP secrets are PEM EC keys or long base64 Ed25519 keys. Reject short/malformed.\n return !!id && (secret.includes(\"BEGIN\") || secret.length >= 50);\n}\n\nexport function network(): string {\n const n = Deno.env.get(\"FAX_NETWORK\") || \"base-sepolia\";\n // Mainnet settlement needs a valid CDP facilitator key. If it's missing or\n // malformed, fall back to the keyless Base Sepolia facilitator so the service\n // keeps working — and auto-upgrades to mainnet once a valid key is set.\n if (n === \"base\" && !hasUsableCdpKey()) return \"base-sepolia\";\n return n;\n}\n\nexport function priceUsd(): string {\n const p = Deno.env.get(\"FAX_PRICE_USD\") || \"$0.50\";\n return p.startsWith(\"$\") ? p : `$${p}`;\n}\n\nexport function payToAddress(): string {\n // Default to Steve's known EVM address; override per-deployment.\n return Deno.env.get(\"FAX_PAYTO_ADDRESS\") || \"0xd6f0870b8e1c6af8d712cc506ccf5e96ac040592\";\n}\n\nexport function facilitatorUrl(): string {\n return network() === \"base\"\n ? \"https://api.cdp.coinbase.com/platform/v2/x402\"\n : \"https://x402.org/facilitator\";\n}\n\n/** Public, machine-readable description of how to pay this service. */\nexport function paymentInfo() {\n const net = network();\n return {\n protocol: \"x402\",\n x402Version: 1,\n scheme: \"exact\",\n network: net,\n asset: { symbol: \"USDC\", address: USDC[net]?.address ?? null, decimals: 6 },\n price: priceUsd(),\n payTo: payToAddress(),\n facilitator: facilitatorUrl(),\n mode: paymentMode(),\n payableBy: [\"coinbase-x402\", \"circle-agent-wallets\"],\n };\n}\n\nconst ROUTE_CONFIG = {\n price: priceUsd(),\n network: network(),\n config: {\n description: \"Send a fax to any phone number. Billed once per fax.\",\n mimeType: \"application/json\",\n maxTimeoutSeconds: 120,\n outputSchema: {\n type: \"object\",\n properties: {\n id: { type: \"string\" },\n status: { type: \"string\", enum: [\"queued\", \"sending\", \"delivered\", \"failed\"] },\n to: { type: \"string\" },\n },\n },\n },\n};\n\n/** Install x402 payment gating on POST /v1/fax (no-op in sandbox mode). */\nexport async function installPayment(app: Hono): Promise {\n if (paymentMode() === \"sandbox\") return;\n\n let facilitator: { url: string } | unknown = { url: facilitatorUrl() };\n if (network() === \"base\") {\n // CDP facilitator helper reads CDP_API_KEY_ID / CDP_API_KEY_SECRET.\n const mod = await import(\"npm:@coinbase/x402\");\n facilitator = mod.facilitator;\n }\n\n app.use(\n paymentMiddleware(\n payToAddress() as `0x${string}`,\n { \"POST /v1/fax\": ROUTE_CONFIG },\n facilitator as any,\n ),\n );\n}\n\n/** Decode the x402 X-PAYMENT header to learn who paid (best-effort). */\nexport function decodePayer(header: string | undefined): { payer: string | null; network: string | null } {\n if (!header) return { payer: null, network: null };\n try {\n const payload = JSON.parse(atob(header));\n return {\n payer: payload?.payload?.authorization?.from ?? null,\n network: payload?.network ?? null,\n };\n } catch {\n return { payer: null, network: null };\n }\n}\n","label",[140],"50bd1848-5b84-11f1-8fc4-ee650bb23af1","og.ts","33fd9954-5b83-11f1-8fee-ee650bb23af1",106,["D",1780075927348],3,"// Open Graph / Twitter card image (1200×630), generated with satori (JSX→SVG)\n// + resvg-wasm (SVG→PNG). Served at GET /og.png. Modeled on stevekrouse/secret-share.\nimport satori from \"npm:satori@0.10.13\";\nimport { initWasm, Resvg } from \"npm:@resvg/resvg-wasm@2.6.2\";\n\n// Static-weight TTFs (variable fonts crash satori's opentype.js). PT Sans is the\n// sans sibling of the PT Serif that secret-share uses — same reliable repo path.\nconst SANS_BOLD_TTF =\n \"https://raw.githubusercontent.com/google/fonts/main/ofl/ptsans/PT_Sans-Web-Bold.ttf\";\nconst SANS_REGULAR_TTF =\n \"https://raw.githubusercontent.com/google/fonts/main/ofl/ptsans/PT_Sans-Web-Regular.ttf\";\nconst RESVG_WASM_URL = \"https://unpkg.com/@resvg/resvg-wasm@2.6.2/index_bg.wasm\";\n\nlet fontsPromise: Promise<{ bold: ArrayBuffer; regular: ArrayBuffer }> | null = null;\nfunction loadFonts() {\n if (!fontsPromise) {\n const get = (url: string, label: string) =>\n fetch(url).then((r) => {\n if (!r.ok) throw new Error(`${label} font fetch failed: ${r.status}`);\n return r.arrayBuffer();\n });\n fontsPromise = Promise.all([\n get(SANS_BOLD_TTF, \"Bold\"),\n get(SANS_REGULAR_TTF, \"Regular\"),\n ]).then(([bold, regular]) => ({ bold, regular }));\n }\n return fontsPromise;\n}\n\nlet wasmPromise: Promise | null = null;\nfunction ensureResvg(): Promise {\n if (!wasmPromise) {\n wasmPromise = fetch(RESVG_WASM_URL)\n .then((r) => {\n if (!r.ok) throw new Error(`resvg wasm fetch failed: ${r.status}`);\n return r.arrayBuffer();\n })\n .then((bytes) => initWasm(bytes));\n }\n return wasmPromise;\n}\n\nfunction pill(text: string) {\n return {\n type: \"div\",\n props: {\n style: {\n display: \"flex\",\n fontSize: 26,\n color: \"#d4d4d4\",\n background: \"#1f1f1f\",\n borderRadius: \"999px\",\n padding: \"12px 28px\",\n },\n children: text,\n },\n };\n}\n\n// The favicon's fax glyph as a satori SVG node (0–32 grid), scaled to `size`.\nfunction faxIcon(size: number) {\n return {\n type: \"svg\",\n props: {\n width: size,\n height: size,\n viewBox: \"0 0 32 32\",\n children: [\n { type: \"rect\", props: { width: 32, height: 32, rx: 7, fill: \"#10b981\" } },\n { type: \"rect\", props: { x: 9, y: 5, width: 14, height: 7, rx: 1.5, fill: \"#0a0a0a\" } },\n { type: \"rect\", props: { x: 6, y: 12, width: 20, height: 14, rx: 2.5, fill: \"#0a0a0a\" } },\n { type: \"circle\", props: { cx: 22, cy: 16, r: 1.2, fill: \"#10b981\" } },\n { type: \"rect\", props: { x: 10, y: 19, width: 12, height: 8, rx: 1, fill: \"#10b981\" } },\n { type: \"rect\", props: { x: 12, y: 21, width: 8, height: 1.4, rx: 0.7, fill: \"#0a0a0a\" } },\n { type: \"rect\", props: { x: 12, y: 23.6, width: 6, height: 1.4, rx: 0.7, fill: \"#0a0a0a\" } },\n ],\n },\n };\n}\n\nasync function renderSvg(): Promise {\n const { bold, regular } = await loadFonts();\n const tree = {\n type: \"div\",\n props: {\n style: {\n width: \"1200px\",\n height: \"630px\",\n display: \"flex\",\n background: \"#0a0a0a\",\n padding: \"56px\",\n fontFamily: \"Sans\",\n },\n children: [\n {\n type: \"div\",\n props: {\n style: {\n flex: 1,\n display: \"flex\",\n flexDirection: \"row\",\n alignItems: \"center\",\n justifyContent: \"space-between\",\n padding: \"0 72px\",\n border: \"1px solid #262626\",\n borderRadius: \"28px\",\n background: \"#000\",\n },\n children: [\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", flexDirection: \"column\", maxWidth: \"640px\" },\n children: [\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 28, fontWeight: 700, color: \"#10b981\", letterSpacing: \"6px\" },\n children: \"FAX FOR AI AGENTS\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 110, fontWeight: 700, color: \"#ffffff\", letterSpacing: \"-3px\", marginTop: \"18px\" },\n children: \"agentfax\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 36, color: \"#a3a3a3\", lineHeight: 1.35, marginTop: \"20px\" },\n children: \"Pay per fax in USDC over Tempo/MPP. No signup, no API key.\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", flexDirection: \"row\", gap: \"14px\", marginTop: \"34px\" },\n children: [pill(\"$0.20 / page\"), pill(\"USDC.e on Tempo\")],\n },\n },\n ],\n },\n },\n faxIcon(300),\n ],\n },\n },\n ],\n },\n };\n return await satori(tree as any, {\n width: 1200,\n height: 630,\n fonts: [\n { name: \"Sans\", data: bold, weight: 700, style: \"normal\" },\n { name: \"Sans\", data: regular, weight: 400, style: \"normal\" },\n ],\n });\n}\n\nexport async function renderOg(): Promise {\n try {\n const svg = await renderSvg();\n await ensureResvg();\n const png = new Resvg(svg).render().asPng();\n return new Response(png, {\n headers: { \"content-type\": \"image/png\", \"cache-control\": \"public, max-age=3600\" },\n });\n } catch (err) {\n const msg = err instanceof Error ? err.stack || err.message : String(err);\n return new Response(`OG render failed:\\n${msg}`, {\n status: 500,\n headers: { \"content-type\": \"text/plain\" },\n });\n }\n}\n",[151],"fdf92806-5b77-11f1-a89e-ee650bb23af1","mpp.ts","c2760d68-5b76-11f1-9a34-ee650bb23af1",54,["D",1780070634528],"// Tempo / MPP payment rail — mainnet (chain 4217), USDC.e, priced PER PAGE.\n//\n// On the unpaid request we fetch/decode the document, count its pages, and set\n// the MPP charge to pages × rate — so the 402 tells the agent the exact cost.\n// mppx settles directly against the Tempo RPC (no facilitator). Pay in one line:\n// tempo request -X POST --json '{...}' /v1/fax\nimport { Mppx, tempo } from \"npm:mppx@0.6.28/hono\";\nimport { privateKeyToAccount } from \"npm:viem/accounts\";\n\nexport const USDC_E = {\n symbol: \"USDC.e\",\n address: \"0x20C000000000000000000000b9537d11c60E8b50\",\n decimals: 6,\n};\n\nexport function perPageUsd(): number {\n return parseFloat(Deno.env.get(\"FAX_PRICE_PER_PAGE\") || \"0.20\") || 0.2;\n}\n\nexport function priceLabel(): string {\n return `$${perPageUsd().toFixed(2)}/page`;\n}\n\nexport function recipient(): string {\n return Deno.env.get(\"TEMPO_RECIPIENT\") || \"0xed5bd29c47d40a054591b18cc2142cea8ab7c18a\";\n}\n\n// --- page counting ----------------------------------------------------------\n\nfunction base64ToBytes(b64: string): Uint8Array {\n const bin = atob(b64.replace(/^data:.*;base64,/, \"\"));\n const out = new Uint8Array(bin.length);\n for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n return out;\n}\n\nasync function docBytes(input: { fileUrl?: string; contentBase64?: string }): Promise {\n if (input.contentBase64) {\n try {\n return base64ToBytes(input.contentBase64);\n } catch {\n return null;\n }\n }\n if (input.fileUrl) {\n try {\n const res = await fetch(input.fileUrl);\n if (!res.ok) return null;\n const buf = new Uint8Array(await res.arrayBuffer());\n return buf.byteLength <= 25_000_000 ? buf : null; // 25 MB cap\n } catch {\n return null;\n }\n }\n return null;\n}\n\n/** Count PDF pages. Falls back to 1 page if the doc can't be fetched/parsed. */\nexport async function countPages(input: { fileUrl?: string; contentBase64?: string }): Promise {\n const bytes = await docBytes(input);\n if (!bytes) return 1;\n try {\n const { PDFDocument } = await import(\"npm:pdf-lib\"); // dynamic so an import error can't kill the val\n const doc = await PDFDocument.load(bytes, { updateMetadata: false });\n return Math.max(1, doc.getPageCount());\n } catch {\n return 1; // non-PDF / unparseable → bill a single page\n }\n}\n\nexport function amountForPages(pages: number): string {\n return (Math.max(1, pages) * perPageUsd()).toFixed(2);\n}\n\n// --- mppx client ------------------------------------------------------------\n\nfunction signer() {\n const k = Deno.env.get(\"MPP_SIGNER_KEY\");\n return k ? privateKeyToAccount(k as `0x${string}`) : undefined;\n}\n\nlet _client: ReturnType | null = null;\nfunction client() {\n // secretKey from MPP_SECRET_KEY; mainnet + USDC.e are the tempo() defaults.\n // `account` is a server signer tempo() requires (session settlement; unused by charge).\n _client ??= Mppx.create({ methods: [tempo({ recipient: recipient(), account: signer() })] });\n return _client;\n}\n\n/** Hono middleware: count the document's pages and charge pages × rate. Lazily\n * inits so a config error only affects this route, not the whole val. */\nexport function chargeFax() {\n return async (c: any, next: any) => {\n let body: any = {};\n try {\n body = await c.req.json();\n } catch {\n body = {};\n }\n const pages = await countPages({\n fileUrl: body?.file_url ? String(body.file_url) : undefined,\n contentBase64: body?.content_base64 ? String(body.content_base64) : undefined,\n });\n const amount = amountForPages(pages);\n c.set(\"faxPages\", pages);\n c.set(\"faxAmount\", amount);\n return client().charge({ amount })(c, next);\n };\n}\n\nexport function paymentInfo() {\n const r = recipient();\n return {\n protocol: \"mpp\",\n method: \"tempo\",\n network: \"tempo\",\n chainId: 4217,\n asset: USDC_E,\n pricing: { model: \"per_page\", per_page_usd: perPageUsd(), currency: \"USDC.e\" },\n price: priceLabel(),\n recipient: r,\n payTo: r, // alias for UI compatibility\n facilitator: \"none (settles via Tempo RPC)\",\n mode: \"mpp\",\n payableBy: [\"tempo-mpp\"],\n };\n}\n",[159],"2056f958-5b84-11f1-92a7-ee650bb23af1","main.ts",104,["D",1780075846105],19,"http","// agentfax — a fax API for AI agents, paid per fax over Tempo/MPP (USDC.e).\n//\n// No signup, no API key: an agent calls POST /v1/fax, gets back a 402 with an\n// MPP \"Payment\" challenge, pays in USDC.e on Tempo, and the fax goes out.\n// Pay in one line with the Tempo CLI:\n// tempo request -X POST --json '{...}' /v1/fax\n//\n// We never store the document itself — it's forwarded to the fax network and\n// dropped. We do keep a minimal metadata log (destination, pages, amount,\n// paying wallet) for a running total. Status is read live from the provider.\nimport { Hono } from \"npm:hono\";\nimport { parseVal, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { activeProvider, decodeJobId, getStatus, sendFax, validateInput } from \"./fax.ts\";\nimport { chargeFax, paymentInfo, priceLabel, recipient } from \"./mpp.ts\";\nimport { renderPage } from \"./frontend/render.tsx\";\nimport { renderOg } from \"./og.ts\";\nimport { faxStats, logFax } from \"./db.ts\";\n\nconst app = new Hono();\n\nconst origin = (c: { req: { url: string } }) => new URL(c.req.url).origin;\n\n// Best-effort: pull the paying wallet from the MPP credential (the address that\n// isn't our recipient). Returns null if it can't be read — metadata only.\nfunction decodePayer(authHeader: string | undefined, recip: string): string | null {\n if (!authHeader) return null;\n try {\n const json = atob(authHeader.replace(/^Payment\\s+/i, \"\").trim().replace(/-/g, \"+\").replace(/_/g, \"/\"));\n const addrs = [...json.matchAll(/0x[a-fA-F0-9]{40}/g)].map((m) => m[0]);\n return addrs.find((a) => a.toLowerCase() !== recip.toLowerCase()) ?? null;\n } catch {\n return null;\n }\n}\n\n// --- Landing page (SSR) -----------------------------------------------------\napp.get(\"/\", async (c) =>\n c.html(renderPage({\n baseUrl: origin(c),\n payment: paymentInfo(),\n provider: activeProvider(),\n price: priceLabel(),\n stats: await faxStats().catch(() => ({ faxes: 0, pages: 0 })),\n })));\n\n// View source (required for Val Town UIs)\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// Static frontend assets (favicon, client demo script)\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path));\n\n// Social card image (Open Graph / Twitter)\napp.get(\"/og.png\", () => renderOg());\n\n// --- Discovery manifest -----------------------------------------------------\nfunction manifest(base: string) {\n return {\n name: \"agentfax\",\n description: \"Send a fax to any phone number. Paid per fax in USDC.e over Tempo/MPP — no signup, no API key.\",\n data_retention: \"documents/content are never stored; only minimal send metadata is logged (destination, pages, amount, payer)\",\n payment: paymentInfo(),\n endpoints: {\n send_fax: {\n method: \"POST\",\n path: \"/v1/fax\",\n paid: true,\n body: {\n to: \"string (E.164, e.g. +14155550123) — required\",\n file_url: \"string (public PDF URL) — provide this or content_base64\",\n content_base64: \"string (base64 document bytes)\",\n file_name: \"string (optional, used with content_base64)\",\n metadata: \"object (optional, echoed back, not stored)\",\n },\n returns: { id: \"string\", status: \"queued|sending|delivered|failed\", to: \"string\" },\n },\n get_fax: { method: \"GET\", path: \"/v1/fax/{id}\", paid: false, note: \"live status from the fax network\" },\n info: { method: \"GET\", path: \"/v1/info\", paid: false },\n },\n example: {\n tempo_cli: `tempo request -X POST --json '{\"to\":\"+14155550123\",\"file_url\":\"https://example.com/doc.pdf\"}' ${base}/v1/fax`,\n curl: `curl -X POST ${base}/v1/fax -H 'content-type: application/json' -d '{\"to\":\"+14155550123\",\"file_url\":\"https://example.com/doc.pdf\"}'`,\n note: \"Without payment this returns HTTP 402 with an MPP 'Payment' challenge. The Tempo CLI (or any MPP client) pays in USDC.e and retries automatically.\",\n },\n };\n}\napp.get(\"/v1/info\", (c) => c.json(manifest(origin(c))));\n\n// llms.txt — point agents at the manifest so they can self-onboard.\napp.get(\"/llms.txt\", (c) => {\n const base = origin(c);\n return c.text(\n `# agentfax\n\n> A pay-per-fax HTTP API for AI agents. Send a fax to any phone number and pay per fax in USDC.e over Tempo/MPP — no signup, no API key. Documents are never stored; only minimal send metadata is logged.\n\n## Docs\n- [Machine-readable manifest](${base}/v1/info): payment terms (network, asset, price, recipient), the request schema, and a ready-to-run example.\n- [Homepage](${base}/): overview and a live payment demo.\n\n## Using it\n- POST ${base}/v1/fax with {\"to\":\"+14155550123\",\"file_url\":\"https://.../doc.pdf\"}. An unpaid request returns HTTP 402 with an MPP Payment challenge; pay with the Tempo CLI (\\`tempo request\\`) or any MPP client and retry.\n- GET ${base}/v1/fax/{id}: live delivery status.\n`,\n 200,\n { \"content-type\": \"text/plain; charset=utf-8\" },\n );\n});\n\n// --- Read fax status (free, proxied live — we hold no state) ----------------\napp.get(\"/v1/fax/:id\", async (c) => {\n const id = c.req.param(\"id\");\n if (!decodeJobId(id)) return c.json({ error: \"bad_id\", id }, 400);\n const s = await getStatus(id).catch(() => null);\n if (!s) return c.json({ error: \"not_found\", id }, 404);\n return c.json({\n id,\n status: s.status,\n pages: s.pages,\n error: s.error ?? null,\n _links: { self: `${origin(c)}/v1/fax/${id}` },\n });\n});\n\n// --- Send a fax (paid via Tempo/MPP) ----------------------------------------\napp.post(\"/v1/fax\", chargeFax(), async (c) => {\n let body: Record = {};\n try {\n body = await c.req.json();\n } catch {\n return c.json({ error: \"invalid_json\", message: \"Request body must be JSON.\" }, 400);\n }\n\n const input = {\n to: String(body.to ?? \"\"),\n fileUrl: body.file_url ? String(body.file_url) : undefined,\n contentBase64: body.content_base64 ? String(body.content_base64) : undefined,\n fileName: body.file_name ? String(body.file_name) : undefined,\n };\n\n const validationError = validateInput(input);\n if (validationError) return c.json({ error: \"invalid_request\", message: validationError }, 400);\n\n const result = await sendFax(input);\n if (!result.jobId && result.status === \"failed\") {\n return c.json({ error: \"provider_error\", message: result.error ?? \"Failed to submit fax.\" }, 502);\n }\n\n const pages = (c.get(\"faxPages\") as number) ?? result.pages;\n const amount = (c.get(\"faxAmount\") as string) ?? null;\n const created_at = new Date().toISOString();\n\n // Log innocuous metadata only — never the document. Best-effort; never blocks the fax.\n try {\n await logFax({\n id: result.jobId,\n to: input.to,\n pages,\n amount,\n payer: decodePayer(c.req.header(\"Authorization\"), recipient()),\n network: \"tempo\",\n provider: result.provider,\n status: result.status,\n created_at,\n });\n } catch (_e) { /* metadata is best-effort */ }\n\n return c.json({\n id: result.jobId,\n status: result.status,\n to: input.to,\n pages,\n provider: result.provider,\n price_usd: amount ? `${amount}` : priceLabel(),\n pricing: \"per_page\",\n error: result.error ?? null,\n metadata: body.metadata ?? undefined,\n created_at,\n _links: { self: `${origin(c)}/v1/fax/${result.jobId}` },\n }, 200);\n});\n\n// Unwrap Hono errors so logs show real stack traces.\napp.onError((err) => Promise.reject(err));\n\nexport default app.fetch;\n",[166],"678cb562-5b78-11f1-9cf4-ee650bb23af1","fax.ts","fb07a1c6-5b69-11f1-aa33-ee650bb23af1",59,["D",1780070811654],"// Pluggable, stateless fax backend.\n//\n// agentfax stores NOTHING: we forward the document to the fax network, hand\n// back a job id, and drop the payload. Status is read live from the provider.\n//\n// Live: Sinch Fax API v3 (Phaxio's successor). Needs SINCH_KEY_ID +\n// SINCH_KEY_SECRET (OAuth2) + SINCH_PROJECT_ID. (The key id/secret fall back to\n// PHAXIO_API_KEY / PHAXIO_SECRET, which hold the same Sinch access key.)\n// Otherwise: a deterministic sandbox that simulates sending so the full\n// pay -> fax loop is demoable without a fax account.\n\nexport type FaxStatus = \"queued\" | \"sending\" | \"delivered\" | \"failed\";\nexport type Provider = \"sinch\" | \"sandbox\";\n\nexport interface FaxInput {\n to: string;\n fileUrl?: string; // public URL to a PDF (preferred — Sinch fetches it)\n contentBase64?: string; // base64-encoded document bytes\n fileName?: string; // used with contentBase64\n}\n\nexport interface FaxSendResult {\n provider: Provider;\n jobId: string; // opaque, provider-namespaced id we hand back to the caller\n status: FaxStatus;\n pages: number | null;\n error?: string;\n}\n\nfunction sinchKeyId() {\n return Deno.env.get(\"SINCH_KEY_ID\") || Deno.env.get(\"PHAXIO_API_KEY\");\n}\nfunction sinchKeySecret() {\n return Deno.env.get(\"SINCH_KEY_SECRET\") || Deno.env.get(\"PHAXIO_SECRET\");\n}\nfunction sinchProjectId() {\n return Deno.env.get(\"SINCH_PROJECT_ID\");\n}\n\nexport function activeProvider(): Provider {\n return sinchKeyId() && sinchKeySecret() && sinchProjectId() ? \"sinch\" : \"sandbox\";\n}\n\n// --- Input handling ---------------------------------------------------------\n\nexport function normalizeNumber(to: string): string {\n const digits = to.trim().replace(/[^\\d+]/g, \"\");\n if (digits.startsWith(\"+\")) return digits;\n if (/^\\d{10}$/.test(digits)) return \"+1\" + digits; // bare NANP\n if (/^1\\d{10}$/.test(digits)) return \"+\" + digits;\n return \"+\" + digits;\n}\n\nexport function validateInput(input: FaxInput): string | null {\n if (!input.to || normalizeNumber(input.to).replace(/\\D/g, \"\").length < 8) {\n return \"`to` must be a valid phone number in E.164 format, e.g. +14155550123\";\n }\n if (!input.fileUrl && !input.contentBase64) {\n return \"Provide a document via `file_url` (a public PDF URL) or `content_base64`.\";\n }\n if (input.fileUrl && !/^https?:\\/\\//.test(input.fileUrl)) {\n return \"`file_url` must be an http(s) URL.\";\n }\n return null;\n}\n\n// --- Job id (provider-namespaced, carries no payload) -----------------------\n\nexport function encodeJobId(provider: Provider, providerRef: string): string {\n return `${provider === \"sinch\" ? \"snc\" : \"sbx\"}_${providerRef}`;\n}\n\nexport function decodeJobId(id: string): { provider: Provider; ref: string } | null {\n const i = id.indexOf(\"_\");\n if (i < 0) return null;\n const prefix = id.slice(0, i);\n const ref = id.slice(i + 1);\n if (prefix === \"snc\") return { provider: \"sinch\", ref };\n if (prefix === \"sbx\") return { provider: \"sandbox\", ref };\n return null;\n}\n\n// --- Send -------------------------------------------------------------------\n\nexport async function sendFax(input: FaxInput): Promise {\n return activeProvider() === \"sinch\" ? sendViaSinch(input) : sendViaSandbox(input);\n}\n\n/** Live status lookup — no local state. */\nexport async function getStatus(\n jobId: string,\n): Promise<{ status: FaxStatus; pages: number | null; error?: string } | null> {\n const decoded = decodeJobId(jobId);\n if (!decoded) return null;\n return decoded.provider === \"sinch\" ? sinchStatus(decoded.ref) : sandboxStatus(decoded.ref);\n}\n\n// --- Sinch Fax API v3 -------------------------------------------------------\n\nlet _token: { value: string; exp: number } | null = null;\nasync function sinchToken(): Promise {\n const now = Date.now();\n if (_token && _token.exp > now + 60_000) return _token.value;\n const res = await fetch(\"https://auth.sinch.com/oauth2/token\", {\n method: \"POST\",\n headers: {\n Authorization: \"Basic \" + btoa(`${sinchKeyId()}:${sinchKeySecret()}`),\n \"content-type\": \"application/x-www-form-urlencoded\",\n },\n body: \"grant_type=client_credentials\",\n });\n const j = await res.json().catch(() => ({}));\n if (!j.access_token) throw new Error(`Sinch auth failed (HTTP ${res.status})`);\n _token = { value: j.access_token, exp: now + (Number(j.expires_in) || 3600) * 1000 };\n return _token.value;\n}\n\nfunction faxApiBase() {\n return `https://fax.api.sinch.com/v3/projects/${sinchProjectId()}/faxes`;\n}\n\nasync function sendViaSinch(input: FaxInput): Promise {\n let token: string;\n try {\n token = await sinchToken();\n } catch (e) {\n return { provider: \"sinch\", jobId: \"\", status: \"failed\", pages: null, error: String((e as Error).message) };\n }\n\n const form = new FormData();\n form.append(\"to\", normalizeNumber(input.to));\n const from = Deno.env.get(\"SINCH_FROM\");\n if (from) form.append(\"from\", from);\n if (input.fileUrl) {\n form.append(\"contentUrl\", input.fileUrl);\n } else if (input.contentBase64) {\n const blob = new Blob([base64ToBytes(input.contentBase64)], { type: \"application/pdf\" });\n form.append(\"file\", blob, input.fileName || \"document.pdf\");\n }\n\n const res = await fetch(faxApiBase(), {\n method: \"POST\",\n headers: { Authorization: `Bearer ${token}` },\n body: form,\n });\n const j = await res.json().catch(() => ({}));\n if (!res.ok || !j?.id) {\n return {\n provider: \"sinch\",\n jobId: \"\",\n status: \"failed\",\n pages: null,\n error: j?.message || j?.error || `Sinch error (HTTP ${res.status})`,\n };\n }\n return {\n provider: \"sinch\",\n jobId: encodeJobId(\"sinch\", String(j.id)),\n status: mapSinchStatus(j.status),\n pages: j.numberOfPages ?? null,\n };\n}\n\nasync function sinchStatus(ref: string): Promise<{ status: FaxStatus; pages: number | null; error?: string }> {\n const token = await sinchToken();\n const res = await fetch(`${faxApiBase()}/${encodeURIComponent(ref)}`, {\n headers: { Authorization: `Bearer ${token}` },\n });\n const j = await res.json().catch(() => ({}));\n return { status: mapSinchStatus(j?.status), pages: j?.numberOfPages ?? null, error: j?.errorType || undefined };\n}\n\nexport function mapSinchStatus(s: string | undefined): FaxStatus {\n switch (s) {\n case \"COMPLETED\":\n return \"delivered\";\n case \"FAILURE\":\n return \"failed\";\n case \"QUEUED\":\n return \"queued\";\n default:\n return \"sending\"; // IN_PROGRESS + unknowns\n }\n}\n\n// --- Sandbox (stateless: outcome is encoded in the job ref) -----------------\n\nconst SANDBOX_FAIL_NUMBERS = new Set([\"+15550000000\", \"+10000000000\"]);\n\nfunction sendViaSandbox(input: FaxInput): FaxSendResult {\n const to = normalizeNumber(input.to);\n const status: FaxStatus = SANDBOX_FAIL_NUMBERS.has(to) ? \"failed\" : \"delivered\";\n const ref = `${status}.${crypto.randomUUID().slice(0, 8)}`;\n return {\n provider: \"sandbox\",\n jobId: encodeJobId(\"sandbox\", ref),\n status,\n pages: status === \"delivered\" ? 1 : null,\n error: status === \"failed\" ? \"no_answer (simulated)\" : undefined,\n };\n}\n\nfunction sandboxStatus(ref: string): { status: FaxStatus; pages: number | null; error?: string } {\n const status = (ref.split(\".\")[0] as FaxStatus) || \"delivered\";\n return {\n status,\n pages: status === \"delivered\" ? 1 : null,\n error: status === \"failed\" ? \"no_answer (simulated)\" : undefined,\n };\n}\n\nfunction base64ToBytes(b64: string): Uint8Array {\n const bin = atob(b64.replace(/^data:.*;base64,/, \"\"));\n const out = new Uint8Array(bin.length);\n for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n return out;\n}\n",[174],"ef1ec7e4-5b83-11f1-a640-ee650bb23af1","db.ts","ef1ec8b6-5b83-11f1-a640-ee650bb23af1",97,["D",1780075763522],"// Minimal metadata log — NEVER the document content. We record only innocuous\n// send metadata (destination, pages, amount, paying wallet) so we can show a\n// running total and basic analytics. The fax payload is never persisted.\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nconst TABLE = \"fax_log_v1\";\n\nlet ready: Promise | null = null;\nfunction init(): Promise {\n ready ??= sqlite\n .execute(`CREATE TABLE IF NOT EXISTS ${TABLE} (\n id TEXT PRIMARY KEY,\n to_number TEXT,\n pages INTEGER,\n amount_usd TEXT,\n payer TEXT,\n network TEXT,\n provider TEXT,\n status TEXT,\n created_at TEXT NOT NULL\n )`)\n .then(() => undefined);\n return ready;\n}\n\nexport interface FaxLog {\n id: string;\n to: string;\n pages: number | null;\n amount: string | null;\n payer: string | null;\n network: string;\n provider: string;\n status: string;\n created_at: string;\n}\n\nexport async function logFax(rec: FaxLog): Promise {\n await init();\n await sqlite.execute({\n sql: `INSERT OR REPLACE INTO ${TABLE}\n (id, to_number, pages, amount_usd, payer, network, provider, status, created_at)\n VALUES (?,?,?,?,?,?,?,?,?)`,\n args: [rec.id, rec.to, rec.pages, rec.amount, rec.payer, rec.network, rec.provider, rec.status, rec.created_at],\n });\n}\n\nexport async function faxStats(): Promise<{ faxes: number; pages: number }> {\n await init();\n const { rows } = await sqlite.execute(\n `SELECT COUNT(*) AS faxes, COALESCE(SUM(pages), 0) AS pages FROM ${TABLE}`,\n );\n const r = rows[0] as unknown as { faxes: number; pages: number };\n return { faxes: Number(r?.faxes ?? 0), pages: Number(r?.pages ?? 0) };\n}\n",[181],"6956d860-5b77-11f1-9efa-ee650bb23af1","README.md","954e2682-5b6b-11f1-b802-ee650bb23af1",53,["D",1780070385162],5,"# agentfax\n\nA fax API for AI agents — **paid per fax over [Tempo/MPP](https://mpp.dev) (USDC.e)**. No signup, no\nAPI key, no dashboard. An agent calls one endpoint, gets a `402 Payment Required` with an MPP `Payment`\nchallenge, pays in USDC.e on Tempo, and the fax goes out. It's \"AgentMail, but for faxes.\"\n\nPay it in one line with the Tempo CLI:\n\n```bash\ntempo request -X POST --json '{\"to\":\"+14155550123\",\"file_url\":\"https://example.com/doc.pdf\"}' \\\n https://agentfax.val.run/v1/fax\n```\n\n## Why it's interesting\n\n- **Permissionless monetization.** No marketplace to apply to. You stand up an HTTP endpoint that\n returns a 402 `WWW-Authenticate: Payment` challenge pointing at your wallet; any MPP client pays it.\n- **No facilitator, no keys to babysit.** `mppx` verifies and settles the payment directly against the\n Tempo chain — there's no payment processor in the middle.\n- **Stateless / zero data retention.** agentfax forwards the document to the fax network and keeps\n nothing — no DB, no logs of numbers or contents. The job id it returns is a thin pointer to the carrier.\n- **Pluggable fax backend.** Real faxing via [Phaxio](https://www.phaxio.com) when keys are set;\n otherwise a deterministic **sandbox** that simulates sending, so the whole pay→fax loop works with no\n fax account.\n\n## Endpoints\n\n| Method | Path | Paid | Description |\n|--------|------|------|-------------|\n| `POST` | `/v1/fax` | ✅ MPP | Send a fax. Returns `402` (MPP `Payment` challenge) until paid, then a job id. |\n| `GET` | `/v1/fax/{id}` | free | Live delivery status (proxied from the carrier). |\n| `GET` | `/v1/info` | free | Machine-readable manifest (price, network, recipient, schema, example). |\n| `GET` | `/llms.txt` | free | Pointer file so an agent can self-onboard. |\n\n### Send a fax\n\n`to` is required (E.164). Provide the document as either `file_url` (a public PDF URL) or\n`content_base64` (+ optional `file_name`). `metadata` is optional, echoed back, not stored.\n\nUnpaid, `POST /v1/fax` returns `402` with a `WWW-Authenticate: Payment` header. The Tempo CLI (or any\nMPP client) reads it, signs the USDC.e payment, and retries automatically.\n\n## Payments\n\n- **Rail:** MPP (the open `Payment` HTTP-auth scheme) on **Tempo mainnet** (chain id 4217).\n- **Asset:** USDC.e — `0x20C000000000000000000000b9537d11c60E8b50` (6 decimals).\n- **Settlement:** verified directly against the Tempo RPC by `mppx` — no facilitator.\n- **You get paid** at `TEMPO_RECIPIENT` (your Tempo wallet).\n- **x402 (Coinbase/Circle) is parked** in the codebase (`payment.ts`); re-enable it with a valid CDP\n facilitator key to also accept Base USDC agents.\n\n## Configuration\n\nSensible defaults; the only thing you must set for real money is funding your wallet.\n\n| Env var | Default | Purpose |\n|---------|---------|---------|\n| `TEMPO_RECIPIENT` | Steve's Tempo wallet | Tempo address that **receives** the USDC.e. |\n| `MPP_SECRET_KEY` | (set) | Server HMAC secret binding challenges to credentials. |\n| `MPP_SIGNER_KEY` | (set) | Server signer required by `mppx` (session settlement; unused by one-shot charge). |\n| `FAX_PRICE_USD` | `0.50` | Price per fax. |\n| `PHAXIO_API_KEY` / `PHAXIO_SECRET` | unset → sandbox | Enable real faxing via Phaxio. |\n\n### Go live (real faxes + real payments)\n\n1. **Fund your Tempo wallet** with a little USDC.e (`tempo wallet fund`) — that's where payments are\n debited from when *you* test, and the recipient of inbound payments.\n2. **Add Phaxio keys** so faxes actually transmit (otherwise sandbox-simulated):\n\n 👉 Add PHAXIO_API_KEY here: https://www.val.town/x/stevekrouse/agentfax/environment-variables?key=PHAXIO_API_KEY\n\n 👉 Add PHAXIO_SECRET here: https://www.val.town/x/stevekrouse/agentfax/environment-variables?key=PHAXIO_SECRET\n\n## Files\n\n- `main.ts` — Hono server: routes, MPP payment gate, SSR landing page.\n- `mpp.ts` — Tempo/MPP rail via `mppx` (mainnet, USDC.e), `paymentInfo()`.\n- `fax.ts` — stateless fax backend (Phaxio + sandbox), job-id codec, live status.\n- `payment.ts` — parked x402 rail (re-enable with a CDP key).\n- `frontend/` — SSR React + Twind landing page.\n\nBuilt on [Val Town](https://val.town). Faxes via Phaxio. Payments via [Tempo/MPP](https://mpp.dev).\n",[188],"d94cf8b4-5b6a-11f1-8821-ee650bb23af1","frontend","9e1c8bb4-274b-4708-8b6c-c29d6ea270c2",8,["D",1780064989545],"directory",[196],"pulls","branches",1,"forks","envVars",{"_210":212,"_213":64},"connections",{"_210":64,"_211":64},"count","unfilledCount",13,"emptyCount",{"_44":195,"_32":196,"_30":197,"_142":-5,"_42":43,"_41":198,"_144":60,"_39":322,"_13":64,"_34":200,"_36":-5,"_24":25,"_148":-5,"_232":323,"_27":324},{"_44":318,"_32":295,"_30":289,"_142":197,"_42":43,"_41":198,"_144":60,"_39":319,"_13":64,"_34":200,"_36":-5,"_24":25,"_148":-5,"_232":320,"_27":321},{"_44":310,"_32":311,"_30":312,"_142":289,"_42":43,"_41":313,"_144":60,"_39":314,"_13":155,"_34":35,"_36":315,"_24":25,"_148":-5,"_232":316,"_27":317},{"_44":301,"_32":302,"_30":303,"_142":289,"_42":43,"_41":304,"_144":25,"_39":305,"_13":306,"_34":35,"_36":307,"_24":25,"_148":-5,"_232":308,"_27":309},{"_44":296,"_32":33,"_30":31,"_142":289,"_42":43,"_41":14,"_144":25,"_39":297,"_13":298,"_34":35,"_36":38,"_24":25,"_148":-5,"_232":299,"_27":300},{"_44":286,"_32":287,"_30":288,"_142":289,"_42":43,"_41":290,"_144":60,"_39":291,"_13":146,"_34":35,"_36":292,"_24":25,"_148":-5,"_232":293,"_27":294},{"_44":277,"_32":278,"_30":279,"_142":197,"_42":43,"_41":280,"_144":25,"_39":281,"_13":282,"_34":35,"_36":283,"_24":25,"_148":-5,"_232":284,"_27":285},{"_44":269,"_32":270,"_30":271,"_142":197,"_42":43,"_41":272,"_144":60,"_39":273,"_13":204,"_34":35,"_36":274,"_24":25,"_148":-5,"_232":275,"_27":276},{"_44":261,"_32":262,"_30":263,"_142":197,"_42":43,"_41":264,"_144":60,"_39":265,"_13":64,"_34":20,"_36":266,"_24":25,"_148":-5,"_232":267,"_27":268},{"_44":253,"_32":254,"_30":255,"_142":197,"_42":43,"_41":256,"_144":60,"_39":257,"_13":155,"_34":35,"_36":258,"_24":25,"_148":-5,"_232":259,"_27":260},{"_44":187,"_32":188,"_30":189,"_142":-5,"_42":43,"_41":190,"_144":25,"_39":250,"_13":192,"_34":20,"_36":193,"_24":25,"_148":-5,"_232":251,"_27":252},{"_44":180,"_32":181,"_30":182,"_142":-5,"_42":43,"_41":183,"_144":25,"_39":247,"_13":64,"_34":35,"_36":185,"_24":25,"_148":-5,"_232":248,"_27":249},{"_44":173,"_32":174,"_30":175,"_142":-5,"_42":43,"_41":176,"_144":25,"_39":244,"_13":146,"_34":35,"_36":178,"_24":25,"_148":-5,"_232":245,"_27":246},{"_44":165,"_32":166,"_30":58,"_142":-5,"_42":43,"_41":167,"_144":25,"_39":241,"_13":169,"_34":170,"_36":171,"_24":25,"_148":46,"_232":242,"_27":243},{"_44":158,"_32":159,"_30":160,"_142":-5,"_42":43,"_41":161,"_144":60,"_39":238,"_13":155,"_34":35,"_36":163,"_24":25,"_148":-5,"_232":239,"_27":240},{"_44":150,"_32":151,"_30":152,"_142":-5,"_42":43,"_41":153,"_144":60,"_39":235,"_13":155,"_34":35,"_36":156,"_24":25,"_148":-5,"_232":236,"_27":237},{"_44":139,"_32":140,"_30":141,"_142":-5,"_42":43,"_41":143,"_144":60,"_39":231,"_13":146,"_34":35,"_36":147,"_24":25,"_148":-5,"_232":233,"_27":234},["D",1780069741640],"children",[],[140],["D",1780075927348],[],[151],["D",1780070634528],[],[159],["D",1780075846105],[],[166],["D",1780070811654],[],[174],["D",1780075763522],[],[181],["D",1780070385162],[],[188],"c23392be-5b83-11f1-9e9b-ee650bb23af1","render.tsx","1881fa52-5b6b-11f1-a9ea-ee650bb23af1",94,["D",1780075688203],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n// Server-side render of the landing page. Per Val Town's React SSR quirk we\n// import react-dom/server from esm.sh with a pinned `?deps` to avoid the\n// \"ReactCurrentDispatcher\" mismatch that `npm:` imports trigger.\nimport { renderToString } from \"https://esm.sh/react-dom@18.2.0/server?deps=react@18.2.0\";\nimport { App, type PageData } from \"./App.tsx\";\n\nexport function renderPage(data: PageData): string {\n const body = renderToString();\n const desc = \"Send a fax from an AI agent. Pay per fax in USDC.e over Tempo/MPP — no signup, no API key.\";\n return `\n\n \n \n \n agentfax — a fax API for AI agents\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

${body}

\n \n \n \n`;\n}\n",[],[196,254],"1d53ca9c-5b6b-11f1-849c-ee650bb23af1","favicon.svg","1d53cb5a-5b6b-11f1-849c-ee650bb23af1",15,["D",1780065103676],"\n",[],[196,262],"3309e8f4-5b74-11f1-a656-ee650bb23af1","demo.js","1bc83bae-5b6b-11f1-a9af-ee650bb23af1",38,["D",1780069005517],"// Minimal client JS: fire a real POST /v1/fax with no payment and show the\n// response (the 402 challenge in x402 mode, or a simulated fax in sandbox mode).\nconst btn = document.getElementById(\"try-btn\");\nconst out = document.getElementById(\"try-out\");\n\nbtn?.addEventListener(\"click\", async () => {\n const label = btn.textContent;\n btn.disabled = true;\n btn.textContent = \"Calling…\";\n out.className = \"text-neutral-200\";\n out.textContent = \"\";\n try {\n const res = await fetch(\"/v1/fax\", {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\" },\n body: JSON.stringify({\n to: \"+14155550123\",\n file_url: \"https://example.com/invoice.pdf\",\n }),\n });\n const text = await res.text();\n let pretty = text;\n try {\n pretty = JSON.stringify(JSON.parse(text), null, 2);\n } catch (_) { /* leave as text */ }\n out.textContent = `HTTP ${res.status} ${res.statusText}\\n\\n${pretty}`;\n } catch (e) {\n out.textContent = \"Error: \" + (e && e.message ? e.message : String(e));\n } finally {\n btn.disabled = false;\n btn.textContent = label;\n }\n});\n\n// \"Copy prompt for your agent\" — copy the onboarding prompt to the clipboard.\nconst copyBtn = document.getElementById(\"copy-prompt\");\ncopyBtn?.addEventListener(\"click\", async () => {\n const text = copyBtn.dataset.prompt || \"\";\n const orig = copyBtn.textContent;\n try {\n await navigator.clipboard.writeText(text);\n } catch (_) {\n const ta = document.createElement(\"textarea\");\n ta.value = text;\n document.body.appendChild(ta);\n ta.select();\n try { document.execCommand(\"copy\"); } catch (e) { /* ignore */ }\n document.body.removeChild(ta);\n }\n copyBtn.textContent = \"Copied — paste it to your agent\";\n setTimeout(() => { copyBtn.textContent = orig; }, 2200);\n});\n",[],[196,270],"611c00fa-5b84-11f1-8ec0-ee650bb23af1","App.tsx","14a4fede-5b6b-11f1-9995-ee650bb23af1",108,["D",1780075954650],6,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg } from \"./components/ui.tsx\";\nimport { Hero } from \"./components/Hero.tsx\";\nimport { Api } from \"./components/Api.tsx\";\nimport { Footer, HowItWorks, Networks, Privacy, Shingle, TryIt } from \"./components/Sections.tsx\";\n\nexport interface PageData {\n baseUrl: string;\n payment: {\n network: string;\n price: string;\n payTo: string;\n facilitator: string;\n mode: string;\n asset: { symbol: string; address: string | null; decimals: number };\n };\n provider: \"sinch\" | \"sandbox\";\n price: string;\n stats: { faxes: number; pages: number };\n}\n\nexport function App(data: PageData) {\n const cfg: Cfg = {\n baseUrl: data.baseUrl,\n network: data.payment.network,\n price: data.payment.price,\n assetSymbol: data.payment.asset.symbol,\n assetAddress: data.payment.asset.address,\n payTo: data.payment.payTo,\n facilitator: data.payment.facilitator,\n provider: data.provider,\n mode: data.payment.mode,\n };\n\n return (\n

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

\n );\n}\n",[],[196,278],"653b27e6-5b6c-11f1-b3c6-ee650bb23af1","ui.tsx","d94cc79a-5b6a-11f1-8821-ee650bb23af1","2cfc3eb1-20cd-46f7-9c4d-6cd1b987b684",25,["D",1780065653799],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n// Shared presentational primitives. Server-rendered; no client JS.\n\nexport interface Cfg {\n baseUrl: string;\n network: string;\n price: string;\n assetSymbol: string;\n assetAddress: string | null;\n payTo: string;\n facilitator: string;\n provider: \"phaxio\" | \"sandbox\";\n mode: \"x402\" | \"sandbox\";\n}\n\nexport function Section(\n { id, className = \"\", children }: { id?: string; className?: string; children: any },\n) {\n return (\n

\n {children}\n

\n );\n}\n\nexport function Eyebrow({ children }: { children: any }) {\n return (\n

\n {children}\n

\n );\n}\n\nconst TONES: Record = {\n neutral: \"bg-neutral-800/80 text-neutral-300 border-neutral-700\",\n green: \"bg-emerald-500/10 text-emerald-300 border-emerald-500/30\",\n amber: \"bg-amber-500/10 text-amber-300 border-amber-500/30\",\n blue: \"bg-sky-500/10 text-sky-300 border-sky-500/30\",\n};\n\nexport function Pill({ tone = \"neutral\", children }: { tone?: string; children: any }) {\n return (\n \n {children}\n \n );\n}\n\nexport function Card({ className = \"\", children }: { className?: string; children: any }) {\n return (\n

\n {children}\n

\n );\n}\n\nexport function CodeBlock(\n { label, children }: { label?: string; children: any },\n) {\n return (\n

\n {label\n ? (\n

\n {label}\n

\n )\n : null}\n

\n        {children}\n

\n );\n}\n\nexport function Mono({ children }: { children: any }) {\n return {children};\n}\n",[],[196,295,287],"components","64f67b38-5b84-11f1-be4f-ee650bb23af1",["D",1780075961277],12,[],[196,295,33],"c39b4b56-5b83-11f1-9314-ee650bb23af1","Hero.tsx","e3d46286-5b6a-11f1-ae79-ee650bb23af1",96,["D",1780075690567],14,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg, CodeBlock, Eyebrow, Pill, Section } from \"./ui.tsx\";\n\nfunction shorten(addr: string) {\n return addr && addr.length > 12 ? `${addr.slice(0, 6)}…${addr.slice(-4)}` : addr;\n}\n\nexport function Hero({ cfg }: { cfg: Cfg }) {\n const agentPrompt =\n `You can send a real fax through agentfax — a pay-per-fax HTTP API for AI agents. ` +\n `Read ${cfg.baseUrl}/v1/info to learn the endpoints, parameters, and pricing ` +\n `(and ${cfg.baseUrl} for more context). It's paid per call over Tempo/MPP (USDC.e over HTTP 402), ` +\n `so use your wallet to pay. Once you understand the API, send a test fax for me.`;\n\n return (\n

\n Fax for AI agents\n

\n Your agent can send a fax now.\n

\n One HTTP endpoint. Your agent pays a few cents in {cfg.assetSymbol} over{\" \"}\n \n Tempo/MPP\n , and the fax goes out — no account, no API key.\n

\n\n

\n Tempo mainnet\n {cfg.price}\n no document storage\n

\n\n

\n \n Copy prompt for your agent\n \n

\n Works with any agent that has a Tempo wallet — or{\" \"}\n read the API.\n

\n\n

\n \n {`$ tempo request -X POST ${cfg.baseUrl}/v1/fax \\\\\n --json '{\n \"to\": \"+14155550123\",\n \"file_url\": \"https://example.com/invoice.pdf\"\n }'`}\n \n \n {`HTTP/1.1 402 Payment Required\nWWW-Authenticate: Payment\n method=\"tempo\", intent=\"charge\",\n amount=\"400000\" // 2 pages × ${cfg.price}, in ${cfg.assetSymbol}\n currency=\"0x20C0…60E8b50\" // ${cfg.assetSymbol}\n recipient=\"${shorten(cfg.payTo)}\"\n chainId=4217 // Tempo mainnet`}\n \n

\n Any MPP client reads the challenge, pays, and retries — your code just gets back a job id.\n

\n );\n}\n",[],[196,295,302],"87ba0408-5b81-11f1-929e-ee650bb23af1","Api.tsx","ed7aa17e-5b6a-11f1-8984-ee650bb23af1",86,["D",1780074731107],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg, Card, CodeBlock, Eyebrow, Mono, Pill, Section } from \"./ui.tsx\";\n\nfunction Endpoint(\n { method, path, paid, children }: { method: string; path: string; paid?: boolean; children: any },\n) {\n const methodTone = method === \"GET\" ? \"blue\" : \"green\";\n return (\n \n

\n {method}\n {path}\n {paid ? 402 · paid : free}\n

\n {children}\n \n );\n}\n\nexport function Api({ cfg }: { cfg: Cfg }) {\n return (\n

\n API\n

Three endpoints. That's the whole thing.

\n Discover the service at GET /v1/info. Everything an agent needs — price, network,\n receiving address, and the request schema — is machine-readable.\n

\n\n

\n \n

\n Send a fax. Returns 402 with payment terms until paid; on success returns a job id.\n

\n \n {`{\n \"to\": \"+14155550123\", // E.164, required\n \"file_url\": \"https://…/doc.pdf\", // a public PDF URL …\n \"content_base64\": \"JVBERi0…\", // … or raw base64 bytes\n \"file_name\": \"doc.pdf\", // optional\n \"metadata\": { \"ref\": \"inv-42\" } // optional, echoed back, not stored\n}`}\n \n \n {`{\n \"id\": \"snc_8675309\",\n \"status\": \"sending\",\n \"to\": \"+14155550123\",\n \"pages\": 2,\n \"price_usd\": \"$0.40\",\n \"_links\": { \"self\": \"${cfg.baseUrl}/v1/fax/snc_8675309\" }\n}`}\n \n \n\n \n

\n Poll delivery status — proxied live from the fax network. Status is one of{\" \"}\n queued, sending, delivered, failed. We hold\n no record of the destination or document.\n

\n \n\n \n

\n The machine-readable manifest: payment terms, the request schema, and a ready-to-run example.\n

\n \n

\n );\n}\n",[],[196,295,311],"d94cfc1a-5b6a-11f1-8821-ee650bb23af1",["D",1780064989545],[216,217,218,219],[196,295],["D",1780064989545],[215,220,221,222,223],[196],["D",1780064564355],["D",1789500689328],{"_101":100,"_108":104},{"_101":100,"_102":-5,"_103":104,"_18":56,"_105":106,"_107":25},{"_13":90,"_32":91,"_44":43,"_92":45,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":46,"_99":100},"ctx",{"_83":-5,"_128":363,"_364":365,"_366":367,"_368":25,"_369":25,"_370":25,"_371":60,"_372":-5,"_373":-7,"_374":-7,"_375":64,"_376":25,"_377":25,"_378":-5,"_379":25,"_380":25,"_381":25,"_382":-5},"ENV",{"_334":335,"_336":337,"_338":91,"_339":340,"_341":342,"_343":344,"_345":346,"_347":348,"_349":350,"_351":352,"_353":354,"_355":356,"_357":358,"_359":360,"_361":362},"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"]

Diff · v109