Runtime API - Forge

Node

createForge(options) returns the adapter for the import you chose:

Adapter	Request integration
`@forgeintel/sdk` or `/express`	`app.use(forge.middleware())` before x402 middleware.
`@forgeintel/sdk/hono`	`app.use(forge.middleware())` before x402 middleware.
`@forgeintel/sdk/next`	`forge.withForge(handler)` outermost.
`@forgeintel/sdk/fetch`	`forge.wrap(handler)` or `forge.handle(request, next)`.
`@forgeintel/sdk/core`	Call `route()` and `call()` when building a custom adapter.

All adapters expose diagnostics() with enabled, configErrors, event counters, and OpenAPI status. enrichOpenApi(document) is available for build-time enrichment. Call await forge.shutdown() after your server drains to flush queued events.

Python

Forge(...) holds configuration and diagnostics. Install ForgeMiddleware outside the payment handler, or use forge.wrap(app) for plain ASGI. Inspect forge.diagnostics() for enabled, config_errors, and event counters. forge.enrich_openapi(document) supports build-time enrichment. ASGI lifespan shutdown closes the SDK automatically; call await forge.shutdown() if your host disables lifespan. Forge observes x402 behavior but does not verify signatures or settle payments. Keep your existing payment stack and facilitator.

​Node

​Python

Node

Python