@puga-labs/x402-mantle-sdk 0.3.1 → 0.3.3

package/dist/server.d.ts

@@ -1,116 +1,79 @@
-import { Request, Response, NextFunction } from 'express';
-import { N as NetworkId, P as PaymentRequirements } from './types-2zqbJvcz.js';
-export { A as AssetConfig, a as Authorization, E as EIP1193Provider, d as PaymentHeaderBase64, c as PaymentHeaderObject, b as PaymentHeaderPayload } from './types-2zqbJvcz.js';
-export { M as MANTLE_DEFAULTS } from './constants-CVFF0ray.js';
+import { c as PaymentCheckInput, d as PaymentCheckResult } from './types-CqQ6OgRi.js';
+export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CqQ6OgRi.js';
+import { c as PaymentHeaderObject } from './types-BFUqKBBO.js';
+export { M as MantleMiddleware, c as createPaymentMiddleware, e as express, m as mantlePaywall } from './express-D8EwEcOL.js';
+export { n as nextjs } from './nextjs-TFhFiQuL.js';
+export { w as web } from './web-standards-D8j1kZxd.js';
+import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-DTzov_EE.js';
+import 'express';
+import 'next/server';
 
-/** Unique key for a protected route, e.g. "GET /api/protected". */
-type RouteKey = string;
-/** Pricing config for a single route. */
-interface RoutePricingConfig {
-    /** Price in USD cents, e.g. 1 => $0.01. */
-    priceUsdCents: number;
-    /** Network identifier (e.g. "mantle-mainnet"). */
-    network: NetworkId;
-}
-/** Map of route keys to pricing config. */
-type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
-/** Log entry for a successfully settled payment. */
-interface PaymentLogEntry {
-    id: string;
-    from: string;
-    to: string;
-    valueAtomic: string;
-    network: NetworkId;
-    asset: string;
-    route?: RouteKey;
-    txHash?: string;
-    timestamp: number;
-    facilitatorUrl?: string;
-    paymentRequirements?: PaymentRequirements;
-}
-/** Config for optional telemetry (billing/analytics). */
-interface TelemetryConfig {
-    /** Project key from nosubs.ai dashboard. */
-    projectKey: string;
-    /**
-     * Telemetry endpoint URL.
-     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
-     * If both are undefined, telemetry is not sent.
-     */
-    endpoint?: string;
-}
-/** Telemetry event payload for payment_verified. */
-interface TelemetryEvent {
-    event: "payment_verified";
-    ts: number;
-    projectKey: string;
-    network: string;
-    buyer: string;
-    payTo: string;
-    amountAtomic: string;
-    asset: string;
-    decimals: number;
-    nonce: string;
-    route: string;
-    facilitatorType: "hosted" | "self-hosted";
-    facilitatorUrl?: string;
-    facilitatorAddress?: string;
-    txHash?: string;
-    priceUsd?: string;
-}
-/** Config for createPaymentMiddleware. */
-interface PaymentMiddlewareConfig {
-    /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
-    facilitatorUrl: string;
-    /** Recipient address (developer). */
-    receiverAddress: `0x${string}`;
-    /** Map of protected routes and their pricing. */
-    routes: RoutesConfig;
-    /**
-     * Optional hook called whenever a payment is successfully settled.
-     * You can use this to push logs into your DB / analytics pipeline.
-     */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-    /** Optional: Send usage telemetry for billing/analytics. */
-    telemetry?: TelemetryConfig;
-}
 /**
- * Minimal config for mantlePaywall() - simplified API for single-route protection.
- * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
+ * Validate Ethereum address format.
+ * Throws descriptive error if invalid.
+ *
+ * @param address - Address to validate
+ * @param paramName - Parameter name for error messages (default: "address")
+ * @throws Error if address is invalid
+ *
+ * @example
+ * ```typescript
+ * validateAddress("0x1234567890123456789012345678901234567890", "payTo");
+ * // Valid - no error thrown
+ *
+ * validateAddress("invalid", "payTo");
+ * // Throws: "payTo must start with \"0x\"..."
+ * ```
  */
-interface MinimalPaywallOptions {
-    /** Price in USD (e.g. 0.01 for 1 cent). */
-    priceUsd: number;
-    /** Recipient address (developer wallet). */
-    payTo: `0x${string}`;
-    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
-    facilitatorUrl?: string;
-    /** Optional telemetry config. */
-    telemetry?: TelemetryConfig;
-    /** Optional payment settled hook. */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-}
+declare function validateAddress(address: string, paramName?: string): void;
 /**
- * Express middleware function type for Mantle paywall.
- * Async function that returns Promise<void>.
+ * Decode base64 payment header into JSON object.
+ * Works in both Node.js and browser environments.
  */
