x402-proxy 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-03-21
+
+### Added
+- `config` command with `show`, `set`, and `unset` subcommands for managing configuration from the CLI (no more manual YAML editing)
+- Setup wizard now asks about preferred payment protocol (x402/MPP) and network
+- MCP proxy handles `McpError(-32042)` from dual-protocol servers that throw instead of using `isError`, automatically retrying with x402 payment
+- MPP payment amounts captured from challenges and displayed in payment logs, MCP proxy output, and transaction history
+- `formatAmount()` and `formatUsdcValue()` exported from library for adaptive USDC precision formatting
+
+### Changed
+- USDC amounts displayed with adaptive precision (2-6 decimals based on magnitude) instead of fixed 4 decimals everywhere
+- Zero-balance detection uses numeric comparison instead of string matching
+
 ## [0.7.1] - 2026-03-20
 
 ### Fixed
@@ -191,7 +204,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `appendHistory` / `readHistory` / `calcSpend` - JSONL transaction history
 - Re-exports from `@x402/fetch`, `@x402/svm`, `@x402/evm`
 
-[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.7.1...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.0...HEAD
+[0.8.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.7.1...v0.8.0
 [0.7.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.5.2...v0.6.0

package/README.md

@@ -70,6 +70,9 @@ $ npx x402-proxy <url>                    # paid HTTP request (default command)
 $ npx x402-proxy mcp <url>                # MCP stdio proxy for agents
 $ npx x402-proxy setup                    # onboarding wizard
 $ npx x402-proxy status                   # config + wallet + spend summary
+$ npx x402-proxy config                   # show current configuration
+$ npx x402-proxy config set <key> <value> # set a config value
+$ npx x402-proxy config unset <key>       # remove a config value
 $ npx x402-proxy wallet                   # show addresses and balances
 $ npx x402-proxy wallet history           # payment history
 $ npx x402-proxy wallet export-key <target> # bare key/mnemonic to stdout (evm|solana|mnemonic)

package/dist/bin/cli.js

@@ -1,14 +1,165 @@
 #!/usr/bin/env node
-import { _ as formatTxLine, c as resolveWallet, d as info, f as isTTY, g as displayNetwork, h as calcSpend, l as dim, m as appendHistory, o as walletInfoCommand, p as warn, s as buildX402Client, u as error, v as readHistory } from "../wallet-DxKCHa7U.js";
-import { a as getHistoryPath, c as loadConfig, l as loadWalletFile, s as isConfigured } from "../derive-ibF2UinV.js";
-import { n as setupCommand } from "../setup-hJGkO2Lo.js";
-import { n as statusCommand } from "../status-JNGv2Ghp.js";
+import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort, l as loadWalletFile, s as isConfigured, u as saveConfig } from "../derive-BR6N1ZjI.js";
+import { _ as error, b as warn, c as resolveWallet, d as displayNetwork, f as formatAmount, g as dim, h as readHistory, l as appendHistory, m as formatUsdcValue, o as walletInfoCommand, p as formatTxLine, s as buildX402Client, u as calcSpend, v as info, y as isTTY } from "../wallet-CeY5DPj-.js";
+import { n as setupCommand } from "../setup-Di_b5Vp9.js";
+import { n as statusCommand } from "../status-S3t-XV_M.js";
 import { buildApplication, buildCommand, buildRouteMap, run } from "@stricli/core";
 import pc from "picocolors";
 import { decodePaymentResponseHeader, wrapFetchWithPayment } from "@x402/fetch";
 import { base58 } from "@scure/base";
 import * as prompts from "@clack/prompts";
 
+//#region src/commands/config.ts
+const VALID_KEYS = {
+	defaultNetwork: {
+		description: "Preferred network (base, solana, tempo)",
+		parse: (v) => {
+			if (![
+				"base",
+				"solana",
+				"tempo"
+			].includes(v)) throw new Error("Must be one of: base, solana, tempo");
+			return v;
+		}
+	},
+	preferredProtocol: {
+		description: "Payment protocol (x402, mpp)",
+		parse: (v) => {
+			if (!["x402", "mpp"].includes(v)) throw new Error("Must be one of: x402, mpp");
+			return v;
+		}
+	},
+	mppSessionBudget: {
+		description: "Max USDC per MPP session (default: 1)",
+		parse: (v) => {
+			const n = Number(v);
+			if (Number.isNaN(n) || n <= 0) throw new Error("Must be a positive number");
+			return v;
+		}
+	},
+	spendLimitDaily: {
+		description: "Daily spending limit in USDC",
+		parse: (v) => {
+			const n = Number(v);
+			if (Number.isNaN(n) || n <= 0) throw new Error("Must be a positive number");
+			return n;
+		}
+	},
+	spendLimitPerTx: {
+		description: "Per-transaction spending limit in USDC",
+		parse: (v) => {
+			const n = Number(v);
+			if (Number.isNaN(n) || n <= 0) throw new Error("Must be a positive number");
+			return n;
+		}
+	}
+};
+function isConfigKey(k) {
+	return k in VALID_KEYS;
+}
+const configShowCommand = buildCommand({
+	docs: { brief: "Show current configuration" },
+	parameters: {
+		flags: {},
+		positional: {
+			kind: "tuple",
+			parameters: []
+		}
+	},
+	async func() {
+		const config = loadConfig();
+		console.log();
+		console.log(pc.bold("Configuration"));
+		dim(`  ${getConfigDirShort()}/config.yaml`);
+		console.log();
+		if (!config || Object.keys(config).length === 0) {
+			dim("  No configuration set. Using defaults.");
+			console.log();
+			dim("  Available keys:");
+			for (const [key, meta] of Object.entries(VALID_KEYS)) dim(`    ${pc.cyan(key)} - ${meta.description}`);
+			console.log();
+			dim(`  Set with: ${pc.cyan("npx x402-proxy config set <key> <value>")}`);
+			console.log();
+			return;
+		}
+		for (const key of Object.keys(VALID_KEYS)) {
+			const value = config[key];
+			if (value !== void 0) console.log(`  ${pc.cyan(key)}: ${pc.green(String(value))}`);
+			else dim(`  ${key}: ${pc.dim("(not set)")}`);
+		}
+		console.log();
+	}
+});
+const configSetCommand = buildCommand({
+	docs: {
+		brief: "Set a configuration value",
+		fullDescription: `Set a configuration value.
+
+Available keys:
+${Object.entries(VALID_KEYS).map(([k, v]) => `  ${k} - ${v.description}`).join("\n")}
+
+To unset a value, use: npx x402-proxy config unset <key>`
+	},
+	parameters: {
+		flags: {},
+		positional: {
+			kind: "tuple",
+			parameters: [{
+				brief: "Configuration key",
+				parse: String
+			}, {
+				brief: "Value to set",
+				parse: String
+			}]
+		}
+	},
+	async func(_flags, key, value) {
+		if (!isConfigKey(key)) {
+			error(`Unknown config key: ${key}`);
+			console.error();
+			dim("  Available keys:");
+			for (const [k, m] of Object.entries(VALID_KEYS)) dim(`    ${pc.cyan(k)} - ${m.description}`);
+			process.exit(1);
+		}
+		const meta = VALID_KEYS[key];
+		let parsed;
+		try {
+			parsed = meta.parse(value);
+		} catch (err) {
+			error(`Invalid value for ${key}: ${err instanceof Error ? err.message : String(err)}`);
+			process.exit(1);
+		}
+		const config = loadConfig() ?? {};
+		config[key] = parsed;
+		saveConfig(config);
+		console.log(`  ${pc.cyan(key)} = ${pc.green(String(parsed))}`);
+	}
+});
+const configUnsetCommand = buildCommand({
+	docs: { brief: "Unset a configuration value" },
+	parameters: {
+		flags: {},
+		positional: {
+			kind: "tuple",
+			parameters: [{
+				brief: "Configuration key to remove",
+				parse: String
+			}]
+		}
+	},
+	async func(_flags, key) {
+		if (!isConfigKey(key)) {
+			error(`Unknown config key: ${key}`);
+			process.exit(1);
+		}
+		const config = loadConfig() ?? {};
+		delete config[key];
+		saveConfig(config);
+		dim(`  ${key} unset`);
+	}
+});
+
+//#endregion
 //#region src/handler.ts
 /**
 * Detect which payment protocols a 402 response advertises.
@@ -70,30 +221,40 @@ async function createMppProxyHandler(opts) {
 	const account = privateKeyToAccount(opts.evmKey);
 	const maxDeposit = opts.maxDeposit ?? "1";
 	const paymentQueue = [];
+	let lastChallengeAmount;
 	const mppx = Mppx.create({
 		methods: [tempo({
 			account,
 			maxDeposit
 		})],
-		polyfill: false
+		polyfill: false,
+		onChallenge: async (challenge) => {
+			const req = challenge.request;
+			if (req.amount) lastChallengeAmount = (Number(req.amount) / 10 ** (req.decimals ?? 6)).toString();
+		}
 	});
 	let session;
 	return {
 		async fetch(input, init) {
 			const response = await mppx.fetch(typeof input === "string" ? input : input.toString(), init);
 			const receiptHeader = response.headers.get("Payment-Receipt");
-			if (receiptHeader) try {
-				const receipt = JSON.parse(Buffer.from(receiptHeader, "base64url").toString());
-				paymentQueue.push({
-					protocol: "mpp",
-					network: TEMPO_NETWORK,
-					receipt
-				});
-			} catch {
-				paymentQueue.push({
-					protocol: "mpp",
-					network: TEMPO_NETWORK
-				});
+			if (receiptHeader) {
+				try {
+					const receipt = JSON.parse(Buffer.from(receiptHeader, "base64url").toString());
+					paymentQueue.push({
+						protocol: "mpp",
+						network: TEMPO_NETWORK,
+						amount: lastChallengeAmount,
+						receipt
+					});
+				} catch {
+					paymentQueue.push({
+						protocol: "mpp",
+						network: TEMPO_NETWORK,
+						amount: lastChallengeAmount
+					});
+				}
+				lastChallengeAmount = void 0;
 			}
 			return response;
 		},
@@ -230,7 +391,7 @@ Examples:
 		};
 		if (!url) {
 			if (isConfigured()) {
-				const { displayStatus } = await import("../status-w5y-fhhe.js");
+				const { displayStatus } = await import("../status-CJPUbh6Z.js");
 				await displayStatus();
 				console.log();
 				console.log(pc.dim("  Commands:"));
@@ -282,7 +443,7 @@ Examples:
 				process.exit(1);
 			}
 			dim("  No wallet found. Let's set one up first.\n");
-			const { runSetup } = await import("../setup-j_xQ14-4.js");
+			const { runSetup } = await import("../setup-CJwYRd78.js");
 			await runSetup();
 			console.log();
 			wallet = resolveWallet();
@@ -295,7 +456,7 @@ Examples:
 		verbose(`protocol: ${resolvedProtocol ?? "auto-detect"}, maxDeposit: ${maxDeposit}`);
 		let preferredNetwork = config?.defaultNetwork;
 		if (!preferredNetwork && wallet.evmAddress && wallet.solanaAddress) {
-			const { fetchAllBalances } = await import("../wallet-DjixXCHy.js");
+			const { fetchAllBalances } = await import("../wallet-CJBRFJw8.js");
 			const balances = await fetchAllBalances(wallet.evmAddress, wallet.solanaAddress);
 			const evmUsdc = balances.evm ? Number(balances.evm.usdc) : 0;
 			const solUsdc = balances.sol ? Number(balances.sol.usdc) : 0;
@@ -352,7 +513,7 @@ Examples:
 					usedProtocol = "mpp";
 					const elapsedMs = Date.now() - startMs;
 					const spentAmount = mppPayment.amount ? Number(mppPayment.amount) : void 0;
-					if (mppPayment && isTTY()) info(`  MPP session: ${spentAmount != null ? `${spentAmount.toFixed(4)} USDC ` : ""}(${displayNetwork(mppPayment.network)})`);
+					if (mppPayment && isTTY()) info(`  MPP session: ${spentAmount != null ? `${formatAmount(spentAmount, "USDC")} ` : ""}(${displayNetwork(mppPayment.network)})`);
 					if (isTTY()) dim(`  Streamed (${elapsedMs}ms)`);
 					if (mppPayment) {
 						const record = {
@@ -445,13 +606,13 @@ Examples:
 			if (accepts.length > 0) {
 				const cheapest = accepts.reduce((min, a) => Number(a.amount) < Number(min.amount) ? a : min);
 				costNum = Number(cheapest.amount) / 1e6;
-				costStr = costNum.toFixed(4);
+				costStr = formatUsdcValue(costNum);
 			}
 			const hasEvm = accepts.some((a) => a.network.startsWith("eip155:"));
 			const hasSolana = accepts.some((a) => a.network.startsWith("solana:"));
 			const hasMpp = detected.mpp;
 			const hasOther = accepts.some((a) => !a.network.startsWith("eip155:") && !a.network.startsWith("solana:"));
-			const { fetchAllBalances } = await import("../wallet-DjixXCHy.js");
+			const { fetchAllBalances } = await import("../wallet-CJBRFJw8.js");
 			const balances = await fetchAllBalances(wallet.evmAddress, wallet.solanaAddress);
 			const evmUsdc = hasEvm && balances.evm ? Number(balances.evm.usdc) : 0;
 			const solUsdc = hasSolana && balances.sol ? Number(balances.sol.usdc) : 0;
@@ -470,9 +631,9 @@ Examples:
 				if (payment) dim("  Payment was signed and sent but rejected by the server.");
 				else dim("  Payment was not attempted despite sufficient balance.");
 				if (serverReason) dim(`  Reason: ${serverReason}`);
-				if (hasEvm && wallet.evmAddress && evmUsdc > 0) console.error(`    Base:   ${pc.cyan(wallet.evmAddress)} ${pc.dim(`(${evmUsdc.toFixed(4)} USDC)`)}`);
-				if (hasMpp && wallet.evmAddress && tempoUsdc > 0) console.error(`    Tempo:  ${pc.cyan(wallet.evmAddress)} ${pc.dim(`(${tempoUsdc.toFixed(4)} USDC)`)}`);
-				if (hasSolana && wallet.solanaAddress && solUsdc > 0) console.error(`    Solana: ${pc.cyan(wallet.solanaAddress)} ${pc.dim(`(${solUsdc.toFixed(4)} USDC)`)}`);
+				if (hasEvm && wallet.evmAddress && evmUsdc > 0) console.error(`    Base:   ${pc.cyan(wallet.evmAddress)} ${pc.dim(`(${formatAmount(evmUsdc, "USDC")})`)}`);
+				if (hasMpp && wallet.evmAddress && tempoUsdc > 0) console.error(`    Tempo:  ${pc.cyan(wallet.evmAddress)} ${pc.dim(`(${formatAmount(tempoUsdc, "USDC")})`)}`);
+				if (hasSolana && wallet.solanaAddress && solUsdc > 0) console.error(`    Solana: ${pc.cyan(wallet.solanaAddress)} ${pc.dim(`(${formatAmount(solUsdc, "USDC")})`)}`);
 				console.error();
 				dim("  This may be a temporary server-side issue. Try again in a moment.");
 				console.error();
@@ -482,15 +643,15 @@ Examples:
 					console.error();
 					dim("  Fund your wallet with USDC:");
 					if (hasEvm && wallet.evmAddress) {
-						const balHint = evmUsdc > 0 ? pc.dim(` (${evmUsdc.toFixed(4)} USDC)`) : "";
+						const balHint = evmUsdc > 0 ? pc.dim(` (${formatAmount(evmUsdc, "USDC")})`) : "";
 						console.error(`    Base:   ${pc.cyan(wallet.evmAddress)}${balHint}`);
 					}
 					if (hasMpp && wallet.evmAddress) {
-						const balHint = tempoUsdc > 0 ? pc.dim(` (${tempoUsdc.toFixed(4)} USDC)`) : "";
+						const balHint = tempoUsdc > 0 ? pc.dim(` (${formatAmount(tempoUsdc, "USDC")})`) : "";
 						console.error(`    Tempo:  ${pc.cyan(wallet.evmAddress)}${balHint}`);
 					}
 					if (hasSolana && wallet.solanaAddress) {
-						const balHint = solUsdc > 0 ? pc.dim(` (${solUsdc.toFixed(4)} USDC)`) : "";
+						const balHint = solUsdc > 0 ? pc.dim(` (${formatAmount(solUsdc, "USDC")})`) : "";
 						console.error(`    Solana: ${pc.cyan(wallet.solanaAddress)}${balHint}`);
 					}
 					if (hasEvm && !wallet.evmAddress) dim("    Base:   endpoint accepts EVM but no EVM wallet configured");
@@ -509,8 +670,8 @@ Examples:
 			return;
 		}
 		if (payment && isTTY()) {
-			if (usedProtocol === "mpp" && mppPayment) info(`  Payment: MPP (${displayNetwork(mppPayment.network)})`);
-			else if (x402Payment) info(`  Payment: ${x402Payment.amount ? (Number(x402Payment.amount) / 1e6).toFixed(4) : "?"} USDC (${displayNetwork(x402Payment.network ?? "unknown")})`);
+			if (usedProtocol === "mpp" && mppPayment) info(`  Payment:${mppPayment.amount ? ` ${formatAmount(Number(mppPayment.amount), "USDC")}` : ""} MPP (${displayNetwork(mppPayment.network)})`);
+			else if (x402Payment) info(`  Payment: ${x402Payment.amount ? formatAmount(Number(x402Payment.amount) / 1e6, "USDC") : "? USDC"} (${displayNetwork(x402Payment.network ?? "unknown")})`);
 			if (txSig) dim(`  Tx: ${txSig}`);
 		}
 		if (isTTY()) dim(`  ${response.status} ${response.statusText} (${elapsedMs}ms)`);
@@ -626,7 +787,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 		const { StreamableHTTPClientTransport } = await import("@modelcontextprotocol/sdk/client/streamableHttp.js");
 		const { Server } = await import("@modelcontextprotocol/sdk/server/index.js");
 		const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
-		const { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ToolListChangedNotificationSchema, ResourceListChangedNotificationSchema } = await import("@modelcontextprotocol/sdk/types.js");
+		const { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ToolListChangedNotificationSchema, ResourceListChangedNotificationSchema, McpError } = await import("@modelcontextprotocol/sdk/types.js");
 		async function connectTransport(target) {
 			try {
 				const transport = new StreamableHTTPClientTransport(new URL(remoteUrl));
@@ -648,7 +809,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 		async function startX402Proxy() {
 			let preferredNetwork = config?.defaultNetwork;
 			if (!preferredNetwork && wallet.evmAddress && wallet.solanaAddress) {
-				const { fetchAllBalances } = await import("../wallet-DjixXCHy.js");
+				const { fetchAllBalances } = await import("../wallet-CJBRFJw8.js");
 				const balances = await fetchAllBalances(wallet.evmAddress, wallet.solanaAddress);
 				const evmUsdc = balances.evm ? Number(balances.evm.usdc) : 0;
 				const solUsdc = balances.sol ? Number(balances.sol.usdc) : 0;
@@ -662,15 +823,18 @@ Add to your MCP client config (Claude, Cursor, etc.):
 				spendLimitPerTx: config?.spendLimitPerTx
 			});
 			const { x402MCPClient } = await import("@x402/mcp");
+			function warnPayment(accepts, toolName) {
+				const accept = accepts?.[0];
+				if (accept) warn(`  Payment: ${accept.amount ? formatAmount(Number(accept.amount) / 1e6, "USDC") : "? USDC"} on ${displayNetwork(accept.network)} for tool "${toolName}"`);
+			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.7.1"
+				version: "0.8.0"
 			});
 			const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 				autoPayment: true,
 				onPaymentRequested: (ctx) => {
-					const accept = ctx.paymentRequired.accepts?.[0];
-					if (accept) warn(`  Payment: ${accept.amount ? (Number(accept.amount) / 1e6).toFixed(4) : "?"} USDC on ${displayNetwork(accept.network)} for tool "${ctx.toolName}"`);
+					warnPayment(ctx.paymentRequired.accepts, ctx.toolName);
 					return true;
 				}
 			});
@@ -703,7 +867,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.7.1"
+				version: "0.8.0"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -716,11 +880,28 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			})) }));
 			localServer.setRequestHandler(CallToolRequestSchema, async (request) => {
 				const { name, arguments: args } = request.params;
-				const result = await x402Mcp.callTool(name, args ?? {});
-				return {
-					content: result.content,
-					isError: result.isError
-				};
+				try {
+					const result = await x402Mcp.callTool(name, args ?? {});
+					return {
+						content: result.content,
+						isError: result.isError
+					};
+				} catch (err) {
+					if (err instanceof McpError && err.code === -32042) {
+						const x402PaymentRequired = err.data?.x402;
+						if (x402PaymentRequired) {
+							const accepts = x402PaymentRequired.accepts;
+							warnPayment(accepts, name);
+							const paymentPayload = await x402PaymentClient.createPaymentPayload(x402PaymentRequired);
+							const result = await x402Mcp.callToolWithPayment(name, args ?? {}, paymentPayload);
+							return {
+								content: result.content,
+								isError: result.isError
+							};
+						}
+					}
+					throw err;
+				}
 			});
 			if (remoteResources.length > 0) {
 				localServer.setRequestHandler(ListResourcesRequestSchema, async () => ({ resources: remoteResources.map((r) => ({
@@ -767,15 +948,24 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			const { privateKeyToAccount } = await import("viem/accounts");
 			const account = privateKeyToAccount(wallet.evmKey);
 			const maxDeposit = config?.mppSessionBudget ?? "1";
+			let lastChallengeAmount;
+			const wrappedMethods = tempo({
+				account,
+				maxDeposit
+			}).map((m) => ({
+				...m,
+				createCredential: async (params) => {
+					const req = params.challenge.request;
+					if (req.amount) lastChallengeAmount = Number(req.amount) / 10 ** (req.decimals ?? 6);
+					return m.createCredential(params);
+				}
+			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.7.1"
+				version: "0.8.0"
 			});
 			await connectTransport(remoteClient);
-			const mppClient = McpClient.wrap(remoteClient, { methods: [tempo({
-				account,
-				maxDeposit
-			})] });
+			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
 			let { tools } = await remoteClient.listTools();
 			dim(`  ${tools.length} tools available`);
 			let remoteResources = [];
@@ -787,7 +977,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.7.1"
+				version: "0.8.0"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -812,11 +1002,14 @@ Add to your MCP client config (Claude, Cursor, etc.):
 						net: TEMPO_NETWORK,
 						from: wallet.evmAddress ?? "unknown",
 						tx: result.receipt.reference,
+						amount: lastChallengeAmount,
 						token: "USDC",
 						label: `mcp:${name}`
 					};
 					appendHistory(getHistoryPath(), record);
-					warn(`  MPP payment for tool "${name}" (Tempo)`);
+					const amountStr = lastChallengeAmount !== void 0 ? formatAmount(lastChallengeAmount, "USDC") : "";
+					warn(`  MPP payment for tool "${name}" (Tempo)${amountStr ? ` \u00b7 ${amountStr}` : ""}`);
+					lastChallengeAmount = void 0;
 				}
 				return {
 					content: result.content,
@@ -959,7 +1152,7 @@ const walletHistoryCommand = buildCommand({
 			console.log(line);
 		}
 		console.log();
-		console.log(pc.dim(`  Today: ${spend.today.toFixed(4)} USDC | Total: ${spend.total.toFixed(4)} USDC | ${spend.count} transactions`));
+		console.log(pc.dim(`  Today: ${formatAmount(spend.today, "USDC")} | Total: ${formatAmount(spend.total, "USDC")} | ${spend.count} transactions`));
 		console.log();
 	}
 });
@@ -979,6 +1172,15 @@ const routes = buildRouteMap({
 			defaultCommand: "info",
 			docs: { brief: "Wallet management" }
 		}),
+		config: buildRouteMap({
+			routes: {
+				show: configShowCommand,
+				set: configSetCommand,
+				unset: configUnsetCommand
+			},
+			defaultCommand: "show",
+			docs: { brief: "Manage configuration" }
+		}),
 		setup: setupCommand,
 		status: statusCommand
 	},
@@ -987,7 +1189,7 @@ const routes = buildRouteMap({
 });
 const app = buildApplication(routes, {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.7.1" },
+	versionInfo: { currentVersion: "0.8.0" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 

package/dist/{derive-ibF2UinV.js → derive-BR6N1ZjI.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import fs from "node:fs";
-import path from "node:path";
 import os from "node:os";
+import path from "node:path";
 import { parse, stringify } from "yaml";
 import { ed25519 } from "@noble/curves/ed25519.js";
 import { base58 } from "@scure/base";

package/dist/index.js

@@ -67,30 +67,40 @@ async function createMppProxyHandler(opts) {
 	const account = privateKeyToAccount(opts.evmKey);
 	const maxDeposit = opts.maxDeposit ?? "1";
 	const paymentQueue = [];
+	let lastChallengeAmount;
 	const mppx = Mppx.create({
 		methods: [tempo({
 			account,
 			maxDeposit
 		})],
-		polyfill: false
+		polyfill: false,
+		onChallenge: async (challenge) => {
+			const req = challenge.request;
+			if (req.amount) lastChallengeAmount = (Number(req.amount) / 10 ** (req.decimals ?? 6)).toString();
+		}
 	});
 	let session;
 	return {
 		async fetch(input, init) {
 			const response = await mppx.fetch(typeof input === "string" ? input : input.toString(), init);
 			const receiptHeader = response.headers.get("Payment-Receipt");
-			if (receiptHeader) try {
-				const receipt = JSON.parse(Buffer.from(receiptHeader, "base64url").toString());
-				paymentQueue.push({
-					protocol: "mpp",
-					network: TEMPO_NETWORK,
-					receipt
-				});
-			} catch {
-				paymentQueue.push({
-					protocol: "mpp",
-					network: TEMPO_NETWORK
-				});
+			if (receiptHeader) {
+				try {
+					const receipt = JSON.parse(Buffer.from(receiptHeader, "base64url").toString());
+					paymentQueue.push({
+						protocol: "mpp",
+						network: TEMPO_NETWORK,
+						amount: lastChallengeAmount,
+						receipt
+					});
+				} catch {
+					paymentQueue.push({
+						protocol: "mpp",
+						network: TEMPO_NETWORK,
+						amount: lastChallengeAmount
+					});
+				}
+				lastChallengeAmount = void 0;
 			}
 			return response;
 		},
@@ -189,13 +199,15 @@ function calcSpend(records) {
 		count
 	};
 }
+/** Format a USDC value with adaptive precision (no token suffix). */
+function formatUsdcValue(amount) {
+	if (amount >= .01) return amount.toFixed(2);
+	if (amount >= .001) return amount.toFixed(3);
+	if (amount >= 1e-4) return amount.toFixed(4);
+	return amount.toFixed(6);
+}
 function formatAmount(amount, token) {
-	if (token === "USDC") {
-		if (amount >= .01) return `${amount.toFixed(2)} USDC`;
-		if (amount >= .001) return `${amount.toFixed(3)} USDC`;
-		if (amount >= 1e-4) return `${amount.toFixed(4)} USDC`;
-		return `${amount.toFixed(6)} USDC`;
-	}
+	if (token === "USDC") return `${formatUsdcValue(amount)} USDC`;
 	if (token === "SOL") return `${amount} SOL`;
 	return `${amount} ${token}`;
 }

package/dist/openclaw/plugin.js

@@ -138,13 +138,15 @@ function calcSpend(records) {
 		count
 	};
 }
+/** Format a USDC value with adaptive precision (no token suffix). */
+function formatUsdcValue(amount) {
+	if (amount >= .01) return amount.toFixed(2);
+	if (amount >= .001) return amount.toFixed(3);
+	if (amount >= 1e-4) return amount.toFixed(4);
+	return amount.toFixed(6);
+}
 function formatAmount(amount, token) {
-	if (token === "USDC") {
-		if (amount >= .01) return `${amount.toFixed(2)} USDC`;
-		if (amount >= .001) return `${amount.toFixed(3)} USDC`;
-		if (amount >= 1e-4) return `${amount.toFixed(4)} USDC`;
-		return `${amount.toFixed(6)} USDC`;
-	}
+	if (token === "USDC") return `${formatUsdcValue(amount)} USDC`;
 	if (token === "SOL") return `${amount} SOL`;
 	return `${amount} ${token}`;
 }
@@ -502,8 +504,8 @@ function createBalanceTool(ctx) {
 					`USDC: ${snap.ui} USDC`,
 					`Available for tools: ${available.toFixed(2)} USDC`,
 					`Reserved for inference: ${INFERENCE_RESERVE.toFixed(2)} USDC`,
-					`Spent today: ${snap.spend.today.toFixed(4)} USDC`,
-					`Total spent: ${snap.spend.total.toFixed(4)} USDC (${snap.spend.count} txs)`,
+					`Spent today: ${formatAmount(snap.spend.today, "USDC")}`,
+					`Total spent: ${formatAmount(snap.spend.total, "USDC")} (${snap.spend.count} txs)`,
 					...tokenLines.length > 0 ? [`Tokens held: ${tokenLines.join(", ")}`] : []
 				].join("\n"));
 			} catch (err) {
@@ -724,7 +726,7 @@ function createWalletCommand(ctx) {
 			try {
 				const snap = await getWalletSnapshot(ctx.rpcUrl, walletAddress, ctx.historyPath);
 				const solscanUrl = `https://solscan.io/account/${walletAddress}`;
-				const lines = [`x402-proxy v0.7.1`];
+				const lines = [`x402-proxy v0.8.0`];
 				const defaultModel = ctx.allModels[0];
 				if (defaultModel) lines.push("", `**Model** - ${defaultModel.name} (${defaultModel.provider})`);
 				lines.push("", `**[Wallet](${solscanUrl})**`, `\`${walletAddress}\``);

package/dist/setup-CJwYRd78.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { n as setupCommand, t as runSetup } from "./setup-Di_b5Vp9.js";
+
+export { runSetup };

package/dist/{setup-hJGkO2Lo.js → setup-Di_b5Vp9.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { d as saveWalletFile, i as getConfigDirShort, n as deriveSolanaKeypair, o as getWalletPath, r as generateMnemonic, s as isConfigured, t as deriveEvmKeypair, u as saveConfig } from "./derive-ibF2UinV.js";
+import { d as saveWalletFile, i as getConfigDirShort, n as deriveSolanaKeypair, o as getWalletPath, r as generateMnemonic, s as isConfigured, t as deriveEvmKeypair, u as saveConfig } from "./derive-BR6N1ZjI.js";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
 import * as prompts from "@clack/prompts";
@@ -57,7 +57,48 @@ async function runSetup(opts) {
 			solana: sol.address
 		}
 	});
-	saveConfig({});
+	const protocol = await prompts.select({
+		message: "Preferred payment protocol?",
+		options: [{
+			value: "x402",
+			label: "x402 - on-chain payments (Base, Solana)"
+		}, {
+			value: "mpp",
+			label: "MPP - streaming micropayments (Tempo)"
+		}]
+	});
+	if (prompts.isCancel(protocol)) {
+		prompts.cancel("Setup cancelled.");
+		process.exit(0);
+	}
+	const networkOptions = protocol === "mpp" ? [{
+		value: "tempo",
+		label: "Tempo"
+	}] : [
+		{
+			value: "auto",
+			label: "Auto-detect (pick chain with highest balance)"
+		},
+		{
+			value: "base",
+			label: "Base (EVM)"
+		},
+		{
+			value: "solana",
+			label: "Solana"
+		}
+	];
+	const network = await prompts.select({
+		message: "Preferred network?",
+		options: networkOptions
+	});
+	if (prompts.isCancel(network)) {
+		prompts.cancel("Setup cancelled.");
+		process.exit(0);
+	}
+	const config = { preferredProtocol: protocol };
+	if (network !== "auto") config.defaultNetwork = network;
+	saveConfig(config);
 	prompts.log.info(`Config directory: ${pc.dim(getConfigDirShort())}`);
 	prompts.log.step("Fund your wallets to start using x402 resources:");
 	prompts.log.message(`  Solana (USDC): Send USDC to ${pc.cyan(sol.address)}`);

package/dist/{status-w5y-fhhe.js → status-CJPUbh6Z.js}

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { n as statusCommand, t as displayStatus } from "./status-JNGv2Ghp.js";
+import { n as statusCommand, t as displayStatus } from "./status-S3t-XV_M.js";
 
 export { displayStatus };

package/dist/{status-JNGv2Ghp.js → status-S3t-XV_M.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { _ as formatTxLine, c as resolveWallet, h as calcSpend, l as dim, n as fetchAllBalances, t as balanceLine, v as readHistory } from "./wallet-DxKCHa7U.js";
-import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort } from "./derive-ibF2UinV.js";
+import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort } from "./derive-BR6N1ZjI.js";
+import { c as resolveWallet, f as formatAmount, g as dim, h as readHistory, m as formatUsdcValue, n as fetchAllBalances, p as formatTxLine, t as balanceLine, u as calcSpend } from "./wallet-CeY5DPj-.js";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
 
@@ -35,7 +35,7 @@ async function displayStatus() {
 			console.log();
 			if (config.spendLimitDaily) {
 				const pct = config.spendLimitDaily > 0 ? Math.round(spend.today / config.spendLimitDaily * 100) : 0;
-				dim(`  Daily limit:    ${spend.today.toFixed(4)} / ${config.spendLimitDaily} USDC (${pct}%)`);
+				dim(`  Daily limit:    ${formatUsdcValue(spend.today)} / ${config.spendLimitDaily} USDC (${pct}%)`);
 			}
 			if (config.spendLimitPerTx) dim(`  Per-tx limit:   ${config.spendLimitPerTx} USDC`);
 		}
@@ -49,7 +49,7 @@ async function displayStatus() {
 			console.log(line);
 		}
 		console.log();
-		dim(`  Today: ${spend.today.toFixed(4)} USDC | Total: ${spend.total.toFixed(4)} USDC | ${spend.count} tx`);
+		dim(`  Today: ${formatAmount(spend.today, "USDC")} | Total: ${formatAmount(spend.total, "USDC")} | ${spend.count} tx`);
 	} else dim("  No payment history yet.");
 	console.log();
 	if (config?.defaultNetwork) dim(`  Network:  ${config.defaultNetwork}`);

