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

package/dist/chunk-WELDWRDX.js

@@ -1,307 +0,0 @@
-import {
-  __require,
-  getChainIdForNetwork
-} from "./chunk-XAQGMFSR.js";
-
-// src/shared/utils.ts
-function encodeJsonToBase64(value) {
-  const json = JSON.stringify(value);
-  if (typeof btoa === "function") {
-    const bytes = new TextEncoder().encode(json);
-    const binString = Array.from(
-      bytes,
-      (byte) => String.fromCodePoint(byte)
-    ).join("");
-    return btoa(binString);
-  }
-  if (typeof globalThis.Buffer !== "undefined") {
-    return globalThis.Buffer.from(json, "utf8").toString("base64");
-  }
-  throw new Error("No base64 implementation found in this environment");
-}
-function randomBytes32Hex() {
-  if (typeof crypto !== "undefined" && "getRandomValues" in crypto) {
-    const arr = new Uint8Array(32);
-    crypto.getRandomValues(arr);
-    return "0x" + Array.from(arr).map((b) => b.toString(16).padStart(2, "0")).join("");
-  }
-  try {
-    const nodeCrypto = __require("crypto");
-    const buf = nodeCrypto.randomBytes(32);
-    return "0x" + buf.toString("hex");
-  } catch {
-    throw new Error(
-      "No cryptographically secure random number generator found. This environment does not support crypto.getRandomValues or Node.js crypto module."
-    );
-  }
-}
-
-// src/client/paymentClient.ts
-function joinUrl(base, path) {
-  const normalizedBase = base.replace(/\/+$/, "");
-  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
-  return `${normalizedBase}${normalizedPath}`;
-}
-async function getUserAddressFromProvider(provider) {
-  const p = provider;
-  if (!p || typeof p.request !== "function") {
-    throw new Error("provider must implement EIP-1193 request()");
-  }
-  const accounts = await p.request({
-    method: "eth_requestAccounts"
-  });
-  if (!accounts || accounts.length === 0) {
-    throw new Error("No accounts returned from provider");
-  }
-  return accounts[0];
-}
-function buildTypedDataForAuthorization(authorization, paymentRequirements) {
-  const chainId = getChainIdForNetwork(paymentRequirements.network);
-  const verifyingContract = paymentRequirements.asset;
-  const domain = {
-    name: "USD Coin",
-    version: "2",
-    chainId,
-    verifyingContract
-  };
-  const types = {
-    TransferWithAuthorization: [
-      { name: "from", type: "address" },
-      { name: "to", type: "address" },
-      { name: "value", type: "uint256" },
-      { name: "validAfter", type: "uint256" },
-      { name: "validBefore", type: "uint256" },
-      { name: "nonce", type: "bytes32" }
-    ]
-  };
-  return {
-    domain,
-    types,
-    primaryType: "TransferWithAuthorization",
-    message: authorization
-  };
-}
-async function signAuthorizationWithProvider(provider, address, authorization, paymentRequirements) {
-  const p = provider;
-  if (!p || typeof p.request !== "function") {
-    throw new Error("provider must implement EIP-1193 request()");
-  }
-  const typedData = buildTypedDataForAuthorization(
-    authorization,
-    paymentRequirements
-  );
-  const params = [address, JSON.stringify(typedData)];
-  const signature = await p.request({
-    method: "eth_signTypedData_v4",
-    params
-  });
-  if (typeof signature !== "string" || !signature.startsWith("0x")) {
-    throw new Error("Invalid signature returned from provider");
-  }
-  return signature;
-}
-function createPaymentClient(config) {
-  const {
-    resourceUrl,
-    facilitatorUrl,
-    provider,
-    userAddress: userAddressOverride,
-    projectKey
-  } = config;
-  if (!resourceUrl) {
-    throw new Error("resourceUrl is required");
-  }
-  if (!facilitatorUrl) {
-    throw new Error("facilitatorUrl is required");
-  }
-  if (!provider) {
-    throw new Error("provider is required (e.g. window.ethereum)");
-  }
-  return {
-    async callWithPayment(path, options) {
-      const method = options?.method ?? "GET";
-      const headers = {
-        ...options?.headers ?? {}
-      };
-      let body;
-      if (options?.body !== void 0) {
-        headers["Content-Type"] = headers["Content-Type"] ?? "application/json";
-        body = JSON.stringify(options.body);
-      }
-      const initialUrl = joinUrl(resourceUrl, path);
-      const initialRes = await fetch(initialUrl, {
-        method,
-        headers,
-        body
-      });
-      if (initialRes.status !== 402) {
-        const json = await initialRes.json().catch((err) => {
-          console.error("[x402] Failed to parse initial response JSON:", err);
-          return null;
-        });
-        return {
-          response: json,
-          txHash: void 0
-        };
-      }
-      const bodyJson = await initialRes.json();
-      const paymentRequirements = bodyJson.paymentRequirements;
-      if (!paymentRequirements) {
-        throw new Error(
-          "402 response did not include paymentRequirements field"
-        );
-      }
-      const fromAddress = userAddressOverride ?? await getUserAddressFromProvider(provider);
-      try {
-        const p = provider;
-        const accounts = await p.request({ method: "eth_accounts" });
-        console.log("[SDK] Wallet accounts:", accounts);
-        console.log("[SDK] Using fromAddress:", fromAddress);
-      } catch (err) {
-      }
-      const nowSec = Math.floor(Date.now() / 1e3);
-      const validAfter = "0";
-      const validBefore = String(nowSec + 10 * 60);
-      const nonce = randomBytes32Hex();
-      const valueAtomic = options?.valueOverrideAtomic ?? paymentRequirements.maxAmountRequired;
-      let authorization = {
-        from: fromAddress,
-        to: paymentRequirements.payTo,
-        value: valueAtomic,
-        validAfter,
-        validBefore,
-        nonce
-      };
-      const signature = await signAuthorizationWithProvider(
-        provider,
-        fromAddress,
-        authorization,
-        paymentRequirements
-      );
-      const { ethers } = await import("ethers");
-      const typedData = buildTypedDataForAuthorization(
-        authorization,
-        paymentRequirements
-      );
-      const recovered = ethers.verifyTypedData(
-        typedData.domain,
-        typedData.types,
-        typedData.message,
-        signature
-      );
-      if (recovered.toLowerCase() !== authorization.from.toLowerCase()) {
-        console.warn("[SDK WARNING] Signer address differs from expected, using recovered address", {
-          expected: authorization.from,
-          recovered,
-          message: "This may indicate multiple accounts in wallet or wrong active account"
-        });
-        authorization = {
-          ...authorization,
-          from: recovered
-        };
-      }
-      console.log("[SDK] Using authorization.from:", authorization.from);
-      const paymentHeaderObject = {
-        x402Version: 1,
-        scheme: paymentRequirements.scheme,
-        network: paymentRequirements.network,
-        payload: {
-          signature,
-          authorization
-        }
-      };
-      const paymentHeader = encodeJsonToBase64(paymentHeaderObject);
-      const settleUrl = joinUrl(facilitatorUrl, "/settle");
-      const settleRes = await fetch(settleUrl, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          ...projectKey ? { "X-Project-Key": projectKey } : {}
-        },
-        body: JSON.stringify({
-          x402Version: 1,
-          paymentHeader,
-          paymentRequirements
-        })
-      });
-      if (!settleRes.ok) {
-        const text = await settleRes.text().catch((err) => {
-          console.error("[x402] Failed to read settle response text:", err);
-          return "";
-        });
-        throw new Error(
-          `Facilitator /settle failed with HTTP ${settleRes.status}: ${text}`
-        );
-      }
-      const settleJson = await settleRes.json();
-      if (!settleJson.success) {
-        throw new Error(
-          `Facilitator /settle returned error: ${settleJson.error ?? "unknown error"}`
-        );
-      }
-      const txHash = settleJson.txHash ?? void 0;
-      const retryHeaders = {
-        ...headers,
-        "X-PAYMENT": paymentHeader
-      };
-      const retryRes = await fetch(initialUrl, {
-        method,
-        headers: retryHeaders,
-        body
-      });
-      if (!retryRes.ok) {
-        const text = await retryRes.text().catch((err) => {
-          console.error("[x402] Failed to read retry response text:", err);
-          return "";
-        });
-        throw new Error(
-          `Protected request with X-PAYMENT failed: HTTP ${retryRes.status} ${text}`
-        );
-      }
-      const finalJson = await retryRes.json();
-      return {
-        response: finalJson,
-        txHash,
-        paymentHeader,
-        paymentRequirements
-      };
-    }
-  };
-}
-
-// src/client/createMantleClient.ts
-function createMantleClient(config) {
-  const resourceUrl = config?.resourceUrl ?? (typeof window !== "undefined" ? window.location.origin : "");
-  const facilitatorUrl = config?.facilitatorUrl ?? (typeof process !== "undefined" ? process.env?.NEXT_PUBLIC_FACILITATOR_URL : void 0) ?? "http://localhost:8080";
-  return {
-    async postWithPayment(url, body) {
-      const account = await config?.getAccount?.();
-      if (!account) {
-        throw new Error(
-          "Wallet not connected. Please connect your wallet first."
-        );
-      }
-      const provider = config?.getProvider?.();
-      if (!provider) {
-        throw new Error("Wallet provider not available");
-      }
-      const client = createPaymentClient({
-        resourceUrl,
-        facilitatorUrl,
-        provider,
-        userAddress: account,
-        projectKey: config?.projectKey
-      });
-      const result = await client.callWithPayment(url, {
-        method: "POST",
-        body
-      });
-      return result.response;
-    }
-  };
-}
-
-export {
-  createPaymentClient,
-  createMantleClient
-};

