@dexterai/x402 1.9.3 → 2.0.0

package/dist/adapters/index.cjs

@@ -131,8 +131,11 @@ var SolanaAdapter = class {
       const account = await (0, import_spl_token.getAccount)(connection, ata, void 0, programId);
       const decimals = accept.extra?.decimals ?? 6;
       return Number(account.amount) / Math.pow(10, decimals);
-    } catch {
-      return 0;
+    } catch (err) {
+      if (err && typeof err === "object" && "name" in err && (err.name === "TokenAccountNotFoundError" || err.name === "TokenInvalidAccountOwnerError")) {
+        return 0;
+      }
+      throw err;
     }
   }
   async buildTransaction(accept, wallet, rpcUrl) {
@@ -360,15 +363,21 @@ var EvmAdapter = class {
           ]
         })
       });
+      if (!response.ok) {
+        throw new Error(`RPC request failed: ${response.status}`);
+      }
       const result = await response.json();
-      if (result.error || !result.result) {
+      if (result.error) {
+        throw new Error(`RPC error: ${JSON.stringify(result.error)}`);
+      }
+      if (!result.result || result.result === "0x") {
         return 0;
       }
       const balance = BigInt(result.result);
       const decimals = accept.extra?.decimals ?? 6;
       return Number(balance) / Math.pow(10, decimals);
-    } catch {
-      return 0;
+    } catch (err) {
+      throw err;
     }
   }
   encodeBalanceOf(address) {
@@ -502,4 +511,3 @@ function findAdapter(adapters, network) {
   isKnownUSDC,
   isSolanaWallet
 });
-//# sourceMappingURL=index.cjs.map

package/dist/adapters/index.d.cts

