[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_329":330,"_331":332},"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",110,"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({ 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 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()} fax${stats.faxes === 1 ? \"\" : \"es\"} (${stats.pages.toLocaleString()} page${stats.pages === 1 ? \"\" : \"s\"}).`\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",1780076014351],"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":324,"_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":325,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":326,"_85":327,"_87":328,"_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":321,"_13":64,"_34":200,"_36":-5,"_24":25,"_148":-5,"_232":322,"_27":323},{"_44":317,"_32":295,"_30":289,"_142":197,"_42":43,"_41":198,"_144":60,"_39":318,"_13":64,"_34":200,"_36":-5,"_24":25,"_148":-5,"_232":319,"_27":320},{"_44":309,"_32":310,"_30":311,"_142":289,"_42":43,"_41":312,"_144":60,"_39":313,"_13":155,"_34":35,"_36":314,"_24":25,"_148":-5,"_232":315,"_27":316},{"_44":300,"_32":301,"_30":302,"_142":289,"_42":43,"_41":303,"_144":25,"_39":304,"_13":305,"_34":35,"_36":306,"_24":25,"_148":-5,"_232":307,"_27":308},{"_44":296,"_32":33,"_30":31,"_142":289,"_42":43,"_41":14,"_144":25,"_39":297,"_13":212,"_34":35,"_36":38,"_24":25,"_148":-5,"_232":298,"_27":299},{"_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","84a1a48a-5b84-11f1-bb4a-ee650bb23af1",["D",1780076014351],[],[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,301],"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,310],"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":362,"_363":364,"_365":366,"_367":25,"_368":25,"_369":25,"_370":60,"_371":-5,"_372":-7,"_373":-7,"_374":64,"_375":25,"_376":25,"_377":-5,"_378":25,"_379":25,"_380":25,"_381":-5},"ENV",{"_333":334,"_335":336,"_337":91,"_338":339,"_340":341,"_342":343,"_344":345,"_346":347,"_348":349,"_350":351,"_352":353,"_354":355,"_356":357,"_358":359,"_360":361},"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 · v110