package/dist/chunk-XAQGMFSR.js

@@ -1,56 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-// src/shared/constants.ts
-var MANTLE_MAINNET_NETWORK_ID = "mantle-mainnet";
-var MANTLE_MAINNET_CHAIN_ID = 5e3;
-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 getChainIdForNetwork(network) {
-  switch (network) {
-    case MANTLE_MAINNET_NETWORK_ID:
-    default:
-      return MANTLE_MAINNET_CHAIN_ID;
-  }
-}
-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;
-}
-
-export {
-  __require,
-  MANTLE_DEFAULTS,
-  getDefaultAssetForNetwork,
-  getChainIdForNetwork,
-  usdCentsToAtomic
-};

package/dist/constants-C7aY8u5b.d.cts

@@ -1,77 +0,0 @@
-/** Network identifier used in x402 paymentRequirements / paymentHeader. */
-type NetworkId = "mantle-mainnet" | (string & {});
-/** Basic ERC-20 asset config (e.g. USDC on Mantle). */
-interface AssetConfig {
-    symbol: string;
-    address: string;
-    decimals: number;
-}
-/** x402-style payment requirements (returned in 402 response). */
-interface PaymentRequirements {
-    scheme: "exact";
-    network: NetworkId;
-    asset: string;
-    maxAmountRequired: string;
-    payTo: `0x${string}`;
-    price?: string;
-    currency?: string;
-}
-/** EIP-3009 TransferWithAuthorization payload. */
-interface Authorization {
-    from: string;
-    to: string;
-    value: string;
-    validAfter: string;
-    validBefore: string;
-    nonce: string;
-}
-/** Inner payload of x402-style payment header. */
-interface PaymentHeaderPayload {
-    signature: string;
-    authorization: Authorization;
-}
-/** Structured x402-style payment header (before base64 encoding). */
-interface PaymentHeaderObject {
-    x402Version: number;
-    scheme: "exact";
-    network: NetworkId;
-    payload: PaymentHeaderPayload;
-}
-/** Base64-encoded payment header, sent in X-PAYMENT. */
-type PaymentHeaderBase64 = string;
-/**
- * EIP-1193 provider interface (window.ethereum, MetaMask, etc.)
- * Standard interface for Ethereum wallet providers.
- */
-interface EIP1193Provider {
-    request(args: {
-        method: string;
-        params?: unknown[];
-    }): Promise<unknown>;
-    on?(event: string, listener: (...args: unknown[]) => void): void;
-    removeListener?(event: string, listener: (...args: unknown[]) => void): void;
-}
-/**
- * Window ethereum extension for TypeScript
- */
-declare global {
-    interface Window {
-        ethereum?: EIP1193Provider;
-    }
-}
-
-/**
- * Default values for Mantle mainnet x402 payments.
- * These are used by the simplified API (mantlePaywall, createMantleClient).
- */
-declare const MANTLE_DEFAULTS: {
-    readonly NETWORK: "mantle-mainnet";
-    readonly CHAIN_ID: 5000;
-    readonly USDC_ADDRESS: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9";
-    readonly USDC_DECIMALS: 6;
-    readonly CURRENCY: "USD";
-    readonly SCHEME: "exact";
-    readonly FACILITATOR_URL: string;
-};
-
-export { type AssetConfig as A, type EIP1193Provider as E, MANTLE_DEFAULTS as M, type NetworkId as N, type PaymentRequirements as P, type Authorization as a, type PaymentHeaderPayload as b, type PaymentHeaderObject as c, type PaymentHeaderBase64 as d };