-type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
+declare function decodePaymentHeader(paymentHeaderBase64: string): PaymentHeaderObject;
+/**
+ * Build a route key from HTTP method and path.
+ * @param method - HTTP method (GET, POST, etc.)
+ * @param path - URL path (e.g. "/api/protected")
+ * @returns Route key string (e.g. "POST /api/protected")
+ */
+declare function buildRouteKey(method: string, path: string): string;
 
-declare function createPaymentMiddleware(config: PaymentMiddlewareConfig): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Check payment header and verify with facilitator.
+ * This function is framework-agnostic and can be used with any HTTP framework.
+ *
+ * @param input - Payment check configuration
+ * @returns Result indicating whether to allow access or return error response
+ */
+declare function checkPayment(input: PaymentCheckInput): Promise<PaymentCheckResult>;
 
 /**
- * Simplified wrapper for protecting a single route with x402 payments.
- * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
+ * Default telemetry endpoint URL.
  *
- * Usage:
- * ```typescript
- * const pay = mantlePaywall({ priceUsd: 0.01, payTo: "0x..." });
- * export const POST = pay(async (req) => { ... });
- * ```
+ * Set to a valid URL when the official analytics backend is ready.
+ * If undefined, telemetry will only be sent if explicitly configured
+ * via TelemetryConfig.endpoint.
+ */
+declare const DEFAULT_TELEMETRY_ENDPOINT: string | undefined;
+
+/**
+ * Converts PaymentLogEntry to TelemetryEvent.
+ *
+ * This function transforms the internal PaymentLogEntry format
+ * to the telemetry event format expected by the analytics backend.
+ */
+declare function createTelemetryEvent(entry: PaymentLogEntry, config: TelemetryConfig): TelemetryEvent;
+/**
+ * Sends telemetry event to endpoint (fire-and-forget).
+ *
+ * This function sends the telemetry event asynchronously and never throws.
+ * Errors are logged but never propagate to the caller, ensuring that
+ * telemetry failures never break the payment flow.
  *
- * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
- * @returns Express middleware function for single-route protection.
+ * @param event - The telemetry event to send
+ * @param endpoint - The telemetry endpoint URL (optional, falls back to DEFAULT_TELEMETRY_ENDPOINT)
  */
-declare function mantlePaywall(opts: MinimalPaywallOptions): MantleMiddleware;
+declare function sendTelemetry(event: TelemetryEvent, endpoint?: string): Promise<void>;
 
-export { type MantleMiddleware, type MinimalPaywallOptions, NetworkId, type PaymentLogEntry, type PaymentMiddlewareConfig, PaymentRequirements, type RouteKey, type RoutePricingConfig, type RoutesConfig, type TelemetryConfig, type TelemetryEvent, createPaymentMiddleware, mantlePaywall };
+export { DEFAULT_TELEMETRY_ENDPOINT, PaymentCheckInput, PaymentCheckResult, buildRouteKey, checkPayment, createTelemetryEvent, decodePaymentHeader, sendTelemetry, validateAddress };

package/dist/server.js

@@ -1,12 +1,36 @@
+import "./chunk-WO2MYZXT.js";
 import {
   createPaymentMiddleware,
+  express_exports,
   mantlePaywall
-} from "./chunk-Q6SPMEIW.js";
+} from "./chunk-QWQUSRLY.js";
 import {
-  MANTLE_DEFAULTS
-} from "./chunk-XAQGMFSR.js";
+  nextjs_exports
+} from "./chunk-CXRILT3C.js";
+import {
+  web_standards_exports
+} from "./chunk-ZROK2XOB.js";
+import {
+  DEFAULT_TELEMETRY_ENDPOINT,
+  buildRouteKey,
+  checkPayment,
+  createTelemetryEvent,
+  decodePaymentHeader,
+  sendTelemetry,
+  validateAddress
+} from "./chunk-ZLCKBFVJ.js";
+import "./chunk-HEZZ74SI.js";
 export {
-  MANTLE_DEFAULTS,
+  DEFAULT_TELEMETRY_ENDPOINT,
+  buildRouteKey,
+  checkPayment,
   createPaymentMiddleware,
-  mantlePaywall
+  createTelemetryEvent,
+  decodePaymentHeader,
+  express_exports as express,
+  mantlePaywall,
+  nextjs_exports as nextjs,
+  sendTelemetry,
+  validateAddress,
+  web_standards_exports as web
 };

