Hono (and Workers, Bun, Deno)

Add Forge

Mount the middleware before paymentMiddleware from @x402/hono:

import { createForge } from "@forgeintel/sdk/hono";

const forge = createForge({
  apiKey: process.env.FORGE_API_KEY,
  backendUrl: process.env.FORGE_BACKEND_URL,
  publicUrl: "https://api.example.com",
});

app.use(forge.middleware());
app.use(paymentMiddleware(routes, resourceServer));

Everything from the Express integration applies: the 402 gets the rating ask and the forge-feedback extension, paid JSON responses get the feedback fields, the payment receipt gets the extension, agent context is read and removed before your handlers, and your /openapi.json is served enriched.

Runtimes

Node
Bun / Deno
Cloudflare Workers

Serve with @hono/node-server, as in the example below.

export default app (Bun) or Deno.serve(app.fetch). Nothing Forge-specific.

export default app. Forge uses node:crypto to sign feedback IDs, so enable Node compatibility in wrangler.toml:

compatibility_flags = ["nodejs_compat"]

Workers can freeze between requests, so events are sent every 2 seconds only while the Worker is alive. To flush after each request, pass the promise to ctx.waitUntil:

export default {
  fetch: (request, env, ctx) => {
    ctx.waitUntil(forge.shutdown());
    return app.fetch(request, env, ctx);
  },
};

Without Hono

Any (request) => Response handler works with the fetch adapter:

import { createForge } from "@forgeintel/sdk/fetch";

const forge = createForge({ apiKey, backendUrl, publicUrl });
export default { fetch: forge.wrap(handler) }; // your handler runs your x402 flow

forge.handle(request, next) does the same for a single request, and forge.route(request) answers only Forge’s own routes.

Complete example

A text-statistics API on Base Sepolia. Forge lines are marked (forge). From examples/hono in the Forge SDK repository.

server.ts

// A Hono x402 v2 service (@x402/hono) wrapped by the Forge SDK. Runs on Node via @hono/node-server;
// on Bun or Cloudflare Workers, `export default app` instead of calling serve(). Forge lines are marked (forge).
import { serve } from "@hono/node-server";
import { HTTPFacilitatorClient } from "@x402/core/server";
import { ExactEvmScheme } from "@x402/evm/exact/server";
import { paymentMiddleware, x402ResourceServer } from "@x402/hono";
import { Hono } from "hono";
import { createForge } from "@forgeintel/sdk/hono"; // (forge)

const required = (name: string) => {
  const value = process.env[name];
  if (!value) throw new Error(`Set ${name}`);
  return value;
};

const PAY_TO = required("PAY_TO");
const NETWORK = (process.env.NETWORK ?? "eip155:84532") as `${string}:${string}`; // Base Sepolia; eip155:8453 for mainnet
const FACILITATOR_URL = process.env.FACILITATOR_URL ?? "https://x402.org/facilitator";

// (forge) PUBLIC_URL is this service's public origin; it's used in the rating URLs agents see.
const forge = createForge({
  apiKey: required("FORGE_API_KEY"),
  backendUrl: required("FORGE_BACKEND_URL"),
  publicUrl: required("PUBLIC_URL"),
});

const resourceServer = new x402ResourceServer(new HTTPFacilitatorClient({ url: FACILITATOR_URL })).register(NETWORK, new ExactEvmScheme());

const app = new Hono();
app.use(forge.middleware()); // (forge) before payment middleware

app.use(
  paymentMiddleware(
    {
      "POST /api/text-stats": {
        accepts: { scheme: "exact", price: "$0.001", network: NETWORK, payTo: PAY_TO },
        description: "Count characters, words and sentences in a text and estimate reading time.",
        mimeType: "application/json",
      },
    },
    resourceServer,
  ),
);

app.get("/health", (c) => c.json({ status: "ok" }));

app.post("/api/text-stats", async (c) => {
  const body = await c.req.json().catch(() => ({}));
  const text = typeof body?.text === "string" ? body.text : "";
  if (!text) return c.json({ error: "text is required" }, 400);
  const words = text.split(/\s+/).filter(Boolean).length;
  return c.json({
    characters: text.length,
    words,
    sentences: text.split(/[.!?]+/).filter((s: string) => s.trim()).length,
    reading_time_seconds: Math.ceil((words / 238) * 60),
  });
});

const port = Number(process.env.PORT ?? 4025);
const server = serve({ fetch: app.fetch, port }, () => console.log(`Hono example on http://localhost:${port}`));
process.on("SIGTERM", () => server.close(() => void forge.shutdown())); // (forge) flush pending events

Run it:

export PAY_TO=0xYourAddress PUBLIC_URL=http://localhost:4025
export FORGE_API_KEY=forge_… FORGE_BACKEND_URL=https://your-forge-api/api/sdk/v2
npm start

Get started

Integrations

Guides

Hono (and Workers, Bun, Deno)

Add Forge

Runtimes

Without Hono

Complete example

​Add Forge

​Runtimes

​Without Hono

​Complete example

Add Forge

Runtimes

Without Hono

Complete example