package/dist/constants-C7aY8u5b.d.ts

@@ -1,77 +0,0 @@
-/** Network identifier used in x402 paymentRequirements / paymentHeader. */
-type NetworkId = "mantle-mainnet" | (string & {});
-/** Basic ERC-20 asset config (e.g. USDC on Mantle). */
-interface AssetConfig {
-    symbol: string;
-    address: string;
-    decimals: number;
-}
-/** x402-style payment requirements (returned in 402 response). */
-interface PaymentRequirements {
-    scheme: "exact";
-    network: NetworkId;
-    asset: string;
-    maxAmountRequired: string;
-    payTo: `0x${string}`;
-    price?: string;
-    currency?: string;
-}
-/** EIP-3009 TransferWithAuthorization payload. */
-interface Authorization {
-    from: string;
-    to: string;
-    value: string;
-    validAfter: string;
-    validBefore: string;
-    nonce: string;
-}
-/** Inner payload of x402-style payment header. */
-interface PaymentHeaderPayload {
-    signature: string;
-    authorization: Authorization;
-}
-/** Structured x402-style payment header (before base64 encoding). */
-interface PaymentHeaderObject {
-    x402Version: number;
-    scheme: "exact";
-    network: NetworkId;
-    payload: PaymentHeaderPayload;
-}
-/** Base64-encoded payment header, sent in X-PAYMENT. */
-type PaymentHeaderBase64 = string;
-/**
- * EIP-1193 provider interface (window.ethereum, MetaMask, etc.)
- * Standard interface for Ethereum wallet providers.
- */
-interface EIP1193Provider {
-    request(args: {
-        method: string;
-        params?: unknown[];
-    }): Promise<unknown>;
-    on?(event: string, listener: (...args: unknown[]) => void): void;
-    removeListener?(event: string, listener: (...args: unknown[]) => void): void;
-}
-/**
- * Window ethereum extension for TypeScript
- */
-declare global {
-    interface Window {
-        ethereum?: EIP1193Provider;
-    }
-}
-
-/**
- * Default values for Mantle mainnet x402 payments.
- * These are used by the simplified API (mantlePaywall, createMantleClient).
- */
-declare const MANTLE_DEFAULTS: {
-    readonly NETWORK: "mantle-mainnet";
-    readonly CHAIN_ID: 5000;
-    readonly USDC_ADDRESS: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9";
-    readonly USDC_DECIMALS: 6;
-    readonly CURRENCY: "USD";
-    readonly SCHEME: "exact";
-    readonly FACILITATOR_URL: string;
-};
-
-export { type AssetConfig as A, type EIP1193Provider as E, MANTLE_DEFAULTS as M, type NetworkId as N, type PaymentRequirements as P, type Authorization as a, type PaymentHeaderPayload as b, type PaymentHeaderObject as c, type PaymentHeaderBase64 as d };

