x402-proxy 0.9.0 → 0.9.2

package/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.2] - 2026-03-26
+
+### Changed
+- Upgraded all dependencies to latest: `@x402/*` 2.6.0 -> 2.8.0, `@solana/kit` 6.3.0 -> 6.5.0, `viem` 2.47.6, `@modelcontextprotocol/sdk` 1.28.0, `vitest` 4.1.1, `tsdown` 0.21.5, `@biomejs/biome` 2.4.9, `turbo` 2.8.20, `openclaw` 2026.3.24
+- `pnpm check` now runs tests alongside build, type-check, and biome
+- Biome config scoped to supported file types only (`*.ts`, `*.json`, `*.jsonc`)
+
+## [0.9.1] - 2026-03-26
+
+### Added
+- `setup --non-interactive` flag - auto-generates wallet and outputs addresses as JSON to stdout (`{"base":"0x...","tempo":"0x...","solana":"..."}`)
+- `setup --import-mnemonic` flag - import existing BIP-39 mnemonic non-interactively
+- MCP proxy auto-generates wallet on first run when no wallet exists (no more "No wallet configured" error)
+- OpenClaw integration example in README and SKILL.md: `openclaw mcp set surf '{"command":"npx","args":["-y","x402-proxy","mcp","https://surf.cascade.fyi/mcp"]}'`
+
+### Fixed
+- `npx -y` flag added to all generated MCP configs (`mcp add` command and docs) - prevents npx install prompt from corrupting MCP stdio protocol
+- MCP config examples no longer show `X402_PROXY_WALLET_MNEMONIC` env var as default - wallet file is the primary path, env vars are documented as fallback only
+- All example MCP URLs updated to `https://surf.cascade.fyi/mcp`
+- Non-interactive JSON output uses network names (`base`, `tempo`, `solana`) instead of generic `evm`
+
 ## [0.9.0] - 2026-03-25
 
 ### Added
