@zeroxyz/cli 0.0.7 → 0.0.9

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command as Command8 } from "commander";
 // package.json
 var package_default = {
   name: "@zeroxyz/cli",
-  version: "0.0.7",
+  version: "0.0.9",
   type: "module",
   bin: {
     zero: "dist/index.js",
@@ -26,8 +26,9 @@ var package_default = {
     dev: "tsx src/index.ts",
     cli: "ZERO_API_URL=http://localhost:1111 tsx src/index.ts",
     "test:integration": "vitest run --project integration",
+    "test:online": "vitest run --project online",
     "test:unit": "vitest run --project unit",
-    test: "pnpm run test:integration",
+    test: "pnpm run test:unit && pnpm run test:integration",
     typecheck: "tsc"
   },
   dependencies: {
@@ -35,6 +36,8 @@ var package_default = {
     "@relayprotocol/relay-sdk": "^5.2.1",
     "@x402/core": "^2.9.0",
     "@x402/evm": "^2.9.0",
+    "@x402/extensions": "^2.9.0",
+    "@x402/fetch": "^2.9.0",
     commander: "^13.0.0",
     mppx: "^0.5.9",
     open: "^11.0.0",
@@ -43,7 +46,10 @@ var package_default = {
     zod: "^4.3.5"
   },
   devDependencies: {
+    "@hono/node-server": "^1.19.13",
     "@types/node": "^25.0.7",
+    "@x402/hono": "^2.9.0",
+    hono: "^4.12.12",
     tsup: "^8.5.1",
     tsx: "^4.21.0",
     typescript: "^5.9.3",
@@ -105,7 +111,7 @@ var configCommand = (_appContext) => new Command("config").description("View or
 import { Command as Command2 } from "commander";
 var detectPaymentRequirement = (headers, status) => {
   if (status !== 402) return null;
-  const x402Header = headers.get("x-payment-required");
+  const x402Header = headers.get("payment-required") ?? headers.get("x-payment-required");
   if (x402Header) {
     try {
       const decoded = JSON.parse(
@@ -218,10 +224,25 @@ var fetchCommand = (appContext2) => new Command2("fetch").description("Fetch a c
               paymentMode: "charge"
             }
           });
+          console.error(`
+  Run ID: ${runResult.runId}`);
           console.error(
-            `
-  Run \`zero review ${runResult.runId}\` to rate this capability.
-`
+            `  Leave a review to help other agents discover great capabilities:`
+          );
+          console.error(
+            `  zero review ${runResult.runId} --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"`
+          );
+          console.error(
+            [
+              ``,
+              `  Tips for a great review:`,
+              `    --success / --no-success   Did the API return the result you expected?`,
+              `    --accuracy  1-5            How correct was the response? (1 = wrong, 5 = perfect)`,
+              `    --value     1-5            Was it worth the price? (1 = overpriced, 5 = great deal)`,
+              `    --reliability 1-5          Did it respond quickly and without errors? (1 = flaky, 5 = rock solid)`,
+              `    --content                  Free-text is optional but helps other agents pick the best capability.`,
+              ``
+            ].join("\n")
           );
         } catch {
         }
@@ -498,7 +519,19 @@ var initCommand = (appContext2) => new Command4("init").description("Initialize
 
 // src/commands/review-command.ts
 import { Command as Command5 } from "commander";
-var reviewCommand = (appContext2) => new Command5("review").description("Submit a review for a capability run").argument("<runId>", "Run ID to review").option("--success", "The capability succeeded").option("--no-success", "The capability failed").requiredOption("--accuracy <n>", "Accuracy rating (1-5)", Number.parseInt).requiredOption("--value <n>", "Value rating (1-5)", Number.parseInt).requiredOption(
+var reviewCommand = (appContext2) => new Command5("review").description("Submit a review for a capability run").addHelpText(
+  "after",
+  `
+Tips for a great review:
+  --success / --no-success   Did the API return the result you expected?
+  --accuracy  1-5            How correct was the response? (1 = wrong, 5 = perfect)
+  --value     1-5            Was it worth the price? (1 = overpriced, 5 = great deal)
+  --reliability 1-5          Did it respond quickly and without errors? (1 = flaky, 5 = rock solid)
+  --content                  Free-text is optional but helps other agents pick the best capability.
+
+Example:
+  zero review run_abc123 --success --accuracy 5 --value 4 --reliability 5 --content "Fast, accurate translation"`
+).argument("<runId>", "Run ID to review").option("--success", "The capability succeeded").option("--no-success", "The capability failed").requiredOption("--accuracy <n>", "Accuracy rating (1-5)", Number.parseInt).requiredOption("--value <n>", "Value rating (1-5)", Number.parseInt).requiredOption(
   "--reliability <n>",
   "Reliability rating (1-5)",
   Number.parseInt
@@ -617,6 +650,7 @@ ${address}`);
     if (url) {
       await open(url);
       console.log("Opened funding page in your browser.");
+      console.log(`If it didn't open, visit: ${url}`);
       console.log(`Your wallet address: ${address}`);
       analyticsService.capture("wallet_funded", {
         method: "browser",
@@ -806,6 +840,7 @@ var capabilityResponseSchema = z2.object({
   method: z2.string(),
   headers: z2.record(z2.string(), z2.string()).nullable(),
   bodySchema: z2.record(z2.string(), z2.unknown()).nullable(),
+  responseSchema: z2.record(z2.string(), z2.unknown()).nullable(),
   example: z2.object({ request: z2.unknown(), response: z2.unknown() }).nullable(),
   tags: z2.array(z2.string()).nullable(),
   displayCostAmount: z2.string(),
@@ -923,13 +958,11 @@ import {
   MAINNET_RELAY_API
 } from "@relayprotocol/relay-sdk";
 import { x402Client as X402Client } from "@x402/core/client";
-import {
-  decodePaymentRequiredHeader,
-  decodePaymentResponseHeader,
-  encodePaymentSignatureHeader
-} from "@x402/core/http";
+import { decodePaymentResponseHeader, x402HTTPClient } from "@x402/core/http";
 import { ExactEvmScheme } from "@x402/evm/exact/client";
-import { Challenge } from "mppx";
+import { createSIWxClientHook } from "@x402/extensions/sign-in-with-x";
+import { wrapFetchWithPayment } from "@x402/fetch";
+import { Receipt } from "mppx";
 import { Mppx, tempo } from "mppx/client";
 import {
   createPublicClient,
@@ -937,11 +970,14 @@ import {
   formatUnits,
   http
 } from "viem";
-import { base } from "viem/chains";
+import { base, baseSepolia } from "viem/chains";
 var USDC_BASE = "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
+var USDC_BASE_SEPOLIA = "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
 var USDC_TEMPO = "0x20c000000000000000000000b9537d11c60e8b50";
+var PATHUSD_TEMPO = "0x20c0000000000000000000000000000000000000";
 var BASE_CHAIN_ID = 8453;
 var TEMPO_CHAIN_ID = 4217;
+var TEMPO_TESTNET_CHAIN_ID = 42431;
 var calculateBuffer = (baseBalance) => {
   const twentyFivePercent = baseBalance / 4n;
   const twoDollars = 2000000n;
@@ -955,6 +991,14 @@ var tempoChain = {
     default: { http: ["https://rpc.tempo.xyz"] }
   }
 };
+var tempoTestnetChain = {
+  id: TEMPO_TESTNET_CHAIN_ID,
+  name: "Tempo Testnet",
+  nativeCurrency: { name: "USD", symbol: "USD", decimals: 18 },
+  rpcUrls: {
+    default: { http: ["https://rpc.moderato.tempo.xyz"] }
+  }
+};
 var ERC20_BALANCE_ABI = [
   {
     inputs: [{ name: "account", type: "address" }],
@@ -969,29 +1013,7 @@ var PaymentService = class {
     this.account = account;
     this.config = config;
   }
-  x402Client = null;
-  mppxClient = null;
   relayInitialized = false;
-  getX402Client = () => {
-    if (!this.x402Client) {
-      if (!this.account) throw new Error("No wallet configured");
-      this.x402Client = new X402Client().register(
-        "eip155:*",
-        new ExactEvmScheme(this.account)
-      );
-    }
-    return this.x402Client;
-  };
-  getMppxClient = () => {
-    if (!this.mppxClient) {
-      if (!this.account) throw new Error("No wallet configured");
-      this.mppxClient = Mppx.create({
-        polyfill: false,
-        methods: [tempo({ account: this.account })]
-      });
-    }
-    return this.mppxClient;
-  };
   ensureRelayClient = () => {
     if (!this.relayInitialized) {
       createRelayClient({
@@ -1053,32 +1075,35 @@ var PaymentService = class {
     }
     throw new Error("Unrecognized 402 payment protocol");
   };
-  payX402 = async (url, request, raw, maxPay) => {
-    const headerValue = Buffer.from(JSON.stringify(raw)).toString("base64");
-    const paymentRequired = decodePaymentRequiredHeader(headerValue);
-    const requirement = paymentRequired.accepts[0];
-    if (!requirement) {
-      throw new Error("No accepted payment methods in x402 challenge");
-    }
-    const amountUsdc = formatUnits(BigInt(requirement.amount), 6);
-    if (maxPay && Number.parseFloat(amountUsdc) > Number.parseFloat(maxPay)) {
-      throw new Error(
-        `Payment of ${amountUsdc} USDC exceeds --max-pay ${maxPay}`
-      );
-    }
-    const client = this.getX402Client();
-    const paymentPayload = await client.createPaymentPayload(paymentRequired);
-    const signatureHeader = encodePaymentSignatureHeader(paymentPayload);
-    const retryResponse = await fetch(url, {
+  payX402 = async (url, request, _raw, maxPay) => {
+    if (!this.account) throw new Error("No wallet configured");
+    let capturedAmount = "0";
+    const client = new X402Client().register(
+      "eip155:*",
+      new ExactEvmScheme(this.account)
+    );
+    client.onBeforePaymentCreation(async (context) => {
+      const requirement = context.paymentRequired.accepts[0];
+      if (!requirement) return;
+      capturedAmount = formatUnits(BigInt(requirement.amount), 6);
+      if (maxPay && Number.parseFloat(capturedAmount) > Number.parseFloat(maxPay)) {
+        return {
+          abort: true,
+          reason: `Payment of ${capturedAmount} USDC exceeds --max-pay ${maxPay}`
+        };
+      }
+    });
+    const httpClient = new x402HTTPClient(client).onPaymentRequired(
+      createSIWxClientHook(this.account)
+    );
+    const wrappedFetch = wrapFetchWithPayment(fetch, httpClient);
+    const response = await wrappedFetch(url, {
       method: request.method,
-      headers: {
-        ...request.headers,
-        "PAYMENT-SIGNATURE": signatureHeader
-      },
+      headers: request.headers,
       body: request.body
     });
     let txHash = null;
-    const paymentResponseHeader = retryResponse.headers.get("payment-response");
+    const paymentResponseHeader = response.headers.get("payment-response") ?? response.headers.get("x-payment-response");
     if (paymentResponseHeader) {
       try {
         const settlement = decodePaymentResponseHeader(paymentResponseHeader);
@@ -1087,61 +1112,86 @@ var PaymentService = class {
       }
     }
     return {
-      response: retryResponse,
+      response,
       protocol: "x402",
       chain: "base",
       txHash,
-      amount: amountUsdc,
+      amount: capturedAmount,
       asset: "USDC"
     };
   };
-  payMpp = async (url, request, raw, maxPay) => {
-    const wwwAuth = raw?.["www-authenticate"] ?? "";
-    const challengeResponse = new Response("Payment Required", {
-      status: 402,
-      headers: { "www-authenticate": wwwAuth }
+  payMpp = async (url, request, _raw, maxPay) => {
+    if (!this.account) throw new Error("No wallet configured");
+    let capturedAmount = "0";
+    const mppx = Mppx.create({
+      polyfill: false,
+      methods: [tempo({ account: this.account })],
+      onChallenge: async (challenge) => {
+        const challengeRequest = challenge.request;
+        const amountRaw = challengeRequest.amount;
+        capturedAmount = formatUnits(BigInt(amountRaw), 6);
+        if (maxPay && Number.parseFloat(capturedAmount) > Number.parseFloat(maxPay)) {
+          throw new Error(
+            `Payment of ${capturedAmount} USDC exceeds --max-pay ${maxPay}`
+          );
+        }
+        const methodDetails = challengeRequest.methodDetails;
+        const challengeChainId = challengeRequest.chainId ?? methodDetails?.chainId;
+        const isTestnet = challengeChainId === TEMPO_TESTNET_CHAIN_ID;
+        const balanceChain = isTestnet ? "tempo-testnet" : "tempo";
+        const tempoBalance = await this.getBalanceRaw(balanceChain);
+        if (tempoBalance < BigInt(amountRaw)) {
+          if (isTestnet) {
+            throw new Error(
+              `Insufficient pathUSD on Tempo testnet: have ${formatUnits(tempoBalance, 6)}, need ${capturedAmount}. Fund your wallet with the Tempo testnet faucet: https://docs.tempo.xyz/quickstart/faucet`
+            );
+          }
+          await this.bridgeToTempo(BigInt(amountRaw));
+        }
+        return void 0;
+      }
     });
-    const challenge = Challenge.fromResponse(challengeResponse);
-    const amountRaw = challenge.request.amount;
-    const amountUsdc = formatUnits(BigInt(amountRaw), 6);
-    if (maxPay && Number.parseFloat(amountUsdc) > Number.parseFloat(maxPay)) {
-      throw new Error(
-        `Payment of ${amountUsdc} USDC exceeds --max-pay ${maxPay}`
-      );
-    }
-    const tempoBalance = await this.getBalanceRaw("tempo");
-    if (tempoBalance < BigInt(amountRaw)) {
-      await this.bridgeToTempo(BigInt(amountRaw));
-    }
-    const mppx = this.getMppxClient();
-    const credential = await mppx.createCredential(challengeResponse);
-    const retryResponse = await fetch(url, {
+    const response = await mppx.fetch(url, {
       method: request.method,
-      headers: {
-        ...request.headers,
-        // biome-ignore lint/style/useNamingConvention: HTTP header name
-        Authorization: credential
-      },
+      headers: request.headers,
       body: request.body
     });
+    let txHash = null;
+    try {
+      const receipt = Receipt.fromResponse(response);
+      txHash = receipt.reference ?? null;
+    } catch {
+    }
     return {
-      response: retryResponse,
+      response,
       protocol: "mpp",
       chain: "tempo",
-      txHash: null,
-      // MPP pull mode — server broadcasts, tx hash not returned in response
-      amount: amountUsdc,
+      txHash,
+      amount: capturedAmount,
       asset: "USDC"
     };
   };
+  resolveChainConfig = (chain) => {
+    switch (chain) {
+      case "base":
+        return { viemChain: base, token: USDC_BASE };
+      case "base-sepolia":
+        return { viemChain: baseSepolia, token: USDC_BASE_SEPOLIA };
+      case "tempo":
+        return { viemChain: tempoChain, token: USDC_TEMPO };
+      case "tempo-testnet":
+        return { viemChain: tempoTestnetChain, token: PATHUSD_TEMPO };
+    }
+  };
   getBalanceRaw = async (chain) => {
     if (!this.account) return 0n;
+    const { viemChain, token } = this.resolveChainConfig(chain);
     const client = createPublicClient({
-      chain: chain === "base" ? base : tempoChain,
+      chain: viemChain,
       transport: http()
     });
     const balance = await client.readContract({
-      address: chain === "base" ? USDC_BASE : USDC_TEMPO,
+      address: token,
       abi: ERC20_BALANCE_ABI,
       functionName: "balanceOf",
       args: [this.account.address]

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zeroxyz/cli",
-	"version": "0.0.7",
+	"version": "0.0.9",
 	"type": "module",
 	"bin": {
 		"zero": "dist/index.js",
@@ -20,8 +20,9 @@
 		"dev": "tsx src/index.ts",
 		"cli": "ZERO_API_URL=http://localhost:1111 tsx src/index.ts",
 		"test:integration": "vitest run --project integration",
+		"test:online": "vitest run --project online",
 		"test:unit": "vitest run --project unit",
-		"test": "pnpm run test:integration",
+		"test": "pnpm run test:unit && pnpm run test:integration",
 		"typecheck": "tsc"
 	},
 	"dependencies": {
@@ -29,6 +30,8 @@
 		"@relayprotocol/relay-sdk": "^5.2.1",
 		"@x402/core": "^2.9.0",
 		"@x402/evm": "^2.9.0",
+		"@x402/extensions": "^2.9.0",
+		"@x402/fetch": "^2.9.0",
 		"commander": "^13.0.0",
 		"mppx": "^0.5.9",
 		"open": "^11.0.0",
@@ -37,7 +40,10 @@
 		"zod": "^4.3.5"
 	},
 	"devDependencies": {
+		"@hono/node-server": "^1.19.13",
 		"@types/node": "^25.0.7",
+		"@x402/hono": "^2.9.0",
+		"hono": "^4.12.12",
 		"tsup": "^8.5.1",
 		"tsx": "^4.21.0",
 		"typescript": "^5.9.3",