package/dist/constants-CVFF0ray.d.ts

@@ -1,17 +0,0 @@
-import './types-2zqbJvcz.js';
-
-/**
- * Default values for Mantle mainnet x402 payments.
- * These are used by the simplified API (mantlePaywall, createMantleClient).
- */
-declare const MANTLE_DEFAULTS: {
-    readonly NETWORK: "mantle-mainnet";
-    readonly CHAIN_ID: 5000;
-    readonly USDC_ADDRESS: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9";
-    readonly USDC_DECIMALS: 6;
-    readonly CURRENCY: "USD";
-    readonly SCHEME: "exact";
-    readonly FACILITATOR_URL: string;
-};
-
-export { MANTLE_DEFAULTS as M };

package/dist/constants-DzCGK0Q3.d.cts

@@ -1,17 +0,0 @@
-import './types-2zqbJvcz.cjs';
-
-/**
- * Default values for Mantle mainnet x402 payments.
- * These are used by the simplified API (mantlePaywall, createMantleClient).
- */
-declare const MANTLE_DEFAULTS: {
-    readonly NETWORK: "mantle-mainnet";
-    readonly CHAIN_ID: 5000;
-    readonly USDC_ADDRESS: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9";
-    readonly USDC_DECIMALS: 6;
-    readonly CURRENCY: "USD";
-    readonly SCHEME: "exact";
-    readonly FACILITATOR_URL: string;
-};
-
-export { MANTLE_DEFAULTS as M };

