@foldset/cloudflare 0.0.2 → 0.0.3

package/dist/ai-crawlers/index.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from "hono";
+import type { Env } from "../types";
+export interface AiCrawler {
+    user_agent: string;
+}
+export declare function getAiCrawlers(c: Context<{
+    Bindings: Env;
+}>): Promise<AiCrawler[]>;
+export declare function storeAiCrawlers(c: Context<{
+    Bindings: Env;
+}>, aiCrawlers: AiCrawler[]): Promise<void>;
+export declare function isAiCrawler(c: Context<{
+    Bindings: Env;
+}>): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-crawlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-crawlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,wBAAsB,aAAa,CACjC,CAAC,EAAE,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,CAAC,GAC5B,OAAO,CAAC,SAAS,EAAE,CAAC,CAWtB;AAED,wBAAsB,eAAe,CACnC,CAAC,EAAE,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,CAAC,EAC7B,UAAU,EAAE,SAAS,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,WAAW,CAC/B,CAAC,EAAE,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAKjD"}

package/dist/ai-crawlers/index.js

@@ -0,0 +1,26 @@
+const CACHE_TTL_MS = 30_000;
+let cachedAiCrawlers = [];
+let cacheTimestamp = 0;
+export async function getAiCrawlers(c) {
+    const now = Date.now();
+    if (cachedAiCrawlers.length > 0 && now - cacheTimestamp < CACHE_TTL_MS) {
+        return cachedAiCrawlers;
+    }
+    const response = await c.env.FOLDSET_CONFIG.get("ai-crawlers");
+    const parsed = response ? JSON.parse(response) : [];
+    cachedAiCrawlers = parsed.map((c) => ({ user_agent: c.user_agent.toLowerCase() }));
+    cacheTimestamp = now;
+    return cachedAiCrawlers;
+}
+export async function storeAiCrawlers(c, aiCrawlers) {
+    await c.env.FOLDSET_CONFIG.put("ai-crawlers", JSON.stringify(aiCrawlers), {
+        expirationTtl: 60 * 60 * 3 + 60 * 30, // 3 hours + 30 minutes
+    });
+}
+export async function isAiCrawler(c) {
+    const aiCrawlers = await getAiCrawlers(c);
+    const userAgent = c.req.header("User-Agent")?.toLowerCase();
+    if (!userAgent)
+        return false;
+    return aiCrawlers.some((crawler) => userAgent.includes(crawler.user_agent));
+}

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+export declare const API_BASE_URL = "https://api.foldset.com/v1";
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,+BAA+B,CAAC"}

package/dist/config.js

@@ -0,0 +1 @@
+export const API_BASE_URL = "https://api.foldset.com/v1";

package/dist/facilitators/index.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from "hono";
+import type { Env } from "../types";
+import { HTTPFacilitatorClient } from "@x402/core/server";
+export interface FacilitatorConfig {
+    url: string;
+    verifyHeaders?: Record<string, string>;
+    settleHeaders?: Record<string, string>;
+    supportedHeaders?: Record<string, string>;
+}
+export declare function getFacilitator(c: Context<{
+    Bindings: Env;
+}>): Promise<HTTPFacilitatorClient | null>;
+export declare function storeFacilitator(c: Context<{
+    Bindings: Env;
+}>, facilitatorConfig: FacilitatorConfig): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/facilitators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/facilitators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAOD,wBAAsB,cAAc,CAClC,CAAC,EAAE,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,CAAC,GAC5B,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA8BvC;AAED,wBAAsB,gBAAgB,CACpC,CAAC,EAAE,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,CAAC,EAC7B,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/facilitators/index.js

@@ -0,0 +1,35 @@
+import { HTTPFacilitatorClient } from "@x402/core/server";
+const CACHE_TTL_MS = 30_000;
+let cachedFacilitator = null;
+let cacheTimestamp = 0;
+export async function getFacilitator(c) {
+    const now = Date.now();
+    if (cachedFacilitator && now - cacheTimestamp < CACHE_TTL_MS) {
+        return cachedFacilitator;
+    }
+    const response = await c.env.FOLDSET_CONFIG.get("facilitator");
+    const facilitatorConfig = response ? JSON.parse(response) : null;
+    if (!facilitatorConfig) {
+        return null;
+    }
+    const hasAuthHeaders = facilitatorConfig.verifyHeaders ||
+        facilitatorConfig.settleHeaders ||
+        facilitatorConfig.supportedHeaders;
+    cachedFacilitator = new HTTPFacilitatorClient({
+        url: facilitatorConfig.url,
+        ...(hasAuthHeaders && {
+            createAuthHeaders: async () => ({
+                verify: facilitatorConfig.verifyHeaders ?? {},
+                settle: facilitatorConfig.settleHeaders ?? {},
+                supported: facilitatorConfig.supportedHeaders ?? {},
+            }),
+        }),
+    });
+    cacheTimestamp = now;
+    return cachedFacilitator;
+}
+export async function storeFacilitator(c, facilitatorConfig) {
+    await c.env.FOLDSET_CONFIG.put("facilitator", JSON.stringify(facilitatorConfig), {
+        expirationTtl: 60 * 60 * 3 + 60 * 30, // 3 hours + 30 minutes
+    });
+}

