@zeroxyz/cli 1.2.0 → 1.3.0

package/dist/index.js

@@ -76582,7 +76582,7 @@ init_esm_shims();
 
 // package.json
 var package_default = {
-  version: "1.2.0"};
+  version: "1.3.0"};
 
 // src/app.ts
 init_esm_shims();
@@ -77578,7 +77578,7 @@ init_esm_shims();
 // ../sdk/dist/index.js
 init_esm_shims();
 
-// ../sdk/dist/chunk-SLXRHGE4.js
+// ../sdk/dist/chunk-RPL7VC32.js
 init_esm_shims();
 
 // ../../node_modules/.pnpm/viem@2.52.2_bufferutil@4.1.0_typescript@5.9.3_utf-8-validate@6.0.6_zod@4.3.6/node_modules/viem/_esm/index.js
@@ -143021,6 +143021,16 @@ var ZeroPaymentError = class extends ZeroError {
     this.name = "ZeroPaymentError";
   }
 };
+var ZeroInsufficientFundsError = class extends ZeroError {
+  have;
+  need;
+  constructor(message2, init) {
+    super("insufficient_funds", message2, { cause: init.cause });
+    this.name = "ZeroInsufficientFundsError";
+    this.have = init.have;
+    this.need = init.need;
+  }
+};
 var ZeroSessionCloseFailedError = class extends ZeroError {
   session;
   response;
@@ -143361,7 +143371,12 @@ var FETCH_SKIP_REASONS = Object.freeze({
   bodyReadFailed: "body_read_failed",
   mppSessionCloseFailedNotRecorded: "mpp_session_close_failed_not_recorded",
   paidButStill402NotRecorded: FETCH_WARNINGS.paidButStill402NotRecorded,
-  paymentSettlementUnconfirmed: FETCH_WARNINGS.paymentSettlementUnconfirmed
+  paymentSettlementUnconfirmed: FETCH_WARNINGS.paymentSettlementUnconfirmed,
+  // Pre-sign abort: deliberately NOT recorded as a run — the wallet was
+  // empty before we reached the capability, so charging it as a 402 would
+  // corrupt cap reliability. The wallet funnel is tracked via the
+  // fetch_executed.outcome analytics event instead.
+  insufficientFunds: "insufficient_funds_not_recorded"
 });
 var MAX_RECEIPT_HEADER_BYTES = 8 * 1024;
 var decodeSessionReceiptHeader = (header) => {
@@ -143503,6 +143518,7 @@ var Payments = class {
     );
     let capturedAmount = null;
     let capturedNetwork;
+    let preflightError = null;
     const x402 = registerExactEvmScheme(new x402Client(), { signer: account });
     x402.onBeforePaymentCreation(async (context) => {
       const selected = context.selectedRequirements;
@@ -143536,6 +143552,29 @@ var Payments = class {
           reason: `Payment of ${capturedAmount} USDC exceeds maxPay ${input.maxPay}`
         };
       }
+      const detected = networkToChain(capturedNetwork);
+      const balanceChain = detected === "base-sepolia" ? "base-sepolia" : "base";
+      let balance = null;
+      try {
+        balance = await this.readUsdcBalance(account.address, balanceChain);
+      } catch (readErr) {
+        this.client.logger?.({
+          level: "warn",
+          message: "Pre-flight balance read failed; proceeding to attempt payment",
+          meta: {
+            chain: balanceChain,
+            error: readErr instanceof Error ? readErr.message : String(readErr)
+          }
+        });
+      }
+      if (balance !== null && balance < rawAmountUnits) {
+        const have = formatUnits(balance, 6);
+        preflightError = new ZeroInsufficientFundsError(
+          `wallet has ${have} USDC on Base, needs ${capturedAmount}.`,
+          { have, need: capturedAmount }
+        );
+        return { abort: true, reason: preflightError.message };
+      }
     });
     const configuredFetch = buildConfiguredFetch(this.client, {
       timeoutMs: input.timeoutMs
@@ -143556,6 +143595,7 @@ var Payments = class {
         signal: input.signal
       });
     } catch (err) {
+      if (preflightError) throw preflightError;
       if (err instanceof ZeroError) throw err;
       throw new ZeroPaymentError(
         `x402 payment failed: ${err instanceof Error ? err.message : String(err)}`,
@@ -143800,23 +143840,29 @@ var Payments = class {
     );
     if (tempoBalance < requiredRaw) {
       if (coerced.chain === "tempo-testnet") {
-        throw new ZeroPaymentError(
-          `Insufficient pathUSD on Tempo testnet: have ${formatUnits(tempoBalance, 6)}, need ${capturedAmount}. Fund via the Tempo testnet faucet: https://docs.tempo.xyz/quickstart/faucet`
+        const have = formatUnits(tempoBalance, 6);
+        throw new ZeroInsufficientFundsError(
+          `Insufficient pathUSD on Tempo testnet: have ${have}, need ${capturedAmount}. Fund via the Tempo testnet faucet: https://docs.tempo.xyz/quickstart/faucet`,
+          { have, need: capturedAmount }
         );
       }
-      await this.bridgeBaseToTempo(account, requiredRaw - tempoBalance);
+      await this.bridgeBaseToTempo(account, requiredRaw - tempoBalance, {
+        isSessionDeposit: challenge2.intent === "session",
+        depositTotal: capturedAmount
+      });
     }
     return capturedAmount;
   };
-  bridgeBaseToTempo = async (account, requiredAmount) => {
+  bridgeBaseToTempo = async (account, requiredAmount, depositContext) => {
     this.ensureRelayClient();
     const baseBalance = await this.readUsdcBalance(account.address, "base");
     const buffer3 = calculateBuffer(baseBalance);
     const bridgeAmount = requiredAmount + buffer3;
     if (baseBalance < bridgeAmount) {
-      throw new ZeroPaymentError(
-        `Insufficient Base USDC to bridge: have ${formatUnits(baseBalance, 6)}, need ${formatUnits(bridgeAmount, 6)} (${formatUnits(requiredAmount, 6)} + ${formatUnits(buffer3, 6)} buffer). This capability uses an MPP payment channel, which is pre-funded up front. Either fund your wallet on Base, or pass \`maxPay\` to size a smaller channel (e.g. \`maxPay: '0.05'\` for a ~5-cent channel sized for a single cheap call).`
-      );
+      const have = formatUnits(baseBalance, 6);
+      const need = formatUnits(bridgeAmount, 6);
+      const message2 = depositContext?.isSessionDeposit ? `wallet has ${have} USDC on Base, but this capability pre-funds a ${depositContext.depositTotal} USDC MPP payment channel up front (the channel is deposited before the call, so it asks for more than a single charge). Needs ${need} on Base to open it \u2014 fund the wallet, or pass a smaller \`maxPay\` (e.g. '0.05') to size the channel down to one cheap call.` : `wallet has ${have} USDC on Base, needs ${need} to fund this capability's MPP payment channel (${formatUnits(requiredAmount, 6)} + ${formatUnits(buffer3, 6)} buffer). Tip: pass a smaller \`maxPay\` (e.g. '0.05') to size a cheaper channel.`;
+      throw new ZeroInsufficientFundsError(message2, { have, need });
     }
     this.client.logger?.({
       level: "info",
@@ -144034,7 +144080,7 @@ var Payments = class {
   };
 };
 var package_default2 = {
-  version: "0.2.0"
+  version: "0.4.0"
 };
 var SDK_VERSION2 = package_default2.version;
 var userWalletDtoSchema = external_exports3.object({
@@ -145395,6 +145441,15 @@ var clientFetch = async (client, url4, opts = {}) => {
             session: err.session
           };
           warnings.push(FETCH_WARNINGS.mppSessionCloseFailed);
+        } else if (err instanceof ZeroInsufficientFundsError) {
+          return errorFetchResult(
+            startedAt,
+            err.message,
+            FETCH_SKIP_REASONS.insufficientFunds,
+            capabilityIdRequested,
+            "insufficient_funds",
+            null
+          );
         } else if (err instanceof ZeroPaymentError || err instanceof ZeroAuthError) {
           const result2 = errorFetchResult(
             startedAt,
@@ -145592,8 +145647,15 @@ var searchResultSchema = external_exports3.object({
   slug: external_exports3.string(),
   name: external_exports3.string(),
   canonicalName: external_exports3.string().nullable().optional(),
+  brandName: external_exports3.string().nullable().optional(),
   description: external_exports3.string(),
   whatItDoes: external_exports3.string().nullable().optional(),
+  // HTTP verb the capability expects. Surfaced on the search row so a caller
+  // can tell GET from POST without a `capabilities.get()` round-trip — enough
+  // to `fetch()` a no-body GET directly. POST bodies still need `get()` for
+  // the `bodySchema`. Optional (not required) so a response that omits it —
+  // an older API deploy — still parses rather than failing the whole search.
+  method: external_exports3.string().optional(),
   url: external_exports3.string(),
   urlTemplate: external_exports3.string().nullable().optional(),
   cost: external_exports3.object({ amount: external_exports3.string(), asset: external_exports3.string() }),
@@ -146341,6 +146403,14 @@ var OUTCOMES = {
     errorClass: "payment_rejected",
     reviewable: false
   },
+  // Wallet can't cover the call (pre-sign abort). A funding condition, not
+  // a cap failure — the SDK records no run, so this is the only surviving
+  // signal. Not reviewable (we never reached the capability).
+  insufficient_funds: {
+    exitCode: 1,
+    errorClass: "insufficient_funds",
+    reviewable: false
+  },
   server_error: { exitCode: 0, errorClass: "upstream_4xx", reviewable: true }
 };
 var cliErrorClassFor = (outcome, status, walletAddress) => {
@@ -146757,6 +146827,16 @@ var fetchCommand = (appContext) => new Command("fetch").description(
             `  Payment failed: ${resultError ?? "could not complete payment"}`
           );
           if (legacyMigrateHint) console.error(`  ${legacyMigrateHint}`);
+        } else if (outcome === "insufficient_funds") {
+          console.error(
+            `  Insufficient funds: ${resultError ?? "wallet can't cover this call"}`
+          );
+          if (!resultError?.includes("faucet")) {
+            console.error(
+              "  Top off your wallet with `zero wallet fund`, then retry."
+            );
+          }
+          if (legacyMigrateHint) console.error(`  ${legacyMigrateHint}`);
         } else if (outcome === "payment_rejected") {
           console.error(
             `  Upstream returned 402 after payment was sent \u2014 the seller's facilitator rejected the credential${messageSuffix}`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zeroxyz/cli",
-	"version": "1.2.0",
+	"version": "1.3.0",
 	"type": "module",
 	"bin": {
 		"zero": "dist/index.js",