package/dist/{wallet-DjixXCHy.js → wallet-CJBRFJw8.js}

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { a as fetchTempoBalances, i as fetchSolanaBalances, n as fetchAllBalances, o as walletInfoCommand, r as fetchEvmBalances, t as balanceLine } from "./wallet-DxKCHa7U.js";
+import { a as fetchTempoBalances, i as fetchSolanaBalances, n as fetchAllBalances, o as walletInfoCommand, r as fetchEvmBalances, t as balanceLine } from "./wallet-CeY5DPj-.js";
 
 export { fetchAllBalances };

package/dist/{wallet-DxKCHa7U.js → wallet-CeY5DPj-.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { a as getHistoryPath, l as loadWalletFile, n as deriveSolanaKeypair, t as deriveEvmKeypair } from "./derive-ibF2UinV.js";
+import { a as getHistoryPath, l as loadWalletFile, n as deriveSolanaKeypair, t as deriveEvmKeypair } from "./derive-BR6N1ZjI.js";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
-import { x402Client } from "@x402/fetch";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { x402Client } from "@x402/fetch";
 import { ed25519 } from "@noble/curves/ed25519.js";
 import { base58 } from "@scure/base";
 import { toClientEvmSigner } from "@x402/evm";
@@ -15,6 +15,24 @@ import { privateKeyToAccount } from "viem/accounts";
 import { base } from "viem/chains";
 import { address, getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";
 
+//#region src/lib/output.ts
+function isTTY() {
+	return !!process.stderr.isTTY;
+}
+function info(msg) {
+	process.stderr.write(`${isTTY() ? pc.cyan(msg) : msg}\n`);
+}
+function warn(msg) {
+	process.stderr.write(`${isTTY() ? pc.yellow(msg) : msg}\n`);
+}
+function error(msg) {
+	process.stderr.write(`${isTTY() ? pc.red(`✗ ${msg}`) : `✗ ${msg}`}\n`);
+}
+function dim(msg) {
+	process.stderr.write(`${isTTY() ? pc.dim(msg) : msg}\n`);
+}
+
+//#endregion
 //#region src/history.ts
 const HISTORY_MAX_LINES = 1e3;
 const HISTORY_KEEP_LINES = 500;
@@ -68,13 +86,15 @@ function calcSpend(records) {
 		count
 	};
 }
+/** Format a USDC value with adaptive precision (no token suffix). */
+function formatUsdcValue(amount) {
+	if (amount >= .01) return amount.toFixed(2);
+	if (amount >= .001) return amount.toFixed(3);
+	if (amount >= 1e-4) return amount.toFixed(4);
+	return amount.toFixed(6);
+}
 function formatAmount(amount, token) {
-	if (token === "USDC") {
-		if (amount >= .01) return `${amount.toFixed(2)} USDC`;
-		if (amount >= .001) return `${amount.toFixed(3)} USDC`;
-		if (amount >= 1e-4) return `${amount.toFixed(4)} USDC`;
-		return `${amount.toFixed(6)} USDC`;
-	}
+	if (token === "USDC") return `${formatUsdcValue(amount)} USDC`;
 	if (token === "SOL") return `${amount} SOL`;
 	return `${amount} ${token}`;
 }
@@ -138,24 +158,6 @@ function formatTxLine(r, opts) {
 	return `  ${timeStr} ${r.ok ? "" : "✗ "}${parts.join(" · ")}`;
 }
 
-//#endregion
-//#region src/lib/output.ts
-function isTTY() {
-	return !!process.stderr.isTTY;
-}
-function info(msg) {
-	process.stderr.write(`${isTTY() ? pc.cyan(msg) : msg}\n`);
-}
-function warn(msg) {
-	process.stderr.write(`${isTTY() ? pc.yellow(msg) : msg}\n`);
-}
-function error(msg) {
-	process.stderr.write(`${isTTY() ? pc.red(`✗ ${msg}`) : `✗ ${msg}`}\n`);
-}
-function dim(msg) {
-	process.stderr.write(`${isTTY() ? pc.dim(msg) : msg}\n`);
-}
-
 //#endregion
 //#region src/lib/resolve-wallet.ts
 /**
@@ -273,10 +275,10 @@ async function buildX402Client(wallet, opts) {
 	if (daily || perTx) client.registerPolicy((_version, reqs) => {
 		if (daily) {
 			const spend = calcSpend(readHistory(getHistoryPath()));
-			if (spend.today >= daily) throw new Error(`Daily spend limit reached (${spend.today.toFixed(4)}/${daily} USDC)`);
+			if (spend.today >= daily) throw new Error(`Daily spend limit reached (${formatUsdcValue(spend.today)}/${daily} USDC)`);
 			const remaining = daily - spend.today;
 			reqs = reqs.filter((r) => Number(r.amount) / 1e6 <= remaining);
-			if (reqs.length === 0) throw new Error(`Daily spend limit of ${daily} USDC would be exceeded (${spend.today.toFixed(4)} spent today)`);
+			if (reqs.length === 0) throw new Error(`Daily spend limit of ${daily} USDC would be exceeded (${formatUsdcValue(spend.today)} spent today)`);
 		}
 		if (perTx) {
 			const before = reqs.length;
@@ -320,7 +322,7 @@ async function fetchEvmBalances(address) {
 	}, "latest"])]);
 	return {
 		eth: ethRes.result ? (Number(BigInt(ethRes.result)) / 0xde0b6b3a7640000).toFixed(6) : "?",
-		usdc: usdcRes.result ? (Number(BigInt(usdcRes.result)) / 1e6).toFixed(4) : "?"
+		usdc: usdcRes.result ? formatUsdcValue(Number(BigInt(usdcRes.result)) / 1e6) : "?"
 	};
 }
 async function fetchTempoBalances(address) {
@@ -328,7 +330,7 @@ async function fetchTempoBalances(address) {
 		to: USDC_TEMPO,
 		data: `0x70a08231${address.slice(2).padStart(64, "0")}`
 	}, "latest"]);
-	return { usdc: res.result ? (Number(BigInt(res.result)) / 1e6).toFixed(4) : "?" };
+	return { usdc: res.result ? formatUsdcValue(Number(BigInt(res.result)) / 1e6) : "?" };
 }
 async function getUsdcAta(owner) {
 	const encoder = getAddressEncoder();
@@ -349,7 +351,7 @@ async function fetchSolanaBalances(ownerAddress) {
 	const usdcVal = usdcRes.result?.value;
 	return {
 		sol,
-		usdc: usdcVal ? Number(usdcVal.uiAmountString).toFixed(4) : usdcVal === void 0 ? "?" : "0.0000"
+		usdc: usdcVal ? formatUsdcValue(Number(usdcVal.uiAmountString)) : usdcVal === void 0 ? "?" : "0"
 	};
 }
 function balanceLine(usdc, native, nativeSymbol) {
@@ -404,9 +406,9 @@ const walletInfoCommand = buildCommand({
 			const bal = sol ? balanceLine(sol.usdc, sol.sol, "SOL") : pc.dim(" (network error)");
 			console.log(`  Solana: ${pc.green(wallet.solanaAddress)}${bal}`);
 		}
-		const evmEmpty = !evm || evm.usdc === "0.0000";
-		const solEmpty = !sol || sol.usdc === "0.0000";
-		const tempoEmpty = !tempo || tempo.usdc === "0.0000";
+		const evmEmpty = !evm || Number(evm.usdc) === 0;
+		const solEmpty = !sol || Number(sol.usdc) === 0;
+		const tempoEmpty = !tempo || Number(tempo.usdc) === 0;
 		if (evmEmpty && solEmpty && tempoEmpty) {
 			console.log();
 			dim("  Send USDC to any address above to start using paid APIs.");
@@ -422,7 +424,7 @@ const walletInfoCommand = buildCommand({
 				console.log(line);
 			}
 			console.log();
-			console.log(pc.dim(`  Today: ${spend.today.toFixed(4)} USDC | Total: ${spend.total.toFixed(4)} USDC | ${spend.count} tx`));
+			console.log(pc.dim(`  Today: ${formatAmount(spend.today, "USDC")} | Total: ${formatAmount(spend.total, "USDC")} | ${spend.count} tx`));
 		} else dim("  No transactions yet.");
 		console.log();
 		console.log(pc.dim("  See also: wallet history, wallet export-key"));
@@ -431,4 +433,4 @@ const walletInfoCommand = buildCommand({
 });
 
 //#endregion
-export { formatTxLine as _, fetchTempoBalances as a, resolveWallet as c, info as d, isTTY as f, displayNetwork as g, calcSpend as h, fetchSolanaBalances as i, dim as l, appendHistory as m, fetchAllBalances as n, walletInfoCommand as o, warn as p, fetchEvmBalances as r, buildX402Client as s, balanceLine as t, error as u, readHistory as v };
+export { error as _, fetchTempoBalances as a, warn as b, resolveWallet as c, displayNetwork as d, formatAmount as f, dim as g, readHistory as h, fetchSolanaBalances as i, appendHistory as l, formatUsdcValue as m, fetchAllBalances as n, walletInfoCommand as o, formatTxLine as p, fetchEvmBalances as r, buildX402Client as s, balanceLine as t, calcSpend as u, info as v, isTTY as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base, Solana, and Tempo. Also works as an OpenClaw plugin.",
   "type": "module",
   "sideEffects": false,

package/skills/SKILL.md

@@ -45,6 +45,9 @@ x402-proxy mcp <url>                    # MCP stdio proxy for AI agents
 x402-proxy setup                        # wallet onboarding wizard
 x402-proxy setup --force                # re-run setup (overwrite existing wallet)
 x402-proxy status                       # config + wallet + daily spend summary
+x402-proxy config                       # show current configuration
+x402-proxy config set <key> <value>     # set a config value
+x402-proxy config unset <key>           # remove a config value
 x402-proxy wallet                       # show addresses and USDC balances
 x402-proxy wallet history               # payment log
 x402-proxy wallet history --limit 5     # last 5 payments

package/dist/setup-j_xQ14-4.js

@@ -1,4 +0,0 @@
-#!/usr/bin/env node
-import { n as setupCommand, t as runSetup } from "./setup-hJGkO2Lo.js";
-
-export { runSetup };