@puga-labs/x402-mantle-sdk 0.2.1 → 0.3.2

package/dist/server-web.d.ts

@@ -0,0 +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 { 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

@@ -0,0 +1,11 @@
+import {
+  mantlePaywall
+} from "./chunk-NQWSCY44.js";
+import "./chunk-U73CZU3X.js";
+import {
+  MANTLE_DEFAULTS
+} from "./chunk-HEZZ74SI.js";
+export {
+  MANTLE_DEFAULTS,
+  mantlePaywall
+};

package/dist/server.cjs

@@ -0,0 +1,497 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  DEFAULT_TELEMETRY_ENDPOINT: () => DEFAULT_TELEMETRY_ENDPOINT,
+  buildRouteKey: () => buildRouteKey,
+  checkPayment: () => checkPayment,
+  createPaymentMiddleware: () => createPaymentMiddleware,
+  createTelemetryEvent: () => createTelemetryEvent,
+  decodePaymentHeader: () => decodePaymentHeader,
+  express: () => express_exports,
+  mantlePaywall: () => mantlePaywall,
+  nextjs: () => nextjs_exports,
+  sendTelemetry: () => sendTelemetry,
+  validateAddress: () => validateAddress,
+  web: () => web_standards_exports
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/server/core/utils.ts
+function validateAddress(address, paramName = "address") {
+  if (!address) {
+    throw new Error(`${paramName} is required`);
+  }
+  if (typeof address !== "string") {
+    throw new Error(`${paramName} must be a string, got ${typeof address}`);
+  }
+  if (!address.startsWith("0x")) {
+    const preview = address.length > 10 ? `${address.substring(0, 10)}...` : address;
+    throw new Error(
+      `${paramName} must start with "0x", got: ${preview}`
+    );
+  }
+  if (address.length !== 42) {
+    throw new Error(
+      `${paramName} must be 42 characters (0x + 40 hex), got ${address.length} characters`
+    );
+  }
+  const hexPart = address.slice(2);
+  if (!/^[0-9a-fA-F]{40}$/.test(hexPart)) {
+    throw new Error(
+      `${paramName} must contain only hexadecimal characters (0-9, a-f, A-F) after "0x"`
+    );
+  }
+}
+function decodePaymentHeader(paymentHeaderBase64) {
+  try {
+    if (typeof Buffer !== "undefined") {
+      const json = Buffer.from(paymentHeaderBase64, "base64").toString("utf8");
+      return JSON.parse(json);
+    }
+    if (typeof atob === "function") {
+      const json = atob(paymentHeaderBase64);
+      return JSON.parse(json);
+    }
+    throw new Error("No base64 decoding available in this environment");
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : "Unknown error";
+    throw new Error(`Failed to decode paymentHeader: ${msg}`);
+  }
+}
+function buildRouteKey(method, path) {
+  const normalizedMethod = (method || "GET").toUpperCase();
+  const normalizedPath = path || "/";
+  return `${normalizedMethod} ${normalizedPath}`;
+}
+
+// src/shared/constants.ts
+var MANTLE_MAINNET_NETWORK_ID = "mantle-mainnet";
+var MANTLE_MAINNET_USDC = {
+  symbol: "USDC",
+  address: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9",
+  decimals: 6
+};
+var MANTLE_DEFAULTS = {
+  NETWORK: "mantle-mainnet",
+  CHAIN_ID: 5e3,
+  USDC_ADDRESS: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9",
+  USDC_DECIMALS: 6,
+  CURRENCY: "USD",
+  SCHEME: "exact",
+  FACILITATOR_URL: (typeof process !== "undefined" ? process.env?.NEXT_PUBLIC_FACILITATOR_URL : void 0) || "http://localhost:8080"
+};
+function getDefaultAssetForNetwork(network) {
+  switch (network) {
+    case MANTLE_MAINNET_NETWORK_ID:
+    default:
+      return MANTLE_MAINNET_USDC;
+  }
+}
+function usdCentsToAtomic(cents, decimals) {
+  if (cents < 0) {
+    throw new Error("priceUsdCents must be non-negative");
+  }
+  if (decimals < 2) {
+    throw new Error("token decimals must be >= 2 for USD cent conversion");
+  }
+  const base = BigInt(10) ** BigInt(decimals - 2);
+  return BigInt(cents) * base;
+}
+
+// src/server/constants.ts
+var DEFAULT_TELEMETRY_ENDPOINT = void 0;
+
+// src/server/telemetry.ts
+function createTelemetryEvent(entry, config) {
+  const assetConfig = getDefaultAssetForNetwork(entry.network);
+  return {
+    event: "payment_verified",
+    ts: entry.timestamp,
+    projectKey: config.projectKey,
+    network: entry.network,
+    buyer: entry.from,
+    payTo: entry.to,
+    amountAtomic: entry.valueAtomic,
+    asset: entry.asset,
+    decimals: assetConfig.decimals,
+    nonce: entry.id,
+    route: entry.route ?? "unknown",
+    // Facilitator metadata
+    facilitatorType: "hosted",
+    // SDK always uses hosted mode
+    facilitatorUrl: entry.facilitatorUrl,
+    // From PaymentLogEntry
+    // facilitatorAddress is undefined for SDK (not available)
+    // Optional metadata
+    txHash: entry.txHash,
+    priceUsd: entry.paymentRequirements?.price
+  };
+}
+async function sendTelemetry(event, endpoint) {
+  const targetEndpoint = endpoint ?? DEFAULT_TELEMETRY_ENDPOINT;
+  if (!targetEndpoint) {
+    return;
+  }
+  try {
+    const response = await fetch(targetEndpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${event.projectKey}`
+      },
+      body: JSON.stringify(event)
+    });
+    if (!response.ok) {
+      console.warn(
+        `[x402-telemetry] Failed to send event: HTTP ${response.status}`
+      );
+    }
+  } catch (err) {
+    console.error("[x402-telemetry] Error sending telemetry:", err);
+  }
+}
+
+// src/server/core/verifyPayment.ts
+async function checkPayment(input) {
+  const {
+    paymentHeader,
+    paymentRequirements,
+    facilitatorUrl,
+    routeKey,
+    network,
+    asset,
+    telemetry,
+    onPaymentSettled
+  } = input;
+  if (!paymentHeader) {
+    return {
+      status: "require_payment",
+      statusCode: 402,
+      responseBody: {
+        error: "Payment Required",
+        paymentRequirements,
+        paymentHeader: null
+      },
+      isValid: false
+    };
+  }
+  try {
+    const verifyUrl = `${facilitatorUrl.replace(/\/+$/, "")}/verify`;
+    const verifyRes = await fetch(verifyUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        x402Version: 1,
+        paymentHeader,
+        paymentRequirements
+      })
+    });
+    if (!verifyRes.ok) {
+      const text = await verifyRes.text().catch(() => "");
+      console.error(
+        "[x402-mantle-sdk] Facilitator /verify returned non-OK:",
+        verifyRes.status,
+        text
+      );
+      return {
+        status: "verification_error",
+        statusCode: 500,
+        responseBody: {
+          error: "Payment verification error",
+          details: `Facilitator responded with HTTP ${verifyRes.status}`
+        },
+        isValid: false
+      };
+    }
+    const verifyJson = await verifyRes.json();
+    if (!verifyJson.isValid) {
+      return {
+        status: "invalid_payment",
+        statusCode: 402,
+        responseBody: {
+          error: "Payment verification failed",
+          invalidReason: verifyJson.invalidReason ?? null,
+          paymentRequirements,
+          paymentHeader: null
+        },
+        isValid: false
+      };
+    }
+    if (onPaymentSettled) {
+      try {
+        const headerObj = decodePaymentHeader(paymentHeader);
+        const { authorization } = headerObj.payload;
+        const assetConfig = getDefaultAssetForNetwork(network);
+        const logEntry = {
+          id: authorization.nonce,
+          from: authorization.from,
+          to: authorization.to,
+          valueAtomic: authorization.value,
+          network,
+          asset,
+          route: routeKey,
+          timestamp: Date.now(),
+          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)
+          );
+        }
+      } catch (err) {
+        console.error(
+          "[x402-mantle-sdk] Error calling onPaymentSettled hook:",
+          err
+        );
+      }
+    }
+    return {
+      status: "verified",
+      statusCode: 200,
+      responseBody: null,
+      isValid: true
+    };
+  } catch (err) {
+    console.error(
+      "[x402-mantle-sdk] Error while calling facilitator /verify:",
+      err
+    );
+    const message = err instanceof Error ? err.message : "Unknown verification error";
+    return {
+      status: "verification_error",
+      statusCode: 500,
+      responseBody: {
+        error: "Payment verification error",
+        details: message
+      },
+      isValid: false
+    };
+  }
+}
+
+// src/server/adapters/express.ts
+var express_exports = {};
+__export(express_exports, {
+  createPaymentMiddleware: () => createPaymentMiddleware,
+  mantlePaywall: () => mantlePaywall
+});
+function createPaymentMiddleware(config) {
+  const { facilitatorUrl, receiverAddress, routes, onPaymentSettled, telemetry } = config;
+  if (!facilitatorUrl) {
+    throw new Error("facilitatorUrl is required");
+  }
+  if (!receiverAddress) {
+    throw new Error("receiverAddress is required");
+  }
+  validateAddress(receiverAddress, "receiverAddress");
+  if (!routes || Object.keys(routes).length === 0) {
+    throw new Error("routes config must not be empty");
+  }
+  return async function paymentMiddleware(req, res, next) {
+    const routeKey = buildRouteKey(req.method, req.path);
+    const routeConfig = routes[routeKey];
+    if (!routeConfig) {
+      next();
+      return;
+    }
+    const { priceUsdCents, network } = routeConfig;
+    const assetConfig = getDefaultAssetForNetwork(network);
+    const maxAmountRequiredBigInt = usdCentsToAtomic(
+      priceUsdCents,
+      assetConfig.decimals
+    );
+    const paymentRequirements = {
+      scheme: "exact",
+      network,
+      asset: assetConfig.address,
+      maxAmountRequired: maxAmountRequiredBigInt.toString(),
+      payTo: receiverAddress,
+      price: `$${(priceUsdCents / 100).toFixed(2)}`,
+      currency: "USD"
+    };
+    const paymentHeader = req.header("X-PAYMENT") || req.header("x-payment") || null;
+    const result = await checkPayment({
+      paymentHeader,
+      paymentRequirements,
+      facilitatorUrl,
+      routeKey,
+      network,
+      asset: assetConfig.address,
+      telemetry,
+      onPaymentSettled
+    });
+    if (!result.isValid) {
+      res.status(result.statusCode).json(result.responseBody);
+      return;
+    }
+    next();
+  };
+}
+function mantlePaywall(opts) {
+  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  validateAddress(payTo, "payTo");
+  const priceUsdCents = Math.round(priceUsd * 100);
+  return async (req, res, next) => {
+    const method = (req.method || "GET").toUpperCase();
+    const path = req.path || "/";
+    const routeKey = `${method} ${path}`;
+    const middleware = createPaymentMiddleware({
+      facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+      receiverAddress: payTo,
+      routes: {
+        [routeKey]: {
+          priceUsdCents,
+          network: MANTLE_DEFAULTS.NETWORK
+        }
+      },
+      telemetry,
+      onPaymentSettled
+    });
+    return middleware(req, res, next);
+  };
+}
+
+// src/server/adapters/nextjs.ts
+var nextjs_exports = {};
+__export(nextjs_exports, {
+  mantlePaywall: () => mantlePaywall2
+});
+var import_server = require("next/server");
+function mantlePaywall2(opts) {
+  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  validateAddress(payTo, "payTo");
+  const priceUsdCents = Math.round(priceUsd * 100);
+  return function(handler) {
+    return async (req) => {
+      const url = new URL(req.url);
+      const method = req.method;
+      const path = url.pathname;
+      const routeKey = buildRouteKey(method, path);
+      const network = MANTLE_DEFAULTS.NETWORK;
+      const assetConfig = getDefaultAssetForNetwork(network);
+      const maxAmountRequiredBigInt = usdCentsToAtomic(
+        priceUsdCents,
+        assetConfig.decimals
+      );
+      const paymentRequirements = {
+        scheme: "exact",
+        network,
+        asset: assetConfig.address,
+        maxAmountRequired: maxAmountRequiredBigInt.toString(),
+        payTo,
+        price: `$${(priceUsdCents / 100).toFixed(2)}`,
+        currency: "USD"
+      };
+      const paymentHeader = req.headers.get("X-PAYMENT") || req.headers.get("x-payment") || null;
+      const result = await checkPayment({
+        paymentHeader,
+        paymentRequirements,
+        facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        routeKey,
+        network,
+        asset: assetConfig.address,
+        telemetry,
+        onPaymentSettled
+      });
+      if (!result.isValid) {
+        return import_server.NextResponse.json(result.responseBody, {
+          status: result.statusCode
+        });
+      }
+      return handler(req);
+    };
+  };
+}
+
+// src/server/adapters/web-standards.ts
+var web_standards_exports = {};
+__export(web_standards_exports, {
+  mantlePaywall: () => mantlePaywall3
+});
+function mantlePaywall3(opts) {
+  const { priceUsd, payTo, facilitatorUrl, telemetry, onPaymentSettled } = opts;
+  validateAddress(payTo, "payTo");
+  const priceUsdCents = Math.round(priceUsd * 100);
+  return function(handler) {
+    return async (request) => {
+      const url = new URL(request.url);
+      const method = request.method;
+      const path = url.pathname;
+      const routeKey = buildRouteKey(method, path);
+      const network = MANTLE_DEFAULTS.NETWORK;
+      const assetConfig = getDefaultAssetForNetwork(network);
+      const maxAmountRequiredBigInt = usdCentsToAtomic(
+        priceUsdCents,
+        assetConfig.decimals
+      );
+      const paymentRequirements = {
+        scheme: "exact",
+        network,
+        asset: assetConfig.address,
+        maxAmountRequired: maxAmountRequiredBigInt.toString(),
+        payTo,
+        price: `$${(priceUsdCents / 100).toFixed(2)}`,
+        currency: "USD"
+      };
+      const paymentHeader = request.headers.get("X-PAYMENT") || request.headers.get("x-payment") || null;
+      const result = await checkPayment({
+        paymentHeader,
+        paymentRequirements,
+        facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
+        routeKey,
+        network,
+        asset: assetConfig.address,
+        telemetry,
+        onPaymentSettled
+      });
+      if (!result.isValid) {
+        return new Response(JSON.stringify(result.responseBody), {
+          status: result.statusCode,
+          headers: {
+            "Content-Type": "application/json"
+          }
+        });
+      }
+      return handler(request);
+    };
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_TELEMETRY_ENDPOINT,
+  buildRouteKey,
+  checkPayment,
+  createPaymentMiddleware,
+  createTelemetryEvent,
+  decodePaymentHeader,
+  express,
+  mantlePaywall,
+  nextjs,
+  sendTelemetry,
+  validateAddress,
+  web
+});

package/dist/server.d.cts

@@ -0,0 +1,79 @@
+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 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-Duecps0q.cjs';
+export { w as web } from './web-standards-BNQyWzBC.cjs';
+import { P as PaymentLogEntry, T as TelemetryConfig, c as TelemetryEvent } from './types-CoOdbZSp.cjs';
+import 'express';
+import 'next/server';
+
+/**
+ * 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\"..."
+ * ```
+ */
+declare function validateAddress(address: string, paramName?: string): void;
+/**
+ * Decode base64 payment header into JSON object.
+ * Works in both Node.js and browser environments.
+ */
+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;
+
+/**
+ * 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>;
+
+/**
+ * Default telemetry endpoint URL.
+ *
+ * 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 event - The telemetry event to send
+ * @param endpoint - The telemetry endpoint URL (optional, falls back to DEFAULT_TELEMETRY_ENDPOINT)
+ */
+declare function sendTelemetry(event: TelemetryEvent, endpoint?: string): Promise<void>;
+
+export { DEFAULT_TELEMETRY_ENDPOINT, PaymentCheckInput, PaymentCheckResult, buildRouteKey, checkPayment, createTelemetryEvent, decodePaymentHeader, sendTelemetry, validateAddress };

package/dist/server.d.ts

@@ -0,0 +1,79 @@
+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';
+
+/**
+ * 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\"..."
+ * ```
+ */
+declare function validateAddress(address: string, paramName?: string): void;
+/**
+ * Decode base64 payment header into JSON object.
+ * Works in both Node.js and browser environments.
+ */
+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;
+
+/**
+ * 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>;
+
+/**
+ * Default telemetry endpoint URL.
+ *
+ * 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 event - The telemetry event to send
+ * @param endpoint - The telemetry endpoint URL (optional, falls back to DEFAULT_TELEMETRY_ENDPOINT)
+ */
+declare function sendTelemetry(event: TelemetryEvent, endpoint?: string): Promise<void>;
+
+export { DEFAULT_TELEMETRY_ENDPOINT, PaymentCheckInput, PaymentCheckResult, buildRouteKey, checkPayment, createTelemetryEvent, decodePaymentHeader, sendTelemetry, validateAddress };