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

package/dist/chunk-APBCF3SX.js

@@ -0,0 +1,179 @@
+import {
+  createMantleClient
+} from "./chunk-VNO4LJWC.js";
+
+// src/client/react/useEthersWallet.ts
+import { useState, useEffect, useCallback } from "react";
+import { ethers } from "ethers";
+function useEthersWallet(options) {
+  const [address, setAddress] = useState(void 0);
+  const [isConnected, setIsConnected] = useState(false);
+  const [provider, setProvider] = useState(
+    void 0
+  );
+  const [chainId, setChainId] = useState(void 0);
+  const [error, setError] = useState(void 0);
+  const setProviderAndChain = useCallback(async () => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    const browserProvider = new ethers.BrowserProvider(
+      window.ethereum
+    );
+    setProvider(browserProvider);
+    const network = await browserProvider.getNetwork();
+    setChainId(Number(network.chainId));
+  }, []);
+  const hydrateFromPermissions = useCallback(async () => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    try {
+      const accounts = await window.ethereum.request({
+        method: "eth_accounts"
+      });
+      if (accounts && accounts.length > 0) {
+        const userAddress = accounts[0];
+        setAddress(userAddress);
+        setIsConnected(true);
+        await setProviderAndChain();
+      }
+    } catch (err) {
+      console.warn("[useEthersWallet] Failed to hydrate from permissions:", err);
+    }
+  }, [setProviderAndChain]);
+  const connect = useCallback(async () => {
+    try {
+      setError(void 0);
+      if (typeof window === "undefined" || !window.ethereum) {
+        throw new Error(
+          "No Ethereum wallet detected. Please install MetaMask or another wallet."
+        );
+      }
+      const browserProvider = new ethers.BrowserProvider(
+        window.ethereum
+      );
+      setProvider(browserProvider);
+      const accounts = await window.ethereum.request({
+        method: "eth_requestAccounts"
+      });
+      if (!accounts || accounts.length === 0) {
+        throw new Error("No accounts returned from wallet");
+      }
+      const userAddress = accounts[0];
+      setAddress(userAddress);
+      setIsConnected(true);
+      const network = await browserProvider.getNetwork();
+      setChainId(Number(network.chainId));
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error(String(err));
+      setError(errorObj);
+      setIsConnected(false);
+      setAddress(void 0);
+      setChainId(void 0);
+      throw errorObj;
+    }
+  }, []);
+  const disconnect = useCallback(() => {
+    setAddress(void 0);
+    setIsConnected(false);
+    setChainId(void 0);
+    setError(void 0);
+  }, []);
+  useEffect(() => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    const ethereum = window.ethereum;
+    const handleAccountsChanged = (accounts) => {
+      const accountsArray = accounts;
+      if (!accountsArray || accountsArray.length === 0) {
+        disconnect();
+      } else {
+        setAddress(accountsArray[0]);
+        setIsConnected(true);
+        void setProviderAndChain();
+      }
+    };
+    if (ethereum.on) {
+      ethereum.on("accountsChanged", handleAccountsChanged);
+    }
+    return () => {
+      if (ethereum.removeListener) {
+        ethereum.removeListener("accountsChanged", handleAccountsChanged);
+      }
+    };
+  }, [disconnect, setProviderAndChain]);
+  useEffect(() => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    const ethereum = window.ethereum;
+    const handleConnect = () => {
+      void hydrateFromPermissions();
+    };
+    if (ethereum.on) {
+      ethereum.on("connect", handleConnect);
+    }
+    return () => {
+      if (ethereum.removeListener) {
+        ethereum.removeListener("connect", handleConnect);
+      }
+    };
+  }, [hydrateFromPermissions]);
+  useEffect(() => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    const ethereum = window.ethereum;
+    const handleChainChanged = (chainIdHex) => {
+      const newChainId = parseInt(chainIdHex, 16);
+      setChainId(newChainId);
+    };
+    if (ethereum.on) {
+      ethereum.on("chainChanged", handleChainChanged);
+    }
+    return () => {
+      if (ethereum.removeListener) {
+        ethereum.removeListener("chainChanged", handleChainChanged);
+      }
+    };
+  }, []);
+  useEffect(() => {
+    void hydrateFromPermissions();
+  }, [hydrateFromPermissions]);
+  useEffect(() => {
+    if (options?.autoConnect) {
+      connect().catch((err) => {
+        console.warn("[useEthersWallet] Auto-connect failed:", err);
+      });
+    }
+  }, [options?.autoConnect, connect]);
+  return {
+    address,
+    isConnected,
+    provider,
+    chainId,
+    connect,
+    disconnect,
+    error
+  };
+}
+
+// src/client/react/useMantleX402.ts
+function useMantleX402(opts) {
+  const { address, isConnected } = useEthersWallet({
+    autoConnect: opts?.autoConnect ?? false
+  });
+  const client = createMantleClient({
+    facilitatorUrl: opts?.facilitatorUrl,
+    resourceUrl: opts?.resourceUrl,
+    projectKey: opts?.projectKey,
+    getAccount: () => {
+      if (!isConnected || !address) return void 0;
+      return address;
+    },
+    getProvider: () => {
+      if (typeof window !== "undefined" && window.ethereum) {
+        return window.ethereum;
+      }
+      return void 0;
+    }
+  });
+  return client;
+}
+
+export {
+  useEthersWallet,
+  useMantleX402
+};