package/dist/hono.d.ts

@@ -0,0 +1,2 @@
+export { paymentHandler } from "./payment/handler";
+//# sourceMappingURL=hono.d.ts.map

package/dist/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/hono.js

@@ -0,0 +1 @@
+export { paymentHandler } from "./payment/handler";

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { Hono } from 'hono';
-type Env = {
-    FOLDSET_API_KEY: string;
-};
-declare const app: Hono<{
-    Bindings: Env;
-}, import("hono/types").BlankSchema, "/">;
-export default app;
+export type { Env } from "./types";
+export type { Restriction } from "./restrictions";
+export type { PaymentMethod } from "./payment-methods";
+export type { FoldsetWebhook } from "./webhooks";
+export type { EventPayload } from "./telemetry/logging";
+export type { AiCrawler } from "./ai-crawlers";
+export type { FacilitatorConfig } from "./facilitators";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,163 +1 @@
-// TODO rfradkin: Make a lot of these types not just functions
-import { Hono } from 'hono';
-import { x402ResourceServer, x402HTTPResourceServer } from '@x402/hono';
-import { registerExactEvmScheme } from '@x402/evm/exact/server';
-import { HTTPFacilitatorClient } from '@x402/core/server';
-import { HonoAdapter } from './adapter';
-async function fetchFoldsetAPI(endpoint, env) {
-    const res = await fetch(`https://api.foldset.com/v1/${endpoint}`, {
-        method: 'GET',
-        headers: {
-            Authorization: `Bearer ${env.FOLDSET_API_KEY}`,
-            Accept: 'application/json',
-        },
-    });
-    if (!res.ok) {
-        throw new Error(`Foldset API (${endpoint}) failed: ${res.status}`);
-    }
-    return (await res.json());
-}
-async function getRestrictions(env) {
-    const restrictionList = await fetchFoldsetAPI('restrictions', env);
-    const restrictions = {};
-    for (const restriction of restrictionList) {
-        restrictions[restriction.pathname] = restriction.price;
-    }
-    return restrictions;
-}
-// TODO rfradkin: Should change to get addresses...
-async function getEVMAddress(env) {
-    const data = await fetchFoldsetAPI('get-address', env);
-    return data.address;
-}
-// TODO rfradkin: Add metadata for bazaar finding
-// https://x402.gitbook.io/x402/getting-started/quickstart-for-sellers
-function buildRoutesConfig(restrictions, payTo) {
-    const routesConfig = {};
-    for (const [pathname, price] of Object.entries(restrictions)) {
-        routesConfig[pathname] = {
-            accepts: [
-                {
-                    scheme: 'exact',
-                    price: `$${price}`,
-                    network: 'eip155:84532',
-                    payTo,
-                },
-            ],
-            description: 'Access to premium content',
-            mimeType: 'application/json',
-        };
-    }
-    return routesConfig;
-}
-let server = null;
-// Right now, load times are like 800ms, which is pretty slow since
-// static site is 200ms. Look into later, this call probably takes most of the time.
-// This is like this cause can'd do async calls at module level in cloudflare
-async function getHttpServer(routes, env) {
-    // At some point allow users to dynamically choose facilitator
-    // Setup endpoint for that
-    if (!server) {
-        // TODO rfradkin: Hard coded for now but consider making it configurable
-        const facilitatorClient = new HTTPFacilitatorClient({
-            url: 'https://x402.org/facilitator',
-        });
-        server = new x402ResourceServer(facilitatorClient);
-        registerExactEvmScheme(server);
-    }
-    const httpServer = new x402HTTPResourceServer(server, routes);
-    await httpServer.initialize();
-    return httpServer;
-}
-const app = new Hono();
-// TODO rfradkin: This is still potentially quite slow since it is getting
-// each of these on each request regardless of whether the request is in
-// the restrictions or not. Should find a better solution down the road
-app.use('*', async (c, next) => {
-    const [restrictions, payTo] = await Promise.all([
-        getRestrictions(c.env),
-        getEVMAddress(c.env),
-    ]);
-    const routes = buildRoutesConfig(restrictions, payTo);
-    const httpServer = await getHttpServer(routes, c.env);
-    const adapter = new HonoAdapter(c);
-    const context = {
-        adapter,
-        path: c.req.path,
-        method: c.req.method,
-        paymentHeader: adapter.getHeader("payment-signature") || adapter.getHeader("x-payment"),
-    };
-    if (!httpServer.requiresPayment(context)) {
-        return next();
-    }
-    const result = await httpServer.processHTTPRequest(context);
-    switch (result.type) {
-        case "no-payment-required":
-            return next();
-        case "payment-error":
-            // Payment required but not provided or invalid
-            const { response } = result;
-            Object.entries(response.headers).forEach(([key, value]) => {
-                c.header(key, value);
-            });
-            if (response.isHtml) {
-                return c.html(response.body, response.status);
-            }
-            else {
-                return c.json(response.body || {}, response.status);
-            }
-        case "payment-verified":
-            // Payment is valid, need to wrap response for settlement
-            const { paymentPayload, paymentRequirements } = result;
-            await next();
-            let res = c.res;
-            // If the response from the protected route is >= 400, do not settle payment
-            if (res.status >= 400) {
-                return;
-            }
-            // Clear the response so we can modify headers
-            c.res = undefined;
-            try {
-                const settleResult = await httpServer.processSettlement(paymentPayload, paymentRequirements);
-                if (!settleResult.success) {
-                    // Settlement failed - do not return the protected resource
-                    res = c.json({
-                        error: "Settlement failed",
-                        details: settleResult.errorReason,
-                    }, 402);
-                }
-                else {
-                    // Settlement succeeded - add headers to response
-                    Object.entries(settleResult.headers).forEach(([key, value]) => {
-                        res.headers.set(key, value);
-                    });
-                }
-            }
-            catch (error) {
-                console.error(error);
-                // If settlement fails, return an error response
-                res = c.json({
-                    error: "Settlement failed",
-                    details: error instanceof Error ? error.message : "Unknown error",
-                }, 402);
-            }
-            // Restore the response (potentially modified with settlement headers)
-            c.res = res;
-            return;
-    }
-});
-app.all('*', async (c) => {
-    const req = c.req.raw;
-    const resp = await fetch(req);
-    // This is cause the payment middleware needs to modify the headers to add the payment status
-    // (since it tags the data response after the request with settlement related headers)
-    // (ie success or failure)
-    // and the fetch headers returned by cloudlflare is immutable, so causes an issue
-    // TODO rfradkin: This could be cleaned up and made nicer, but works for now
-    return new Response(resp.body, {
-        status: resp.status,
-        statusText: resp.statusText,
-        headers: new Headers(resp.headers),
-    });
-});
-export default app;
+export {};