@@ -1,8 +1,6 @@
-import { C as ChainAdapter } from '../types-DmqH9yD8.cjs';
-export { A as AdapterConfig, B as BalanceInfo, G as GenericWallet, S as SignedTransaction, W as WalletSet } from '../types-DmqH9yD8.cjs';
-import { b as SolanaAdapter, d as EvmAdapter } from '../solana-CfHuiW2H.cjs';
-export { A as ARBITRUM_ONE, k as AVALANCHE, B as BASE_MAINNET, j as BASE_SEPOLIA, n as ETHEREUM_MAINNET, E as EvmWallet, O as OPTIMISM, P as POLYGON, l as SKALE_BASE, m as SKALE_BASE_SEPOLIA, e as SOLANA_DEVNET, S as SOLANA_MAINNET, f as SOLANA_TESTNET, g as SolanaWallet, U as USDC_ADDRESSES, a as createEvmAdapter, c as createSolanaAdapter, h as isEvmWallet, i as isSolanaWallet } from '../solana-CfHuiW2H.cjs';
-import '../types-BQvaF8lB.cjs';
+import { e as SolanaAdapter, f as EvmAdapter, C as ChainAdapter } from '../types-DWhpiOBD.cjs';
+export { m as ARBITRUM_ONE, n as AVALANCHE, A as AdapterConfig, B as BASE_MAINNET, l as BASE_SEPOLIA, d as BalanceInfo, q as ETHEREUM_MAINNET, E as EvmWallet, G as GenericWallet, O as OPTIMISM, P as POLYGON, o as SKALE_BASE, p as SKALE_BASE_SEPOLIA, h as SOLANA_DEVNET, b as SOLANA_MAINNET, j as SOLANA_TESTNET, g as SignedTransaction, S as SolanaWallet, U as USDC_ADDRESSES, W as WalletSet, a as createEvmAdapter, c as createSolanaAdapter, k as isEvmWallet, i as isSolanaWallet } from '../types-DWhpiOBD.cjs';
+import '../types-CjLMR7qs.cjs';
 
 /**
  * Check if an asset address is a known USDC contract (any chain).

package/dist/adapters/index.d.ts

@@ -1,8 +1,6 @@
-import { C as ChainAdapter } from '../types-ENcnkof8.js';
-export { A as AdapterConfig, B as BalanceInfo, G as GenericWallet, S as SignedTransaction, W as WalletSet } from '../types-ENcnkof8.js';
-import { b as SolanaAdapter, d as EvmAdapter } from '../solana-kZcwbUK9.js';
-export { A as ARBITRUM_ONE, k as AVALANCHE, B as BASE_MAINNET, j as BASE_SEPOLIA, n as ETHEREUM_MAINNET, E as EvmWallet, O as OPTIMISM, P as POLYGON, l as SKALE_BASE, m as SKALE_BASE_SEPOLIA, e as SOLANA_DEVNET, S as SOLANA_MAINNET, f as SOLANA_TESTNET, g as SolanaWallet, U as USDC_ADDRESSES, a as createEvmAdapter, c as createSolanaAdapter, h as isEvmWallet, i as isSolanaWallet } from '../solana-kZcwbUK9.js';
-import '../types-BQvaF8lB.js';
+import { e as SolanaAdapter, f as EvmAdapter, C as ChainAdapter } from '../types-D1TGACsL.js';
+export { m as ARBITRUM_ONE, n as AVALANCHE, A as AdapterConfig, B as BASE_MAINNET, l as BASE_SEPOLIA, d as BalanceInfo, q as ETHEREUM_MAINNET, E as EvmWallet, G as GenericWallet, O as OPTIMISM, P as POLYGON, o as SKALE_BASE, p as SKALE_BASE_SEPOLIA, h as SOLANA_DEVNET, b as SOLANA_MAINNET, j as SOLANA_TESTNET, g as SignedTransaction, S as SolanaWallet, U as USDC_ADDRESSES, W as WalletSet, a as createEvmAdapter, c as createSolanaAdapter, k as isEvmWallet, i as isSolanaWallet } from '../types-D1TGACsL.js';
+import '../types-CjLMR7qs.js';
 
 /**
  * Check if an asset address is a known USDC contract (any chain).

package/dist/adapters/index.js

@@ -87,8 +87,11 @@ var SolanaAdapter = class {
       const account = await getAccount(connection, ata, void 0, programId);
       const decimals = accept.extra?.decimals ?? 6;
       return Number(account.amount) / Math.pow(10, decimals);
-    } catch {
-      return 0;
+    } catch (err) {
+      if (err && typeof err === "object" && "name" in err && (err.name === "TokenAccountNotFoundError" || err.name === "TokenInvalidAccountOwnerError")) {
+        return 0;
+      }
+      throw err;
     }
   }
   async buildTransaction(accept, wallet, rpcUrl) {
@@ -316,15 +319,21 @@ var EvmAdapter = class {
           ]
         })
       });
+      if (!response.ok) {
+        throw new Error(`RPC request failed: ${response.status}`);
+      }
       const result = await response.json();
-      if (result.error || !result.result) {
+      if (result.error) {
+        throw new Error(`RPC error: ${JSON.stringify(result.error)}`);
+      }
+      if (!result.result || result.result === "0x") {
         return 0;
       }
       const balance = BigInt(result.result);
       const decimals = accept.extra?.decimals ?? 6;
       return Number(balance) / Math.pow(10, decimals);
-    } catch {
-      return 0;
+    } catch (err) {
+      throw err;
     }
   }
   encodeBalanceOf(address) {
@@ -457,4 +466,3 @@ export {
   isKnownUSDC,
   isSolanaWallet
 };
-//# sourceMappingURL=index.js.map

package/dist/client/index.cjs

@@ -187,9 +187,11 @@ var client_exports = {};
 __export(client_exports, {
   BASE_MAINNET: () => BASE_MAINNET,
   DEXTER_FACILITATOR_URL: () => DEXTER_FACILITATOR_URL,
+  KEYPAIR_SYMBOL: () => KEYPAIR_SYMBOL,
   SOLANA_MAINNET: () => SOLANA_MAINNET,
   USDC_MINT: () => USDC_MINT,
   X402Error: () => X402Error,
+  createBudgetAccount: () => createBudgetAccount,
   createEvmAdapter: () => createEvmAdapter,
   createEvmKeypairWallet: () => createEvmKeypairWallet,
   createKeypairWallet: () => createKeypairWallet,
@@ -201,6 +203,7 @@ __export(client_exports, {
   getSponsoredRecommendations: () => getSponsoredRecommendations,
   isEvmKeypairWallet: () => isEvmKeypairWallet,
   isKeypairWallet: () => isKeypairWallet,
+  searchAPIs: () => searchAPIs,
   wrapFetch: () => wrapFetch
 });
 module.exports = __toCommonJS(client_exports);
@@ -298,8 +301,11 @@ var SolanaAdapter = class {
       const account = await (0, import_spl_token.getAccount)(connection, ata, void 0, programId);
       const decimals = accept.extra?.decimals ?? 6;
       return Number(account.amount) / Math.pow(10, decimals);
-    } catch {
-      return 0;
+    } catch (err) {
+      if (err && typeof err === "object" && "name" in err && (err.name === "TokenAccountNotFoundError" || err.name === "TokenInvalidAccountOwnerError")) {
+        return 0;
+      }
+      throw err;
     }
   }
   async buildTransaction(accept, wallet, rpcUrl) {
@@ -527,15 +533,21 @@ var EvmAdapter = class {
           ]
         })
       });
+      if (!response.ok) {
+        throw new Error(`RPC request failed: ${response.status}`);
+      }
       const result = await response.json();
-      if (result.error || !result.result) {
+      if (result.error) {
+        throw new Error(`RPC error: ${JSON.stringify(result.error)}`);
+      }
+      if (!result.result || result.result === "0x") {
         return 0;
       }
       const balance = BigInt(result.result);
       const decimals = accept.extra?.decimals ?? 6;
       return Number(balance) / Math.pow(10, decimals);
-    } catch {
-      return 0;
+    } catch (err) {
+      throw err;
     }
   }
   encodeBalanceOf(address) {
@@ -651,10 +663,34 @@ function createX402Client(config) {
     maxAmountAtomic,
     fetch: customFetch = globalThis.fetch,
     verbose = false,
-    accessPass: accessPassConfig
+    accessPass: accessPassConfig,
+    onPaymentRequired,
+    maxRetries = 0,
+    retryDelayMs = 500
   } = config;
   const log = verbose ? console.log.bind(console, "[x402]") : () => {
   };
+  async function fetchWithRetry(input, init) {
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        const response = await customFetch(input, init);
+        if (response.status >= 502 && response.status <= 504 && attempt < maxRetries) {
+          log(`Retry ${attempt + 1}/${maxRetries}: server returned ${response.status}`);
+          await new Promise((r) => setTimeout(r, retryDelayMs * Math.pow(2, attempt)));
+          continue;
+        }
+        return response;
+      } catch (err) {
+        lastError = err;
+        if (attempt < maxRetries) {
+          log(`Retry ${attempt + 1}/${maxRetries}: ${err instanceof Error ? err.message : "network error"}`);
+          await new Promise((r) => setTimeout(r, retryDelayMs * Math.pow(2, attempt)));
+        }
+      }
+    }
+    throw lastError;
+  }
   const passCache = /* @__PURE__ */ new Map();
   function getCachedPass(url) {
     try {
@@ -764,13 +800,17 @@ function createX402Client(config) {
     const paymentAmount = accept.amount ?? accept.maxAmountRequired;
     if (!paymentAmount) return null;
     const rpcUrl = getRpcUrl(accept.network, adapter);
-    const balance = await adapter.getBalance(accept, wallet, rpcUrl);
-    const requiredAmount = Number(paymentAmount) / Math.pow(10, decimals);
-    if (balance < requiredAmount) {
-      throw new X402Error(
-        "insufficient_balance",
-        `Insufficient balance for access pass. Have $${balance.toFixed(4)}, need $${requiredAmount.toFixed(4)}`
-      );
+    try {
+      const balance = await adapter.getBalance(accept, wallet, rpcUrl);
+      const requiredAmount = Number(paymentAmount) / Math.pow(10, decimals);
+      if (balance < requiredAmount) {
+        throw new X402Error(
+          "insufficient_balance",
+          `Insufficient balance for access pass. Have $${balance.toFixed(4)}, need $${requiredAmount.toFixed(4)}`
+        );
+      }
+    } catch (err) {
+      if (err instanceof X402Error) throw err;
     }
     const signedTx = await adapter.buildTransaction(accept, wallet, rpcUrl);
     let payload;
@@ -783,13 +823,19 @@ function createX402Client(config) {
     let resolvedResource = requirements.resource;
     if (typeof requirements.resource === "string") {
       try {
-        resolvedResource = new URL(requirements.resource, originalUrl).toString();
+        const resolved = new URL(requirements.resource, originalUrl);
+        if (["http:", "https:"].includes(resolved.protocol)) {
+          resolvedResource = resolved.toString();
+        }
       } catch {
       }
     } else if (requirements.resource && typeof requirements.resource === "object" && "url" in requirements.resource) {
       const rObj = requirements.resource;
       try {
-        resolvedResource = { ...rObj, url: new URL(rObj.url, originalUrl).toString() };
+        const resolved = new URL(rObj.url, originalUrl);
+        if (["http:", "https:"].includes(resolved.protocol)) {
+          resolvedResource = { ...rObj, url: resolved.toString() };
+        }
       } catch {
       }
     }
@@ -844,7 +890,7 @@ function createX402Client(config) {
         }
       }
     }
-    const response = await customFetch(input, init);
+    const response = await fetchWithRetry(input, init);
     if (response.status !== 402) {
       return response;
     }
@@ -917,16 +963,27 @@ function createX402Client(config) {
     }
     const rpcUrl = getRpcUrl(accept.network, adapter);
     log("Checking balance...");
-    const balance = await adapter.getBalance(accept, wallet, rpcUrl);
-    const requiredAmount = Number(paymentAmount) / Math.pow(10, decimals);
-    if (balance < requiredAmount) {
-      const network = adapter.name === "EVM" ? "Base" : "Solana";
-      throw new X402Error(
-        "insufficient_balance",
-        `Insufficient USDC balance on ${network}. Have $${balance.toFixed(4)}, need $${requiredAmount.toFixed(4)}`
-      );
+    try {
+      const balance = await adapter.getBalance(accept, wallet, rpcUrl);
+      const requiredAmount = Number(paymentAmount) / Math.pow(10, decimals);
+      if (balance < requiredAmount) {
+        const network = adapter.name === "EVM" ? "Base" : "Solana";
+        throw new X402Error(
+          "insufficient_balance",
+          `Insufficient USDC balance on ${network}. Have $${balance.toFixed(4)}, need $${requiredAmount.toFixed(4)}`
+        );
+      }
+      log(`Balance OK: $${balance.toFixed(4)} >= $${requiredAmount.toFixed(4)}`);
+    } catch (err) {
+      if (err instanceof X402Error) throw err;
+      log("Balance check failed (RPC error), proceeding with transaction attempt");
+    }
+    if (onPaymentRequired) {
+      const approved = await onPaymentRequired(accept);
+      if (!approved) {
+        throw new X402Error("payment_rejected", "Payment rejected by onPaymentRequired callback");
+      }
     }
-    log(`Balance OK: $${balance.toFixed(4)} >= $${requiredAmount.toFixed(4)}`);
     log("Building transaction...");
     const signedTx = await adapter.buildTransaction(accept, wallet, rpcUrl);
     log("Transaction signed");
@@ -968,7 +1025,7 @@ function createX402Client(config) {
     };
     const paymentSignatureHeader = btoa(JSON.stringify(paymentSignature));
     log("Retrying request with payment...");
-    const retryResponse = await customFetch(input, {
+    const retryResponse = await fetchWithRetry(input, {
       ...init,
       headers: {
         ...init?.headers || {},
@@ -1012,6 +1069,7 @@ function createX402Client(config) {
 
 // src/client/keypair-wallet.ts
 var import_web32 = require("@solana/web3.js");
+var KEYPAIR_SYMBOL = /* @__PURE__ */ Symbol.for("x402:keypair");
 async function createKeypairWallet(privateKey) {
   let keypair;
   if (typeof privateKey === "string") {
@@ -1066,7 +1124,9 @@ async function createKeypairWallet(privateKey) {
       }
       throw new Error("Unknown transaction type");
     },
+    [KEYPAIR_SYMBOL]: keypair,
     keypair
+    // deprecated — kept for backwards compat
   };
 }
 function isKeypairWallet(wallet) {
@@ -1109,7 +1169,8 @@ function wrapFetch(fetchImpl, options) {
     rpcUrls,
     maxAmountAtomic,
     verbose,
-    accessPass
+    accessPass,
+    onPaymentRequired
   } = options;
   if (!walletPrivateKey && !evmPrivateKey) {
     throw new Error("At least one wallet private key is required (walletPrivateKey or evmPrivateKey)");
@@ -1142,7 +1203,8 @@ function wrapFetch(fetchImpl, options) {
     maxAmountAtomic,
     fetch: fetchImpl,
     verbose,
-    accessPass
+    accessPass,
+    onPaymentRequired
   };
   const client = createX402Client(clientConfig);
   const clientFetch = client.fetch.bind(client);
@@ -1155,6 +1217,164 @@ function wrapFetch(fetchImpl, options) {
   return clientFetch;
 }
 
+// src/client/discovery.ts
+var DEFAULT_MARKETPLACE = "https://x402.dexter.cash/api/facilitator/marketplace/resources";
+async function searchAPIs(options = {}) {
+  const {
+    query,
+    category,
+    network,
+    maxPrice,
+    verifiedOnly,
+    sort = "marketplace",
+    limit = 20,
+    marketplaceUrl = DEFAULT_MARKETPLACE
+  } = options;
+  const params = new URLSearchParams();
+  if (query) params.set("search", query);
+  if (category) params.set("category", category);
+  if (network) params.set("network", network);
+  if (maxPrice !== void 0) params.set("maxPrice", String(maxPrice));
+  if (verifiedOnly) params.set("verified", "true");
+  params.set("sort", sort);
+  params.set("order", "desc");
+  params.set("limit", String(Math.min(limit, 50)));
+  const url = `${marketplaceUrl}?${params.toString()}`;
+  const response = await fetch(url, {
+    headers: { "Accept": "application/json" },
+    signal: AbortSignal.timeout(15e3)
+  });
+  if (!response.ok) {
+    throw new Error(`Marketplace search failed: ${response.status}`);
+  }
+  const data = await response.json();
+  if (!data.resources) return [];
+  return data.resources.map((r) => ({
+    name: r.displayName || r.resourceUrl,
+    url: r.resourceUrl,
+    method: r.method || "GET",
+    price: r.priceLabel || (r.priceUsdc ? `$${r.priceUsdc.toFixed(4)}` : "free"),
+    priceUsdc: r.priceUsdc ?? null,
+    network: r.priceNetwork ?? null,
+    description: r.description || "",
+    category: r.category || "uncategorized",
+    qualityScore: r.qualityScore ?? null,
+    verified: r.verificationStatus === "pass",
+    totalCalls: r.totalSettlements || 0,
+    totalVolume: r.totalVolumeUsdc ? `$${r.totalVolumeUsdc.toLocaleString("en-US", { minimumFractionDigits: 2 })}` : null,
+    seller: r.seller?.displayName ?? null,
+    sellerReputation: r.reputationScore ?? null,
+    authRequired: r.authRequired || false,
+    lastActive: r.lastSettlementAt ?? null
+  }));
+}
+
+// src/client/budget-account.ts
+function createBudgetAccount(config) {
+  const { budget, allowedDomains, onPaymentRequired: userOnPayment, ...fetchOptions } = config;
+  const totalBudget = parseFloat(budget.total);
+  const perRequestMax = budget.perRequest ? parseFloat(budget.perRequest) : Infinity;
+  const perHourMax = budget.perHour ? parseFloat(budget.perHour) : Infinity;
+  if (isNaN(totalBudget) || totalBudget <= 0) {
+    throw new Error("budget.total must be a positive number");
+  }
+  let ledger = [];
+  let pendingAmount = 0;
+  function getSpent() {
+    return ledger.reduce((sum, r) => sum + r.amount, 0);
+  }
+  function getHourlySpend() {
+    const cutoff = Date.now() - 36e5;
+    return ledger.filter((r) => r.timestamp >= cutoff).reduce((sum, r) => sum + r.amount, 0);
+  }
+  const innerFetch = wrapFetch(fetch, {
+    ...fetchOptions,
+    onPaymentRequired: async (accept) => {
+      const decimals = accept.extra?.decimals ?? 6;
+      const amountUsd = Number(accept.amount) / Math.pow(10, decimals);
+      if (amountUsd > perRequestMax) {
+        throw new X402Error(
+          "amount_exceeds_max",
+          `$${amountUsd.toFixed(4)} exceeds per-request limit of $${perRequestMax.toFixed(2)}`
+        );
+      }
+      const spent = getSpent();
+      if (spent + amountUsd > totalBudget) {
+        throw new X402Error(
+          "amount_exceeds_max",
+          `Budget exceeded. Spent $${spent.toFixed(2)} of $${totalBudget.toFixed(2)}, payment: $${amountUsd.toFixed(4)}`
+        );
+      }
+      const hourly = getHourlySpend();
+      if (hourly + amountUsd > perHourMax) {
+        throw new X402Error(
+          "amount_exceeds_max",
+          `Hourly limit ($${perHourMax.toFixed(2)}) exceeded. Spent $${hourly.toFixed(2)} this hour`
+        );
+      }
+      pendingAmount = amountUsd;
+      if (userOnPayment) return userOnPayment(accept);
+      return true;
+    }
+  });
+  const budgetFetch = (async (input, init) => {
+    const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    let domain = "unknown";
+    try {
+      domain = new URL(url).hostname;
+    } catch {
+    }
+    if (allowedDomains) {
+      if (!allowedDomains.some((d) => domain === d || domain.endsWith(`.${d}`))) {
+        throw new X402Error("payment_rejected", `Domain "${domain}" not in allowed domains`);
+      }
+    }
+    pendingAmount = 0;
+    const response = await innerFetch(input, init);
+    if (pendingAmount > 0) {
+      let network = "unknown";
+      const paymentHeader = response.headers.get("PAYMENT-RESPONSE");
+      if (paymentHeader) {
+        try {
+          const decoded = JSON.parse(atob(paymentHeader));
+          network = decoded.network || network;
+        } catch {
+        }
+      }
+      ledger.push({ amount: pendingAmount, domain, network, timestamp: Date.now() });
+      pendingAmount = 0;
+    }
+    return response;
+  });
+  return {
+    fetch: budgetFetch,
+    get spent() {
+      return `$${getSpent().toFixed(2)}`;
+    },
+    get remaining() {
+      return `$${(totalBudget - getSpent()).toFixed(2)}`;
+    },
+    get payments() {
+      return ledger.length;
+    },
+    get spentAmount() {
+      return getSpent();
+    },
+    get remainingAmount() {
+      return totalBudget - getSpent();
+    },
+    get ledger() {
+      return ledger;
+    },
+    get hourlySpend() {
+      return getHourlySpend();
+    },
+    reset() {
+      ledger = [];
+    }
+  };
+}
+
 // src/client/sponsored-access.ts
 function getSponsoredAccessInfo(response) {
   const receipt = getPaymentReceipt(response);
@@ -1180,9 +1400,11 @@ async function fireImpressionBeacon(response) {
 0 && (module.exports = {
   BASE_MAINNET,
   DEXTER_FACILITATOR_URL,
+  KEYPAIR_SYMBOL,
   SOLANA_MAINNET,
   USDC_MINT,
   X402Error,
+  createBudgetAccount,
   createEvmAdapter,
   createEvmKeypairWallet,
   createKeypairWallet,
@@ -1194,6 +1416,6 @@ async function fireImpressionBeacon(response) {
   getSponsoredRecommendations,
   isEvmKeypairWallet,
   isKeypairWallet,
+  searchAPIs,
   wrapFetch
 });
-//# sourceMappingURL=index.cjs.map