package/dist/chunk-VNO4LJWC.js

@@ -0,0 +1,286 @@
+import {
+  __require,
+  getChainIdForNetwork
+} from "./chunk-HEZZ74SI.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}`;
+}
+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, authorization, paymentRequirements) {
+  const { BrowserProvider } = await import("ethers");
+  const chainId = getChainIdForNetwork(paymentRequirements.network);
+  const browserProvider = new BrowserProvider(provider, chainId);
+  const signer = await browserProvider.getSigner();
+  const from = await signer.getAddress();
+  const authWithFrom = {
+    ...authorization,
+    from
+  };
+  const typedData = buildTypedDataForAuthorization(
+    authWithFrom,
+    paymentRequirements
+  );
+  const signature = await signer.signTypedData(
+    typedData.domain,
+    typedData.types,
+    typedData.message
+  );
+  return { signature, from };
+}
+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 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: "0x0000000000000000000000000000000000000000",
+        to: paymentRequirements.payTo,
+        value: valueAtomic,
+        validAfter,
+        validBefore,
+        nonce
+      };
+      const { signature, from } = await signAuthorizationWithProvider(
+        provider,
+        authorization,
+        paymentRequirements
+      );
+      authorization = {
+        ...authorization,
+        from
+      };
+      if (userAddressOverride && userAddressOverride.toLowerCase() !== from.toLowerCase()) {
+        console.warn(
+          "[SDK WARNING] userAddress override differs from signer address",
+          { override: userAddressOverride, signer: 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 provider = config?.getProvider?.();
+      if (!provider) {
+        throw new Error("Wallet provider not available");
+      }
+      let account = await config?.getAccount?.();
+      if (!account && provider?.request) {
+        try {
+          const accounts = await provider.request({
+            method: "eth_accounts"
+          });
+          if (Array.isArray(accounts) && accounts.length > 0) {
+            account = accounts[0];
+          }
+        } catch (err) {
+          console.warn("[x402] Failed to hydrate account from provider:", err);
+        }
+      }
+      if (!account) {
+        throw new Error(
+          "Wallet not connected. Please connect your wallet first."
+        );
+      }
+      const client = createPaymentClient({
+        resourceUrl,
+        facilitatorUrl,
+        provider,
+        userAddress: account,
+        projectKey: config?.projectKey
+      });
+      const result = await client.callWithPayment(url, {
+        method: "POST",
+        body
+      });
+      return result;
+    }
+  };
+}
+
+export {
+  createPaymentClient,
+  createMantleClient
+};

package/dist/client.cjs

@@ -295,16 +295,28 @@ function createMantleClient(config) {
   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?.();
+      const provider = config?.getProvider?.();
+      if (!provider) {
+        throw new Error("Wallet provider not available");
+      }
+      let account = await config?.getAccount?.();
+      if (!account && provider?.request) {
+        try {
+          const accounts = await provider.request({
+            method: "eth_accounts"
+          });
+          if (Array.isArray(accounts) && accounts.length > 0) {
+            account = accounts[0];
+          }
+        } catch (err) {
+          console.warn("[x402] Failed to hydrate account from provider:", err);
+        }
+      }
       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,

package/dist/client.js

@@ -1,7 +1,7 @@
 import {
   createMantleClient,
   createPaymentClient
-} from "./chunk-E46A7I6B.js";
+} from "./chunk-VNO4LJWC.js";
 import {
   MANTLE_DEFAULTS
 } from "./chunk-HEZZ74SI.js";

package/dist/index.cjs