@@ -263,7 +284,9 @@ 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.9.0...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.2...HEAD
+[0.9.2]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.1...v0.9.2
+[0.9.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.0...v0.9.1
 [0.9.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.6...v0.9.0
 [0.8.6]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.5...v0.8.6
 [0.8.5]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.4...v0.8.5

package/README.md

@@ -19,7 +19,7 @@ Let your AI agent consume any paid MCP server.
 ### Quick setup
 
 ```bash
-npx x402-proxy mcp add my-service https://mcp.example.com/sse
+npx x402-proxy mcp add surf https://surf.cascade.fyi/mcp
 ```
 
 Auto-detects installed AI clients (Claude Code, Cursor, VS Code, and 16+ others), shows a config preview, and writes it for you. Runs wallet setup if needed.
@@ -31,18 +31,21 @@ Or add to your client config directly:
 ```json
 {
   "mcpServers": {
-    "paid-service": {
+    "surf": {
       "command": "npx",
-      "args": ["x402-proxy", "mcp", "https://mcp.example.com/sse"],
-      "env": {
-        "X402_PROXY_WALLET_MNEMONIC": "your 24 words here"
-      }
+      "args": ["-y", "x402-proxy", "mcp", "https://surf.cascade.fyi/mcp"]
     }
   }
 }
 ```
 
-The proxy sits between your agent and the remote server, intercepting 402 responses, paying automatically, and forwarding the result. Supports both x402 and MPP protocols. Your agent never touches crypto.
+The proxy auto-generates a wallet on first run and uses `~/.config/x402-proxy/wallet.json`. No env vars needed. Your agent never touches crypto.
+
+For OpenClaw:
+
+```bash
+openclaw mcp set surf '{"command":"npx","args":["-y","x402-proxy","mcp","https://surf.cascade.fyi/mcp"]}'
+```
 
 ## HTTP Requests
 
@@ -110,7 +113,7 @@ $ MY_MNEMONIC=$(npx x402-proxy wallet export-key mnemonic)
 
 ## Env Vars
 
-Override wallet per-instance (useful for MCP configs):
+Override wallet per-instance (fallback for environments where the wallet file isn't accessible):
 
 ```
 X402_PROXY_WALLET_MNEMONIC     # BIP-39 mnemonic (derives both chains)

package/dist/bin/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort, l as loadWalletFile, s as isConfigured, u as saveConfig } from "../derive-CAYmX-Yz.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, n as fetchAllBalances, o as walletInfoCommand, p as formatTxLine, s as buildX402Client, u as calcSpend, v as info, y as isTTY } from "../wallet-DZsXptY7.js";
-import { n as setupCommand, t as runSetup } from "../setup-BjyoqzT3.js";
-import { n as statusCommand } from "../status-D3f5IVf6.js";
+import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort, l as loadWalletFile, s as isConfigured, u as saveConfig } from "../derive-EDXzwKW2.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, n as fetchAllBalances, o as walletInfoCommand, p as formatTxLine, s as buildX402Client, u as calcSpend, v as info, y as isTTY } from "../wallet-Bs8cBOv7.js";
+import { n as setupCommand, t as runSetup } from "../setup-QtTFsCFs.js";
+import { n as statusCommand } from "../status-ZRhJKaXq.js";
 import { dirname, join, normalize, resolve } from "node:path";
 import { buildApplication, buildCommand, buildRouteMap, run } from "@stricli/core";
 import pc from "picocolors";
@@ -11,7 +11,6 @@ import { homedir } from "node:os";
 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: {
@@ -161,7 +160,6 @@ const configUnsetCommand = buildCommand({
 		dim(`  ${key} unset`);
 	}
 });
-
 //#endregion
 //#region src/handler.ts
 /**
@@ -301,7 +299,6 @@ async function createMppProxyHandler(opts) {
 		}
 	};
 }
-
 //#endregion
 //#region src/commands/fetch.ts
 function isStreamingResponse(res) {
@@ -401,7 +398,7 @@ Examples:
 		};
 		if (!url) {
 			if (isConfigured()) {
-				const { displayStatus } = await import("../status-BkURZYDA.js");
+				const { displayStatus } = await import("../status-Dt8be_kW.js");
 				await displayStatus();
 				console.log();
 				console.log(pc.dim("  Commands:"));
@@ -453,7 +450,7 @@ Examples:
 				process.exit(1);
 			}
 			dim("  No wallet found. Let's set one up first.\n");
-			const { runSetup } = await import("../setup-CJgw4opQ.js");
+			const { runSetup } = await import("../setup-lCsiivm2.js");
 			await runSetup();
 			console.log();
 			wallet = resolveWallet();
@@ -466,7 +463,7 @@ Examples:
 		verbose(`protocol: ${resolvedProtocol ?? "auto-detect"}, maxDeposit: ${maxDeposit}`);
 		let preferredNetwork = config?.defaultNetwork;
 		if (!preferredNetwork && wallet.evmAddress && wallet.solanaAddress) {
-			const { fetchAllBalances } = await import("../wallet-BM0ngyqk.js");
+			const { fetchAllBalances } = await import("../wallet-8evCw-5Z.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;
@@ -527,7 +524,7 @@ Examples:
 					verbose(closeReceipt ? `close receipt: amount=${closeReceipt.amount ?? "none"}, channelId=${closeReceipt.channelId ?? "none"}, txHash=${closeReceipt.receipt?.txHash ?? "none"}` : "no close receipt (session close may have failed)");
 					mppPayment = closeReceipt ?? {
 						protocol: "mpp",
-						network: TEMPO_NETWORK,
+						network: "eip155:4217",
 						intent: "session"
 					};
 					usedProtocol = "mpp";
@@ -633,7 +630,7 @@ Examples:
 			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-BM0ngyqk.js");
+			const { fetchAllBalances } = await import("../wallet-8evCw-5Z.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;
@@ -754,7 +751,6 @@ Examples:
 		}
 	}
 });
-
 //#endregion
 //#region src/commands/mcp.ts
 const mcpCommand = buildCommand({
@@ -764,8 +760,9 @@ const mcpCommand = buildCommand({
 
 Add to your MCP client config (Claude, Cursor, etc.):
   "command": "npx",
-  "args": ["x402-proxy", "mcp", "https://mcp.example.com/sse"],
-  "env": { "X402_PROXY_WALLET_MNEMONIC": "your 24 words" }`
+  "args": ["-y", "x402-proxy", "mcp", "https://surf.cascade.fyi/mcp"]
+
+Wallet is auto-generated on first run. No env vars needed.`
 	},
 	parameters: {
 		flags: {
@@ -808,8 +805,18 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			solanaKey: flags.solanaKey
 		});
 		if (wallet.source === "none") {
-			error("No wallet configured.\nRun:\n  $ npx x402-proxy setup\n\nOr set X402_PROXY_WALLET_MNEMONIC");
-			process.exit(1);
+			dim("No wallet found. Auto-generating...");
+			const { runSetup } = await import("../setup-lCsiivm2.js");
+			await runSetup({ nonInteractive: true });
+			const fresh = resolveWallet({
+				evmKey: flags.evmKey,
+				solanaKey: flags.solanaKey
+			});
+			if (fresh.source === "none") {
+				error("Wallet auto-setup failed. Run: $ npx x402-proxy setup");
+				process.exit(1);
+			}
+			Object.assign(wallet, fresh);
 		}
 		dim(`x402-proxy MCP proxy -> ${remoteUrl}`);
 		if (wallet.evmAddress) dim(`  EVM:    ${wallet.evmAddress}`);
@@ -843,7 +850,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-BM0ngyqk.js");
+				const { fetchAllBalances } = await import("../wallet-8evCw-5Z.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;
@@ -863,7 +870,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.9.0"
+				version: "0.9.2"
 			});
 			const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 				autoPayment: true,
@@ -901,7 +908,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.9.0"
+				version: "0.9.2"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -996,7 +1003,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.9.0"
+				version: "0.9.2"
 			});
 			await connectTransport(remoteClient);
 			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
@@ -1011,7 +1018,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.9.0"
+				version: "0.9.2"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -1087,7 +1094,6 @@ Add to your MCP client config (Claude, Cursor, etc.):
 		}
 	}
 });
-
 //#endregion
 //#region src/commands/mcp-add.ts
 function resolvePlatformPath(raw) {
@@ -1197,6 +1203,7 @@ const mcpAddCommand = buildCommand({
 		const generated = generateConfig(clientId, serverName, {
 			command: "npx",
 			args: [
+				"-y",
 				"x402-proxy",
 				"mcp",
 				url
@@ -1270,7 +1277,6 @@ const mcpAddCommand = buildCommand({
 		prompts.outro(pc.green(`MCP server ${pc.bold(serverName)} is ready to use!`));
 	}
 });
-
 //#endregion
 //#region src/commands/wallet-export.ts
 const walletExportCommand = buildCommand({
@@ -1324,62 +1330,57 @@ const walletExportCommand = buildCommand({
 		else process.stdout.write(base58.encode(wallet.solanaKey.slice(0, 32)));
 	}
 });
-
-//#endregion
-//#region src/commands/wallet-history.ts
-const walletHistoryCommand = buildCommand({
-	docs: { brief: "Show payment history" },
-	parameters: {
-		flags: {
-			limit: {
-				kind: "parsed",
-				brief: "Number of entries to show",
-				parse: Number,
-				default: "20"
-			},
-			json: {
-				kind: "boolean",
-				brief: "Output raw JSONL",
-				default: false
-			}
-		},
-		positional: {
-			kind: "tuple",
-			parameters: []
-		}
-	},
-	func(flags) {
-		const records = readHistory(getHistoryPath());
-		if (records.length === 0) {
-			console.log(pc.dim("No payment history yet."));
-			return;
-		}
-		if (flags.json) {
-			const slice = records.slice(-flags.limit);
-			for (const r of slice) process.stdout.write(`${JSON.stringify(r)}\n`);
-			return;
-		}
-		const spend = calcSpend(records);
-		const slice = records.slice(-flags.limit);
-		console.log();
-		info("Payment History");
-		console.log();
-		for (const r of slice) {
-			const line = formatTxLine(r).replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
-			console.log(line);
-		}
-		console.log();
-		console.log(pc.dim(`  Today: ${formatAmount(spend.today, "USDC")} | Total: ${formatAmount(spend.total, "USDC")} | ${spend.count} transactions`));
-		console.log();
-	}
-});
-
 //#endregion
 //#region src/app.ts
 const walletRoutes = buildRouteMap({
 	routes: {
 		info: walletInfoCommand,
-		history: walletHistoryCommand,
+		history: buildCommand({
+			docs: { brief: "Show payment history" },
+			parameters: {
+				flags: {
+					limit: {
+						kind: "parsed",
+						brief: "Number of entries to show",
+						parse: Number,
+						default: "20"
+					},
+					json: {
+						kind: "boolean",
+						brief: "Output raw JSONL",
+						default: false
+					}
+				},
+				positional: {
+					kind: "tuple",
+					parameters: []
+				}
+			},
+			func(flags) {
+				const records = readHistory(getHistoryPath());
+				if (records.length === 0) {
+					console.log(pc.dim("No payment history yet."));
+					return;
+				}
+				if (flags.json) {
+					const slice = records.slice(-flags.limit);
+					for (const r of slice) process.stdout.write(`${JSON.stringify(r)}\n`);
+					return;
+				}
+				const spend = calcSpend(records);
+				const slice = records.slice(-flags.limit);
+				console.log();
+				info("Payment History");
+				console.log();
+				for (const r of slice) {
+					const line = formatTxLine(r).replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+					console.log(line);
+				}
+				console.log();
+				console.log(pc.dim(`  Today: ${formatAmount(spend.today, "USDC")} | Total: ${formatAmount(spend.total, "USDC")} | ${spend.count} transactions`));
+				console.log();
+			}
+		}),
 		"export-key": walletExportCommand
 	},
 	defaultCommand: "info",
@@ -1394,7 +1395,7 @@ const configRoutes = buildRouteMap({
 	defaultCommand: "show",
 	docs: { brief: "Manage configuration" }
 });
-const routes = buildRouteMap({
+const app = buildApplication(buildRouteMap({
 	routes: {
 		fetch: fetchCommand,
 		mcp: buildRouteMap({
@@ -1412,19 +1413,16 @@ const routes = buildRouteMap({
 	},
 	defaultCommand: "fetch",
 	docs: { brief: "curl for x402 paid APIs" }
-});
-const app = buildApplication(routes, {
+}), {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.9.0" },
+	versionInfo: { currentVersion: "0.9.2" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
-
 //#endregion
 //#region src/context.ts
 function buildContext(process) {
 	return { process };
 }
-
 //#endregion
 //#region src/bin/cli.ts
 process.on("SIGINT", () => process.exit(130));
@@ -1444,6 +1442,5 @@ for (let i = 0; i < rawArgs.length; i++) {
 	} else args.push(a);
 }
 await run(app, args, buildContext(process));
-
 //#endregion
-export {  };
+export {};

package/dist/{derive-CAYmX-Yz.js → derive-EDXzwKW2.js}

@@ -12,7 +12,6 @@ import { keccak_256 } from "@noble/hashes/sha3.js";
 import { HDKey } from "@scure/bip32";
 import { generateMnemonic, mnemonicToSeedSync } from "@scure/bip39";
 import { wordlist } from "@scure/bip39/wordlists/english.js";
-
 //#region src/lib/config.ts
 const APP_NAME = "x402-proxy";
 function getConfigDir() {
@@ -85,7 +84,6 @@ function isConfigured() {
 	if (process.env.X402_PROXY_WALLET_SOLANA_KEY) return true;
 	return loadWalletFile() !== null;
 }
-
 //#endregion
 //#region src/lib/derive.ts
 /**
@@ -156,6 +154,5 @@ function checksumAddress(addr) {
 	for (let i = 0; i < 40; i++) out += Number.parseInt(hash[i], 16) >= 8 ? addr[i].toUpperCase() : addr[i];
 	return out;
 }
-
 //#endregion
-export { getHistoryPath as a, loadConfig as c, saveWalletFile as d, getConfigDirShort as i, loadWalletFile as l, deriveSolanaKeypair as n, getWalletPath as o, generateMnemonic$1 as r, isConfigured as s, deriveEvmKeypair as t, saveConfig as u };
+export { getHistoryPath as a, loadConfig as c, saveWalletFile as d, getConfigDirShort as i, loadWalletFile as l, deriveSolanaKeypair as n, getWalletPath as o, generateMnemonic$1 as r, isConfigured as s, deriveEvmKeypair as t, saveConfig as u };

package/dist/index.js

@@ -5,7 +5,6 @@ import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFil
 import { dirname } from "node:path";
 import { createKeyPairSignerFromBytes } from "@solana/kit";
 import { privateKeyToAccount } from "viem/accounts";
-
 //#region src/handler.ts
 /**
 * Detect which payment protocols a 402 response advertises.
@@ -144,7 +143,6 @@ async function createMppProxyHandler(opts) {
 		}
 	};
 }
-
 //#endregion
 //#region src/history.ts
 const HISTORY_MAX_LINES = 1e3;
@@ -154,9 +152,9 @@ function appendHistory(historyPath, record) {
 		mkdirSync(dirname(historyPath), { recursive: true });
 		appendFileSync(historyPath, `${JSON.stringify(record)}\n`);
 		if (existsSync(historyPath)) {
-			if (statSync(historyPath).size > HISTORY_MAX_LINES * 200) {
+			if (statSync(historyPath).size > 1e3 * 200) {
 				const lines = readFileSync(historyPath, "utf-8").trimEnd().split("\n");
-				if (lines.length > HISTORY_MAX_LINES) writeFileSync(historyPath, `${lines.slice(-HISTORY_KEEP_LINES).join("\n")}\n`);
+				if (lines.length > 1e3) writeFileSync(historyPath, `${lines.slice(-500).join("\n")}\n`);
 			}
 		}
 	} catch {}
@@ -263,7 +261,6 @@ function formatTxLine(r, opts) {
 	}
 	return `  ${timeStr} ${r.ok ? "" : "✗ "}${parts.join(" · ")}`;
 }
-
 //#endregion
 //#region src/wallet.ts
 /**
@@ -283,6 +280,5 @@ function loadEvmWallet(keyPath) {
 	if (!hex.startsWith("0x")) hex = `0x${hex}`;
 	return toClientEvmSigner$1(privateKeyToAccount(hex));
 }
-
 //#endregion
-export { ExactEvmScheme, ExactSvmScheme, HISTORY_KEEP_LINES, HISTORY_MAX_LINES, TEMPO_NETWORK, appendHistory, calcSpend, createMppProxyHandler, createX402ProxyHandler, detectProtocols, explorerUrl, extractTxSignature, formatTxLine, loadEvmWallet, loadSvmWallet, readHistory, toClientEvmSigner, x402Client };
+export { ExactEvmScheme, ExactSvmScheme, HISTORY_KEEP_LINES, HISTORY_MAX_LINES, TEMPO_NETWORK, appendHistory, calcSpend, createMppProxyHandler, createX402ProxyHandler, detectProtocols, explorerUrl, extractTxSignature, formatTxLine, loadEvmWallet, loadSvmWallet, readHistory, toClientEvmSigner, x402Client };

package/dist/openclaw/plugin.js

@@ -20,7 +20,6 @@ import { HDKey } from "@scure/bip32";
 import { mnemonicToSeedSync } from "@scure/bip39";
 import "@scure/bip39/wordlists/english.js";
 import { Type } from "@sinclair/typebox";
-
 //#region src/handler.ts
 /**
 * Extract the on-chain transaction signature from an x402 payment response header.
@@ -58,7 +57,6 @@ function createX402ProxyHandler(opts) {
 		shiftPayment: () => paymentQueue.shift()
 	};
 }
-
 //#endregion
 //#region src/lib/config.ts
 const APP_NAME = "x402-proxy";
@@ -83,19 +81,14 @@ function loadWalletFile() {
 		return null;
 	}
 }
-
-//#endregion
-//#region src/history.ts
-const HISTORY_MAX_LINES = 1e3;
-const HISTORY_KEEP_LINES = 500;
 function appendHistory(historyPath, record) {
 	try {
 		mkdirSync(dirname(historyPath), { recursive: true });
 		appendFileSync(historyPath, `${JSON.stringify(record)}\n`);
 		if (existsSync(historyPath)) {
-			if (statSync(historyPath).size > HISTORY_MAX_LINES * 200) {
+			if (statSync(historyPath).size > 1e3 * 200) {
 				const lines = readFileSync(historyPath, "utf-8").trimEnd().split("\n");
-				if (lines.length > HISTORY_MAX_LINES) writeFileSync(historyPath, `${lines.slice(-HISTORY_KEEP_LINES).join("\n")}\n`);
+				if (lines.length > 1e3) writeFileSync(historyPath, `${lines.slice(-500).join("\n")}\n`);
 			}
 		}
 	} catch {}
@@ -202,7 +195,6 @@ function formatTxLine(r, opts) {
 	}
 	return `  ${timeStr} ${r.ok ? "" : "✗ "}${parts.join(" · ")}`;
 }
-
 //#endregion
 //#region src/lib/derive.ts
 /**
@@ -270,7 +262,6 @@ function checksumAddress(addr) {
 	for (let i = 0; i < 40; i++) out += Number.parseInt(hash[i], 16) >= 8 ? addr[i].toUpperCase() : addr[i];
 	return out;
 }
-
 //#endregion
 //#region src/lib/resolve-wallet.ts
 /**
@@ -341,7 +332,6 @@ function solanaAddressFromKey(keyBytes) {
 	if (keyBytes.length >= 64) return base58.encode(keyBytes.slice(32));
 	return base58.encode(ed25519.getPublicKey(keyBytes));
 }
-
 //#endregion
 //#region src/wallet.ts
 /**
@@ -352,7 +342,6 @@ async function loadSvmWallet(keypairPath) {
 	const data = JSON.parse(readFileSync(keypairPath, "utf-8"));
 	return createKeyPairSignerFromBytes(new Uint8Array(data));
 }
-
 //#endregion
 //#region src/openclaw/solana.ts
 const USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
@@ -444,7 +433,6 @@ async function transferUsdc(signer, rpcUrl, dest, amountRaw) {
 	const encoded = getBase64EncodedWireTransaction(await partiallySignTransactionMessageWithSigners(pipe(createTransactionMessage({ version: 0 }), (m) => setTransactionMessageFeePayer(signer.address, m), (m) => appendTransactionMessageInstructions([transferIx], m), (m) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, m))));
 	return await rpc.sendTransaction(encoded, { encoding: "base64" }).send();
 }
-
 //#endregion
 //#region src/openclaw/tools.ts
 const SOL_MAINNET = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
@@ -606,7 +594,6 @@ function createPaymentTool(ctx) {
 		}
 	};
 }
-
 //#endregion
 //#region src/openclaw/commands.ts
 const HISTORY_PAGE_SIZE = 5;
@@ -726,7 +713,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.9.0`];
+				const lines = [`x402-proxy v0.9.2`];
 				const defaultModel = ctx.allModels[0];
 				if (defaultModel) lines.push("", `**Model** - ${defaultModel.name} (${defaultModel.provider})`);
 				lines.push("", `**[Wallet](${solscanUrl})**`, `\`${walletAddress}\``);
@@ -759,7 +746,6 @@ function createWalletCommand(ctx) {
 		}
 	};
 }