package/dist/payment/adapter.d.ts

@@ -0,0 +1,16 @@
+import { HTTPAdapter } from "@x402/core/server";
+import { Context } from "hono";
+export declare class HonoAdapter implements HTTPAdapter {
+    private c;
+    constructor(c: Context);
+    getHeader(name: string): string | undefined;
+    getMethod(): string;
+    getPath(): string;
+    getUrl(): string;
+    getAcceptHeader(): string;
+    getUserAgent(): string;
+    getQueryParams(): Record<string, string | string[]>;
+    getQueryParam(name: string): string | string[] | undefined;
+    getBody(): Promise<unknown>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/payment/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/payment/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,qBAAa,WAAY,YAAW,WAAW;IACjC,OAAO,CAAC,CAAC;gBAAD,CAAC,EAAE,OAAO;IAE9B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,MAAM;IAIjB,MAAM,IAAI,MAAM;IAIhB,eAAe,IAAI,MAAM;IAIzB,YAAY,IAAI,MAAM;IAItB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IASnD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAIpD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAOlC"}

package/dist/payment/adapter.js

@@ -0,0 +1,43 @@
+export class HonoAdapter {
+    c;
+    constructor(c) {
+        this.c = c;
+    }
+    getHeader(name) {
+        return this.c.req.header(name);
+    }
+    getMethod() {
+        return this.c.req.method;
+    }
+    getPath() {
+        return this.c.req.path;
+    }
+    getUrl() {
+        return this.c.req.url;
+    }
+    getAcceptHeader() {
+        return this.c.req.header("Accept") || "";
+    }
+    getUserAgent() {
+        return this.c.req.header("User-Agent") || "";
+    }
+    getQueryParams() {
+        const query = this.c.req.query();
+        const result = {};
+        for (const [key, value] of Object.entries(query)) {
+            result[key] = value;
+        }
+        return result;
+    }
+    getQueryParam(name) {
+        return this.c.req.query(name);
+    }
+    async getBody() {
+        try {
+            return await this.c.req.json();
+        }
+        catch {
+            return undefined;
+        }
+    }
+}

package/dist/payment/handler.d.ts

@@ -0,0 +1,6 @@
+import type { Context } from "hono";
+import type { Env } from "../types";
+export declare function paymentHandler(c: Context<{
+    Bindings: Env;
+}>): Promise<Response>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/payment/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/payment/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AA2GpC,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQ/E"}

package/dist/payment/handler.js

@@ -0,0 +1,86 @@
+import * as Sentry from "@sentry/cloudflare";
+import { handleWebhook } from "../webhooks";
+import { logVisitEvent } from "../telemetry/logging";
+import { wrappedPaymentHandler } from "../telemetry/sentry";
+import { HonoAdapter } from "./adapter";
+import { getHttpServer } from "./setup";
+import { handleSettlement } from "./settlement";
+import { isAiCrawler } from "../ai-crawlers";
+// TODO rfradkin: Open a PR in x402 github to change the handlePaymentError to protected or allow for passing parameteres to specify
+// this behavior
+function createPaymentContext(c) {
+    const adapter = new HonoAdapter(c);
+    return {
+        adapter,
+        path: c.req.path,
+        method: c.req.method,
+        paymentHeader: adapter.getHeader("PAYMENT-SIGNATURE") || adapter.getHeader("X-PAYMENT"),
+    };
+}
+function handlePaymentError(c, response) {
+    Object.entries(response.headers).forEach(([key, value]) => {
+        c.header(key, value);
+    });
+    // We always return a 200 even though the status code is 402
+    // AI crawlers tend to view the raw html only if a 200 is returned
+    // For now, we will return 200 errors while blocking the content even though 
+    // we should be returning response.status as 402 here 
+    // We also provide the headers and html to everyone, regardless of web browser status
+    return c.html(response.body, response.status);
+    // if (response.isHtml) {
+    //   return c.html(response.body as string, response.status as 402));
+    // }
+    // return c.json(response.body || {}, response.status as 402);
+}
+async function paymentHandlerHelper(c) {
+    if (!c.env.FOLDSET_API_KEY) {
+        throw new Error("Missing required environment variable: FOLDSET_API_KEY. See https://docs.foldset.com/setup");
+    }
+    if (!c.env.FOLDSET_CONFIG) {
+        throw new Error("Missing required KV namespace binding: FOLDSET_CONFIG. See https://docs.foldset.com/setup");
+    }
+    Sentry.setTag("url", c.req.url);
+    Sentry.setTag("path", c.req.path);
+    Sentry.setTag("method", c.req.method);
+    if (c.req.method === "POST" && c.req.path === "/foldset/webhooks") {
+        return handleWebhook(c);
+    }
+    if (!(await isAiCrawler(c))) {
+        return await fetch(c.req.raw);
+    }
+    const httpServer = await getHttpServer(c);
+    if (!httpServer) {
+        return await fetch(c.req.raw);
+    }
+    const context = createPaymentContext(c);
+    if (!httpServer.requiresPayment(context)) {
+        return await fetch(c.req.raw);
+    }
+    const result = await httpServer.processHTTPRequest(context);
+    if (result.type === "no-payment-required") {
+        const response = await fetch(c.req.raw);
+        logVisitEvent(c, response);
+        return response;
+    }
+    if (result.type === "payment-error") {
+        const response = handlePaymentError(c, result.response);
+        logVisitEvent(c, response);
+        return response;
+    }
+    const { paymentPayload, paymentRequirements } = result;
+    const upstreamResponse = await fetch(c.req.raw);
+    const response = new Response(upstreamResponse.body, {
+        status: upstreamResponse.status,
+        statusText: upstreamResponse.statusText,
+        headers: new Headers(upstreamResponse.headers),
+    });
+    const settledResponse = await handleSettlement(c, httpServer, paymentPayload, paymentRequirements, response);
+    logVisitEvent(c, settledResponse);
+    return settledResponse;
+}
+export function paymentHandler(c) {
+    return wrappedPaymentHandler({
+        request: c.req.raw,
+        context: c.executionCtx,
+    }, () => paymentHandlerHelper(c));
+}

package/dist/payment/paywall.d.ts

@@ -0,0 +1,4 @@
+import type { PaymentRequired } from "@x402/core/types";
+import type { PaywallConfig } from "@x402/core/server";
+export declare function generateHtml(paymentRequired: PaymentRequired, config?: PaywallConfig): string;
+//# sourceMappingURL=paywall.d.ts.map

package/dist/payment/paywall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paywall.d.ts","sourceRoot":"","sources":["../../src/payment/paywall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,wBAAgB,YAAY,CAAC,eAAe,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAyG7F"}

package/dist/payment/paywall.js

@@ -0,0 +1,99 @@
+export function generateHtml(paymentRequired, config) {
+    const resource = paymentRequired.resource;
+    const description = resource?.description ?? "This resource requires payment";
+    const url = resource?.url ?? config?.currentUrl ?? "";
+    const accepts = paymentRequired.accepts ?? [];
+    // Group payment options by blockchain network (e.g., Base Mainnet, Solana Mainnet)
+    const optionsByNetwork = new Map();
+    for (const accept of accepts) {
+        const existing = optionsByNetwork.get(accept.network) ?? [];
+        existing.push(accept);
+        optionsByNetwork.set(accept.network, existing);
+    }
+    const paymentOptionsHtml = Array.from(optionsByNetwork.entries()).map(([_network, networkOptions]) => {
+        // Chain display name (e.g., "Base Mainnet", "Solana Mainnet")
+        const chainDisplayName = networkOptions[0].extra?.["chainDisplayName"] ?? "Unknown Network";
+        const chainCaip2Id = networkOptions[0].network;
+        // Recipient wallet address (where payments are sent)
+        const recipientAddresses = Array.from(new Set(networkOptions.map((opt) => opt.payTo)));
+        const recipientAddress = recipientAddresses[0] ?? "";
+        // Build list of accepted tokens for this network
+        const acceptedTokensHtml = networkOptions.map((accept) => {
+            // Token display name (e.g., "USD Coin", "USDC")
+            const tokenDisplayName = accept.extra?.["assetDisplayName"] ?? "Unknown Token";
+            // Token contract address (e.g., "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" for USDC on Base)
+            const tokenContractAddress = accept.asset;
+            // Amount in token's smallest unit (e.g., for USDC with 6 decimals: 1000000 = $1.00)
+            const rawTokenAmount = accept.amount;
+            const rawPrice = accept.extra?.["price"] ?? "Unknown Price";
+            return `
+        <tr>
+          <td>${tokenDisplayName}</td>
+          <td>${rawTokenAmount}</td>
+          <td>${rawPrice}</td>
+          <td><code>${tokenContractAddress}</code></td>
+        </tr>`;
+        }).join("");
+        return `
+    <section>
+      <h3>${chainDisplayName} (${chainCaip2Id})</h3>
+
+      <p><strong>Send payment to:</strong> <code>${recipientAddress}</code></p>
+
+      <table border="1" cellpadding="8" cellspacing="0">
+        <thead>
+          <tr>
+            <th>Token</th>
+            <th>Amount (on-chain units)</th>
+            <th>Price (USD)</th>
+            <th>Contract Address</th>
+          </tr>
+        </thead>
+        <tbody>${acceptedTokensHtml}
+        </tbody>
+      </table>
+    </section>`;
+    }).join("\n");
+    return `<!DOCTYPE html>
+<html>
+<head>
+  <title>HTTP 402 - Payment Required</title>
+  <style>
+    body { font-family: system-ui, sans-serif; max-width: 800px; margin: 40px auto; padding: 0 20px; }
+    code { background: #f0f0f0; padding: 2px 6px; border-radius: 3px; font-size: 0.9em; }
+    table { border-collapse: collapse; margin: 10px 0; }
+    th { background: #f5f5f5; text-align: left; }
+    section { margin: 20px 0; padding: 15px; border: 1px solid #ddd; border-radius: 5px; }
+    h3 { margin-top: 0; }
+    .notice { background: #f7f7f7; border: 1px solid #e2e2e2; border-radius: 6px; padding: 10px 12px; margin: 16px 0; color: #555; font-size: 0.92em; }
+    .notice strong { display: block; margin-bottom: 4px; font-weight: 600; }
+    .notice p { margin: 0; }
+    footer { margin-top: 30px; padding-top: 15px; border-top: 1px solid #eee; font-size: 0.9em; color: #666; }
+  </style>
+</head>
+<body>
+  <h1>HTTP 402 - Payment Required</h1>
+
+  <p>This content requires a payment via the <a href="https://github.com/coinbase/x402">x402 protocol</a>.</p>
+
+  <h2>Protected Resource</h2>
+  <ul>
+    <li><strong>URL:</strong> <code>${url}</code></li>
+    <li><strong>Description:</strong> ${description}</li>
+  </ul>
+
+  <h2>Accepted Payment Options</h2>
+  <p>Pay using any of the following blockchain networks and tokens:</p>
+  ${paymentOptionsHtml}
+
+  <div class="notice">
+    <strong>Important for payment libraries</strong>
+    <p>An HTTP 200 response was returned to encourage agents to view this page. Please treat it as you would a 402 error. All required x402 headers are present. Some unmodified x402 libraries require a 402 response to initiate payment; instead of checking only the response code, check for the presence of the x402 headers.</p>
+  </div>
+
+  <footer>
+    <p><strong>Powered by:</strong> <a href="https://www.foldset.com">Foldset</a></p>
+  </footer>
+</body>
+</html>`;
+}

package/dist/payment/routes.d.ts

@@ -0,0 +1,5 @@
+import type { RoutesConfig } from "@x402/core/http";
+import type { Restriction } from "../restrictions";
+import type { PaymentMethod } from "../payment-methods";
+export declare function buildRoutesConfig(restrictions: Restriction[], paymentMethods: PaymentMethod[]): RoutesConfig;
+//# sourceMappingURL=routes.d.ts.map

package/dist/payment/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/payment/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,WAAW,EAAE,EAC3B,cAAc,EAAE,aAAa,EAAE,GAC9B,YAAY,CA4Bd"}

package/dist/payment/routes.js

@@ -0,0 +1,31 @@
+function priceToAmount(priceUsd, decimals) {
+    const amount = priceUsd * Math.pow(10, decimals);
+    return Math.round(amount).toString();
+}
+export function buildRoutesConfig(restrictions, paymentMethods) {
+    const routesConfig = {};
+    for (const restriction of restrictions) {
+        routesConfig[restriction.path] = {
+            accepts: paymentMethods.map((paymentMethod) => ({
+                scheme: restriction.scheme,
+                price: {
+                    amount: priceToAmount(restriction.price, paymentMethod.decimals),
+                    asset: paymentMethod.contract_address,
+                    // eip712 required extra
+                    extra: {
+                        ...paymentMethod.extra,
+                        decimals: paymentMethod.decimals,
+                        chainDisplayName: paymentMethod.chain_display_name,
+                        assetDisplayName: paymentMethod.asset_display_name,
+                        price: restriction.price,
+                    },
+                },
+                network: paymentMethod.caip2_id,
+                payTo: paymentMethod.circle_wallet_address,
+            })),
+            description: restriction.description,
+            mimeType: "application/json",
+        };
+    }
+    return routesConfig;
+}

package/dist/payment/settlement.d.ts

@@ -0,0 +1,8 @@
+import type { PaymentPayload, PaymentRequirements } from "@x402/core/types";
+import type { x402HTTPResourceServer } from "@x402/hono";
+import type { Context } from "hono";
+import type { Env } from "../types";
+export declare function handleSettlement(c: Context<{
+    Bindings: Env;
+}>, httpServer: x402HTTPResourceServer, paymentPayload: PaymentPayload, paymentRequirements: PaymentRequirements, res: Response): Promise<Response>;
+//# sourceMappingURL=settlement.d.ts.map

package/dist/payment/settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.d.ts","sourceRoot":"","sources":["../../src/payment/settlement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,wBAAsB,gBAAgB,CACpC,CAAC,EAAE,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,CAAC,EAC7B,UAAU,EAAE,sBAAsB,EAClC,cAAc,EAAE,cAAc,EAC9B,mBAAmB,EAAE,mBAAmB,EACxC,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,QAAQ,CAAC,CAmCnB"}