@@ -622,16 +622,28 @@ function createMantleClient(config) {
   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?.();
+      const provider = config?.getProvider?.();
+      if (!provider) {
+        throw new Error("Wallet provider not available");
+      }
+      let account = await config?.getAccount?.();
+      if (!account && provider?.request) {
+        try {
+          const accounts = await provider.request({
+            method: "eth_accounts"
+          });
+          if (Array.isArray(accounts) && accounts.length > 0) {
+            account = accounts[0];
+          }
+        } catch (err) {
+          console.warn("[x402] Failed to hydrate account from provider:", err);
+        }
+      }
       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,
@@ -659,6 +671,31 @@ function useEthersWallet(options) {
   );
   const [chainId, setChainId] = (0, import_react.useState)(void 0);
   const [error, setError] = (0, import_react.useState)(void 0);
+  const setProviderAndChain = (0, import_react.useCallback)(async () => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    const browserProvider = new import_ethers.ethers.BrowserProvider(
+      window.ethereum
+    );
+    setProvider(browserProvider);
+    const network = await browserProvider.getNetwork();
+    setChainId(Number(network.chainId));
+  }, []);
+  const hydrateFromPermissions = (0, import_react.useCallback)(async () => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    try {
+      const accounts = await window.ethereum.request({
+        method: "eth_accounts"
+      });
+      if (accounts && accounts.length > 0) {
+        const userAddress = accounts[0];
+        setAddress(userAddress);
+        setIsConnected(true);
+        await setProviderAndChain();
+      }
+    } catch (err) {
+      console.warn("[useEthersWallet] Failed to hydrate from permissions:", err);
+    }
+  }, [setProviderAndChain]);
   const connect = (0, import_react.useCallback)(async () => {
     try {
       setError(void 0);
@@ -707,6 +744,7 @@ function useEthersWallet(options) {
       } else {
         setAddress(accountsArray[0]);
         setIsConnected(true);
+        void setProviderAndChain();
       }
     };
     if (ethereum.on) {
@@ -717,7 +755,22 @@ function useEthersWallet(options) {
         ethereum.removeListener("accountsChanged", handleAccountsChanged);
       }
     };
-  }, [disconnect]);
+  }, [disconnect, setProviderAndChain]);
+  (0, import_react.useEffect)(() => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    const ethereum = window.ethereum;
+    const handleConnect = () => {
+      void hydrateFromPermissions();
+    };
+    if (ethereum.on) {
+      ethereum.on("connect", handleConnect);
+    }
+    return () => {
+      if (ethereum.removeListener) {
+        ethereum.removeListener("connect", handleConnect);
+      }
+    };
+  }, [hydrateFromPermissions]);
   (0, import_react.useEffect)(() => {
     if (typeof window === "undefined" || !window.ethereum) return;
     const ethereum = window.ethereum;
@@ -734,14 +787,16 @@ function useEthersWallet(options) {
       }
     };
   }, []);
-  const shouldAutoConnect = options?.autoConnect !== false;
   (0, import_react.useEffect)(() => {
-    if (shouldAutoConnect) {
+    void hydrateFromPermissions();
+  }, [hydrateFromPermissions]);
+  (0, import_react.useEffect)(() => {
+    if (options?.autoConnect) {
       connect().catch((err) => {
         console.warn("[useEthersWallet] Auto-connect failed:", err);
       });
     }
-  }, [shouldAutoConnect, connect]);
+  }, [options?.autoConnect, connect]);
   return {
     address,
     isConnected,

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   useEthersWallet,
   useMantleX402
-} from "./chunk-23QNUJIB.js";
+} from "./chunk-APBCF3SX.js";
 import {
   createMantleClient,
   createPaymentClient
-} from "./chunk-E46A7I6B.js";
+} from "./chunk-VNO4LJWC.js";
 import "./chunk-WO2MYZXT.js";
 import {
   createPaymentMiddleware,

package/dist/nextjs-CGOVHJXl.d.cts

@@ -0,0 +1,89 @@
+import { NextRequest } from 'next/server';
+import { M as MinimalPaywallOptions } from './types-CrOsOHcX.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-w61gRvpz.d.ts

@@ -0,0 +1,89 @@
+import { NextRequest } from 'next/server';
+import { M as MinimalPaywallOptions } from './types-CqQ6OgRi.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

@@ -46,6 +46,31 @@ function useEthersWallet(options) {
   );
   const [chainId, setChainId] = (0, import_react.useState)(void 0);
   const [error, setError] = (0, import_react.useState)(void 0);
+  const setProviderAndChain = (0, import_react.useCallback)(async () => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    const browserProvider = new import_ethers.ethers.BrowserProvider(
+      window.ethereum
+    );
+    setProvider(browserProvider);
+    const network = await browserProvider.getNetwork();
+    setChainId(Number(network.chainId));
+  }, []);
+  const hydrateFromPermissions = (0, import_react.useCallback)(async () => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    try {
+      const accounts = await window.ethereum.request({
+        method: "eth_accounts"
+      });
+      if (accounts && accounts.length > 0) {
+        const userAddress = accounts[0];
+        setAddress(userAddress);
+        setIsConnected(true);
+        await setProviderAndChain();
+      }
+    } catch (err) {
+      console.warn("[useEthersWallet] Failed to hydrate from permissions:", err);
+    }
+  }, [setProviderAndChain]);
   const connect = (0, import_react.useCallback)(async () => {
     try {
       setError(void 0);
@@ -94,6 +119,7 @@ function useEthersWallet(options) {
       } else {
         setAddress(accountsArray[0]);
         setIsConnected(true);
+        void setProviderAndChain();
       }
     };
     if (ethereum.on) {
@@ -104,7 +130,22 @@ function useEthersWallet(options) {
         ethereum.removeListener("accountsChanged", handleAccountsChanged);
       }
     };
-  }, [disconnect]);
+  }, [disconnect, setProviderAndChain]);
+  (0, import_react.useEffect)(() => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    const ethereum = window.ethereum;
+    const handleConnect = () => {
+      void hydrateFromPermissions();
+    };
+    if (ethereum.on) {
+      ethereum.on("connect", handleConnect);
+    }
+    return () => {
+      if (ethereum.removeListener) {
+        ethereum.removeListener("connect", handleConnect);
+      }
+    };
+  }, [hydrateFromPermissions]);
   (0, import_react.useEffect)(() => {
     if (typeof window === "undefined" || !window.ethereum) return;
     const ethereum = window.ethereum;
@@ -121,14 +162,16 @@ function useEthersWallet(options) {
       }
     };
   }, []);