-
 //#endregion
 //#region src/openclaw/route.ts
 function createX402RouteHandler(opts) {
@@ -992,7 +978,6 @@ function createX402RouteHandler(opts) {
 		}
 	};
 }
-
 //#endregion
 //#region src/openclaw/plugin.ts
 function parseProviders(config) {
@@ -1120,6 +1105,5 @@ function register(api) {
 	};
 	api.registerCommand(createWalletCommand(cmdCtx));
 }
-
 //#endregion
-export { register };
+export { register };

package/dist/{setup-BjyoqzT3.js → setup-QtTFsCFs.js}

@@ -1,15 +1,54 @@
 #!/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-CAYmX-Yz.js";
+import { d as saveWalletFile, i as getConfigDirShort, l as loadWalletFile, n as deriveSolanaKeypair, o as getWalletPath, r as generateMnemonic, s as isConfigured, t as deriveEvmKeypair, u as saveConfig } from "./derive-EDXzwKW2.js";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
 import * as prompts from "@clack/prompts";
-
 //#region src/commands/setup.ts
 async function runSetup(opts) {
+	const nonInteractive = opts?.nonInteractive ?? false;
+	if (nonInteractive && isConfigured() && !opts?.force) {
+		const walletFile = loadWalletFile();
+		if (walletFile) {
+			process.stdout.write(`${JSON.stringify({
+				base: walletFile.addresses.evm,
+				tempo: walletFile.addresses.evm,
+				solana: walletFile.addresses.solana
+			})}\n`);
+			return;
+		}
+	}
 	if (isConfigured() && !opts?.force) {
 		prompts.log.warn(`Already configured. Wallet at ${pc.dim(getWalletPath())}\nTo reconfigure, run:\n  ${pc.cyan("$ npx x402-proxy setup --force")}`);
 		return;
 	}
+	let mnemonic;
+	if (nonInteractive) {
+		if (opts?.importMnemonic) {
+			const words = opts.importMnemonic.trim().split(/\s+/);
+			if (words.length !== 12 && words.length !== 24) {
+				process.stderr.write("Error: mnemonic must be 12 or 24 words\n");
+				process.exit(1);
+			}
+			mnemonic = opts.importMnemonic.trim();
+		} else mnemonic = generateMnemonic();
+		const evm = deriveEvmKeypair(mnemonic);
+		const sol = deriveSolanaKeypair(mnemonic);
+		saveWalletFile({
+			version: 1,
+			mnemonic,
+			addresses: {
+				evm: evm.address,
+				solana: sol.address
+			}
+		});
+		saveConfig({ preferredProtocol: "x402" });
+		process.stdout.write(`${JSON.stringify({
+			base: evm.address,
+			tempo: evm.address,
+			solana: sol.address
+		})}\n`);
+		return;
+	}
 	prompts.intro(pc.cyan("x402-proxy setup"));
 	prompts.log.info("This will generate a single BIP-39 mnemonic that derives wallets for both Solana and EVM chains.");
 	const action = await prompts.select({
@@ -26,7 +65,6 @@ async function runSetup(opts) {
 		prompts.cancel("Setup cancelled.");
 		process.exit(0);
 	}
-	let mnemonic;
 	if (action === "generate") {
 		mnemonic = generateMnemonic();
 		prompts.log.warn("Write down your mnemonic and store it safely. It will NOT be shown again.");
@@ -109,22 +147,50 @@ async function runSetup(opts) {
 	prompts.outro(pc.green("Setup complete!"));
 }
 const setupCommand = buildCommand({
-	docs: { brief: "Set up x402-proxy with a new wallet" },
+	docs: {
+		brief: "Set up x402-proxy wallet (generate new or import existing mnemonic)",
+		fullDescription: `Set up x402-proxy wallet interactively, or use --non-interactive for automated environments.
+
+Non-interactive mode auto-generates a wallet and outputs JSON to stdout:
+  $ npx x402-proxy setup --non-interactive
+  {"base":"0x...","tempo":"0x...","solana":"..."}
+
+Import an existing mnemonic non-interactively:
+  $ npx x402-proxy setup --non-interactive --import-mnemonic "word1 word2 ... word24"
+
+If a wallet already exists, --non-interactive outputs the existing addresses.`
+	},
 	parameters: {
-		flags: { force: {
-			kind: "boolean",
-			brief: "Overwrite existing configuration",
-			default: false
-		} },
+		flags: {
+			force: {
+				kind: "boolean",
+				brief: "Overwrite existing configuration",
+				default: false
+			},
+			nonInteractive: {
+				kind: "boolean",
+				brief: "Auto-generate wallet and output addresses as JSON (no prompts)",
+				default: false
+			},
+			importMnemonic: {
+				kind: "parsed",
+				brief: "Import a BIP-39 mnemonic (use with --non-interactive)",
+				parse: String,
+				optional: true
+			}
+		},
 		positional: {
 			kind: "tuple",
 			parameters: []
 		}
 	},
 	async func(flags) {
-		await runSetup({ force: flags.force });
+		await runSetup({
+			force: flags.force,
+			nonInteractive: flags.nonInteractive,
+			importMnemonic: flags.importMnemonic
+		});
 	}
 });
-
 //#endregion
-export { setupCommand as n, runSetup as t };
+export { setupCommand as n, runSetup as t };

package/dist/setup-lCsiivm2.js

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

package/dist/status-Dt8be_kW.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { t as displayStatus } from "./status-ZRhJKaXq.js";
+export { displayStatus };

package/dist/{status-D3f5IVf6.js → status-ZRhJKaXq.js}

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
-import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort } from "./derive-CAYmX-Yz.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-DZsXptY7.js";
+import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort } from "./derive-EDXzwKW2.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-Bs8cBOv7.js";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
-
 //#region src/commands/status.ts
 async function displayStatus() {
 	const wallet = resolveWallet();
@@ -73,6 +72,5 @@ const statusCommand = buildCommand({
 		console.log();
 	}
 });
-
 //#endregion
-export { statusCommand as n, displayStatus as t };
+export { statusCommand as n, displayStatus as t };

package/dist/wallet-8evCw-5Z.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { n as fetchAllBalances } from "./wallet-Bs8cBOv7.js";
+export { fetchAllBalances };

package/dist/{wallet-DZsXptY7.js → wallet-Bs8cBOv7.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as getHistoryPath, l as loadWalletFile, n as deriveSolanaKeypair, t as deriveEvmKeypair } from "./derive-CAYmX-Yz.js";
+import { a as getHistoryPath, l as loadWalletFile, n as deriveSolanaKeypair, t as deriveEvmKeypair } from "./derive-EDXzwKW2.js";
 import { dirname } from "node:path";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
@@ -14,7 +14,6 @@ import { createPublicClient, http } from "viem";
 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;
@@ -31,19 +30,14 @@ function error(msg) {
 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;
 function appendHistory(historyPath, record) {
 	try {
 		mkdirSync(dirname(historyPath), { recursive: true });
 		appendFileSync(historyPath, `${JSON.stringify(record)}\n`);
 		if (existsSync(historyPath)) {
-			if (statSync(historyPath).size > HISTORY_MAX_LINES * 200) {
+			if (statSync(historyPath).size > 1e3 * 200) {
 				const lines = readFileSync(historyPath, "utf-8").trimEnd().split("\n");
-				if (lines.length > HISTORY_MAX_LINES) writeFileSync(historyPath, `${lines.slice(-HISTORY_KEEP_LINES).join("\n")}\n`);
+				if (lines.length > 1e3) writeFileSync(historyPath, `${lines.slice(-500).join("\n")}\n`);
 			}
 		}
 	} catch {}
@@ -157,7 +151,6 @@ function formatTxLine(r, opts) {
 	}
 	return `  ${timeStr} ${r.ok ? "" : "✗ "}${parts.join(" · ")}`;
 }
-
 //#endregion
 //#region src/lib/resolve-wallet.ts
 /**
@@ -312,7 +305,6 @@ async function buildX402Client(wallet, opts) {
 	});
 	return client;
 }
-
 //#endregion
 //#region src/commands/wallet.ts
 const BASE_RPC = "https://mainnet.base.org";
@@ -454,6 +446,5 @@ const walletInfoCommand = buildCommand({
 		console.log();
 	}
 });
-
 //#endregion
-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 };
+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.9.0",
+  "version": "0.9.2",
   "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,
@@ -28,24 +28,24 @@
   "dependencies": {
     "@clack/prompts": "^1.1.0",
     "@getmcp/generators": "^0.10.1",
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/sdk": "^1.28.0",
     "@noble/curves": "^2.0.1",
     "@noble/hashes": "^2.0.1",
     "@scure/base": "^2.0.0",
     "@scure/bip32": "^2.0.1",
     "@scure/bip39": "^2.0.1",
     "@sinclair/typebox": "^0.34.48",
-    "@solana/kit": "^6.0.0",
+    "@solana/kit": "^6.5.0",
     "@stricli/core": "^1.2.6",
-    "@x402/evm": "^2.6.0",
-    "@x402/fetch": "^2.6.0",
-    "@x402/mcp": "^2.6.0",
-    "@x402/svm": "^2.6.0",
-    "ethers": "^6.0.0",
+    "@x402/evm": "^2.8.0",
+    "@x402/fetch": "^2.8.0",
+    "@x402/mcp": "^2.8.0",
+    "@x402/svm": "^2.8.0",
+    "ethers": "^6.16.0",
     "mppx": "^0.4.9",
     "picocolors": "^1.1.1",
-    "viem": "^2.0.0",
-    "yaml": "^2.8.2"
+    "viem": "^2.47.6",
+    "yaml": "^2.8.3"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.8"
@@ -56,12 +56,12 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "openclaw": ">=2026.3.8",
-    "publint": "^0.3.17",
-    "tsdown": "^0.20.3",
-    "typescript": "^5.9.0",
-    "vitest": "^4.0.18"
+    "@types/node": "^25.5.0",
+    "openclaw": "^2026.3.24",
+    "publint": "^0.3.18",
+    "tsdown": "^0.21.5",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.1"
   },
   "files": [
     "dist/**",

package/skills/SKILL.md

@@ -74,7 +74,7 @@ x402-proxy wallet export-key mnemonic   # bare mnemonic to stdout
 Quick setup (auto-detects installed AI clients):
 
 ```bash
-x402-proxy mcp add my-service https://mcp.example.com/sse
+x402-proxy mcp add surf https://surf.cascade.fyi/mcp
 ```
 
 Or drop into your client config manually:
@@ -82,18 +82,28 @@ Or drop into your client config manually:
 ```json
 {
   "mcpServers": {
-    "paid-service": {
+    "surf": {
       "command": "npx",
-      "args": ["x402-proxy", "mcp", "https://mcp.example.com/sse"],
-      "env": {
-        "X402_PROXY_WALLET_MNEMONIC": "your 24 words here"
-      }
+      "args": ["-y", "x402-proxy", "mcp", "https://surf.cascade.fyi/mcp"]
     }
   }
 }
 ```
 
-The proxy intercepts 402 responses, pays automatically, forwards the result. Supports StreamableHTTP and SSE.
+For OpenClaw:
+
+```bash
+openclaw mcp set surf '{"command":"npx","args":["-y","x402-proxy","mcp","https://surf.cascade.fyi/mcp"]}'
+```
+
+The wallet is auto-generated on first run and stored at `~/.config/x402-proxy/wallet.json`. No env vars needed. The proxy intercepts 402 responses, pays automatically, forwards the result. Supports StreamableHTTP and SSE.
+
+For non-interactive setup (e.g. automated provisioning):
+
+```bash
+npx x402-proxy setup --non-interactive
+# outputs: {"evm":"0x...","solana":"..."}
+```
 
 ## Wallet & env vars
 

package/dist/setup-CJgw4opQ.js

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

package/dist/status-BkURZYDA.js

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

package/dist/wallet-BM0ngyqk.js

@@ -1,4 +0,0 @@
-#!/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-DZsXptY7.js";
-
-export { fetchAllBalances };