package/dist/{types-2zqbJvcz.d.cts → types-BFUqKBBO.d.cts}

@@ -12,7 +12,7 @@ interface PaymentRequirements {
     network: NetworkId;
     asset: string;
     maxAmountRequired: string;
-    payTo: `0x${string}`;
+    payTo: string;
     price?: string;
     currency?: string;
 }

package/dist/{types-2zqbJvcz.d.ts → types-BFUqKBBO.d.ts}

@@ -12,7 +12,7 @@ interface PaymentRequirements {
     network: NetworkId;
     asset: string;
     maxAmountRequired: string;
-    payTo: `0x${string}`;
+    payTo: string;
     price?: string;
     currency?: string;
 }

package/dist/types-CoOdbZSp.d.cts

@@ -0,0 +1,97 @@
+import { Request, Response, NextFunction } from 'express';
+import { N as NetworkId, P as PaymentRequirements } from './types-BFUqKBBO.cjs';
+
+/** Unique key for a protected route, e.g. "GET /api/protected". */
+type RouteKey = string;
+/** Pricing config for a single route. */
+interface RoutePricingConfig {
+    /** Price in USD cents, e.g. 1 => $0.01. */
+    priceUsdCents: number;
+    /** Network identifier (e.g. "mantle-mainnet"). */
+    network: NetworkId;
+}
+/** Map of route keys to pricing config. */
+type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
+/** Log entry for a successfully settled payment. */
+interface PaymentLogEntry {
+    id: string;
+    from: string;
+    to: string;
+    valueAtomic: string;
+    network: NetworkId;
+    asset: string;
+    route?: RouteKey;
+    txHash?: string;
+    timestamp: number;
+    facilitatorUrl?: string;
+    paymentRequirements?: PaymentRequirements;
+}
+/** Config for optional telemetry (billing/analytics). */
+interface TelemetryConfig {
+    /** Project key from nosubs.ai dashboard. */
+    projectKey: string;
+    /**
+     * Telemetry endpoint URL.
+     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
+     * If both are undefined, telemetry is not sent.
+     */
+    endpoint?: string;
+}
+/** Telemetry event payload for payment_verified. */
+interface TelemetryEvent {
+    event: "payment_verified";
+    ts: number;
+    projectKey: string;
+    network: string;
+    buyer: string;
+    payTo: string;
+    amountAtomic: string;
+    asset: string;
+    decimals: number;
+    nonce: string;
+    route: string;
+    facilitatorType: "hosted" | "self-hosted";
+    facilitatorUrl?: string;
+    facilitatorAddress?: string;
+    txHash?: string;
+    priceUsd?: string;
+}
+/** Config for createPaymentMiddleware. */
+interface PaymentMiddlewareConfig {
+    /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
+    facilitatorUrl: string;
+    /** Recipient address (developer). Validated at runtime. */
+    receiverAddress: string;
+    /** Map of protected routes and their pricing. */
+    routes: RoutesConfig;
+    /**
+     * Optional hook called whenever a payment is successfully settled.
+     * You can use this to push logs into your DB / analytics pipeline.
+     */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+    /** Optional: Send usage telemetry for billing/analytics. */
+    telemetry?: TelemetryConfig;
+}
+/**
+ * Minimal config for mantlePaywall() - simplified API for single-route protection.
+ * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
+ */
+interface MinimalPaywallOptions {
+    /** Price in USD (e.g. 0.01 for 1 cent). */
+    priceUsd: number;
+    /** Recipient address (developer wallet). Validated at runtime. */
+    payTo: string;
+    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
+    facilitatorUrl?: string;
+    /** Optional telemetry config. */
+    telemetry?: TelemetryConfig;
+    /** Optional payment settled hook. */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+}
+/**
+ * Express middleware function type for Mantle paywall.
+ * Async function that returns Promise<void>.
+ */
+type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+export type { MantleMiddleware as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, TelemetryEvent as c, PaymentMiddlewareConfig as d, MinimalPaywallOptions as e };

package/dist/types-CqQ6OgRi.d.ts