package/dist/createMantleClient-DS1Ghqrz.d.cts

@@ -1,51 +0,0 @@
-/**
- * Configuration for createMantleClient().
- * All fields are optional - the client auto-detects sensible defaults.
- */
-interface MantleClientConfig {
-    /** Optional facilitator URL (auto-detects from NEXT_PUBLIC_FACILITATOR_URL or defaults to localhost:8080). */
-    facilitatorUrl?: string;
-    /** Optional resource URL (defaults to current origin in browser, or empty string for relative paths). */
-    resourceUrl?: string;
-    /** Function to get user's wallet address (required for payments). */
-    getAccount?: () => Promise<string | undefined> | string | undefined;
-    /** Function to get wallet provider/client (e.g., viem WalletClient or window.ethereum). */
-    getProvider?: () => any;
-    /** Optional project key for hosted facilitator billing. */
-    projectKey?: string;
-}
-/**
- * Simplified Mantle payment client interface.
- * Provides a clean API for making paid POST requests.
- */
-interface MantleClient {
-    /**
-     * Make a paid POST request to a protected endpoint.
-     * Automatically handles x402 flow (402 response, signing, payment, retry).
-     *
-     * @param url - API endpoint path (e.g., "/api/generate-image").
-     * @param body - Request body (will be JSON stringified).
-     * @returns Response data from the protected endpoint.
-     * @throws Error if wallet is not connected or payment fails.
-     */
-    postWithPayment<TResp = any>(url: string, body?: any): Promise<TResp>;
-}
-/**
- * Create a simplified Mantle payment client with auto-detected defaults.
- *
- * Usage:
- * ```typescript
- * const client = createMantleClient({
- *   getAccount: () => account?.address,
- *   getProvider: () => walletClient,
- * });
- *
- * const data = await client.postWithPayment("/api/generate", { prompt: "..." });
- * ```
- *
- * @param config - Optional configuration (auto-detects facilitatorUrl and resourceUrl).
- * @returns MantleClient instance with simplified postWithPayment() method.
- */
-declare function createMantleClient(config?: MantleClientConfig): MantleClient;
-
-export { type MantleClient as M, type MantleClientConfig as a, createMantleClient as c };

package/dist/createMantleClient-DS1Ghqrz.d.ts

@@ -1,51 +0,0 @@
-/**
- * Configuration for createMantleClient().
- * All fields are optional - the client auto-detects sensible defaults.
- */
-interface MantleClientConfig {
-    /** Optional facilitator URL (auto-detects from NEXT_PUBLIC_FACILITATOR_URL or defaults to localhost:8080). */
-    facilitatorUrl?: string;
-    /** Optional resource URL (defaults to current origin in browser, or empty string for relative paths). */
-    resourceUrl?: string;
-    /** Function to get user's wallet address (required for payments). */
-    getAccount?: () => Promise<string | undefined> | string | undefined;
-    /** Function to get wallet provider/client (e.g., viem WalletClient or window.ethereum). */
-    getProvider?: () => any;
-    /** Optional project key for hosted facilitator billing. */
-    projectKey?: string;
-}
-/**
- * Simplified Mantle payment client interface.
- * Provides a clean API for making paid POST requests.
- */
-interface MantleClient {
-    /**
-     * Make a paid POST request to a protected endpoint.
-     * Automatically handles x402 flow (402 response, signing, payment, retry).
-     *
-     * @param url - API endpoint path (e.g., "/api/generate-image").
-     * @param body - Request body (will be JSON stringified).
-     * @returns Response data from the protected endpoint.
-     * @throws Error if wallet is not connected or payment fails.
-     */
-    postWithPayment<TResp = any>(url: string, body?: any): Promise<TResp>;
-}
-/**
- * Create a simplified Mantle payment client with auto-detected defaults.
- *
- * Usage:
- * ```typescript
- * const client = createMantleClient({
- *   getAccount: () => account?.address,
- *   getProvider: () => walletClient,
- * });
- *
- * const data = await client.postWithPayment("/api/generate", { prompt: "..." });
- * ```
- *
- * @param config - Optional configuration (auto-detects facilitatorUrl and resourceUrl).
- * @returns MantleClient instance with simplified postWithPayment() method.
- */
-declare function createMantleClient(config?: MantleClientConfig): MantleClient;
-
-export { type MantleClient as M, type MantleClientConfig as a, createMantleClient as c };