-  const shouldAutoConnect = options?.autoConnect !== false;
   (0, import_react.useEffect)(() => {
-    if (shouldAutoConnect) {
+    void hydrateFromPermissions();
+  }, [hydrateFromPermissions]);
+  (0, import_react.useEffect)(() => {
+    if (options?.autoConnect) {
       connect().catch((err) => {
         console.warn("[useEthersWallet] Auto-connect failed:", err);
       });
     }
-  }, [shouldAutoConnect, connect]);
+  }, [options?.autoConnect, connect]);
   return {
     address,
     isConnected,
@@ -399,16 +442,28 @@ function createMantleClient(config) {
   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?.();
+      const provider = config?.getProvider?.();
+      if (!provider) {
+        throw new Error("Wallet provider not available");
+      }
+      let account = await config?.getAccount?.();
+      if (!account && provider?.request) {
+        try {
+          const accounts = await provider.request({
+            method: "eth_accounts"
+          });
+          if (Array.isArray(accounts) && accounts.length > 0) {
+            account = accounts[0];
+          }
+        } catch (err) {
+          console.warn("[x402] Failed to hydrate account from provider:", err);
+        }
+      }
       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,

package/dist/react.d.cts

@@ -44,7 +44,7 @@ declare function useMantleX402(opts?: UseMantleX402Options): MantleClient;
 interface UseEthersWalletOptions {
     /**
      * Auto-connect to existing MetaMask connection on mount.
-     * @default true
+     * @default false
      */
     autoConnect?: boolean;
 }

package/dist/react.d.ts

@@ -44,7 +44,7 @@ declare function useMantleX402(opts?: UseMantleX402Options): MantleClient;
 interface UseEthersWalletOptions {
     /**
      * Auto-connect to existing MetaMask connection on mount.
-     * @default true
+     * @default false
      */
     autoConnect?: boolean;
 }

package/dist/react.js

@@ -1,8 +1,8 @@
 import {
   useEthersWallet,
   useMantleX402
-} from "./chunk-23QNUJIB.js";
-import "./chunk-E46A7I6B.js";
+} from "./chunk-APBCF3SX.js";
+import "./chunk-VNO4LJWC.js";
 import "./chunk-HEZZ74SI.js";
 export {
   useEthersWallet,

package/dist/server-nextjs.d.cts

@@ -1,4 +1,4 @@
-export { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-CY13JXkV.cjs';
+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 { 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-nextjs.d.ts

@@ -1,4 +1,4 @@
-export { N as NextJSHandler, a as NextJSPaywallWrapper, P as PaywallErrorResponse, i as isPaywallErrorResponse, m as mantlePaywall } from './nextjs-BgyAWzT3.js';
+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 { 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.d.cts

@@ -2,7 +2,7 @@ import { c as PaymentCheckInput, d as PaymentCheckResult } from './types-CrOsOHc
 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-CY13JXkV.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';
 import 'express';

package/dist/server.d.ts

@@ -2,7 +2,7 @@ import { c as PaymentCheckInput, d as PaymentCheckResult } from './types-CqQ6OgR
 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-BgyAWzT3.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';
 import 'express';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puga-labs/x402-mantle-sdk",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "x402 payments SDK for Mantle (USDC, gasless, facilitator-based)",
   "license": "MIT",
   "author": "Evgenii Pugachev <cyprus.pugamuga@gmail.com>",