@puga-labs/x402-mantle-sdk 0.3.7 → 0.3.9

package/dist/index.cjs

@@ -189,6 +189,7 @@ async function checkPayment(input) {
     paymentHeader,
     paymentRequirements,
     facilitatorUrl,
+    apiKey,
     routeKey,
     network,
     asset,
@@ -212,7 +213,8 @@ async function checkPayment(input) {
     const verifyRes = await fetch(verifyUrl, {
       method: "POST",
       headers: {
-        "Content-Type": "application/json"
+        "Content-Type": "application/json",
+        ...apiKey && { "Authorization": `Bearer ${apiKey}` }
       },
       body: JSON.stringify({
         x402Version: 1,
@@ -251,12 +253,13 @@ async function checkPayment(input) {
         isValid: false
       };
     }
-    if (onPaymentSettled) {
+    let baseLogEntry = null;
+    if (onPaymentSettled || telemetry) {
       try {
         const headerObj = decodePaymentHeader(paymentHeader);
         const { authorization } = headerObj.payload;
         const assetConfig = getDefaultAssetForNetwork(network);
-        const logEntry = {
+        baseLogEntry = {
           id: authorization.nonce,
           from: authorization.from,
           to: authorization.to,
@@ -268,12 +271,8 @@ async function checkPayment(input) {
           facilitatorUrl,
           paymentRequirements
         };
-        onPaymentSettled(logEntry);
-        if (telemetry) {
-          const event = createTelemetryEvent(logEntry, telemetry);
-          sendTelemetry(event, telemetry.endpoint).catch(
-            (err) => console.error("[x402-telemetry] Async send failed:", err)
-          );
+        if (onPaymentSettled) {
+          onPaymentSettled(baseLogEntry);
         }
       } catch (err) {
         console.error(
@@ -282,11 +281,25 @@ async function checkPayment(input) {
         );
       }
     }
+    const sendTelemetryAfterResponse = telemetry && baseLogEntry ? (responseStatus, error) => {
+      try {
+        const event = createTelemetryEvent(baseLogEntry, telemetry);
+        event.responseStatus = responseStatus;
+        event.errorMessage = error;
+        event.serviceDelivered = responseStatus >= 200 && responseStatus < 300;
+        sendTelemetry(event, telemetry.endpoint).catch(
+          (err) => console.error("[x402-telemetry] Async send failed:", err)
+        );
+      } catch (err) {
+        console.error("[x402-telemetry] Error creating telemetry event:", err);
+      }
+    } : void 0;
     return {
       status: "verified",
       statusCode: 200,
       responseBody: null,
-      isValid: true
+      isValid: true,
+      sendTelemetryAfterResponse
     };
   } catch (err) {
     console.error(
@@ -308,7 +321,7 @@ async function checkPayment(input) {
 
 // src/server/adapters/express.ts
 function createPaymentMiddleware(config) {
-  const { facilitatorUrl, receiverAddress, routes, onPaymentSettled, telemetry } = config;
+  const { facilitatorUrl, receiverAddress, routes, apiKey, onPaymentSettled, telemetry } = config;
   if (!facilitatorUrl) {
     throw new Error("facilitatorUrl is required");
   }
@@ -346,6 +359,7 @@ function createPaymentMiddleware(config) {
       paymentHeader,
       paymentRequirements,
       facilitatorUrl,
+      apiKey,
       routeKey,
       network,
       asset: assetConfig.address,
@@ -356,11 +370,23 @@ function createPaymentMiddleware(config) {
       res.status(result.statusCode).json(result.responseBody);
       return;
     }
+    if (result.sendTelemetryAfterResponse) {
+      res.on("finish", () => {
+        const statusCode = res.statusCode;
+        const errorMessage = statusCode >= 400 ? `Handler returned ${statusCode}` : void 0;
+        result.sendTelemetryAfterResponse(statusCode, errorMessage);
+      });
+      res.on("close", () => {
+        if (!res.writableEnded) {
+          result.sendTelemetryAfterResponse(500, "Response closed without finishing");
+        }
+      });
+    }
     next();
   };
 }
 function mantlePaywall(opts) {
-  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
   const priceUsdCents = Math.round(priceUsd * 100);
   return async (req, res, next) => {
@@ -376,6 +402,7 @@ function mantlePaywall(opts) {
           network: MANTLE_DEFAULTS.NETWORK
         }
       },
+      apiKey,
       telemetry,
       onPaymentSettled
     });

package/dist/index.d.cts

@@ -1,10 +1,10 @@
 export { A as AssetConfig, a as Authorization, E as EIP1193Provider, N as NetworkId, d as PaymentHeaderBase64, c as PaymentHeaderObject, b as PaymentHeaderPayload, P as PaymentRequirements } from './types-BFUqKBBO.cjs';
 export { M as MANTLE_DEFAULTS } from './constants-CsIL25uQ.cjs';
-export { M as MantleMiddleware, e as MinimalPaywallOptions, P as PaymentLogEntry, d as PaymentMiddlewareConfig, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig, c as TelemetryEvent } from './types-CoOdbZSp.cjs';
-export { c as createPaymentMiddleware, m as mantlePaywall } from './express-eQOPxfnI.cjs';
+export { M as MantleMiddleware, e as MinimalPaywallOptions, P as PaymentLogEntry, d as PaymentMiddlewareConfig, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig, c as TelemetryEvent } from './types-X6DeBEgb.cjs';
+export { c as createPaymentMiddleware, m as mantlePaywall } from './express-DqyVgO5n.cjs';
 export { C as CallWithPaymentResult, M as MantleClient, a as MantleClientConfig, b as PaymentClient, P as PaymentClientConfig, c as createMantleClient } from './createMantleClient-CO0uWPb-.cjs';
 export { createPaymentClient } from './client.cjs';
 export { UseEthersWalletOptions, UseEthersWalletReturn, UseMantleX402Options, useEthersWallet, useMantleX402 } from './react.cjs';
 import 'express';
-import './types-CrOsOHcX.cjs';
+import './types-B87bD2yo.cjs';
 import 'ethers';

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export { A as AssetConfig, a as Authorization, E as EIP1193Provider, N as NetworkId, d as PaymentHeaderBase64, c as PaymentHeaderObject, b as PaymentHeaderPayload, P as PaymentRequirements } from './types-BFUqKBBO.js';
 export { M as MANTLE_DEFAULTS } from './constants-0ncqvV_O.js';
-export { M as MantleMiddleware, e as MinimalPaywallOptions, P as PaymentLogEntry, d as PaymentMiddlewareConfig, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig, c as TelemetryEvent } from './types-DTzov_EE.js';
-export { c as createPaymentMiddleware, m as mantlePaywall } from './express-D8EwEcOL.js';
+export { M as MantleMiddleware, e as MinimalPaywallOptions, P as PaymentLogEntry, d as PaymentMiddlewareConfig, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig, c as TelemetryEvent } from './types-DvKDSdL6.js';
+export { c as createPaymentMiddleware, m as mantlePaywall } from './express-DxxlKmmF.js';
 export { C as CallWithPaymentResult, M as MantleClient, a as MantleClientConfig, b as PaymentClient, P as PaymentClientConfig, c as createMantleClient } from './createMantleClient-CuiPsTa6.js';
 export { createPaymentClient } from './client.js';
 export { UseEthersWalletOptions, UseEthersWalletReturn, UseMantleX402Options, useEthersWallet, useMantleX402 } from './react.js';
 import 'express';
-import './types-CqQ6OgRi.js';
+import './types-vicT7qsY.js';
 import 'ethers';

package/dist/index.js

@@ -10,8 +10,8 @@ import "./chunk-WO2MYZXT.js";
 import {
   createPaymentMiddleware,
   mantlePaywall
-} from "./chunk-MBJTUNDL.js";
-import "./chunk-EKEVUVF3.js";
+} from "./chunk-IEJB5W26.js";
+import "./chunk-IXIFGPJ2.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

package/dist/nextjs-CSUWjcxv.d.cts

@@ -0,0 +1,89 @@
+import { NextRequest } from 'next/server';
+import { M as MinimalPaywallOptions } from './types-BmK0G74m.cjs';
+import { P as PaymentRequirements } from './types-BFUqKBBO.cjs';
+
+/**
+ * Error response returned when payment verification fails.
+ * This can be due to missing payment, invalid payment, or verification errors.
+ */
+interface PaywallErrorResponse {
+    error: string;
+    paymentRequirements?: PaymentRequirements;
+    paymentHeader?: null;
+    invalidReason?: string | null;
+    details?: string;
+}
+/**
+ * Simple promise-or-value helper.
+ */
+type Awaitable<T> = T | Promise<T>;
+/**
+ * Next.js App Router route handler type.
+ *
+ * Accepts anything that is a valid `Response` to avoid forcing users
+ * to annotate union bodies on every handler.
+ */
+type NextJSHandler = (req: NextRequest) => Awaitable<Response>;
+/**
+ * Wrapper function that adds x402 payment verification to Next.js route handler.
+ * Returns a handler that may return either the original handler's response
+ * or a PaywallErrorResponse if payment verification fails.
+ */
+type NextJSPaywallWrapper = (handler: NextJSHandler) => NextJSHandler;
+/**
+ * Create Next.js App Router middleware for x402 payment verification.
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
+ *
+ * @example
+ * ```typescript
+ * // app/api/generate-image/route.ts
+ * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/nextjs'
+ *
+ * const pay = mantlePaywall({
+ *   priceUsd: 0.01,
+ *   payTo: process.env.PAY_TO!,
+ * });
+ *
+ * // No 'as any' needed! TypeScript correctly infers the union type
+ * export const POST = pay(async (req: NextRequest) => {
+ *   const { prompt } = await req.json();
+ *   // Your handler code here
+ *   return NextResponse.json({ success: true, imageUrl: "..." });
+ * });
+ * // TypeScript knows POST returns: NextResponse<{ success: boolean; imageUrl: string } | PaywallErrorResponse>
+ * ```
+ *
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
+ * @returns Function that wraps Next.js route handlers with payment verification.
+ */
+declare function mantlePaywall(opts: MinimalPaywallOptions): NextJSPaywallWrapper;
+/**
+ * Type guard to check if a response is a paywall error response.
+ * Useful for handling the union type returned by the paywall wrapper.
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('/api/protected');
+ * const data = await response.json();
+ *
+ * if (isPaywallErrorResponse(data)) {
+ *   // Handle error: data.error, data.paymentRequirements, etc.
+ *   console.error('Payment required:', data.paymentRequirements);
+ * } else {
+ *   // Handle success: data has type T
+ *   console.log('Success:', data);
+ * }
+ * ```
+ */
+declare function isPaywallErrorResponse(response: unknown): response is PaywallErrorResponse;
+
+type nextjs_NextJSHandler = NextJSHandler;
+type nextjs_NextJSPaywallWrapper = NextJSPaywallWrapper;
+type nextjs_PaywallErrorResponse = PaywallErrorResponse;
+declare const nextjs_isPaywallErrorResponse: typeof isPaywallErrorResponse;
+declare const nextjs_mantlePaywall: typeof mantlePaywall;
+declare namespace nextjs {
+  export { type nextjs_NextJSHandler as NextJSHandler, type nextjs_NextJSPaywallWrapper as NextJSPaywallWrapper, type nextjs_PaywallErrorResponse as PaywallErrorResponse, nextjs_isPaywallErrorResponse as isPaywallErrorResponse, nextjs_mantlePaywall as mantlePaywall };
+}
+
+export { type NextJSHandler as N, type PaywallErrorResponse as P, type NextJSPaywallWrapper as a, isPaywallErrorResponse as i, mantlePaywall as m, nextjs as n };

package/dist/nextjs-DGcN_MGa.d.ts

@@ -0,0 +1,89 @@
+import { NextRequest } from 'next/server';
+import { M as MinimalPaywallOptions } from './types-vicT7qsY.js';
+import { P as PaymentRequirements } from './types-BFUqKBBO.js';
+
+/**
+ * Error response returned when payment verification fails.
+ * This can be due to missing payment, invalid payment, or verification errors.
+ */
+interface PaywallErrorResponse {
+    error: string;
+    paymentRequirements?: PaymentRequirements;
+    paymentHeader?: null;
+    invalidReason?: string | null;
+    details?: string;
+}
+/**
+ * Simple promise-or-value helper.
+ */
+type Awaitable<T> = T | Promise<T>;
+/**
+ * Next.js App Router route handler type.
+ *
+ * Accepts anything that is a valid `Response` to avoid forcing users
+ * to annotate union bodies on every handler.
+ */
+type NextJSHandler = (req: NextRequest) => Awaitable<Response>;
+/**
+ * Wrapper function that adds x402 payment verification to Next.js route handler.
+ * Returns a handler that may return either the original handler's response
+ * or a PaywallErrorResponse if payment verification fails.
+ */
+type NextJSPaywallWrapper = (handler: NextJSHandler) => NextJSHandler;
+/**
+ * Create Next.js App Router middleware for x402 payment verification.
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
+ *
+ * @example
+ * ```typescript
+ * // app/api/generate-image/route.ts
+ * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/nextjs'
+ *
+ * const pay = mantlePaywall({
+ *   priceUsd: 0.01,
+ *   payTo: process.env.PAY_TO!,
+ * });
+ *
+ * // No 'as any' needed! TypeScript correctly infers the union type
+ * export const POST = pay(async (req: NextRequest) => {
+ *   const { prompt } = await req.json();
+ *   // Your handler code here
+ *   return NextResponse.json({ success: true, imageUrl: "..." });
+ * });
+ * // TypeScript knows POST returns: NextResponse<{ success: boolean; imageUrl: string } | PaywallErrorResponse>
+ * ```
+ *
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
+ * @returns Function that wraps Next.js route handlers with payment verification.
+ */
+declare function mantlePaywall(opts: MinimalPaywallOptions): NextJSPaywallWrapper;
+/**
+ * Type guard to check if a response is a paywall error response.
+ * Useful for handling the union type returned by the paywall wrapper.
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('/api/protected');
+ * const data = await response.json();
+ *
+ * if (isPaywallErrorResponse(data)) {
+ *   // Handle error: data.error, data.paymentRequirements, etc.
+ *   console.error('Payment required:', data.paymentRequirements);
+ * } else {
+ *   // Handle success: data has type T
+ *   console.log('Success:', data);
+ * }
+ * ```
+ */
+declare function isPaywallErrorResponse(response: unknown): response is PaywallErrorResponse;
+
+type nextjs_NextJSHandler = NextJSHandler;
+type nextjs_NextJSPaywallWrapper = NextJSPaywallWrapper;
+type nextjs_PaywallErrorResponse = PaywallErrorResponse;
+declare const nextjs_isPaywallErrorResponse: typeof isPaywallErrorResponse;
+declare const nextjs_mantlePaywall: typeof mantlePaywall;
+declare namespace nextjs {
+  export { type nextjs_NextJSHandler as NextJSHandler, type nextjs_NextJSPaywallWrapper as NextJSPaywallWrapper, type nextjs_PaywallErrorResponse as PaywallErrorResponse, nextjs_isPaywallErrorResponse as isPaywallErrorResponse, nextjs_mantlePaywall as mantlePaywall };
+}
+
+export { type NextJSHandler as N, type PaywallErrorResponse as P, type NextJSPaywallWrapper as a, isPaywallErrorResponse as i, mantlePaywall as m, nextjs as n };

package/dist/nextjs-DUdgN0d_.d.ts

@@ -0,0 +1,89 @@
+import { NextRequest } from 'next/server';
+import { M as MinimalPaywallOptions } from './types-CXdNC0Ra.js';
+import { P as PaymentRequirements } from './types-BFUqKBBO.js';
+
+/**
+ * Error response returned when payment verification fails.
+ * This can be due to missing payment, invalid payment, or verification errors.
+ */
+interface PaywallErrorResponse {
+    error: string;
+    paymentRequirements?: PaymentRequirements;
+    paymentHeader?: null;
+    invalidReason?: string | null;
+    details?: string;
+}
+/**
+ * Simple promise-or-value helper.
+ */
+type Awaitable<T> = T | Promise<T>;
+/**
+ * Next.js App Router route handler type.
+ *
+ * Accepts anything that is a valid `Response` to avoid forcing users
+ * to annotate union bodies on every handler.
+ */
+type NextJSHandler = (req: NextRequest) => Awaitable<Response>;
+/**
+ * Wrapper function that adds x402 payment verification to Next.js route handler.
+ * Returns a handler that may return either the original handler's response
+ * or a PaywallErrorResponse if payment verification fails.
+ */
+type NextJSPaywallWrapper = (handler: NextJSHandler) => NextJSHandler;
+/**
+ * Create Next.js App Router middleware for x402 payment verification.
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
+ *
+ * @example
+ * ```typescript
+ * // app/api/generate-image/route.ts
+ * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/nextjs'
+ *
+ * const pay = mantlePaywall({
+ *   priceUsd: 0.01,
+ *   payTo: process.env.PAY_TO!,
+ * });
+ *
+ * // No 'as any' needed! TypeScript correctly infers the union type
+ * export const POST = pay(async (req: NextRequest) => {
+ *   const { prompt } = await req.json();
+ *   // Your handler code here
+ *   return NextResponse.json({ success: true, imageUrl: "..." });
+ * });
+ * // TypeScript knows POST returns: NextResponse<{ success: boolean; imageUrl: string } | PaywallErrorResponse>
+ * ```
+ *
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
+ * @returns Function that wraps Next.js route handlers with payment verification.
+ */
+declare function mantlePaywall(opts: MinimalPaywallOptions): NextJSPaywallWrapper;
+/**
+ * Type guard to check if a response is a paywall error response.
+ * Useful for handling the union type returned by the paywall wrapper.
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('/api/protected');
+ * const data = await response.json();
+ *
+ * if (isPaywallErrorResponse(data)) {
+ *   // Handle error: data.error, data.paymentRequirements, etc.
+ *   console.error('Payment required:', data.paymentRequirements);
+ * } else {
+ *   // Handle success: data has type T
+ *   console.log('Success:', data);
+ * }
+ * ```
+ */
+declare function isPaywallErrorResponse(response: unknown): response is PaywallErrorResponse;
+
+type nextjs_NextJSHandler = NextJSHandler;
+type nextjs_NextJSPaywallWrapper = NextJSPaywallWrapper;
+type nextjs_PaywallErrorResponse = PaywallErrorResponse;
+declare const nextjs_isPaywallErrorResponse: typeof isPaywallErrorResponse;
+declare const nextjs_mantlePaywall: typeof mantlePaywall;
+declare namespace nextjs {
+  export { type nextjs_NextJSHandler as NextJSHandler, type nextjs_NextJSPaywallWrapper as NextJSPaywallWrapper, type nextjs_PaywallErrorResponse as PaywallErrorResponse, nextjs_isPaywallErrorResponse as isPaywallErrorResponse, nextjs_mantlePaywall as mantlePaywall };
+}
+
+export { type NextJSHandler as N, type PaywallErrorResponse as P, type NextJSPaywallWrapper as a, isPaywallErrorResponse as i, mantlePaywall as m, nextjs as n };

package/dist/nextjs-EoISXVEo.d.cts

@@ -0,0 +1,89 @@
+import { NextRequest } from 'next/server';
+import { M as MinimalPaywallOptions } from './types-B87bD2yo.cjs';
+import { P as PaymentRequirements } from './types-BFUqKBBO.cjs';
+
+/**
+ * Error response returned when payment verification fails.
+ * This can be due to missing payment, invalid payment, or verification errors.
+ */
+interface PaywallErrorResponse {
+    error: string;
+    paymentRequirements?: PaymentRequirements;
+    paymentHeader?: null;
+    invalidReason?: string | null;
+    details?: string;
+}
+/**
+ * Simple promise-or-value helper.
+ */
+type Awaitable<T> = T | Promise<T>;
+/**
+ * Next.js App Router route handler type.
+ *
+ * Accepts anything that is a valid `Response` to avoid forcing users
+ * to annotate union bodies on every handler.
+ */
+type NextJSHandler = (req: NextRequest) => Awaitable<Response>;
+/**
+ * Wrapper function that adds x402 payment verification to Next.js route handler.
+ * Returns a handler that may return either the original handler's response
+ * or a PaywallErrorResponse if payment verification fails.
+ */
+type NextJSPaywallWrapper = (handler: NextJSHandler) => NextJSHandler;
+/**
+ * Create Next.js App Router middleware for x402 payment verification.
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
+ *
+ * @example
+ * ```typescript
+ * // app/api/generate-image/route.ts
+ * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/nextjs'
+ *
+ * const pay = mantlePaywall({
+ *   priceUsd: 0.01,
+ *   payTo: process.env.PAY_TO!,
+ * });
+ *
+ * // No 'as any' needed! TypeScript correctly infers the union type
+ * export const POST = pay(async (req: NextRequest) => {
+ *   const { prompt } = await req.json();
+ *   // Your handler code here
+ *   return NextResponse.json({ success: true, imageUrl: "..." });
+ * });
+ * // TypeScript knows POST returns: NextResponse<{ success: boolean; imageUrl: string } | PaywallErrorResponse>
+ * ```
+ *
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
+ * @returns Function that wraps Next.js route handlers with payment verification.
+ */
+declare function mantlePaywall(opts: MinimalPaywallOptions): NextJSPaywallWrapper;
+/**
+ * Type guard to check if a response is a paywall error response.
+ * Useful for handling the union type returned by the paywall wrapper.
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('/api/protected');
+ * const data = await response.json();
+ *
+ * if (isPaywallErrorResponse(data)) {
+ *   // Handle error: data.error, data.paymentRequirements, etc.
+ *   console.error('Payment required:', data.paymentRequirements);
+ * } else {
+ *   // Handle success: data has type T
+ *   console.log('Success:', data);
+ * }
+ * ```
+ */
+declare function isPaywallErrorResponse(response: unknown): response is PaywallErrorResponse;
+
+type nextjs_NextJSHandler = NextJSHandler;
+type nextjs_NextJSPaywallWrapper = NextJSPaywallWrapper;
+type nextjs_PaywallErrorResponse = PaywallErrorResponse;
+declare const nextjs_isPaywallErrorResponse: typeof isPaywallErrorResponse;
+declare const nextjs_mantlePaywall: typeof mantlePaywall;
+declare namespace nextjs {
+  export { type nextjs_NextJSHandler as NextJSHandler, type nextjs_NextJSPaywallWrapper as NextJSPaywallWrapper, type nextjs_PaywallErrorResponse as PaywallErrorResponse, nextjs_isPaywallErrorResponse as isPaywallErrorResponse, nextjs_mantlePaywall as mantlePaywall };
+}
+
+export { type NextJSHandler as N, type PaywallErrorResponse as P, type NextJSPaywallWrapper as a, isPaywallErrorResponse as i, mantlePaywall as m, nextjs as n };

package/dist/server-express.cjs

@@ -167,6 +167,7 @@ async function checkPayment(input) {
     paymentHeader,
     paymentRequirements,
     facilitatorUrl,
+    apiKey,
     routeKey,
     network,
     asset,
@@ -190,7 +191,8 @@ async function checkPayment(input) {
     const verifyRes = await fetch(verifyUrl, {
       method: "POST",
       headers: {
-        "Content-Type": "application/json"
+        "Content-Type": "application/json",
+        ...apiKey && { "Authorization": `Bearer ${apiKey}` }
       },
       body: JSON.stringify({
         x402Version: 1,
@@ -229,12 +231,13 @@ async function checkPayment(input) {
         isValid: false
       };
     }
-    if (onPaymentSettled) {
+    let baseLogEntry = null;
+    if (onPaymentSettled || telemetry) {
       try {
         const headerObj = decodePaymentHeader(paymentHeader);
         const { authorization } = headerObj.payload;
         const assetConfig = getDefaultAssetForNetwork(network);
-        const logEntry = {
+        baseLogEntry = {
           id: authorization.nonce,
           from: authorization.from,
           to: authorization.to,
@@ -246,12 +249,8 @@ async function checkPayment(input) {
           facilitatorUrl,
           paymentRequirements
         };
-        onPaymentSettled(logEntry);
-        if (telemetry) {
-          const event = createTelemetryEvent(logEntry, telemetry);
-          sendTelemetry(event, telemetry.endpoint).catch(
-            (err) => console.error("[x402-telemetry] Async send failed:", err)
-          );
+        if (onPaymentSettled) {
+          onPaymentSettled(baseLogEntry);
         }
       } catch (err) {
         console.error(
@@ -260,11 +259,25 @@ async function checkPayment(input) {
         );
       }
     }
+    const sendTelemetryAfterResponse = telemetry && baseLogEntry ? (responseStatus, error) => {
+      try {
+        const event = createTelemetryEvent(baseLogEntry, telemetry);
+        event.responseStatus = responseStatus;
+        event.errorMessage = error;
+        event.serviceDelivered = responseStatus >= 200 && responseStatus < 300;
+        sendTelemetry(event, telemetry.endpoint).catch(
+          (err) => console.error("[x402-telemetry] Async send failed:", err)
+        );
+      } catch (err) {
+        console.error("[x402-telemetry] Error creating telemetry event:", err);
+      }
+    } : void 0;
     return {
       status: "verified",
       statusCode: 200,
       responseBody: null,
-      isValid: true
+      isValid: true,
+      sendTelemetryAfterResponse
     };
   } catch (err) {
     console.error(
@@ -286,7 +299,7 @@ async function checkPayment(input) {
 
 // src/server/adapters/express.ts
 function createPaymentMiddleware(config) {
-  const { facilitatorUrl, receiverAddress, routes, onPaymentSettled, telemetry } = config;
+  const { facilitatorUrl, receiverAddress, routes, apiKey, onPaymentSettled, telemetry } = config;
   if (!facilitatorUrl) {
     throw new Error("facilitatorUrl is required");
   }
@@ -324,6 +337,7 @@ function createPaymentMiddleware(config) {
       paymentHeader,
       paymentRequirements,
       facilitatorUrl,
+      apiKey,
       routeKey,
       network,
       asset: assetConfig.address,
@@ -334,11 +348,23 @@ function createPaymentMiddleware(config) {
       res.status(result.statusCode).json(result.responseBody);
       return;
     }
+    if (result.sendTelemetryAfterResponse) {
+      res.on("finish", () => {
+        const statusCode = res.statusCode;
+        const errorMessage = statusCode >= 400 ? `Handler returned ${statusCode}` : void 0;
+        result.sendTelemetryAfterResponse(statusCode, errorMessage);
+      });
+      res.on("close", () => {
+        if (!res.writableEnded) {
+          result.sendTelemetryAfterResponse(500, "Response closed without finishing");
+        }
+      });
+    }
     next();
   };
 }
 function mantlePaywall(opts) {
-  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
   validateAddress(payTo, "payTo");
   const priceUsdCents = Math.round(priceUsd * 100);
   return async (req, res, next) => {
@@ -354,6 +380,7 @@ function mantlePaywall(opts) {
           network: MANTLE_DEFAULTS.NETWORK
         }
       },
+      apiKey,
       telemetry,
       onPaymentSettled
     });

package/dist/server-express.d.cts

@@ -1,5 +1,5 @@
-export { M as MantleMiddleware, P as PaymentMiddlewareConfig, c as createPaymentMiddleware, m as mantlePaywall } from './express-eQOPxfnI.cjs';
-export { M as MinimalPaywallOptions, c as PaymentCheckInput, d as PaymentCheckResult, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CrOsOHcX.cjs';
+export { M as MantleMiddleware, P as PaymentMiddlewareConfig, c as createPaymentMiddleware, m as mantlePaywall } from './express-DqyVgO5n.cjs';
+export { M as MinimalPaywallOptions, c as PaymentCheckInput, d as PaymentCheckResult, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-B87bD2yo.cjs';
 export { A as AssetConfig, a as Authorization, E as EIP1193Provider, N as NetworkId, d as PaymentHeaderBase64, c as PaymentHeaderObject, b as PaymentHeaderPayload, P as PaymentRequirements } from './types-BFUqKBBO.cjs';
 export { M as MANTLE_DEFAULTS } from './constants-CsIL25uQ.cjs';
 import 'express';

package/dist/server-express.d.ts

@@ -1,5 +1,5 @@
-export { M as MantleMiddleware, P as PaymentMiddlewareConfig, c as createPaymentMiddleware, m as mantlePaywall } from './express-D8EwEcOL.js';
-export { M as MinimalPaywallOptions, c as PaymentCheckInput, d as PaymentCheckResult, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CqQ6OgRi.js';
+export { M as MantleMiddleware, P as PaymentMiddlewareConfig, c as createPaymentMiddleware, m as mantlePaywall } from './express-DxxlKmmF.js';
+export { M as MinimalPaywallOptions, c as PaymentCheckInput, d as PaymentCheckResult, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-vicT7qsY.js';
 export { A as AssetConfig, a as Authorization, E as EIP1193Provider, N as NetworkId, d as PaymentHeaderBase64, c as PaymentHeaderObject, b as PaymentHeaderPayload, P as PaymentRequirements } from './types-BFUqKBBO.js';
 export { M as MANTLE_DEFAULTS } from './constants-0ncqvV_O.js';
 import 'express';