@armory-sh/base 0.2.27-alpha.23.76 → 0.2.27-alpha.23.78

package/dist/index.js

@@ -1,385 +1,161 @@
 import { randomBytes } from 'crypto';
 
-// src/types/x402.ts
-var X402_VERSION = 2;
-var SCHEMES = ["exact"];
-function isPaymentPayload(obj) {
-  return typeof obj === "object" && obj !== null && "x402Version" in obj && "accepted" in obj && "payload" in obj;
-}
-function isExactEvmPayload(obj) {
-  return typeof obj === "object" && obj !== null && "signature" in obj && "authorization" in obj;
-}
-
-// src/types/v2.ts
-var V2_HEADERS = {
-  PAYMENT_SIGNATURE: "PAYMENT-SIGNATURE",
-  PAYMENT_REQUIRED: "PAYMENT-REQUIRED",
-  PAYMENT_RESPONSE: "PAYMENT-RESPONSE"
-};
-function isCAIP2ChainId(value) {
-  return /^eip155:\d+$/.test(value);
-}
-function isCAIPAssetId(value) {
-  return /^eip155:\d+\/erc20:0x[a-fA-F0-9]+$/.test(value);
-}
-function isAddress(value) {
-  return /^0x[a-fA-F0-9]{40}$/.test(value);
-}
-function isPaymentRequiredV2(obj) {
-  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "resource" in obj && "accepts" in obj && Array.isArray(obj.accepts);
-}
-function isPaymentPayloadV2(obj) {
-  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "accepted" in obj && "payload" in obj;
-}
-function assetIdToAddress(assetId) {
-  const match = assetId.match(/\/erc20:(0x[a-fA-F0-9]{40})$/);
-  if (!match) throw new Error(`Invalid CAIP asset ID: ${assetId}`);
-  return match[1];
-}
-function addressToAssetId(address, chainId) {
-  const chain = typeof chainId === "number" ? `eip155:${chainId}` : chainId;
-  if (!isCAIP2ChainId(chain)) throw new Error(`Invalid chain ID: ${chain}`);
-  return `${chain}/erc20:${address}`;
-}
-function parseSignature(signature) {
-  const sig = signature.slice(2);
-  return {
-    r: `0x${sig.slice(0, 64)}`,
-    s: `0x${sig.slice(64, 128)}`,
-    v: parseInt(sig.slice(128, 130), 16)
-  };
-}
-function combineSignature(v, r, s) {
-  const rClean = r.startsWith("0x") ? r.slice(2) : r;
-  const sClean = s.startsWith("0x") ? s.slice(2) : s;
-  const vHex = v.toString(16).padStart(2, "0");
-  return `0x${rClean}${sClean}${vHex}`;
-}
+// src/abi/erc20.ts
+var ERC20_ABI = [
+  {
+    type: "function",
+    name: "transferWithAuthorization",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "from", type: "address" },
+      { name: "to", type: "address" },
+      { name: "amount", type: "uint256" },
+      { name: "validAfter", type: "uint256" },
+      { name: "expiry", type: "uint256" },
+      { name: "v", type: "uint8" },
+      { name: "r", type: "bytes32" },
+      { name: "s", type: "bytes32" }
+    ],
+    outputs: []
+  },
+  {
+    type: "function",
+    name: "receiveWithAuthorization",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "from", type: "address" },
+      { name: "to", type: "address" },
+      { name: "amount", type: "uint256" },
+      { name: "validAfter", type: "uint256" },
+      { name: "expiry", type: "uint256" },
+      { name: "v", type: "uint8" },
+      { name: "r", type: "bytes32" },
+      { name: "s", type: "bytes32" }
+    ],
+    outputs: []
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "balance", type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "name",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }]
+  },
+  {
+    type: "function",
+    name: "symbol",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }]
+  }
+];
 
