@puga-labs/x402-mantle-sdk 0.3.6 → 0.3.8

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-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/react.cjs

@@ -353,11 +353,26 @@ function createPaymentClient(config) {
         validBefore,
         nonce
       };
-      const { signature, from } = await signAuthorizationWithProvider(
-        provider,
-        authorization,
-        paymentRequirements
-      );
+      let signature;
+      let from;
+      try {
+        const signed = await signAuthorizationWithProvider(
+          provider,
+          authorization,
+          paymentRequirements
+        );
+        signature = signed.signature;
+        from = signed.from;
+      } catch (err) {
+        const code = err?.code;
+        if (code === 4001 || code === "ACTION_REJECTED") {
+          const userErr = new Error("User rejected payment signature");
+          userErr.code = "USER_REJECTED_SIGNATURE";
+          userErr.userRejected = true;
+          throw userErr;
+        }
+        throw err;
+      }
       authorization = {
         ...authorization,
         from

package/dist/react.js

@@ -1,8 +1,8 @@
 import {
   useEthersWallet,
   useMantleX402
-} from "./chunk-APBCF3SX.js";
-import "./chunk-VNO4LJWC.js";
+} from "./chunk-26OQ36EN.js";
+import "./chunk-7SOCLVGM.js";
 import "./chunk-HEZZ74SI.js";
 export {
   useEthersWallet,

package/dist/server-express.cjs

@@ -109,7 +109,7 @@ function usdCentsToAtomic(cents, decimals) {
 }
 
 // src/server/constants.ts
-var DEFAULT_TELEMETRY_ENDPOINT = void 0;
+var DEFAULT_TELEMETRY_ENDPOINT = "https://x402mantlesdk.xyz/api/telemetry/settled";
 
 // src/server/telemetry.ts
 function createTelemetryEvent(entry, config) {
@@ -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,
@@ -286,7 +288,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 +326,7 @@ function createPaymentMiddleware(config) {
       paymentHeader,
       paymentRequirements,
       facilitatorUrl,
+      apiKey,
       routeKey,
       network,
       asset: assetConfig.address,
@@ -338,7 +341,7 @@ function createPaymentMiddleware(config) {
   };
 }
 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 +357,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-Pukmnwuu.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-BmK0G74m.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-D8L5Dg1D.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-CXdNC0Ra.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';

package/dist/server-express.js

@@ -1,8 +1,8 @@
 import {
   createPaymentMiddleware,
   mantlePaywall
-} from "./chunk-QWQUSRLY.js";
-import "./chunk-ZLCKBFVJ.js";
+} from "./chunk-B4GST723.js";
+import "./chunk-OW2BDRGZ.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

package/dist/server-nextjs.cjs

@@ -112,7 +112,7 @@ function usdCentsToAtomic(cents, decimals) {
 }
 
 // src/server/constants.ts
-var DEFAULT_TELEMETRY_ENDPOINT = void 0;
+var DEFAULT_TELEMETRY_ENDPOINT = "https://x402mantlesdk.xyz/api/telemetry/settled";
 
 // src/server/telemetry.ts
 function createTelemetryEvent(entry, config) {
@@ -170,6 +170,7 @@ async function checkPayment(input) {
     paymentHeader,
     paymentRequirements,
     facilitatorUrl,
+    apiKey,
     routeKey,
     network,
     asset,
@@ -193,7 +194,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,
@@ -289,7 +291,7 @@ async function checkPayment(input) {
 
 // src/server/adapters/nextjs.ts
 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 function(handler) {
@@ -318,6 +320,7 @@ function mantlePaywall(opts) {
         paymentHeader,
         paymentRequirements,
         facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        apiKey,
         routeKey,
         network,
         asset: assetConfig.address,

package/dist/server-nextjs.d.cts

@@ -1,5 +1,5 @@
-export { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-CGOVHJXl.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 { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-CSUWjcxv.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-BmK0G74m.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 'next/server';

package/dist/server-nextjs.d.ts

@@ -1,5 +1,5 @@
-export { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-w61gRvpz.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 { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-DUdgN0d_.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-CXdNC0Ra.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 'next/server';

package/dist/server-nextjs.js

@@ -1,8 +1,8 @@
 import {
   isPaywallErrorResponse,
   mantlePaywall
-} from "./chunk-IT6VV6YL.js";
-import "./chunk-ZLCKBFVJ.js";
+} from "./chunk-33WHNZDS.js";
+import "./chunk-OW2BDRGZ.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

package/dist/server-web.cjs

@@ -108,7 +108,7 @@ function usdCentsToAtomic(cents, decimals) {
 }
 
 // src/server/constants.ts
-var DEFAULT_TELEMETRY_ENDPOINT = void 0;
+var DEFAULT_TELEMETRY_ENDPOINT = "https://x402mantlesdk.xyz/api/telemetry/settled";
 
 // src/server/telemetry.ts
 function createTelemetryEvent(entry, config) {
@@ -166,6 +166,7 @@ async function checkPayment(input) {
     paymentHeader,
     paymentRequirements,
     facilitatorUrl,
+    apiKey,
     routeKey,
     network,
     asset,
@@ -189,7 +190,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,
@@ -285,7 +287,7 @@ async function checkPayment(input) {
 
 // src/server/adapters/web-standards.ts
 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 function(handler) {
@@ -314,6 +316,7 @@ function mantlePaywall(opts) {
         paymentHeader,
         paymentRequirements,
         facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        apiKey,
         routeKey,
         network,
         asset: assetConfig.address,

package/dist/server-web.d.cts

@@ -1,4 +1,4 @@
-export { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-BNQyWzBC.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 { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-BvMLEKlU.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-BmK0G74m.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';

package/dist/server-web.d.ts

@@ -1,4 +1,4 @@
-export { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-D8j1kZxd.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 { W as WebHandler, a as WebPaywallWrapper, m as mantlePaywall } from './web-standards-g2rYUpgc.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-CXdNC0Ra.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';

package/dist/server-web.js

@@ -1,7 +1,7 @@
 import {
   mantlePaywall
-} from "./chunk-ZROK2XOB.js";
-import "./chunk-ZLCKBFVJ.js";
+} from "./chunk-T63MVWX3.js";
+import "./chunk-OW2BDRGZ.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

package/dist/server.cjs

@@ -118,7 +118,7 @@ function usdCentsToAtomic(cents, decimals) {
 }
 
 // src/server/constants.ts
-var DEFAULT_TELEMETRY_ENDPOINT = void 0;
+var DEFAULT_TELEMETRY_ENDPOINT = "https://x402mantlesdk.xyz/api/telemetry/settled";
 
 // src/server/telemetry.ts
 function createTelemetryEvent(entry, config) {
@@ -176,6 +176,7 @@ async function checkPayment(input) {
     paymentHeader,
     paymentRequirements,
     facilitatorUrl,
+    apiKey,
     routeKey,
     network,
     asset,
@@ -199,7 +200,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,
@@ -300,7 +302,7 @@ __export(express_exports, {
   mantlePaywall: () => mantlePaywall
 });
 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");
   }
@@ -338,6 +340,7 @@ function createPaymentMiddleware(config) {
       paymentHeader,
       paymentRequirements,
       facilitatorUrl,
+      apiKey,
       routeKey,
       network,
       asset: assetConfig.address,
@@ -352,7 +355,7 @@ function createPaymentMiddleware(config) {
   };
 }
 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) => {
@@ -368,6 +371,7 @@ function mantlePaywall(opts) {
           network: MANTLE_DEFAULTS.NETWORK
         }
       },
+      apiKey,
       telemetry,
       onPaymentSettled
     });
@@ -383,7 +387,7 @@ __export(nextjs_exports, {
 });
 var import_server = require("next/server");
 function mantlePaywall2(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 function(handler) {
@@ -412,6 +416,7 @@ function mantlePaywall2(opts) {
         paymentHeader,
         paymentRequirements,
         facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        apiKey,
         routeKey,
         network,
         asset: assetConfig.address,
@@ -437,7 +442,7 @@ __export(web_standards_exports, {
   mantlePaywall: () => mantlePaywall3
 });
 function mantlePaywall3(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 function(handler) {
@@ -466,6 +471,7 @@ function mantlePaywall3(opts) {
         paymentHeader,
         paymentRequirements,
         facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        apiKey,
         routeKey,
         network,
         asset: assetConfig.address,

package/dist/server.d.cts

@@ -1,10 +1,10 @@
-import { c as PaymentCheckInput, d as PaymentCheckResult } from './types-CrOsOHcX.cjs';
-export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CrOsOHcX.cjs';
+import { c as PaymentCheckInput, d as PaymentCheckResult } from './types-BmK0G74m.cjs';
+export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-BmK0G74m.cjs';
 import { c as PaymentHeaderObject } from './types-BFUqKBBO.cjs';
-export { M as MantleMiddleware, c as createPaymentMiddleware, e as express, m as mantlePaywall } from './express-eQOPxfnI.cjs';
-export { n as nextjs } from './nextjs-CGOVHJXl.cjs';
-export { w as web } from './web-standards-BNQyWzBC.cjs';
-import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-CoOdbZSp.cjs';
+export { M as MantleMiddleware, c as createPaymentMiddleware, e as express, m as mantlePaywall } from './express-Pukmnwuu.cjs';
+export { n as nextjs } from './nextjs-CSUWjcxv.cjs';
+export { w as web } from './web-standards-BvMLEKlU.cjs';
+import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-BWfKovFm.cjs';
 import 'express';
 import 'next/server';
 

package/dist/server.d.ts

@@ -1,10 +1,10 @@
-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 PaymentCheckInput, d as PaymentCheckResult } from './types-CXdNC0Ra.js';
+export { M as MinimalPaywallOptions, P as PaymentLogEntry, R as RouteKey, a as RoutePricingConfig, b as RoutesConfig, T as TelemetryConfig } from './types-CXdNC0Ra.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-w61gRvpz.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';
+export { M as MantleMiddleware, c as createPaymentMiddleware, e as express, m as mantlePaywall } from './express-D8L5Dg1D.js';
+export { n as nextjs } from './nextjs-DUdgN0d_.js';
+export { w as web } from './web-standards-g2rYUpgc.js';
+import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-DgfVPQFb.js';
 import 'express';
 import 'next/server';
 

package/dist/server.js

@@ -3,13 +3,13 @@ import {
   createPaymentMiddleware,
   express_exports,
   mantlePaywall
-} from "./chunk-QWQUSRLY.js";
+} from "./chunk-B4GST723.js";
 import {
   nextjs_exports
-} from "./chunk-IT6VV6YL.js";
+} from "./chunk-33WHNZDS.js";
 import {
   web_standards_exports
-} from "./chunk-ZROK2XOB.js";
+} from "./chunk-T63MVWX3.js";
 import {
   DEFAULT_TELEMETRY_ENDPOINT,
   buildRouteKey,
@@ -18,7 +18,7 @@ import {
   decodePaymentHeader,
   sendTelemetry,
   validateAddress
-} from "./chunk-ZLCKBFVJ.js";
+} from "./chunk-OW2BDRGZ.js";
 import "./chunk-HEZZ74SI.js";
 export {
   DEFAULT_TELEMETRY_ENDPOINT,