@@ -0,0 +1,85 @@
+import { N as NetworkId, P as PaymentRequirements } from './types-BFUqKBBO.js';
+
+/** Unique key for a protected route, e.g. "GET /api/protected". */
+type RouteKey = string;
+/** Pricing config for a single route. */
+interface RoutePricingConfig {
+    /** Price in USD cents, e.g. 1 => $0.01. */
+    priceUsdCents: number;
+    /** Network identifier (e.g. "mantle-mainnet"). */
+    network: NetworkId;
+}
+/** Map of route keys to pricing config. */
+type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
+/** Log entry for a successfully settled payment. */
+interface PaymentLogEntry {
+    id: string;
+    from: string;
+    to: string;
+    valueAtomic: string;
+    network: NetworkId;
+    asset: string;
+    route?: RouteKey;
+    txHash?: string;
+    timestamp: number;
+    facilitatorUrl?: string;
+    paymentRequirements?: PaymentRequirements;
+}
+/** Config for optional telemetry (billing/analytics). */
+interface TelemetryConfig {
+    /** Project key from nosubs.ai dashboard. */
+    projectKey: string;
+    /**
+     * Telemetry endpoint URL.
+     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
+     */
+    endpoint?: string;
+}
+/**
+ * Minimal config for mantlePaywall() - simplified API for single-route protection.
+ * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
+ */
+interface MinimalPaywallOptions {
+    /** Price in USD (e.g. 0.01 for 1 cent). */
+    priceUsd: number;
+    /** Recipient address (developer wallet). Validated at runtime. */
+    payTo: string;
+    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
+    facilitatorUrl?: string;
+    /** Optional telemetry config. */
+    telemetry?: TelemetryConfig;
+    /** Optional payment settled hook. */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+}
+/** Input for checkPayment function. */
+interface PaymentCheckInput {
+    /** X-PAYMENT header value (base64 encoded), or null if not present. */
+    paymentHeader: string | null;
+    /** Payment requirements for this route. */
+    paymentRequirements: PaymentRequirements;
+    /** Facilitator URL for verification. */
+    facilitatorUrl: string;
+    /** Route key for logging, e.g. "POST /api/generate-image". */
+    routeKey?: RouteKey;
+    /** Network ID for this payment. */
+    network: NetworkId;
+    /** Asset address (ERC-20 token). */
+    asset: string;
+    /** Telemetry config (optional). */
+    telemetry?: TelemetryConfig;
+    /** Payment settled callback (optional). */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+}
+/** Result from checkPayment function. */
+interface PaymentCheckResult {
+    /** Status of the payment check. */
+    status: "require_payment" | "verification_error" | "invalid_payment" | "verified";
+    /** HTTP status code to return. */
+    statusCode: 402 | 500 | 200;
+    /** Response body to return (null if verified). */
+    responseBody: any | null;
+    /** Whether payment is valid (only true if status is "verified"). */
+    isValid: boolean;
+}
+
+export type { MinimalPaywallOptions as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, PaymentCheckInput as c, PaymentCheckResult as d };

package/dist/types-CrOsOHcX.d.cts

@@ -0,0 +1,85 @@
+import { N as NetworkId, P as PaymentRequirements } from './types-BFUqKBBO.cjs';
+
+/** Unique key for a protected route, e.g. "GET /api/protected". */
+type RouteKey = string;
+/** Pricing config for a single route. */
+interface RoutePricingConfig {
+    /** Price in USD cents, e.g. 1 => $0.01. */
+    priceUsdCents: number;
+    /** Network identifier (e.g. "mantle-mainnet"). */
+    network: NetworkId;
+}
+/** Map of route keys to pricing config. */
+type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
+/** Log entry for a successfully settled payment. */
+interface PaymentLogEntry {
+    id: string;
+    from: string;
+    to: string;
+    valueAtomic: string;
+    network: NetworkId;
+    asset: string;
+    route?: RouteKey;
+    txHash?: string;
+    timestamp: number;
+    facilitatorUrl?: string;
+    paymentRequirements?: PaymentRequirements;
+}
+/** Config for optional telemetry (billing/analytics). */
+interface TelemetryConfig {
+    /** Project key from nosubs.ai dashboard. */
+    projectKey: string;
+    /**
+     * Telemetry endpoint URL.
+     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
+     */
+    endpoint?: string;
+}
+/**
+ * Minimal config for mantlePaywall() - simplified API for single-route protection.
+ * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
+ */
+interface MinimalPaywallOptions {
+    /** Price in USD (e.g. 0.01 for 1 cent). */
+    priceUsd: number;
+    /** Recipient address (developer wallet). Validated at runtime. */
+    payTo: string;
+    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
+    facilitatorUrl?: string;
+    /** Optional telemetry config. */
+    telemetry?: TelemetryConfig;
+    /** Optional payment settled hook. */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+}
+/** Input for checkPayment function. */
+interface PaymentCheckInput {
+    /** X-PAYMENT header value (base64 encoded), or null if not present. */
+    paymentHeader: string | null;
+    /** Payment requirements for this route. */
+    paymentRequirements: PaymentRequirements;
+    /** Facilitator URL for verification. */
+    facilitatorUrl: string;
+    /** Route key for logging, e.g. "POST /api/generate-image". */
+    routeKey?: RouteKey;
+    /** Network ID for this payment. */
+    network: NetworkId;
+    /** Asset address (ERC-20 token). */
+    asset: string;
+    /** Telemetry config (optional). */
+    telemetry?: TelemetryConfig;
+    /** Payment settled callback (optional). */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+}
+/** Result from checkPayment function. */
+interface PaymentCheckResult {
+    /** Status of the payment check. */
+    status: "require_payment" | "verification_error" | "invalid_payment" | "verified";
+    /** HTTP status code to return. */
+    statusCode: 402 | 500 | 200;
+    /** Response body to return (null if verified). */
+    responseBody: any | null;
+    /** Whether payment is valid (only true if status is "verified"). */
+    isValid: boolean;
+}
+
+export type { MinimalPaywallOptions as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, PaymentCheckInput as c, PaymentCheckResult as d };