-// src/utils/base64.ts
-var textEncoder = new TextEncoder();
-var textDecoder = new TextDecoder();
-function toBase64(bytes) {
-  if (typeof btoa === "function") {
-    let binary = "";
-    for (let index = 0; index < bytes.length; index += 1) {
-      binary += String.fromCharCode(bytes[index]);
-    }
-    return btoa(binary);
+// src/client-hooks-runtime.ts
+var notifyError = async (hooks, context) => {
+  if (!hooks?.length) {
+    return;
   }
-  throw new Error("No base64 encoder available in this runtime");
-}
-function fromBase64(base64) {
-  if (typeof atob === "function") {
-    const binary = atob(base64);
-    const bytes = new Uint8Array(binary.length);
-    for (let index = 0; index < binary.length; index += 1) {
-      bytes[index] = binary.charCodeAt(index);
+  for (const hook of hooks) {
+    if (!hook.onError) {
+      continue;
     }
-    return bytes;
+    await hook.onError(context);
   }
-  throw new Error("No base64 decoder available in this runtime");
-}
-function encodeUtf8ToBase64(value) {
-  const bytes = textEncoder.encode(value);
-  return toBase64(bytes);
-}
-function decodeBase64ToUtf8(value) {
-  const bytes = fromBase64(value);
-  return textDecoder.decode(bytes);
-}
-function toBase64Url(base64) {
-  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
-}
-function normalizeBase64Url(value) {
-  return value.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(value.length / 4) * 4, "=");
-}
-
-// src/encoding/x402.ts
-function safeBase64Encode(str) {
-  return toBase64Url(encodeUtf8ToBase64(str));
-}
-function safeBase64Decode(str) {
-  return decodeBase64ToUtf8(normalizeBase64Url(str));
-}
-function encodePayment(payload) {
-  if (!isPaymentPayload(payload)) {
-    throw new Error("Invalid payment payload format");
+};
+var runOnPaymentRequiredHooks = async (hooks, context) => {
+  if (!hooks?.length) {
+    return;
   }
-  const safePayload = JSON.parse(JSON.stringify(payload, (_, value) => {
-    if (typeof value === "bigint") {
-      return value.toString();
+  for (const hook of hooks) {
+    if (!hook.onPaymentRequired) {
+      continue;
+    }
+    try {
+      await hook.onPaymentRequired(context);
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "onPaymentRequired" });
+      throw error;
     }
-    return value;
-  }));
-  return safeBase64Encode(JSON.stringify(safePayload));
-}
-function decodePayment(encoded) {
-  let parsed;
-  try {
-    parsed = JSON.parse(encoded);
-  } catch {
-    const decoded = safeBase64Decode(encoded);
-    parsed = JSON.parse(decoded);
-  }
-  if (!isPaymentPayload(parsed)) {
-    throw new Error("Invalid payment payload format");
   }
-  return parsed;
-}
-function encodeSettlementResponse(response) {
-  const safeResponse = JSON.parse(JSON.stringify(response, (_, value) => {
-    if (typeof value === "bigint") {
-      return value.toString();
+};
+var selectRequirementWithHooks = async (hooks, context) => {
+  if (!context.accepts.length) {
+    throw new Error("No payment requirements found in accepts array");
+  }
+  let selected = context.accepts[0];
+  if (!hooks?.length) {
+    context.selectedRequirement = selected;
+    context.requirements = selected;
+    return selected;
+  }
+  for (const hook of hooks) {
+    if (!hook.selectRequirement) {
+      continue;
+    }
+    try {
+      const override = await hook.selectRequirement({
+        ...context,
+        selectedRequirement: selected,
+        requirements: selected
+      });
+      if (!override) {
+        continue;
+      }
+      const isValid = context.accepts.some((accept) => accept === override);
+      if (!isValid) {
+        throw new Error(
+          "Hook selectRequirement must return an item from accepts"
+        );
+      }
+      selected = override;
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "selectRequirement" });
+      throw error;
     }
-    return value;
-  }));
-  return safeBase64Encode(JSON.stringify(safeResponse));
-}
-function decodeSettlementResponse(encoded) {
-  try {
-    return JSON.parse(encoded);
-  } catch {
-    const decoded = safeBase64Decode(encoded);
-    return JSON.parse(decoded);
   }
-}
-function encodeX402Response(response) {
-  return safeBase64Encode(JSON.stringify(response));
-}
-function decodeX402Response(encoded) {
-  try {
-    return JSON.parse(encoded);
-  } catch {
-    const decoded = safeBase64Decode(encoded);
-    return JSON.parse(decoded);
+  context.selectedRequirement = selected;
+  context.requirements = selected;
+  return selected;
+};
+var runBeforeSignPaymentHooks = async (hooks, context) => {
+  if (!hooks?.length) {
+    return;
   }
-}
-function detectPaymentVersion(headers) {
-  if (headers.has("PAYMENT-SIGNATURE")) {
-    return 2;
+  for (const hook of hooks) {
+    if (!hook.beforeSignPayment) {
+      continue;
+    }
+    try {
+      await hook.beforeSignPayment(context);
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "beforeSignPayment" });
+      throw error;
+    }
   }
-  return null;
-}
-function extractPaymentFromHeaders(headers) {
-  const encoded = headers.get("PAYMENT-SIGNATURE");
-  if (!encoded) return null;
-  try {
-    return decodePayment(encoded);
-  } catch {
-    return null;
+};
+var runAfterPaymentResponseHooks = async (hooks, context) => {
+  if (!hooks?.length) {
+    return;
   }
-}
-function createPaymentRequiredHeaders(requirements, options) {
-  const accepts = Array.isArray(requirements) ? requirements : [requirements];
-  const response = {
-    x402Version: 2,
-    error: options?.error ?? "Payment required",
-    resource: options?.resource ?? { url: "", mimeType: "application/json" },
-    accepts,
-    extensions: options?.extensions ?? {}
-  };
-  return {
-    [V2_HEADERS.PAYMENT_REQUIRED]: safeBase64Encode(JSON.stringify(response))
-  };
-}
-function createSettlementHeaders(settlement) {
-  return {
-    [V2_HEADERS.PAYMENT_RESPONSE]: encodeSettlementResponse(settlement)
-  };
-}
-function createNonce() {
-  const bytes = randomBytes(32);
-  return `0x${bytes.toString("hex")}`;
-}
-function toAtomicUnits(amount, decimals = 6) {
-  const parts = amount.split(".");
-  const whole = parts[0];
-  const fractional = parts[1] || "";
-  const paddedFractional = fractional.padEnd(decimals, "0").slice(0, decimals);
-  return `${whole}${paddedFractional}`;
-}
-function fromAtomicUnits(amount, decimals = 6) {
-  const value = BigInt(amount);
-  const divisor = BigInt(10 ** decimals);
-  const whole = (value / divisor).toString();
-  const fractional = (value % divisor).toString().padStart(decimals, "0").replace(/0+$/, "");
-  if (fractional.length === 0) {
-    return whole;
+  for (const hook of hooks) {
+    if (!hook.afterPaymentResponse) {
+      continue;
+    }
+    try {
+      await hook.afterPaymentResponse(context);
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "afterPaymentResponse" });
+      throw error;
+    }
   }
-  return `${whole}.${fractional}`;
-}
-function caip2ToNetwork(caip2Id) {
-  const match = caip2Id.match(/^eip155:(\d+)$/);
-  if (!match) {
-    return caip2Id;
-  }
-  const chainId = parseInt(match[1], 10);
-  const chainIdToNetwork = {
-    1: "ethereum",
-    8453: "base",
-    84532: "base-sepolia",
-    137: "polygon",
-    42161: "arbitrum",
-    421614: "arbitrum-sepolia",
-    10: "optimism",
-    11155420: "optimism-sepolia",
-    11155111: "ethereum-sepolia"
-  };
-  return chainIdToNetwork[chainId] || caip2Id;
-}
-function networkToCaip2(network) {
-  const networkToChainId = {
-    ethereum: 1,
-    base: 8453,
-    "base-sepolia": 84532,
-    polygon: 137,
-    arbitrum: 42161,
-    "arbitrum-sepolia": 421614,
-    optimism: 10,
-    "optimism-sepolia": 11155420,
-    "ethereum-sepolia": 11155111
-  };
-  const chainId = networkToChainId[network];
-  if (chainId) {
-    return `eip155:${chainId}`;
-  }
-  if (network.startsWith("eip155:")) {
-    return network;
-  }
-  return `eip155:0`;
-}
-function getCurrentTimestamp() {
-  return Math.floor(Date.now() / 1e3);
-}
-function isValidAddress(address) {
-  return /^0x[a-fA-F0-9]{40}$/.test(address);
-}
-function normalizeAddress(address) {
-  return address.toLowerCase();
-}
-
-// src/types/protocol.ts
-function isX402V2Payload(obj) {
-  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "accepted" in obj && "payload" in obj;
-}
-function isX402V2Requirements(obj) {
-  return typeof obj === "object" && obj !== null && "scheme" in obj && obj.scheme === "exact" && "network" in obj && typeof obj.network === "string" && obj.network.startsWith("eip155:") && // CAIP-2 format
-  "amount" in obj && "asset" in obj && "payTo" in obj && "maxTimeoutSeconds" in obj;
-}
-function isX402V2Settlement(obj) {
-  return typeof obj === "object" && obj !== null && "success" in obj && typeof obj.success === "boolean" && "network" in obj && typeof obj.network === "string" && obj.network.startsWith("eip155:");
-}
-function isX402V2PaymentRequired(obj) {
-  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "resource" in obj && "accepts" in obj;
-}
-var PAYMENT_SIGNATURE_HEADER = "PAYMENT-SIGNATURE";
-var PAYMENT_RESPONSE_HEADER = "PAYMENT-RESPONSE";
-var PAYMENT_REQUIRED_HEADER = "PAYMENT-REQUIRED";
-function isSettlementSuccessful(response) {
-  return "success" in response ? response.success : false;
-}
-function getTxHash(response) {
-  if ("transaction" in response) return response.transaction;
-  return void 0;
-}
-
-// src/types/networks.ts
-var isEvmAddress = (value) => /^0x[a-fA-F0-9]{40}$/.test(value);
-var tokenRegistry = /* @__PURE__ */ new Map();
-var tokenKey = (chainId, contractAddress) => `${chainId}:${contractAddress.toLowerCase()}`;
-var NETWORKS = {
-  ethereum: {
-    name: "Ethereum Mainnet",
-    chainId: 1,
-    usdcAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
-    rpcUrl: "https://eth.llamarpc.com",
-    caip2Id: "eip155:1",
-    caipAssetId: "eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
-  },
-  base: {
-    name: "Base Mainnet",
-    chainId: 8453,
-    usdcAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-    rpcUrl: "https://mainnet.base.org",
-    caip2Id: "eip155:8453",
-    caipAssetId: "eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
-  },
-  "base-sepolia": {
-    name: "Base Sepolia",
-    chainId: 84532,
-    usdcAddress: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
-    rpcUrl: "https://sepolia.base.org",
-    caip2Id: "eip155:84532",
-    caipAssetId: "eip155:84532/erc20:0x036CbD53842c5426634e7929541eC2318f3dCF7e"
-  },
-  "skale-base": {
-    name: "SKALE Base",
-    chainId: 1187947933,
-    usdcAddress: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
-    rpcUrl: "https://skale-base.skalenodes.com/v1/base",
-    caip2Id: "eip155:1187947933",
-    caipAssetId: "eip155:1187947933/erc20:0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20"
-  },
-  "skale-base-sepolia": {
-    name: "SKALE Base Sepolia",
-    chainId: 324705682,
-    usdcAddress: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
-    rpcUrl: "https://base-sepolia-testnet.skalenodes.com/v1/jubilant-horrible-ancha",
-    caip2Id: "eip155:324705682",
-    caipAssetId: "eip155:324705682/erc20:0x2e08028E3C4c2356572E096d8EF835cD5C6030bD"
-  },
-  "ethereum-sepolia": {
-    name: "Ethereum Sepolia",
-    chainId: 11155111,
-    usdcAddress: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
-    rpcUrl: "https://rpc.sepolia.org",
-    caip2Id: "eip155:11155111",
-    caipAssetId: "eip155:11155111/erc20:0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"
-  }
-};
-var getNetworkConfig = (name) => NETWORKS[name];
-var getNetworkByChainId = (chainId) => Object.values(NETWORKS).find((c) => c.chainId === chainId);
-var getMainnets = () => Object.values(NETWORKS).filter((c) => !c.name.toLowerCase().includes("sepolia"));
-var getTestnets = () => Object.values(NETWORKS).filter((c) => c.name.toLowerCase().includes("sepolia"));
-var registerToken = (token) => {
-  if (typeof token !== "object" || token === null) {
-    throw new Error("Invalid token: must be an object");
-  }
-  const t = token;
-  if (typeof t.symbol !== "string") {
-    throw new Error("Invalid token: symbol must be a string");
-  }
-  if (typeof t.name !== "string") {
-    throw new Error("Invalid token: name must be a string");
-  }
-  if (typeof t.version !== "string") {
-    throw new Error("Invalid token: version must be a string");
-  }
-  if (typeof t.contractAddress !== "string" || !isEvmAddress(t.contractAddress)) {
-    throw new Error("Invalid token: contractAddress must be a valid EVM address");
-  }
-  if (typeof t.chainId !== "number" || !Number.isInteger(t.chainId) || t.chainId <= 0) {
-    throw new Error("Invalid token: chainId must be a positive integer");
-  }
-  if (t.decimals !== void 0 && (typeof t.decimals !== "number" || !Number.isInteger(t.decimals) || t.decimals < 0)) {
-    throw new Error("Invalid token: decimals must be a non-negative integer");
-  }
-  const validated = {
-    symbol: t.symbol,
-    name: t.name,
-    version: t.version,
-    contractAddress: t.contractAddress,
-    chainId: t.chainId,
-    decimals: t.decimals
-  };
-  tokenRegistry.set(tokenKey(validated.chainId, validated.contractAddress), validated);
-  return validated;
 };
-var getCustomToken = (chainId, contractAddress) => tokenRegistry.get(tokenKey(chainId, contractAddress));
-var getAllCustomTokens = () => Array.from(tokenRegistry.values());
-var unregisterToken = (chainId, contractAddress) => tokenRegistry.delete(tokenKey(chainId, contractAddress));
-var isCustomToken = (chainId, contractAddress) => tokenRegistry.has(tokenKey(chainId, contractAddress));
 
 // src/data/tokens.ts
 var USDC_BASE = {
@@ -511,7 +287,9 @@ function getAllTokens() {
   return Object.values(TOKENS);
 }
 function getTokensBySymbol(symbol) {
-  return getAllTokens().filter((t) => t.symbol.toUpperCase() === symbol.toUpperCase());
+  return getAllTokens().filter(
+    (t) => t.symbol.toUpperCase() === symbol.toUpperCase()
+  );
 }
 function getTokensByChain(chainId) {
   return getAllTokens().filter((t) => t.chainId === chainId);
@@ -535,63 +313,6 @@ function getWETHTokens() {
   return getTokensBySymbol("WETH");
 }
 
-// src/abi/erc20.ts
-var ERC20_ABI = [
-  {
-    type: "function",
-    name: "transferWithAuthorization",
-    stateMutability: "nonpayable",
-    inputs: [
-      { name: "from", type: "address" },
-      { name: "to", type: "address" },
-      { name: "amount", type: "uint256" },
-      { name: "validAfter", type: "uint256" },
-      { name: "expiry", type: "uint256" },
-      { name: "v", type: "uint8" },
-      { name: "r", type: "bytes32" },
-      { name: "s", type: "bytes32" }
-    ],
-    outputs: []
-  },
-  {
-    type: "function",
-    name: "receiveWithAuthorization",
-    stateMutability: "nonpayable",
-    inputs: [
-      { name: "from", type: "address" },
-      { name: "to", type: "address" },
-      { name: "amount", type: "uint256" },
-      { name: "validAfter", type: "uint256" },
-      { name: "expiry", type: "uint256" },
-      { name: "v", type: "uint8" },
-      { name: "r", type: "bytes32" },
-      { name: "s", type: "bytes32" }
-    ],
-    outputs: []
-  },
-  {
-    type: "function",
-    name: "balanceOf",
-    stateMutability: "view",
-    inputs: [{ name: "account", type: "address" }],
-    outputs: [{ name: "balance", type: "uint256" }]
-  },
-  {
-    type: "function",
-    name: "name",
-    stateMutability: "view",
-    inputs: [],
-    outputs: [{ name: "", type: "string" }]
-  },
-  {
-    type: "function",
-    name: "symbol",
-    stateMutability: "view",
-    inputs: [],
-    outputs: [{ name: "", type: "string" }]
-  }
-];
-
 // src/eip712.ts
 var EIP712_TYPES = {
   TransferWithAuthorization: [
@@ -621,20 +342,566 @@ var createTransferWithAuthorization = (params) => ({
   validBefore: BigInt(params.validBefore),
   nonce: params.nonce
 });
-var isAddress2 = (value) => /^0x[a-fA-F0-9]{40}$/.test(value);
+var isAddress = (value) => /^0x[a-fA-F0-9]{40}$/.test(value);
 var isBytes32 = (value) => /^0x[a-fA-F0-9]{64}$/.test(value);
 var validateTransferWithAuthorization = (message) => {
-  if (!isAddress2(message.from)) throw new Error(`Invalid "from" address: ${message.from}`);
-  if (!isAddress2(message.to)) throw new Error(`Invalid "to" address: ${message.to}`);
-  if (message.value < 0n) throw new Error(`"value" must be non-negative: ${message.value}`);
-  if (message.validAfter < 0n) throw new Error(`"validAfter" must be non-negative: ${message.validAfter}`);
-  if (message.validBefore < 0n) throw new Error(`"validBefore" must be non-negative: ${message.validBefore}`);
+  if (!isAddress(message.from))
+    throw new Error(`Invalid "from" address: ${message.from}`);
+  if (!isAddress(message.to))
+    throw new Error(`Invalid "to" address: ${message.to}`);
+  if (message.value < 0n)
+    throw new Error(`"value" must be non-negative: ${message.value}`);
+  if (message.validAfter < 0n)
+    throw new Error(`"validAfter" must be non-negative: ${message.validAfter}`);
+  if (message.validBefore < 0n)
+    throw new Error(
+      `"validBefore" must be non-negative: ${message.validBefore}`
+    );
   if (message.validAfter >= message.validBefore) {
-    throw new Error(`"validAfter" (${message.validAfter}) must be before "validBefore" (${message.validBefore})`);
+    throw new Error(
+      `"validAfter" (${message.validAfter}) must be before "validBefore" (${message.validBefore})`
+    );
+  }
+  if (!isBytes32(message.nonce))
+    throw new Error(
+      `"nonce" must be a valid bytes32 hex string: ${message.nonce}`
+    );
+  return true;
+};
+
+// src/types/v2.ts
+var V2_HEADERS = {
+  PAYMENT_SIGNATURE: "PAYMENT-SIGNATURE",
+  PAYMENT_REQUIRED: "PAYMENT-REQUIRED",
+  PAYMENT_RESPONSE: "PAYMENT-RESPONSE"
+};
+function isCAIP2ChainId(value) {
+  return /^eip155:\d+$/.test(value);
+}
+function isCAIPAssetId(value) {
+  return /^eip155:\d+\/erc20:0x[a-fA-F0-9]+$/.test(value);
+}
+function isAddress2(value) {
+  return /^0x[a-fA-F0-9]{40}$/.test(value);
+}
+function isPaymentRequiredV2(obj) {
+  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "resource" in obj && "accepts" in obj && Array.isArray(obj.accepts);
+}
+function isPaymentPayloadV2(obj) {
+  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "accepted" in obj && "payload" in obj;
+}
+function assetIdToAddress(assetId) {
+  const match = assetId.match(/\/erc20:(0x[a-fA-F0-9]{40})$/);
+  if (!match) throw new Error(`Invalid CAIP asset ID: ${assetId}`);
+  return match[1];
+}
+function addressToAssetId(address, chainId) {
+  const chain = typeof chainId === "number" ? `eip155:${chainId}` : chainId;
+  if (!isCAIP2ChainId(chain)) throw new Error(`Invalid chain ID: ${chain}`);
+  return `${chain}/erc20:${address}`;
+}
+function parseSignature(signature) {
+  const sig = signature.slice(2);
+  return {
+    r: `0x${sig.slice(0, 64)}`,
+    s: `0x${sig.slice(64, 128)}`,
+    v: parseInt(sig.slice(128, 130), 16)
+  };
+}
+function combineSignature(v, r, s) {
+  const rClean = r.startsWith("0x") ? r.slice(2) : r;
+  const sClean = s.startsWith("0x") ? s.slice(2) : s;
+  const vHex = v.toString(16).padStart(2, "0");
+  return `0x${rClean}${sClean}${vHex}`;
+}
+
+// src/utils/base64.ts
+var textEncoder = new TextEncoder();
+var textDecoder = new TextDecoder();
+function toBase64(bytes) {
+  if (typeof btoa === "function") {
+    let binary = "";
+    for (let index = 0; index < bytes.length; index += 1) {
+      binary += String.fromCharCode(bytes[index]);
+    }
+    return btoa(binary);
+  }
+  throw new Error("No base64 encoder available in this runtime");
+}
+function fromBase64(base64) {
+  if (typeof atob === "function") {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1) {
+      bytes[index] = binary.charCodeAt(index);
+    }
+    return bytes;
+  }
+  throw new Error("No base64 decoder available in this runtime");
+}
+function encodeUtf8ToBase64(value) {
+  const bytes = textEncoder.encode(value);
+  return toBase64(bytes);
+}
+function decodeBase64ToUtf8(value) {
+  const bytes = fromBase64(value);
+  return textDecoder.decode(bytes);
+}
+function toBase64Url(base64) {
+  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+function normalizeBase64Url(value) {
+  return value.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(value.length / 4) * 4, "=");
+}
+
+// src/encoding.ts
+function safeBase64Decode(str) {
+  return decodeBase64ToUtf8(normalizeBase64Url(str));
+}
+function safeBase64Encode(str) {
+  return toBase64Url(encodeUtf8ToBase64(str));
+}
+var base64JsonEncode = (data) => safeBase64Encode(JSON.stringify(data));
+var base64JsonDecode = (encoded) => JSON.parse(safeBase64Decode(encoded));
+var encodePaymentV2 = (payload) => base64JsonEncode(payload);
+var decodePaymentV2 = (encoded) => base64JsonDecode(encoded);
+var encodeSettlementV2 = (response) => base64JsonEncode(response);
+var decodeSettlementV2 = (encoded) => base64JsonDecode(encoded);
+var isPaymentV2 = (payload) => "x402Version" in payload && payload.x402Version === 2 && "accepted" in payload && "payload" in payload;
+var isSettlementV2 = (response) => "success" in response && typeof response.success === "boolean" && "network" in response;
+
+// src/types/x402.ts
+var X402_VERSION = 2;
+var SCHEMES = ["exact"];
+function isPaymentPayload(obj) {
+  return typeof obj === "object" && obj !== null && "x402Version" in obj && "accepted" in obj && "payload" in obj;
+}
+function isExactEvmPayload(obj) {
+  return typeof obj === "object" && obj !== null && "signature" in obj && "authorization" in obj;
+}
+
+// src/encoding/x402.ts
+function safeBase64Encode2(str) {
+  return toBase64Url(encodeUtf8ToBase64(str));
+}
+function safeBase64Decode2(str) {
+  return decodeBase64ToUtf8(normalizeBase64Url(str));
+}
+function encodePayment(payload) {
+  if (!isPaymentPayload(payload)) {
+    throw new Error("Invalid payment payload format");
+  }
+  const safePayload = JSON.parse(
+    JSON.stringify(payload, (_, value) => {
+      if (typeof value === "bigint") {
+        return value.toString();
+      }
+      return value;
+    })
+  );
+  return safeBase64Encode2(JSON.stringify(safePayload));
+}
+function decodePayment(encoded) {
+  let parsed;
+  try {
+    parsed = JSON.parse(encoded);
+  } catch {
+    const decoded = safeBase64Decode2(encoded);
+    parsed = JSON.parse(decoded);
+  }
+  if (!isPaymentPayload(parsed)) {
+    throw new Error("Invalid payment payload format");
+  }
+  return parsed;
+}
+function encodeSettlementResponse(response) {
+  const safeResponse = JSON.parse(
+    JSON.stringify(response, (_, value) => {
+      if (typeof value === "bigint") {
+        return value.toString();
+      }
+      return value;
+    })
+  );
+  return safeBase64Encode2(JSON.stringify(safeResponse));
+}
+function decodeSettlementResponse(encoded) {
+  try {
+    return JSON.parse(encoded);
+  } catch {
+    const decoded = safeBase64Decode2(encoded);
+    return JSON.parse(decoded);
+  }
+}
+function encodeX402Response(response) {
+  return safeBase64Encode2(JSON.stringify(response));
+}
+function decodeX402Response(encoded) {
+  try {
+    return JSON.parse(encoded);
+  } catch {
+    const decoded = safeBase64Decode2(encoded);
+    return JSON.parse(decoded);
+  }
+}
+function detectPaymentVersion(headers) {
+  if (headers.has("PAYMENT-SIGNATURE")) {
+    return 2;
+  }
+  return null;
+}
+function extractPaymentFromHeaders(headers) {
+  const encoded = headers.get("PAYMENT-SIGNATURE");
+  if (!encoded) return null;
+  try {
+    return decodePayment(encoded);
+  } catch {
+    return null;
+  }
+}
+function createPaymentRequiredHeaders(requirements, options) {
+  const accepts = Array.isArray(requirements) ? requirements : [requirements];
+  const response = {
+    x402Version: 2,
+    error: options?.error ?? "Payment required",
+    resource: options?.resource ?? { url: "", mimeType: "application/json" },
+    accepts,
+    extensions: options?.extensions ?? {}
+  };
+  return {
+    [V2_HEADERS.PAYMENT_REQUIRED]: safeBase64Encode2(JSON.stringify(response))
+  };
+}
+function createSettlementHeaders(settlement) {
+  return {
+    [V2_HEADERS.PAYMENT_RESPONSE]: encodeSettlementResponse(settlement)
+  };
+}
+
+// src/errors.ts
+var X402ClientError = class extends Error {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "X402ClientError";
+    this.cause = cause;
+  }
+};
+var SigningError = class extends X402ClientError {
+  constructor(message, cause) {
+    super(`Signing failed: ${message}`, cause);
+    this.name = "SigningError";
+  }
+};
+var PaymentException = class extends X402ClientError {
+  constructor(message, cause) {
+    super(`Payment failed: ${message}`, cause);
+    this.name = "PaymentException";
+  }
+};
+
+// src/payment-client.ts
+var DEFAULT_FACILITATOR_URL = "https://facilitator.payai.network";
+function toJsonSafe(data) {
+  function convert(value) {
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      return Object.fromEntries(
+        Object.entries(value).map(([key, val]) => [key, convert(val)])
+      );
+    }
+    if (Array.isArray(value)) {
+      return value.map(convert);
+    }
+    if (typeof value === "bigint") {
+      return value.toString();
+    }
+    return value;
+  }
+  return convert(data);
+}
+function resolveUrl(config) {
+  return config?.url ?? DEFAULT_FACILITATOR_URL;
+}
+async function resolveHeaders(config) {
+  const base = { "Content-Type": "application/json" };
+  if (!config?.createHeaders) return base;
+  const extra = await config.createHeaders();
+  return { ...base, ...extra };
+}
+async function verifyPayment(payload, requirements, config) {
+  const url = resolveUrl(config);
+  const headers = await resolveHeaders(config);
+  const response = await fetch(`${url}/verify`, {
+    method: "POST",
+    headers,
+    body: JSON.stringify({
+      paymentPayload: toJsonSafe(payload),
+      paymentRequirements: toJsonSafe(requirements)
+    })
+  });
+  if (response.status !== 200) {
+    const text = await response.text().catch(() => response.statusText);
+    throw new Error(`Facilitator verify failed: ${response.status} ${text}`);
+  }
+  return await response.json();
+}
+async function settlePayment(payload, requirements, config) {
+  const url = resolveUrl(config);
+  const headers = await resolveHeaders(config);
+  const response = await fetch(`${url}/settle`, {
+    method: "POST",
+    headers,
+    body: JSON.stringify({
+      paymentPayload: toJsonSafe(payload),
+      paymentRequirements: toJsonSafe(requirements)
+    })
+  });
+  if (response.status !== 200) {
+    const text = await response.text().catch(() => response.statusText);
+    throw new Error(`Facilitator settle failed: ${response.status} ${text}`);
+  }
+  return await response.json();
+}
+async function getSupported(config) {
+  const url = resolveUrl(config);
+  const headers = await resolveHeaders(config);
+  const response = await fetch(`${url}/supported`, {
+    method: "GET",
+    headers
+  });
+  if (response.status !== 200) {
+    throw new Error(`Facilitator supported failed: ${response.statusText}`);
+  }
+  return await response.json();
+}
+function isCompactV2Payload(payload) {
+  if (typeof payload !== "object" || payload === null) return false;
+  const record = payload;
+  return typeof record.x402Version === "number" && "payload" in record && !("accepted" in record);
+}
+function decodePayloadHeader(headerValue, defaults) {
+  if (headerValue.startsWith("{")) {
+    const parsed = JSON.parse(headerValue);
+    if (isPaymentPayload(parsed)) return parsed;
+    if (isCompactV2Payload(parsed)) {
+      const compact = parsed;
+      if (!defaults?.accepted) {
+        throw new Error(
+          "Invalid payment payload: missing 'accepted' field and no defaults provided"
+        );
+      }
+      return {
+        x402Version: 2,
+        accepted: defaults.accepted,
+        payload: compact.payload
+      };
+    }
+    throw new Error("Invalid payment payload: unrecognized format");
+  }
+  const normalized = headerValue.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(headerValue.length / 4) * 4, "=");
+  try {
+    const decoded = JSON.parse(decodeBase64ToUtf8(normalized));
+    if (isPaymentPayload(decoded)) return decoded;
+    if (isCompactV2Payload(decoded)) {
+      const compact = decoded;
+      if (!defaults?.accepted) {
+        throw new Error(
+          "Invalid payment payload: missing 'accepted' field and no defaults provided"
+        );
+      }
+      return {
+        x402Version: 2,
+        accepted: defaults.accepted,
+        payload: compact.payload
+      };
+    }
+    throw new Error("Invalid payment payload: unrecognized format");
+  } catch {
+    throw new Error("Invalid payment payload: failed to decode");
+  }
+}
+function extractPayerAddress(payload) {
+  if (isExactEvmPayload(payload.payload)) {
+    return payload.payload.authorization.from;
+  }
+  throw new Error("Unable to extract payer address from payload");
+}
+
+// src/types/networks.ts
+var isEvmAddress = (value) => /^0x[a-fA-F0-9]{40}$/.test(value);
+var tokenRegistry = /* @__PURE__ */ new Map();
+var tokenKey = (chainId, contractAddress) => `${chainId}:${contractAddress.toLowerCase()}`;
+var NETWORKS = {
+  ethereum: {
+    name: "Ethereum Mainnet",
+    chainId: 1,
+    usdcAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    rpcUrl: "https://eth.llamarpc.com",
+    caip2Id: "eip155:1",
+    caipAssetId: "eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+  },
+  base: {
+    name: "Base Mainnet",
+    chainId: 8453,
+    usdcAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    rpcUrl: "https://mainnet.base.org",
+    caip2Id: "eip155:8453",
+    caipAssetId: "eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+  },
+  "base-sepolia": {
+    name: "Base Sepolia",
+    chainId: 84532,
+    usdcAddress: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    rpcUrl: "https://sepolia.base.org",
+    caip2Id: "eip155:84532",
+    caipAssetId: "eip155:84532/erc20:0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+  },
+  "skale-base": {
+    name: "SKALE Base",
+    chainId: 1187947933,
+    usdcAddress: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
+    rpcUrl: "https://skale-base.skalenodes.com/v1/base",
+    caip2Id: "eip155:1187947933",
+    caipAssetId: "eip155:1187947933/erc20:0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20"
+  },
+  "skale-base-sepolia": {
+    name: "SKALE Base Sepolia",
+    chainId: 324705682,
+    usdcAddress: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
+    rpcUrl: "https://base-sepolia-testnet.skalenodes.com/v1/jubilant-horrible-ancha",
+    caip2Id: "eip155:324705682",
+    caipAssetId: "eip155:324705682/erc20:0x2e08028E3C4c2356572E096d8EF835cD5C6030bD"
+  },
+  "ethereum-sepolia": {
+    name: "Ethereum Sepolia",
+    chainId: 11155111,
+    usdcAddress: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+    rpcUrl: "https://rpc.sepolia.org",
+    caip2Id: "eip155:11155111",
+    caipAssetId: "eip155:11155111/erc20:0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"
+  }
+};
+var getNetworkConfig = (name) => NETWORKS[name];
+var getNetworkByChainId = (chainId) => Object.values(NETWORKS).find((c) => c.chainId === chainId);
+var getMainnets = () => Object.values(NETWORKS).filter(
+  (c) => !c.name.toLowerCase().includes("sepolia")
+);
+var getTestnets = () => Object.values(NETWORKS).filter(
+  (c) => c.name.toLowerCase().includes("sepolia")
+);
+var registerToken = (token) => {
+  if (typeof token !== "object" || token === null) {
+    throw new Error("Invalid token: must be an object");
+  }
+  const t = token;
+  if (typeof t.symbol !== "string") {
+    throw new Error("Invalid token: symbol must be a string");
+  }
+  if (typeof t.name !== "string") {
+    throw new Error("Invalid token: name must be a string");
+  }
+  if (typeof t.version !== "string") {
+    throw new Error("Invalid token: version must be a string");
+  }
+  if (typeof t.contractAddress !== "string" || !isEvmAddress(t.contractAddress)) {
+    throw new Error(
+      "Invalid token: contractAddress must be a valid EVM address"
+    );
+  }
+  if (typeof t.chainId !== "number" || !Number.isInteger(t.chainId) || t.chainId <= 0) {
+    throw new Error("Invalid token: chainId must be a positive integer");
+  }
+  if (t.decimals !== void 0 && (typeof t.decimals !== "number" || !Number.isInteger(t.decimals) || t.decimals < 0)) {
+    throw new Error("Invalid token: decimals must be a non-negative integer");
+  }
+  const validated = {
+    symbol: t.symbol,
+    name: t.name,
+    version: t.version,
+    contractAddress: t.contractAddress,
+    chainId: t.chainId,
+    decimals: t.decimals
+  };
+  tokenRegistry.set(
+    tokenKey(validated.chainId, validated.contractAddress),
+    validated
+  );
+  return validated;
+};
+var getCustomToken = (chainId, contractAddress) => tokenRegistry.get(tokenKey(chainId, contractAddress));
+var getAllCustomTokens = () => Array.from(tokenRegistry.values());
+var unregisterToken = (chainId, contractAddress) => tokenRegistry.delete(tokenKey(chainId, contractAddress));
+var isCustomToken = (chainId, contractAddress) => tokenRegistry.has(tokenKey(chainId, contractAddress));
+function createNonce() {
+  const bytes = randomBytes(32);
+  return `0x${bytes.toString("hex")}`;
+}
+function toAtomicUnits(amount, decimals = 6) {
+  const parts = amount.split(".");
+  const whole = parts[0];
+  const fractional = parts[1] || "";
+  const paddedFractional = fractional.padEnd(decimals, "0").slice(0, decimals);
+  return `${whole}${paddedFractional}`;
+}
+function fromAtomicUnits(amount, decimals = 6) {
+  const value = BigInt(amount);
+  const divisor = BigInt(10 ** decimals);
+  const whole = (value / divisor).toString();
+  const fractional = (value % divisor).toString().padStart(decimals, "0").replace(/0+$/, "");
+  if (fractional.length === 0) {
+    return whole;
+  }
+  return `${whole}.${fractional}`;
+}
+function caip2ToNetwork(caip2Id) {
+  const match = caip2Id.match(/^eip155:(\d+)$/);
+  if (!match) {
+    return caip2Id;
+  }
+  const chainId = parseInt(match[1], 10);
+  const chainIdToNetwork = {
+    1: "ethereum",
+    8453: "base",
+    84532: "base-sepolia",
+    137: "polygon",
+    42161: "arbitrum",
+    421614: "arbitrum-sepolia",
+    10: "optimism",
+    11155420: "optimism-sepolia",
+    11155111: "ethereum-sepolia"
+  };
+  return chainIdToNetwork[chainId] || caip2Id;
+}
+function networkToCaip2(network) {
+  const networkToChainId = {
+    ethereum: 1,
+    base: 8453,
+    "base-sepolia": 84532,
+    polygon: 137,
+    arbitrum: 42161,
+    "arbitrum-sepolia": 421614,
+    optimism: 10,
+    "optimism-sepolia": 11155420,
+    "ethereum-sepolia": 11155111
+  };
+  const chainId = networkToChainId[network];
+  if (chainId) {
+    return `eip155:${chainId}`;
   }
-  if (!isBytes32(message.nonce)) throw new Error(`"nonce" must be a valid bytes32 hex string: ${message.nonce}`);
-  return true;
-};
+  if (network.startsWith("eip155:")) {
+    return network;
+  }
+  return `eip155:0`;
+}
+function getCurrentTimestamp() {
+  return Math.floor(Date.now() / 1e3);
+}
+function isValidAddress(address) {
+  return /^0x[a-fA-F0-9]{40}$/.test(address);
+}
+function normalizeAddress(address) {
+  return address.toLowerCase();
+}
 
 // src/validation.ts
 var isEvmAddress2 = (value) => /^0x[a-fA-F0-9]{40}$/.test(value);
@@ -648,7 +915,9 @@ var resolveNetwork = (input) => {
   if (typeof input === "object" && input !== null && "chainId" in input) {
     const config = input;
     if (!config.chainId || !config.usdcAddress || !config.caip2Id) {
-      return createError("INVALID_CAIP_FORMAT", "Invalid network config", { value: config });
+      return createError("INVALID_CAIP_FORMAT", "Invalid network config", {
+        value: config
+      });
     }
     return {
       input,
@@ -660,11 +929,10 @@ var resolveNetwork = (input) => {
     const config = getNetworkByChainId(input);
     if (!config) {
       const validChainIds = Object.values(NETWORKS).map((n) => n.chainId);
-      return createError(
-        "UNKNOWN_NETWORK",
-        `Unknown chain ID: ${input}`,
-        { value: input, validOptions: validChainIds.map(String) }
-      );
+      return createError("UNKNOWN_NETWORK", `Unknown chain ID: ${input}`, {
+        value: input,
+        validOptions: validChainIds.map(String)
+      });
     }
     return {
       input,
@@ -675,13 +943,21 @@ var resolveNetwork = (input) => {
   if (typeof input === "string") {
     if (input.startsWith("eip155:")) {
       const parts = input.split(":");
-      if (parts.length !== 2 || isNaN(Number(parts[1]))) {
-        return createError("INVALID_CAIP_FORMAT", `Invalid CAIP-2 format: ${input}`, { value: input });
+      if (parts.length !== 2 || Number.isNaN(Number(parts[1]))) {
+        return createError(
+          "INVALID_CAIP_FORMAT",
+          `Invalid CAIP-2 format: ${input}`,
+          { value: input }
+        );
       }
       const chainId = Number(parts[1]);
       const config2 = getNetworkByChainId(chainId);
       if (!config2) {
-        return createError("UNKNOWN_NETWORK", `Unknown CAIP-2 network: ${input}`, { value: input });
+        return createError(
+          "UNKNOWN_NETWORK",
+          `Unknown CAIP-2 network: ${input}`,
+          { value: input }
+        );
       }
       return {
         input,
@@ -693,11 +969,10 @@ var resolveNetwork = (input) => {
     const config = getNetworkConfig(normalizedName);
     if (!config) {
       const validNames = Object.keys(NETWORKS);
-      return createError(
-        "UNKNOWN_NETWORK",
-        `Unknown network: "${input}"`,
-        { value: input, validOptions: validNames }
-      );
+      return createError("UNKNOWN_NETWORK", `Unknown network: "${input}"`, {
+        value: input,
+        validOptions: validNames
+      });
     }
     return {
       input,
@@ -705,7 +980,11 @@ var resolveNetwork = (input) => {
       caip2: config.caip2Id
     };
   }
-  return createError("UNKNOWN_NETWORK", `Invalid network identifier type: ${typeof input}`, { value: input });
+  return createError(
+    "UNKNOWN_NETWORK",
+    `Invalid network identifier type: ${typeof input}`,
+    { value: input }
+  );
 };
 var getAvailableNetworks = () => Object.keys(NETWORKS);
 var normalizeTokenSymbol = (symbol) => symbol.toUpperCase();
@@ -713,7 +992,9 @@ var resolveToken = (input, network) => {
   if (typeof input === "object" && input !== null && "contractAddress" in input) {
     const config = input;
     if (!config.chainId || !config.contractAddress || !config.symbol) {
-      return createError("VALIDATION_FAILED", "Invalid token config", { value: config });
+      return createError("VALIDATION_FAILED", "Invalid token config", {
+        value: config
+      });
     }
     if (network && config.chainId !== network.config.chainId) {
       return createError(
@@ -738,7 +1019,10 @@ var resolveToken = (input, network) => {
     if (isEvmAddress2(input)) {
       const contractAddress = input;
       if (network) {
-        const customToken = getCustomToken(network.config.chainId, contractAddress);
+        const customToken = getCustomToken(
+          network.config.chainId,
+          contractAddress
+        );
         const config = customToken || {
           symbol: "CUSTOM",
           name: "Custom Token",
@@ -765,590 +1049,324 @@ var resolveToken = (input, network) => {
           return tokenNetwork;
         }
         const caipAsset = `eip155:${matchingToken2.chainId}/erc20:${contractAddress}`;
-        return {
-          input,
-          config: matchingToken2,
-          caipAsset,
-          network: tokenNetwork
-        };
-      }
-      return createError(
-        "UNKNOWN_TOKEN",
-        `Token address "${contractAddress}" not found in registry. Please specify a network.`,
-        { value: input, validOptions: ["Specify network parameter"] }
-      );
-    }
-    if (input.includes("/erc20:")) {
-      const parts = input.split("/");
-      if (parts.length !== 2) {
-        return createError("INVALID_CAIP_FORMAT", `Invalid CAIP Asset ID format: ${input}`, { value: input });
-      }
-      const chainId = Number(parts[0].split(":")[1]);
-      const contractAddress = parts[1].split(":")[1];
-      const tokenNetwork = resolveNetwork(chainId);
-      if ("code" in tokenNetwork) {
-        return tokenNetwork;
-      }
-      const customToken = getCustomToken(chainId, contractAddress);
-      const config = customToken || {
-        symbol: "CUSTOM",
-        name: "Custom Token",
-        version: "1",
-        chainId,
-        contractAddress,
-        decimals: 18
-      };
-      return {
-        input,
-        config,
-        caipAsset: input,
-        network: tokenNetwork
-      };
-    }
-    const normalizedSymbol = normalizeTokenSymbol(input);
-    if (network) {
-      const customTokens2 = getAllCustomTokens();
-      const matchingToken2 = customTokens2.find(
-        (t) => t.symbol?.toUpperCase() === normalizedSymbol && t.chainId === network.config.chainId
-      );
-      if (matchingToken2) {
-        return {
-          input,
-          config: matchingToken2,
-          caipAsset: `eip155:${matchingToken2.chainId}/erc20:${matchingToken2.contractAddress}`,
-          network
-        };
-      }
-      return {
-        input,
-        config: {
-          symbol: normalizedSymbol,
-          name: network.config.name + " " + normalizedSymbol,
-          version: "2",
-          chainId: network.config.chainId,
-          contractAddress: network.config.usdcAddress,
-          decimals: 6
-        },
-        caipAsset: network.config.caipAssetId,
-        network
-      };
-    }
-    const customTokens = getAllCustomTokens();
-    const matchingToken = customTokens.find((t) => t.symbol?.toUpperCase() === normalizedSymbol);
-    if (matchingToken) {
-      const tokenNetwork = resolveNetwork(matchingToken.chainId);
-      if ("code" in tokenNetwork) {
-        return tokenNetwork;
-      }
-      return {
-        input,
-        config: matchingToken,
-        caipAsset: `eip155:${matchingToken.chainId}/erc20:${matchingToken.contractAddress}`,
-        network: tokenNetwork
-      };
-    }
-    const baseNetwork = resolveNetwork("base");
-    if ("code" in baseNetwork) {
-      return baseNetwork;
-    }
-    return {
-      input,
-      config: {
-        symbol: normalizedSymbol,
-        name: "USD Coin",
-        version: "2",
-        chainId: 8453,
-        contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-        decimals: 6
-      },
-      caipAsset: baseNetwork.config.caipAssetId,
-      network: baseNetwork
-    };
-  }
-  return createError("UNKNOWN_TOKEN", `Invalid token identifier type: ${typeof input}`, { value: input });
-};
-var getAvailableTokens = () => {
-  const customTokens = getAllCustomTokens();
-  const symbols = new Set(customTokens.map((t) => t.symbol.toUpperCase()));
-  return Array.from(symbols);
-};
-var resolveFacilitator = (input, supportedNetworks, supportedTokens) => {
-  try {
-    new URL(input.url);
-  } catch {
-    return createError("VALIDATION_FAILED", `Invalid facilitator URL: ${input.url}`, { value: input.url });
-  }
-  const networks = [];
-  if (input.networks) {
-    for (const network of input.networks) {
-      const resolved = resolveNetwork(network);
-      if ("code" in resolved) {
-        return resolved;
-      }
-      networks.push(resolved);
-    }
-  } else if (supportedNetworks) {
-    networks.push(...supportedNetworks);
-  }
-  const tokens = [];
-  if (input.tokens) {
-    for (const token of input.tokens) {
-      for (const network of networks.length > 0 ? networks : supportedNetworks || []) {
-        const resolved = resolveToken(token, network);
-        if ("code" in resolved) {
-          continue;
-        }
-        tokens.push(resolved);
-        break;
-      }
-    }
-  } else if (supportedTokens) {
-    tokens.push(...supportedTokens);
-  }
-  return {
-    input,
-    url: input.url,
-    networks,
-    tokens
-  };
-};
-var checkFacilitatorSupport = (facilitator, network, token) => {
-  if (facilitator.networks.length > 0) {
-    const networkSupported = facilitator.networks.some(
-      (n) => n.config.chainId === network.config.chainId
-    );
-    if (!networkSupported) {
-      const supportedNames = facilitator.networks.map((n) => n.config.name);
-      return createError(
-        "FACILITATOR_NO_NETWORK_SUPPORT",
-        `Facilitator "${facilitator.url}" does not support network "${network.config.name}" (chain ${network.config.chainId}). Supported: ${supportedNames.join(", ")}`,
-        {
-          value: { facilitator: facilitator.url, network: network.config.name },
-          validOptions: supportedNames
-        }
-      );
-    }
-  }
-  if (facilitator.tokens.length > 0) {
-    const tokenSupported = facilitator.tokens.some(
-      (t) => t.config.contractAddress.toLowerCase() === token.config.contractAddress.toLowerCase() && t.network.config.chainId === token.network.config.chainId
-    );
-    if (!tokenSupported) {
-      const supportedTokens = facilitator.tokens.map((t) => `${t.config.symbol} (${t.network.config.name})`);
-      return createError(
-        "FACILITATOR_NO_TOKEN_SUPPORT",
-        `Facilitator "${facilitator.url}" does not support token "${token.config.symbol}" on "${token.network.config.name}". Supported: ${supportedTokens.join(", ")}`,
-        {
-          value: { facilitator: facilitator.url, token: token.config.symbol, network: token.network.config.name },
-          validOptions: supportedTokens
-        }
-      );
-    }
-  }
-  return { supported: true };
-};
-var validatePaymentConfig = (network, token, facilitators, payTo = "0x0000000000000000000000000000000000000000", amount = "1.0") => {
-  const resolvedNetwork = resolveNetwork(network);
-  if ("code" in resolvedNetwork) {
-    return resolvedNetwork;
-  }
-  const resolvedToken = resolveToken(token, resolvedNetwork);
-  if ("code" in resolvedToken) {
-    return resolvedToken;
-  }
-  const resolvedFacilitators = [];
-  if (facilitators) {
-    const facilitatorArray = Array.isArray(facilitators) ? facilitators : [facilitators];
-    for (const facilitator of facilitatorArray) {
-      const resolved = resolveFacilitator(facilitator, [resolvedNetwork], [resolvedToken]);
-      if ("code" in resolved) {
-        return resolved;
-      }
-      const supportCheck = checkFacilitatorSupport(resolved, resolvedNetwork, resolvedToken);
-      if ("code" in supportCheck) {
-        return supportCheck;
-      }
-      resolvedFacilitators.push(resolved);
-    }
-  }
-  return {
-    network: resolvedNetwork,
-    token: resolvedToken,
-    facilitators: resolvedFacilitators,
-    version: 2,
-    payTo,
-    amount
-  };
-};
-var validateAcceptConfig = (options, payTo, amount) => {
-  const { networks: networkInputs, tokens: tokenInputs, facilitators, version = 2 } = options;
-  const networkIds = networkInputs?.length ? networkInputs : Object.keys(NETWORKS);
-  const tokenIds = tokenInputs?.length ? tokenInputs : ["usdc"];
-  const networks = [];
-  for (const networkId of networkIds) {
-    const resolved = resolveNetwork(networkId);
-    if ("code" in resolved) {
-      return { success: false, error: resolved };
-    }
-    networks.push(resolved);
-  }
-  const tokens = [];
-  for (const tokenId of tokenIds) {
-    let found = false;
-    for (const network of networks) {
-      const resolved = resolveToken(tokenId, network);
-      if ("code" in resolved) {
-        continue;
+        return {
+          input,
+          config: matchingToken2,
+          caipAsset,
+          network: tokenNetwork
+        };
       }
-      tokens.push(resolved);
-      found = true;
-      break;
+      return createError(
+        "UNKNOWN_TOKEN",
+        `Token address "${contractAddress}" not found in registry. Please specify a network.`,
+        { value: input, validOptions: ["Specify network parameter"] }
+      );
     }
-    if (!found) {
+    if (input.includes("/erc20:")) {
+      const parts = input.split("/");
+      if (parts.length !== 2) {
+        return createError(
+          "INVALID_CAIP_FORMAT",
+          `Invalid CAIP Asset ID format: ${input}`,
+          { value: input }
+        );
+      }
+      const chainId = Number(parts[0].split(":")[1]);
+      const contractAddress = parts[1].split(":")[1];
+      const tokenNetwork = resolveNetwork(chainId);
+      if ("code" in tokenNetwork) {
+        return tokenNetwork;
+      }
+      const customToken = getCustomToken(chainId, contractAddress);
+      const config = customToken || {
+        symbol: "CUSTOM",
+        name: "Custom Token",
+        version: "1",
+        chainId,
+        contractAddress,
+        decimals: 18
+      };
       return {
-        success: false,
-        error: createError(
-          "TOKEN_NOT_ON_NETWORK",
-          `Token "${String(tokenId)}" not found on any of the specified networks`,
-          { value: tokenId, validOptions: networks.map((n) => n.config.name) }
-        )
+        input,
+        config,
+        caipAsset: input,
+        network: tokenNetwork
       };
     }
-  }
-  const facilitatorArray = facilitators ? Array.isArray(facilitators) ? facilitators : [facilitators] : [];
-  const resolvedFacilitators = [];
-  for (const facilitator of facilitatorArray) {
-    const resolved = resolveFacilitator(facilitator, networks, tokens);
-    if ("code" in resolved) {
-      return { success: false, error: resolved };
-    }
-    resolvedFacilitators.push(resolved);
-  }
-  const configs = [];
-  for (const network of networks) {
-    for (const token of tokens) {
-      if (token.network.config.chainId === network.config.chainId) {
-        configs.push({
-          network,
-          token,
-          facilitators: resolvedFacilitators,
-          version,
-          payTo,
-          amount
-        });
+    const normalizedSymbol = normalizeTokenSymbol(input);
+    if (network) {
+      const customTokens2 = getAllCustomTokens();
+      const matchingToken2 = customTokens2.find(
+        (t) => t.symbol?.toUpperCase() === normalizedSymbol && t.chainId === network.config.chainId
+      );
+      if (matchingToken2) {
+        return {
+          input,
+          config: matchingToken2,
+          caipAsset: `eip155:${matchingToken2.chainId}/erc20:${matchingToken2.contractAddress}`,
+          network
+        };
       }
+      return {
+        input,
+        config: {
+          symbol: normalizedSymbol,
+          name: `${network.config.name} ${normalizedSymbol}`,
+          version: "2",
+          chainId: network.config.chainId,
+          contractAddress: network.config.usdcAddress,
+          decimals: 6
+        },
+        caipAsset: network.config.caipAssetId,
+        network
+      };
     }
-  }
-  return { success: true, config: configs };
-};
-var isValidationError = (value) => {
-  return typeof value === "object" && value !== null && "code" in value;
-};
-var isResolvedNetwork = (value) => {
-  return typeof value === "object" && value !== null && "config" in value && "caip2" in value;
-};
-var isResolvedToken = (value) => {
-  return typeof value === "object" && value !== null && "config" in value && "caipAsset" in value;
-};
-
-// src/utils/routes.ts
-var PRIORITY_EXACT = 3;
-var PRIORITY_PARAMETRIZED = 2;
-var PRIORITY_WILDCARD = 1;
-function parseRoutePattern(pattern) {
-  const normalizedPattern = pattern.startsWith("/") ? pattern : `/${pattern}`;
-  const segments = normalizedPattern.split("/").filter(Boolean);
-  let isWildcard = false;
-  let isParametrized = false;
-  const paramNames = [];
-  const seenParamNames = /* @__PURE__ */ new Set();
-  const recordParamName = (name) => {
-    if (!name) {
-      return;
-    }
-    if (seenParamNames.has(name)) {
-      return;
-    }
-    seenParamNames.add(name);
-    paramNames.push(name);
-  };
-  for (const segment of segments) {
-    if (segment === "*") {
-      isWildcard = true;
-      continue;
-    }
-    const hasWildcardToken = segment.includes("*");
-    if (segment.startsWith(":")) {
-      isParametrized = true;
-      const paramName = segment.replace(/\*+$/, "").slice(1);
-      recordParamName(paramName);
-      if (hasWildcardToken) {
-        isWildcard = true;
+    const customTokens = getAllCustomTokens();
+    const matchingToken = customTokens.find(
+      (t) => t.symbol?.toUpperCase() === normalizedSymbol
+    );
+    if (matchingToken) {
+      const tokenNetwork = resolveNetwork(matchingToken.chainId);
+      if ("code" in tokenNetwork) {
+        return tokenNetwork;
       }
-      continue;
+      return {
+        input,
+        config: matchingToken,
+        caipAsset: `eip155:${matchingToken.chainId}/erc20:${matchingToken.contractAddress}`,
+        network: tokenNetwork
+      };
     }
-    if (hasWildcardToken) {
-      const parts = segment.split("*");
-      for (const part of parts) {
-        if (part.startsWith(":")) {
-          isParametrized = true;
-          recordParamName(part.slice(1));
-        }
-      }
-      isWildcard = true;
+    const baseNetwork = resolveNetwork("base");
+    if ("code" in baseNetwork) {
+      return baseNetwork;
     }
+    return {
+      input,
+      config: {
+        symbol: normalizedSymbol,
+        name: "USD Coin",
+        version: "2",
+        chainId: 8453,
+        contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        decimals: 6
+      },
+      caipAsset: baseNetwork.config.caipAssetId,
+      network: baseNetwork
+    };
   }
-  let priority = PRIORITY_WILDCARD;
-  if (!isWildcard && !isParametrized) {
-    priority = PRIORITY_EXACT;
-  } else if (isParametrized && !isWildcard) {
-    priority = PRIORITY_PARAMETRIZED;
-  } else if (isParametrized && isWildcard) {
-    priority = PRIORITY_PARAMETRIZED;
-  }
-  return { segments, isWildcard, isParametrized, paramNames, priority };
-}
-function matchSegment(patternSegment, pathSegment) {
-  if (patternSegment === "*") {
-    return true;
-  }
-  if (patternSegment.startsWith(":")) {
-    return true;
-  }
-  if (patternSegment.includes("*")) {
-    const regex = new RegExp(
-      "^" + patternSegment.replace(/\*/g, ".*").replace(/:/g, "") + "$"
+  return createError(
+    "UNKNOWN_TOKEN",
+    `Invalid token identifier type: ${typeof input}`,
+    { value: input }
+  );
+};
+var getAvailableTokens = () => {
+  const customTokens = getAllCustomTokens();
+  const symbols = new Set(customTokens.map((t) => t.symbol.toUpperCase()));
+  return Array.from(symbols);
+};
+var resolveFacilitator = (input, supportedNetworks, supportedTokens) => {
+  try {
+    new URL(input.url);
+  } catch {
+    return createError(
+      "VALIDATION_FAILED",
+      `Invalid facilitator URL: ${input.url}`,
+      { value: input.url }
     );
-    return regex.test(pathSegment);
-  }
-  return patternSegment === pathSegment;
-}
-function matchWildcardPattern(patternSegments, pathSegments) {
-  const requiredSegments = patternSegments.filter((s) => s !== "*");
-  if (requiredSegments.length > pathSegments.length) {
-    return false;
-  }
-  for (let i = 0; i < requiredSegments.length; i++) {
-    const patternIndex = patternSegments.indexOf(requiredSegments[i]);
-    if (pathSegments[patternIndex] !== requiredSegments[i].replace(/^\:/, "")) {
-      if (!requiredSegments[i].startsWith(":") && requiredSegments[i] !== "*") {
-        return false;
-      }
-    }
-  }
-  return true;
-}
-function matchRoute(pattern, path) {
-  const normalizedPattern = pattern.startsWith("/") ? pattern : `/${pattern}`;
-  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
-  if (normalizedPattern === normalizedPath) {
-    return true;
-  }
-  const parsed = parseRoutePattern(normalizedPattern);
-  const patternSegments = parsed.segments;
-  const pathSegments = normalizedPath.split("/").filter(Boolean);
-  if (!parsed.isWildcard && patternSegments.length !== pathSegments.length) {
-    return false;
-  }
-  if (parsed.isWildcard && patternSegments.length > pathSegments.length + 1) {
-    return false;
-  }
-  if (parsed.isWildcard) {
-    return matchWildcardPattern(patternSegments, pathSegments);
   }
-  for (let i = 0; i < patternSegments.length; i++) {
-    if (!matchSegment(patternSegments[i], pathSegments[i])) {
-      return false;
-    }
-  }
-  return true;
-}
-function findMatchingRoute(routes, path) {
-  const matchingRoutes = [];
-  for (const route of routes) {
-    if (matchRoute(route.pattern, path)) {
-      const parsed = parseRoutePattern(route.pattern);
-      matchingRoutes.push({ route, parsed });
+  const networks = [];
+  if (input.networks) {
+    for (const network of input.networks) {
+      const resolved = resolveNetwork(network);
+      if ("code" in resolved) {
+        return resolved;
+      }
+      networks.push(resolved);
     }
+  } else if (supportedNetworks) {
+    networks.push(...supportedNetworks);
   }
-  if (matchingRoutes.length === 0) {
-    return null;
+  const tokens = [];
+  if (input.tokens) {
+    for (const token of input.tokens) {
+      for (const network of networks.length > 0 ? networks : supportedNetworks || []) {
+        const resolved = resolveToken(token, network);
+        if ("code" in resolved) {
+          continue;
+        }
+        tokens.push(resolved);
+        break;
+      }
+    }
+  } else if (supportedTokens) {
+    tokens.push(...supportedTokens);
   }
-  matchingRoutes.sort((a, b) => {
-    if (b.parsed.priority !== a.parsed.priority) {
-      return b.parsed.priority - a.parsed.priority;
+  return {
+    input,
+    url: input.url,
+    networks,
+    tokens
+  };
+};
+var checkFacilitatorSupport = (facilitator, network, token) => {
+  if (facilitator.networks.length > 0) {
+    const networkSupported = facilitator.networks.some(
+      (n) => n.config.chainId === network.config.chainId
+    );
+    if (!networkSupported) {
+      const supportedNames = facilitator.networks.map((n) => n.config.name);
+      return createError(
+        "FACILITATOR_NO_NETWORK_SUPPORT",
+        `Facilitator "${facilitator.url}" does not support network "${network.config.name}" (chain ${network.config.chainId}). Supported: ${supportedNames.join(", ")}`,
+        {
+          value: { facilitator: facilitator.url, network: network.config.name },
+          validOptions: supportedNames
+        }
+      );
     }
-    if (b.parsed.segments.length !== a.parsed.segments.length) {
-      return b.parsed.segments.length - a.parsed.segments.length;
+  }
+  if (facilitator.tokens.length > 0) {
+    const tokenSupported = facilitator.tokens.some(
+      (t) => t.config.contractAddress.toLowerCase() === token.config.contractAddress.toLowerCase() && t.network.config.chainId === token.network.config.chainId
+    );
+    if (!tokenSupported) {
+      const supportedTokens = facilitator.tokens.map(
+        (t) => `${t.config.symbol} (${t.network.config.name})`
+      );
+      return createError(
+        "FACILITATOR_NO_TOKEN_SUPPORT",
+        `Facilitator "${facilitator.url}" does not support token "${token.config.symbol}" on "${token.network.config.name}". Supported: ${supportedTokens.join(", ")}`,
+        {
+          value: {
+            facilitator: facilitator.url,
+            token: token.config.symbol,
+            network: token.network.config.name
+          },
+          validOptions: supportedTokens
+        }
+      );
     }
-    return b.route.pattern.length - a.route.pattern.length;
-  });
-  return matchingRoutes[0].route;
-}
-function containsWildcard(pattern) {
-  return pattern.includes("*");
-}
-function validateRouteConfig(config) {
-  const { route, routes } = config;
-  if (!route && !routes) {
-    return null;
   }
-  if (route && routes) {
-    return {
-      code: "INVALID_ROUTE_CONFIG",
-      message: "Cannot specify both 'route' and 'routes'. Use 'route' for a single exact path or 'routes' for multiple paths.",
-      path: "route",
-      value: { route, routes }
-    };
+  return { supported: true };
+};
+var validatePaymentConfig = (network, token, facilitators, payTo = "0x0000000000000000000000000000000000000000", amount = "1.0") => {
+  const resolvedNetwork = resolveNetwork(network);
+  if ("code" in resolvedNetwork) {
+    return resolvedNetwork;
   }
-  if (route && containsWildcard(route)) {
-    return {
-      code: "INVALID_ROUTE_PATTERN",
-      message: `Wildcard routes must use the routes array, not 'route'. Use 'routes: ["/api/*"]' instead of 'route: "/api/*"'.`,
-      path: "route",
-      value: route,
-      validOptions: ['routes: ["/api/*"]', 'routes: ["/api/users", "/api/posts"]']
-    };
+  const resolvedToken = resolveToken(token, resolvedNetwork);
+  if ("code" in resolvedToken) {
+    return resolvedToken;
   }
-  return null;
-}
-
-// src/encoding.ts
-function safeBase64Decode2(str) {
-  return decodeBase64ToUtf8(normalizeBase64Url(str));
-}
-function safeBase64Encode2(str) {
-  return toBase64Url(encodeUtf8ToBase64(str));
-}
-var base64JsonEncode = (data) => safeBase64Encode2(JSON.stringify(data));
-var base64JsonDecode = (encoded) => JSON.parse(safeBase64Decode2(encoded));
-var encodePaymentV2 = (payload) => base64JsonEncode(payload);
-var decodePaymentV2 = (encoded) => base64JsonDecode(encoded);
-var encodeSettlementV2 = (response) => base64JsonEncode(response);
-var decodeSettlementV2 = (encoded) => base64JsonDecode(encoded);
-var isPaymentV2 = (payload) => "x402Version" in payload && payload.x402Version === 2 && "accepted" in payload && "payload" in payload;
-var isSettlementV2 = (response) => "success" in response && typeof response.success === "boolean" && "network" in response;
-
-// src/payment-client.ts
-var DEFAULT_FACILITATOR_URL = "https://facilitator.payai.network";
-function toJsonSafe(data) {
-  function convert(value) {
-    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
-      return Object.fromEntries(Object.entries(value).map(([key, val]) => [key, convert(val)]));
-    }
-    if (Array.isArray(value)) {
-      return value.map(convert);
-    }
-    if (typeof value === "bigint") {
-      return value.toString();
+  const resolvedFacilitators = [];
+  if (facilitators) {
+    const facilitatorArray = Array.isArray(facilitators) ? facilitators : [facilitators];
+    for (const facilitator of facilitatorArray) {
+      const resolved = resolveFacilitator(
+        facilitator,
+        [resolvedNetwork],
+        [resolvedToken]
+      );
+      if ("code" in resolved) {
+        return resolved;
+      }
+      const supportCheck = checkFacilitatorSupport(
+        resolved,
+        resolvedNetwork,
+        resolvedToken
+      );
+      if ("code" in supportCheck) {
+        return supportCheck;
+      }
+      resolvedFacilitators.push(resolved);
     }
-    return value;
-  }
-  return convert(data);
-}
-function resolveUrl(config) {
-  return config?.url ?? DEFAULT_FACILITATOR_URL;
-}
-async function resolveHeaders(config) {
-  const base = { "Content-Type": "application/json" };
-  if (!config?.createHeaders) return base;
-  const extra = await config.createHeaders();
-  return { ...base, ...extra };
-}
-async function verifyPayment(payload, requirements, config) {
-  const url = resolveUrl(config);
-  const headers = await resolveHeaders(config);
-  const response = await fetch(`${url}/verify`, {
-    method: "POST",
-    headers,
-    body: JSON.stringify({
-      paymentPayload: toJsonSafe(payload),
-      paymentRequirements: toJsonSafe(requirements)
-    })
-  });
-  if (response.status !== 200) {
-    const text = await response.text().catch(() => response.statusText);
-    throw new Error(`Facilitator verify failed: ${response.status} ${text}`);
-  }
-  return await response.json();
-}
-async function settlePayment(payload, requirements, config) {
-  const url = resolveUrl(config);
-  const headers = await resolveHeaders(config);
-  const response = await fetch(`${url}/settle`, {
-    method: "POST",
-    headers,
-    body: JSON.stringify({
-      paymentPayload: toJsonSafe(payload),
-      paymentRequirements: toJsonSafe(requirements)
-    })
-  });
-  if (response.status !== 200) {
-    const text = await response.text().catch(() => response.statusText);
-    throw new Error(`Facilitator settle failed: ${response.status} ${text}`);
   }
-  return await response.json();
-}
-async function getSupported(config) {
-  const url = resolveUrl(config);
-  const headers = await resolveHeaders(config);
-  const response = await fetch(`${url}/supported`, {
-    method: "GET",
-    headers
-  });
-  if (response.status !== 200) {
-    throw new Error(`Facilitator supported failed: ${response.statusText}`);
+  return {
+    network: resolvedNetwork,
+    token: resolvedToken,
+    facilitators: resolvedFacilitators,
+    version: 2,
+    payTo,
+    amount
+  };
+};
+var validateAcceptConfig = (options, payTo, amount) => {
+  const {
+    networks: networkInputs,
+    tokens: tokenInputs,
+    facilitators,
+    version = 2
+  } = options;
+  const networkIds = networkInputs?.length ? networkInputs : Object.keys(NETWORKS);
+  const tokenIds = tokenInputs?.length ? tokenInputs : ["usdc"];
+  const networks = [];
+  for (const networkId of networkIds) {
+    const resolved = resolveNetwork(networkId);
+    if ("code" in resolved) {
+      return { success: false, error: resolved };
+    }
+    networks.push(resolved);
   }
-  return await response.json();
-}
-function isCompactV2Payload(payload) {
-  if (typeof payload !== "object" || payload === null) return false;
-  const record = payload;
-  return typeof record.x402Version === "number" && "payload" in record && !("accepted" in record);
-}
-function decodePayloadHeader(headerValue, defaults) {
-  if (headerValue.startsWith("{")) {
-    const parsed = JSON.parse(headerValue);
-    if (isPaymentPayload(parsed)) return parsed;
-    if (isCompactV2Payload(parsed)) {
-      const compact = parsed;
-      if (!defaults?.accepted) {
-        throw new Error("Invalid payment payload: missing 'accepted' field and no defaults provided");
+  const tokens = [];
+  for (const tokenId of tokenIds) {
+    let found = false;
+    for (const network of networks) {
+      const resolved = resolveToken(tokenId, network);
+      if ("code" in resolved) {
+        continue;
       }
+      tokens.push(resolved);
+      found = true;
+      break;
+    }
+    if (!found) {
       return {
-        x402Version: 2,
-        accepted: defaults.accepted,
-        payload: compact.payload
+        success: false,
+        error: createError(
+          "TOKEN_NOT_ON_NETWORK",
+          `Token "${String(tokenId)}" not found on any of the specified networks`,
+          { value: tokenId, validOptions: networks.map((n) => n.config.name) }
+        )
       };
     }
-    throw new Error("Invalid payment payload: unrecognized format");
   }
-  const normalized = headerValue.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(headerValue.length / 4) * 4, "=");
-  try {
-    const decoded = JSON.parse(decodeBase64ToUtf8(normalized));
-    if (isPaymentPayload(decoded)) return decoded;
-    if (isCompactV2Payload(decoded)) {
-      const compact = decoded;
-      if (!defaults?.accepted) {
-        throw new Error("Invalid payment payload: missing 'accepted' field and no defaults provided");
+  const facilitatorArray = facilitators ? Array.isArray(facilitators) ? facilitators : [facilitators] : [];
+  const resolvedFacilitators = [];
+  for (const facilitator of facilitatorArray) {
+    const resolved = resolveFacilitator(facilitator, networks, tokens);
+    if ("code" in resolved) {
+      return { success: false, error: resolved };
+    }
+    resolvedFacilitators.push(resolved);
+  }
+  const configs = [];
+  for (const network of networks) {
+    for (const token of tokens) {
+      if (token.network.config.chainId === network.config.chainId) {
+        configs.push({
+          network,
+          token,
+          facilitators: resolvedFacilitators,
+          version,
+          payTo,
+          amount
+        });
       }
-      return {
-        x402Version: 2,
-        accepted: defaults.accepted,
-        payload: compact.payload
-      };
     }
-    throw new Error("Invalid payment payload: unrecognized format");
-  } catch {
-    throw new Error("Invalid payment payload: failed to decode");
-  }
-}
-function extractPayerAddress(payload) {
-  if (isExactEvmPayload(payload.payload)) {
-    return payload.payload.authorization.from;
   }
-  throw new Error("Unable to extract payer address from payload");
-}
+  return { success: true, config: configs };
+};
+var isValidationError = (value) => {
+  return typeof value === "object" && value !== null && "code" in value;
+};
+var isResolvedNetwork = (value) => {
+  return typeof value === "object" && value !== null && "config" in value && "caip2" in value;
+};
+var isResolvedToken = (value) => {
+  return typeof value === "object" && value !== null && "config" in value && "caipAsset" in value;
+};
 
 // src/payment-requirements.ts
 var DEFAULT_NETWORKS = [
@@ -1391,7 +1409,9 @@ function resolvePayTo(config, network, token) {
 function resolveFacilitatorUrl(config, network, token) {
   const chainId = network.config.chainId;
   if (config.facilitatorUrlByToken) {
-    for (const [chainKey, tokenMap] of Object.entries(config.facilitatorUrlByToken)) {
+    for (const [chainKey, tokenMap] of Object.entries(
+      config.facilitatorUrlByToken
+    )) {
       const resolvedChain = resolveNetwork(chainKey);
       if (!isValidationError2(resolvedChain) && resolvedChain.config.chainId === chainId) {
         for (const [tokenKey2, url] of Object.entries(tokenMap)) {
@@ -1404,7 +1424,9 @@ function resolveFacilitatorUrl(config, network, token) {
     }
   }
   if (config.facilitatorUrlByChain) {
-    for (const [chainKey, url] of Object.entries(config.facilitatorUrlByChain)) {
+    for (const [chainKey, url] of Object.entries(
+      config.facilitatorUrlByChain
+    )) {
       const resolvedChain = resolveNetwork(chainKey);
       if (!isValidationError2(resolvedChain) && resolvedChain.config.chainId === chainId) {
         return url;
@@ -1463,7 +1485,11 @@ function createPaymentRequirements(config) {
       const atomicAmount = toAtomicUnits(amount);
       const tokenConfig = resolvedToken.config;
       const resolvedPayTo = resolvePayTo(config, network, resolvedToken);
-      resolveFacilitatorUrl(config, network, resolvedToken);
+      resolveFacilitatorUrl(
+        config,
+        network,
+        resolvedToken
+      );
       const requirement = {
         scheme: "exact",
         network: network.caip2,
@@ -1497,28 +1523,6 @@ function findRequirementByNetwork(requirements, network) {
   return requirements.find((r) => r.network === netConfig.caip2Id);
 }
 
-// src/errors.ts
-var X402ClientError = class extends Error {
-  cause;
-  constructor(message, cause) {
-    super(message);
-    this.name = "X402ClientError";
-    this.cause = cause;
-  }
-};
-var SigningError = class extends X402ClientError {
-  constructor(message, cause) {
-    super(`Signing failed: ${message}`, cause);
-    this.name = "SigningError";
-  }
-};
-var PaymentException = class extends X402ClientError {
-  constructor(message, cause) {
-    super(`Payment failed: ${message}`, cause);
-    this.name = "PaymentException";
-  }
-};
-
 // src/protocol.ts
 function parseJsonOrBase64(value) {
   try {
@@ -1542,4 +1546,194 @@ function calculateValidBefore(expirySeconds = 3600) {
   return Math.floor(Date.now() / 1e3) + expirySeconds;
 }
 
-export { EIP712_TYPES, ERC20_ABI, EURC_BASE, NETWORKS, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER, PaymentException, SCHEMES, SKL_SKALE_BASE, SKL_SKALE_BASE_SEPOLIA, SigningError, TOKENS, USDC_BASE, USDC_BASE_SEPOLIA, USDC_DOMAIN, USDC_SKALE_BASE, USDC_SKALE_BASE_SEPOLIA, USDT_SKALE_BASE, USDT_SKALE_BASE_SEPOLIA, V2_HEADERS, WBTC_SKALE_BASE, WBTC_SKALE_BASE_SEPOLIA, WETH_SKALE_BASE, WETH_SKALE_BASE_SEPOLIA, X402ClientError, X402_VERSION, addressToAssetId, assetIdToAddress, caip2ToNetwork, calculateValidBefore, checkFacilitatorSupport, combineSignature as combineSignatureV2, createEIP712Domain, createError, createNonce, createPaymentRequiredHeaders, createPaymentRequirements, createSettlementHeaders, createTransferWithAuthorization, decodeBase64ToUtf8, decodePayloadHeader, decodePayment, decodePaymentV2, decodeSettlementResponse, decodeSettlementV2, decodeX402Response, detectPaymentVersion, detectX402Version, encodePayment, encodePaymentV2, encodeSettlementResponse, encodeSettlementV2, encodeUtf8ToBase64, encodeX402Response, extractPayerAddress, extractPaymentFromHeaders, findMatchingRoute, findRequirementByNetwork, fromAtomicUnits, generateNonce, getAllCustomTokens, getAllTokens, getAvailableNetworks, getAvailableTokens, getCurrentTimestamp, getCustomToken, getEURCTokens, getMainnets, getNetworkByChainId, getNetworkConfig, getPaymentHeaderName, getSKLTokens, getSupported, getTestnets, getToken, getTokensByChain, getTokensBySymbol, getTxHash, getUSDCTokens, getUSDTTokens, getWBTCTokens, getWETHTokens, isAddress, isCAIP2ChainId, isCAIPAssetId, isCustomToken, isExactEvmPayload, isPaymentPayload, isPaymentPayloadV2, isPaymentRequiredV2, isPaymentV2, isResolvedNetwork, isResolvedToken, isSettlementSuccessful, isSettlementV2, isValidAddress, isValidationError, isX402V2Payload, isX402V2PaymentRequired, isX402V2Requirements, isX402V2Settlement, matchRoute, networkToCaip2, normalizeAddress, normalizeBase64Url, normalizeNetworkName, parseJsonOrBase64, parseRoutePattern, parseSignature as parseSignatureV2, registerToken, resolveFacilitator, resolveNetwork, resolveToken, safeBase64Decode, safeBase64Encode, settlePayment, toAtomicUnits, toBase64Url, unregisterToken, validateAcceptConfig, validatePaymentConfig, validateRouteConfig, validateTransferWithAuthorization, verifyPayment };
+// src/types/protocol.ts
+function isX402V2Payload(obj) {
+  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "accepted" in obj && "payload" in obj;
+}
+function isX402V2Requirements(obj) {
+  return typeof obj === "object" && obj !== null && "scheme" in obj && obj.scheme === "exact" && "network" in obj && typeof obj.network === "string" && obj.network.startsWith("eip155:") && // CAIP-2 format
+  "amount" in obj && "asset" in obj && "payTo" in obj && "maxTimeoutSeconds" in obj;
+}
+function isX402V2Settlement(obj) {
+  return typeof obj === "object" && obj !== null && "success" in obj && typeof obj.success === "boolean" && "network" in obj && typeof obj.network === "string" && obj.network.startsWith("eip155:");
+}
+function isX402V2PaymentRequired(obj) {
+  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "resource" in obj && "accepts" in obj;
+}
+var PAYMENT_SIGNATURE_HEADER = "PAYMENT-SIGNATURE";
+var PAYMENT_RESPONSE_HEADER = "PAYMENT-RESPONSE";
+var PAYMENT_REQUIRED_HEADER = "PAYMENT-REQUIRED";
+function isSettlementSuccessful(response) {
+  return "success" in response ? response.success : false;
+}
+function getTxHash(response) {
+  if ("transaction" in response) return response.transaction;
+  return void 0;
+}
+
+// src/utils/routes.ts
+var PRIORITY_EXACT = 3;
+var PRIORITY_PARAMETRIZED = 2;
+var PRIORITY_WILDCARD = 1;
+function parseRoutePattern(pattern) {
+  const normalizedPattern = pattern.startsWith("/") ? pattern : `/${pattern}`;
+  const segments = normalizedPattern.split("/").filter(Boolean);
+  let isWildcard = false;
+  let isParametrized = false;
+  const paramNames = [];
+  const seenParamNames = /* @__PURE__ */ new Set();
+  const recordParamName = (name) => {
+    if (!name) {
+      return;
+    }
+    if (seenParamNames.has(name)) {
+      return;
+    }
+    seenParamNames.add(name);
+    paramNames.push(name);
+  };
+  for (const segment of segments) {
+    if (segment === "*") {
+      isWildcard = true;
+      continue;
+    }
+    const hasWildcardToken = segment.includes("*");
+    if (segment.startsWith(":")) {
+      isParametrized = true;
+      const paramName = segment.replace(/\*+$/, "").slice(1);
+      recordParamName(paramName);
+      if (hasWildcardToken) {
+        isWildcard = true;
+      }
+      continue;
+    }
+    if (hasWildcardToken) {
+      const parts = segment.split("*");
+      for (const part of parts) {
+        if (part.startsWith(":")) {
+          isParametrized = true;
+          recordParamName(part.slice(1));
+        }
+      }
+      isWildcard = true;
+    }
+  }
+  let priority = PRIORITY_WILDCARD;
+  if (!isWildcard && !isParametrized) {
+    priority = PRIORITY_EXACT;
+  } else if (isParametrized && !isWildcard) {
+    priority = PRIORITY_PARAMETRIZED;
+  } else if (isParametrized && isWildcard) {
+    priority = PRIORITY_PARAMETRIZED;
+  }
+  return { segments, isWildcard, isParametrized, paramNames, priority };
+}
+function matchSegment(patternSegment, pathSegment) {
+  if (patternSegment === "*") {
+    return true;
+  }
+  if (patternSegment.startsWith(":")) {
+    return true;
+  }
+  if (patternSegment.includes("*")) {
+    const regex = new RegExp(
+      `^${patternSegment.replace(/\*/g, ".*").replace(/:/g, "")}$`
+    );
+    return regex.test(pathSegment);
+  }
+  return patternSegment === pathSegment;
+}
+function matchWildcardPattern(patternSegments, pathSegments) {
+  const requiredSegments = patternSegments.filter((s) => s !== "*");
+  if (requiredSegments.length > pathSegments.length) {
+    return false;
+  }
+  for (let i = 0; i < requiredSegments.length; i++) {
+    const patternIndex = patternSegments.indexOf(requiredSegments[i]);
+    if (pathSegments[patternIndex] !== requiredSegments[i].replace(/^:/, "")) {
+      if (!requiredSegments[i].startsWith(":") && requiredSegments[i] !== "*") {
+        return false;
+      }
+    }
+  }
+  return true;
+}
+function matchRoute(pattern, path) {
+  const normalizedPattern = pattern.startsWith("/") ? pattern : `/${pattern}`;
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  if (normalizedPattern === normalizedPath) {
+    return true;
+  }
+  const parsed = parseRoutePattern(normalizedPattern);
+  const patternSegments = parsed.segments;
+  const pathSegments = normalizedPath.split("/").filter(Boolean);
+  if (!parsed.isWildcard && patternSegments.length !== pathSegments.length) {
+    return false;
+  }
+  if (parsed.isWildcard && patternSegments.length > pathSegments.length + 1) {
+    return false;
+  }
+  if (parsed.isWildcard) {
+    return matchWildcardPattern(patternSegments, pathSegments);
+  }
+  for (let i = 0; i < patternSegments.length; i++) {
+    if (!matchSegment(patternSegments[i], pathSegments[i])) {
+      return false;
+    }
+  }
+  return true;
+}
+function findMatchingRoute(routes, path) {
+  const matchingRoutes = [];
+  for (const route of routes) {
+    if (matchRoute(route.pattern, path)) {
+      const parsed = parseRoutePattern(route.pattern);
+      matchingRoutes.push({ route, parsed });
+    }
+  }
+  if (matchingRoutes.length === 0) {
+    return null;
+  }
+  matchingRoutes.sort((a, b) => {
+    if (b.parsed.priority !== a.parsed.priority) {
+      return b.parsed.priority - a.parsed.priority;
+    }
+    if (b.parsed.segments.length !== a.parsed.segments.length) {
+      return b.parsed.segments.length - a.parsed.segments.length;
+    }
+    return b.route.pattern.length - a.route.pattern.length;
+  });
+  return matchingRoutes[0].route;
+}
+function containsWildcard(pattern) {
+  return pattern.includes("*");
+}
+function validateRouteConfig(config) {
+  const { route, routes } = config;
+  if (!route && !routes) {
+    return null;
+  }
+  if (route && routes) {
+    return {
+      code: "INVALID_ROUTE_CONFIG",
+      message: "Cannot specify both 'route' and 'routes'. Use 'route' for a single exact path or 'routes' for multiple paths.",
+      path: "route",
+      value: { route, routes }
+    };
+  }
+  if (route && containsWildcard(route)) {
+    return {
+      code: "INVALID_ROUTE_PATTERN",
+      message: `Wildcard routes must use the routes array, not 'route'. Use 'routes: ["/api/*"]' instead of 'route: "/api/*"'.`,
+      path: "route",
+      value: route,
+      validOptions: [
+        'routes: ["/api/*"]',
+        'routes: ["/api/users", "/api/posts"]'
+      ]
+    };
+  }
+  return null;
+}
+
+export { EIP712_TYPES, ERC20_ABI, EURC_BASE, NETWORKS, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER, PaymentException, SCHEMES, SKL_SKALE_BASE, SKL_SKALE_BASE_SEPOLIA, SigningError, TOKENS, USDC_BASE, USDC_BASE_SEPOLIA, USDC_DOMAIN, USDC_SKALE_BASE, USDC_SKALE_BASE_SEPOLIA, USDT_SKALE_BASE, USDT_SKALE_BASE_SEPOLIA, V2_HEADERS, WBTC_SKALE_BASE, WBTC_SKALE_BASE_SEPOLIA, WETH_SKALE_BASE, WETH_SKALE_BASE_SEPOLIA, X402ClientError, X402_VERSION, addressToAssetId, assetIdToAddress, caip2ToNetwork, calculateValidBefore, checkFacilitatorSupport, combineSignature as combineSignatureV2, createEIP712Domain, createError, createNonce, createPaymentRequiredHeaders, createPaymentRequirements, createSettlementHeaders, createTransferWithAuthorization, decodeBase64ToUtf8, decodePayloadHeader, decodePayment, decodePaymentV2, decodeSettlementResponse, decodeSettlementV2, decodeX402Response, detectPaymentVersion, detectX402Version, encodePayment, encodePaymentV2, encodeSettlementResponse, encodeSettlementV2, encodeUtf8ToBase64, encodeX402Response, extractPayerAddress, extractPaymentFromHeaders, findMatchingRoute, findRequirementByNetwork, fromAtomicUnits, generateNonce, getAllCustomTokens, getAllTokens, getAvailableNetworks, getAvailableTokens, getCurrentTimestamp, getCustomToken, getEURCTokens, getMainnets, getNetworkByChainId, getNetworkConfig, getPaymentHeaderName, getSKLTokens, getSupported, getTestnets, getToken, getTokensByChain, getTokensBySymbol, getTxHash, getUSDCTokens, getUSDTTokens, getWBTCTokens, getWETHTokens, isAddress2 as isAddress, isCAIP2ChainId, isCAIPAssetId, isCustomToken, isExactEvmPayload, isPaymentPayload, isPaymentPayloadV2, isPaymentRequiredV2, isPaymentV2, isResolvedNetwork, isResolvedToken, isSettlementSuccessful, isSettlementV2, isValidAddress, isValidationError, isX402V2Payload, isX402V2PaymentRequired, isX402V2Requirements, isX402V2Settlement, matchRoute, networkToCaip2, normalizeAddress, normalizeBase64Url, normalizeNetworkName, parseJsonOrBase64, parseRoutePattern, parseSignature as parseSignatureV2, registerToken, resolveFacilitator, resolveNetwork, resolveToken, runAfterPaymentResponseHooks, runBeforeSignPaymentHooks, runOnPaymentRequiredHooks, safeBase64Decode2 as safeBase64Decode, safeBase64Encode2 as safeBase64Encode, selectRequirementWithHooks, settlePayment, toAtomicUnits, toBase64Url, unregisterToken, validateAcceptConfig, validatePaymentConfig, validateRouteConfig, validateTransferWithAuthorization, verifyPayment };