package/dist/types-DTzov_EE.d.ts

@@ -0,0 +1,97 @@
+import { Request, Response, NextFunction } from 'express';
+import { N as NetworkId, P as PaymentRequirements } from './types-BFUqKBBO.js';
+
+/** Unique key for a protected route, e.g. "GET /api/protected". */
+type RouteKey = string;
+/** Pricing config for a single route. */
+interface RoutePricingConfig {
+    /** Price in USD cents, e.g. 1 => $0.01. */
+    priceUsdCents: number;
+    /** Network identifier (e.g. "mantle-mainnet"). */
+    network: NetworkId;
+}
+/** Map of route keys to pricing config. */
+type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
+/** Log entry for a successfully settled payment. */
+interface PaymentLogEntry {
+    id: string;
+    from: string;
+    to: string;
+    valueAtomic: string;
+    network: NetworkId;
+    asset: string;
+    route?: RouteKey;
+    txHash?: string;
+    timestamp: number;
+    facilitatorUrl?: string;
+    paymentRequirements?: PaymentRequirements;
+}
+/** Config for optional telemetry (billing/analytics). */
+interface TelemetryConfig {
+    /** Project key from nosubs.ai dashboard. */
+    projectKey: string;
+    /**
+     * Telemetry endpoint URL.
+     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
+     * If both are undefined, telemetry is not sent.
+     */
+    endpoint?: string;
+}
+/** Telemetry event payload for payment_verified. */
+interface TelemetryEvent {
+    event: "payment_verified";
+    ts: number;
+    projectKey: string;
+    network: string;
+    buyer: string;
+    payTo: string;
+    amountAtomic: string;
+    asset: string;
+    decimals: number;
+    nonce: string;
+    route: string;
+    facilitatorType: "hosted" | "self-hosted";
+    facilitatorUrl?: string;
+    facilitatorAddress?: string;
+    txHash?: string;
+    priceUsd?: string;
+}
+/** Config for createPaymentMiddleware. */
+interface PaymentMiddlewareConfig {
+    /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
+    facilitatorUrl: string;
+    /** Recipient address (developer). Validated at runtime. */
+    receiverAddress: string;
+    /** Map of protected routes and their pricing. */
+    routes: RoutesConfig;
+    /**
+     * Optional hook called whenever a payment is successfully settled.
+     * You can use this to push logs into your DB / analytics pipeline.
+     */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+    /** Optional: Send usage telemetry for billing/analytics. */
+    telemetry?: TelemetryConfig;
+}
+/**
+ * Minimal config for mantlePaywall() - simplified API for single-route protection.
+ * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
+ */
+interface MinimalPaywallOptions {
+    /** Price in USD (e.g. 0.01 for 1 cent). */
+    priceUsd: number;
+    /** Recipient address (developer wallet). Validated at runtime. */
+    payTo: string;
+    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
+    facilitatorUrl?: string;
+    /** Optional telemetry config. */
+    telemetry?: TelemetryConfig;
+    /** Optional payment settled hook. */
+    onPaymentSettled?: (entry: PaymentLogEntry) => void;
+}
+/**
+ * Express middleware function type for Mantle paywall.
+ * Async function that returns Promise<void>.
+ */
+type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+export type { MantleMiddleware as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, TelemetryEvent as c, PaymentMiddlewareConfig as d, MinimalPaywallOptions as e };