x402-proxy 0.2.1 → 0.3.1

package/README.md

@@ -5,7 +5,7 @@
 ## Quick Start
 
 ```bash
-npx x402-proxy https://twitter.surf.cascade.fyi/search?q=cascade_fyi
+npx x402-proxy https://twitter.surf.cascade.fyi/user/cascade_fyi
 ```
 
 That's it. The endpoint returns 402, x402-proxy pays and streams the response.
@@ -45,7 +45,7 @@ Works like curl. Response body streams to stdout, payment info goes to stderr.
 
 ```bash
 # GET request
-x402-proxy https://twitter.surf.cascade.fyi/search?q=x402
+x402-proxy https://twitter.surf.cascade.fyi/user/cascade_fyi
 
 # POST with body and headers
 x402-proxy --method POST \
@@ -67,7 +67,7 @@ x402-proxy status                   # config + wallet + spend summary
 x402-proxy wallet                   # show addresses
 x402-proxy wallet history           # payment history
 x402-proxy wallet fund              # funding instructions
-x402-proxy wallet export-key <chain> # bare key to stdout (evm|solana)
+x402-proxy wallet export-key <target> # bare key/mnemonic to stdout (evm|solana|mnemonic)
 ```
 
 All commands support `--help` for details.
@@ -83,8 +83,9 @@ Config stored at `$XDG_CONFIG_HOME/x402-proxy/` (default `~/.config/x402-proxy/`
 ### Export keys for other tools
 
 ```bash
-# Pipe-safe - outputs bare key to stdout
+# Pipe-safe - outputs bare key/mnemonic to stdout
 MY_KEY=$(npx x402-proxy wallet export-key evm)
+MY_MNEMONIC=$(npx x402-proxy wallet export-key mnemonic)
 ```
 
 ## Env Vars

package/dist/bin/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { C as readHistory, S as formatTxLine, _ as isConfigured, a as deriveEvmKeypair, b as appendHistory, c as dim, d as isTTY, f as warn, g as getWalletPath, h as getHistoryPath, i as resolveWallet, l as error, m as getConfigDir, n as statusCommand, o as deriveSolanaKeypair, p as ensureConfigDir, r as buildX402Client, s as generateMnemonic, u as info, v as saveConfig, x as calcSpend, y as saveWalletFile } from "../status-J-RoszDZ.js";
+import { C as appendHistory, E as readHistory, S as saveWalletFile, T as formatTxLine, _ as getWalletPath, a as resolveWallet, b as loadWalletFile, c as generateMnemonic, d as info, f as isTTY, g as getHistoryPath, h as getConfigDirShort, i as buildX402Client, l as dim, m as ensureConfigDir, n as statusCommand, o as deriveEvmKeypair, p as warn, r as walletInfoCommand, s as deriveSolanaKeypair, u as error, v as isConfigured, w as calcSpend, x as saveConfig, y as loadConfig } from "../status-BAzavcCj.js";
 import { buildApplication, buildCommand, buildRouteMap, run } from "@stricli/core";
 import pc from "picocolors";
 import { decodePaymentResponseHeader, wrapFetchWithPayment } from "@x402/fetch";
@@ -49,7 +49,15 @@ function createX402ProxyHandler(opts) {
 //#endregion
 //#region src/commands/fetch.ts
 const fetchCommand = buildCommand({
-	docs: { brief: "Make a paid HTTP request (default command)" },
+	docs: {
+		brief: "Make a paid HTTP request (default command)",
+		fullDescription: `Make a paid HTTP request. Payment is automatic when the server returns 402.
+
+Examples:
+  $ x402-proxy https://twitter.surf.cascade.fyi/user/cascade_fyi
+  $ x402-proxy -X POST -d '{"url":"https://x402.org"}' https://web.surf.cascade.fyi/v1/crawl
+  $ x402-proxy https://api.example.com/data | jq '.results'`
+	},
 	parameters: {
 		flags: {
 			method: {
@@ -101,18 +109,38 @@ const fetchCommand = buildCommand({
 	async func(flags, url) {
 		if (!url) {
 			if (isConfigured()) {
-				const { displayStatus } = await import("../status-DnxuVdOP.js");
-				displayStatus();
+				const { displayStatus } = await import("../status-CeXiUR6L.js");
+				await displayStatus();
+				console.log();
+				console.log(pc.dim("  Commands:"));
+				console.log(`    ${pc.cyan("$ npx x402-proxy <url>")}              Fetch a paid API`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy mcp <url>")}          MCP proxy for AI agents`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy setup")}              Reconfigure wallet`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy wallet")}             Addresses and balances`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy wallet history")}     Full payment history`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy wallet fund")}        Funding instructions`);
+				console.log();
+				console.log(pc.dim("  try: ") + pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/user/cascade_fyi"));
+				console.log();
+				console.log(pc.dim("  https://github.com/cascade-protocol/x402-proxy"));
+				console.log();
 			} else {
 				console.log();
-				console.log(pc.cyan("x402-proxy") + pc.dim(" - pay for any x402 resource"));
+				console.log(pc.cyan(pc.bold("x402-proxy")));
+				console.log(pc.dim("curl for x402 paid APIs"));
 				console.log();
-				console.log(pc.dim("  Get started:"));
-				console.log(`    ${pc.cyan("x402-proxy setup")}          Create a wallet`);
-				console.log(`    ${pc.cyan("x402-proxy <url>")}          Make a paid request`);
-				console.log(`    ${pc.cyan("x402-proxy mcp <url>")}      MCP proxy for agents`);
-				console.log(`    ${pc.cyan("x402-proxy wallet")}         Wallet info`);
-				console.log(`    ${pc.cyan("x402-proxy --help")}         All commands`);
+				console.log(pc.dim("  Commands:"));
+				console.log(`    ${pc.cyan("$ npx x402-proxy setup")}              Create a wallet`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy <url>")}              Fetch a paid API`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy mcp <url>")}          MCP proxy for AI agents`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy wallet")}             Addresses and balances`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy wallet history")}     Payment history`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy wallet fund")}        Funding instructions`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy --help")}             All options`);
+				console.log();
+				console.log(pc.dim("  try: ") + pc.cyan("$ npx x402-proxy setup"));
+				console.log();
+				console.log(pc.dim("  https://github.com/cascade-protocol/x402-proxy"));
 				console.log();
 			}
 			return;
@@ -133,7 +161,12 @@ const fetchCommand = buildCommand({
 			console.error(pc.dim(`Run ${pc.cyan("x402-proxy setup")} or set X402_PROXY_WALLET_MNEMONIC`));
 			process.exit(1);
 		}
-		const { x402Fetch, shiftPayment } = createX402ProxyHandler({ client: await buildX402Client(wallet) });
+		const config = loadConfig();
+		const { x402Fetch, shiftPayment } = createX402ProxyHandler({ client: await buildX402Client(wallet, {
+			preferredNetwork: config?.defaultNetwork,
+			spendLimitDaily: config?.spendLimitDaily,
+			spendLimitPerTx: config?.spendLimitPerTx
+		}) });
 		const headers = new Headers();
 		if (flags.header) for (const h of flags.header) {
 			const idx = h.indexOf(":");
@@ -198,7 +231,15 @@ const fetchCommand = buildCommand({
 //#endregion
 //#region src/commands/mcp.ts
 const mcpCommand = buildCommand({
-	docs: { brief: "Start MCP stdio proxy with x402 payment (alpha)" },
+	docs: {
+		brief: "Start MCP stdio proxy with x402 payment (alpha)",
+		fullDescription: `Start an MCP stdio proxy with automatic x402 payment for AI agents.
+
+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" }`
+	},
 	parameters: {
 		flags: {
 			evmKey: {
@@ -235,7 +276,12 @@ const mcpCommand = buildCommand({
 		dim(`x402-proxy MCP proxy -> ${remoteUrl}`);
 		if (wallet.evmAddress) dim(`  EVM:    ${wallet.evmAddress}`);
 		if (wallet.solanaAddress) dim(`  Solana: ${wallet.solanaAddress}`);
-		const x402PaymentClient = await buildX402Client(wallet);
+		const config = loadConfig();
+		const x402PaymentClient = await buildX402Client(wallet, {
+			preferredNetwork: config?.defaultNetwork,
+			spendLimitDaily: config?.spendLimitDaily,
+			spendLimitPerTx: config?.spendLimitPerTx
+		});
 		const { Client } = await import("@modelcontextprotocol/sdk/client/index.js");
 		const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
 		const { StreamableHTTPClientTransport } = await import("@modelcontextprotocol/sdk/client/streamableHttp.js");
@@ -244,7 +290,7 @@ const mcpCommand = buildCommand({
 		const { x402MCPClient } = await import("@x402/mcp");
 		const x402Mcp = new x402MCPClient(new Client({
 			name: "x402-proxy",
-			version: "0.2.0"
+			version: "0.3.0"
 		}), x402PaymentClient, {
 			autoPayment: true,
 			onPaymentRequested: (ctx) => {
@@ -289,7 +335,7 @@ const mcpCommand = buildCommand({
 		dim(`  ${tools.length} tools available`);
 		const localServer = new McpServer({
 			name: "x402-proxy",
-			version: "0.2.0"
+			version: "0.3.0"
 		});
 		for (const tool of tools) localServer.tool(tool.name, tool.description ?? "", tool.inputSchema?.properties ? Object.fromEntries(Object.entries(tool.inputSchema.properties).map(([k, v]) => [k, v])) : {}, async (args) => {
 			const result = await x402Mcp.callTool(tool.name, args);
@@ -377,7 +423,7 @@ const setupCommand = buildCommand({
 		}
 		const evm = deriveEvmKeypair(mnemonic);
 		const sol = deriveSolanaKeypair(mnemonic);
-		prompts.log.success(`EVM address:    ${pc.green(evm.address)}`);
+		prompts.log.success(`Base address:   ${pc.green(evm.address)}`);
 		prompts.log.success(`Solana address: ${pc.green(sol.address)}`);
 		saveWalletFile({
 			version: 1,
@@ -388,82 +434,67 @@ const setupCommand = buildCommand({
 			}
 		});
 		saveConfig({});
-		prompts.log.info(`Config directory: ${pc.dim(getConfigDir())}`);
+		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)}`);
-		prompts.log.message(`  EVM (USDC):    Send USDC to ${pc.cyan(evm.address)} on Base`);
+		prompts.log.message(`  Base (USDC):   Send USDC to ${pc.cyan(evm.address)}`);
+		prompts.log.step("Try your first request:");
+		prompts.log.message(`  ${pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/user/cascade_fyi")}`);
 		prompts.outro(pc.green("Setup complete!"));
 	}
 });
 
-//#endregion
-//#region src/commands/wallet.ts
-const walletInfoCommand = buildCommand({
-	docs: { brief: "Show wallet addresses" },
-	parameters: {
-		flags: {},
-		positional: {
-			kind: "tuple",
-			parameters: []
-		}
-	},
-	func() {
-		const wallet = resolveWallet();
-		if (wallet.source === "none") {
-			console.log(pc.yellow("No wallet configured."));
-			console.log(pc.dim(`Run ${pc.cyan("x402-proxy setup")} to create one.`));
-			console.log(pc.dim(`Or set ${pc.cyan("X402_PROXY_WALLET_MNEMONIC")} environment variable.`));
-			process.exit(1);
-		}
-		console.log();
-		info("Wallet");
-		console.log();
-		console.log(pc.dim(`  Source: ${wallet.source}`));
-		if (wallet.evmAddress) console.log(`  EVM:    ${pc.green(wallet.evmAddress)}`);
-		if (wallet.solanaAddress) console.log(`  Solana: ${pc.green(wallet.solanaAddress)}`);
-		console.log();
-	}
-});
-
 //#endregion
 //#region src/commands/wallet-export.ts
 const walletExportCommand = buildCommand({
-	docs: { brief: "Export private key to stdout (pipe-safe)" },
+	docs: { brief: "Export private key or mnemonic to stdout (pipe-safe)" },
 	parameters: {
 		flags: {},
 		positional: {
 			kind: "tuple",
 			parameters: [{
-				brief: "Chain to export: evm or solana",
+				brief: "What to export: evm, solana, or mnemonic",
 				parse: (input) => {
 					const v = input.toLowerCase();
-					if (v !== "evm" && v !== "solana") throw new Error("Must be 'evm' or 'solana'");
+					if (v !== "evm" && v !== "solana" && v !== "mnemonic") throw new Error("Must be 'evm', 'solana', or 'mnemonic'");
 					return v;
 				}
 			}]
 		}
 	},
-	func(flags, chain) {
+	async func(flags, chain) {
+		if (chain === "mnemonic") {
+			const mnemonic = process.env.X402_PROXY_WALLET_MNEMONIC || loadWalletFile()?.mnemonic;
+			if (!mnemonic) {
+				error("No mnemonic available. Wallet may have been configured with individual keys.");
+				process.exit(1);
+			}
+			if (process.stdout.isTTY) {
+				const confirmed = await prompts.confirm({ message: "This will print your mnemonic to the terminal. Continue?" });
+				if (prompts.isCancel(confirmed) || !confirmed) process.exit(0);
+			} else warn("Warning: mnemonic will be printed to stdout.");
+			process.stdout.write(mnemonic);
+			return;
+		}
 		const wallet = resolveWallet();
 		if (wallet.source === "none") {
 			error("No wallet configured.");
 			process.exit(1);
 		}
-		if (chain === "evm") {
-			if (!wallet.evmKey) {
-				error("No EVM key available.");
-				process.exit(1);
-			}
-			warn("Warning: private key will be printed to stdout.");
-			process.stdout.write(wallet.evmKey);
-		} else {
-			if (!wallet.solanaKey) {
-				error("No Solana key available.");
-				process.exit(1);
-			}
-			warn("Warning: private key will be printed to stdout.");
-			process.stdout.write(base58.encode(wallet.solanaKey.slice(0, 32)));
+		if (chain === "evm" && !wallet.evmKey) {
+			error("No EVM key available.");
+			process.exit(1);
+		}
+		if (chain === "solana" && !wallet.solanaKey) {
+			error("No Solana key available.");
+			process.exit(1);
 		}
+		if (process.stdout.isTTY) {
+			const confirmed = await prompts.confirm({ message: "This will print your private key to the terminal. Continue?" });
+			if (prompts.isCancel(confirmed) || !confirmed) process.exit(0);
+		} else warn("Warning: private key will be printed to stdout.");
+		if (chain === "evm") process.stdout.write(wallet.evmKey);
+		else process.stdout.write(base58.encode(wallet.solanaKey.slice(0, 32)));
 	}
 });
 
@@ -578,7 +609,7 @@ const routes = buildRouteMap({
 });
 const app = buildApplication(routes, {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.2.1" },
+	versionInfo: { currentVersion: "0.3.1" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 

package/dist/index.d.ts

@@ -66,7 +66,9 @@ declare function calcSpend(records: TxRecord[]): {
   count: number;
 };
 declare function explorerUrl(net: string, tx: string): string;
-declare function formatTxLine(r: TxRecord): string;
+declare function formatTxLine(r: TxRecord, opts?: {
+  verbose?: boolean;
+}): string;
 //#endregion
 //#region src/wallet.d.ts
 /**

package/dist/index.js

@@ -131,7 +131,13 @@ function shortModel(model) {
 	const parts = model.split("/");
 	return parts[parts.length - 1].replace(/-\d{6,8}$/, "").replace(/-\d{4}$/, "");
 }
-function formatTxLine(r) {
+function shortNetwork(net) {
+	if (net === "eip155:8453") return "base";
+	if (net.startsWith("eip155:")) return `evm:${net.split(":")[1]}`;
+	if (net.startsWith("solana:")) return "sol";
+	return net;
+}
+function formatTxLine(r, opts) {
 	const time = new Date(r.t).toLocaleTimeString("en-US", {
 		hour: "2-digit",
 		minute: "2-digit",
@@ -143,6 +149,11 @@ function formatTxLine(r) {
 	if (r.label) parts.push(r.label);
 	if (r.ok && r.amount != null && r.token) parts.push(formatAmount(r.amount, r.token));
 	else if (r.ok && r.kind === "sell" && r.meta?.pct != null) parts.push(`${r.meta.pct}%`);
+	parts.push(shortNetwork(r.net));
+	if (opts?.verbose && r.tx) {
+		const short = r.tx.length > 20 ? `${r.tx.slice(0, 10)}...${r.tx.slice(-6)}` : r.tx;
+		parts.push(short);
+	}
 	return `  ${timeStr} ${r.ok ? "" : "✗ "}${parts.join(" · ")}`;
 }
 

package/dist/{status-J-RoszDZ.js → status-BAzavcCj.js}

@@ -106,7 +106,13 @@ function shortModel(model) {
 	const parts = model.split("/");
 	return parts[parts.length - 1].replace(/-\d{6,8}$/, "").replace(/-\d{4}$/, "");
 }
-function formatTxLine(r) {
+function shortNetwork(net) {
+	if (net === "eip155:8453") return "base";
+	if (net.startsWith("eip155:")) return `evm:${net.split(":")[1]}`;
+	if (net.startsWith("solana:")) return "sol";
+	return net;
+}
+function formatTxLine(r, opts) {
 	const time = new Date(r.t).toLocaleTimeString("en-US", {
 		hour: "2-digit",
 		minute: "2-digit",
@@ -118,6 +124,11 @@ function formatTxLine(r) {
 	if (r.label) parts.push(r.label);
 	if (r.ok && r.amount != null && r.token) parts.push(formatAmount(r.amount, r.token));
 	else if (r.ok && r.kind === "sell" && r.meta?.pct != null) parts.push(`${r.meta.pct}%`);
+	parts.push(shortNetwork(r.net));
+	if (opts?.verbose && r.tx) {
+		const short = r.tx.length > 20 ? `${r.tx.slice(0, 10)}...${r.tx.slice(-6)}` : r.tx;
+		parts.push(short);
+	}
 	return `  ${timeStr} ${r.ok ? "" : "✗ "}${parts.join(" · ")}`;
 }
 
@@ -128,6 +139,12 @@ function getConfigDir() {
 	const xdg = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
 	return path.join(xdg, APP_NAME);
 }
+/** Config dir with $HOME replaced by ~ for display */
+function getConfigDirShort() {
+	const dir = getConfigDir();
+	const home = os.homedir();
+	return dir.startsWith(home) ? `~${dir.slice(home.length)}` : dir;
+}
 function getWalletPath() {
 	return path.join(getConfigDir(), "wallet.json");
 }
@@ -201,7 +218,7 @@ function warn(msg) {
 	process.stderr.write(`${isTTY() ? pc.yellow(msg) : msg}\n`);
 }
 function error(msg) {
-	process.stderr.write(`${isTTY() ? pc.red(msg) : msg}\n`);
+	process.stderr.write(`${isTTY() ? pc.red(`✗ ${msg}`) : `✗ ${msg}`}\n`);
 }
 function dim(msg) {
 	process.stderr.write(`${isTTY() ? pc.dim(msg) : msg}\n`);
@@ -338,11 +355,23 @@ function parsesolanaKey(input) {
 	}
 	return base58.decode(trimmed);
 }
+function networkToCaipPrefix(name) {
+	switch (name.toLowerCase()) {
+		case "base": return "eip155:8453";
+		case "solana": return "solana:";
+		default: return name;
+	}
+}
 /**
 * Build a configured x402Client from resolved wallet keys.
 */
-async function buildX402Client(wallet) {
-	const client = new x402Client();
+async function buildX402Client(wallet, opts) {
+	const client = new x402Client(opts?.preferredNetwork ? (() => {
+		const prefix = networkToCaipPrefix(opts.preferredNetwork);
+		return (_version, accepts) => {
+			return accepts.find((r) => r.network.startsWith(prefix)) || accepts[0];
+		};
+	})() : void 0);
 	if (wallet.evmKey) {
 		const hex = wallet.evmKey;
 		const signer = toClientEvmSigner(privateKeyToAccount(hex), createPublicClient({
@@ -357,39 +386,175 @@ async function buildX402Client(wallet) {
 		client.register("solana:mainnet", new ExactSvmScheme(signer));
 		client.register("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", new ExactSvmScheme(signer));
 	}
+	const daily = opts?.spendLimitDaily;
+	const perTx = opts?.spendLimitPerTx;
+	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)`);
+			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 (perTx) {
+			const before = reqs.length;
+			reqs = reqs.filter((r) => Number(r.amount) / 1e6 <= perTx);
+			if (reqs.length === 0 && before > 0) throw new Error(`Payment exceeds per-transaction limit of ${perTx} USDC`);
+		}
+		return reqs;
+	});
 	return client;
 }
 
+//#endregion
+//#region src/commands/wallet.ts
+const BASE_RPC = "https://mainnet.base.org";
+const SOLANA_RPC = "https://api.mainnet-beta.solana.com";
+const USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+const USDC_SOLANA_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+async function rpcCall(url, method, params) {
+	return (await fetch(url, {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({
+			jsonrpc: "2.0",
+			method,
+			params,
+			id: 1
+		})
+	})).json();
+}
+async function fetchEvmBalances(address) {
+	const usdcData = `0x70a08231${address.slice(2).padStart(64, "0")}`;
+	const [ethRes, usdcRes] = await Promise.all([rpcCall(BASE_RPC, "eth_getBalance", [address, "latest"]), rpcCall(BASE_RPC, "eth_call", [{
+		to: USDC_BASE,
+		data: usdcData
+	}, "latest"])]);
+	return {
+		eth: ethRes.result ? (Number(BigInt(ethRes.result)) / 0xde0b6b3a7640000).toFixed(6) : "?",
+		usdc: usdcRes.result ? (Number(BigInt(usdcRes.result)) / 1e6).toFixed(2) : "?"
+	};
+}
+async function fetchSolanaBalances(address) {
+	const [solRes, usdcRes] = await Promise.all([rpcCall(SOLANA_RPC, "getBalance", [address]), rpcCall(SOLANA_RPC, "getTokenAccountsByOwner", [
+		address,
+		{ mint: USDC_SOLANA_MINT },
+		{ encoding: "jsonParsed" }
+	])]);
+	const sol = solRes.result?.value != null ? (solRes.result.value / 1e9).toFixed(6) : "?";
+	const accounts = usdcRes.result?.value;
+	return {
+		sol,
+		usdc: accounts?.length ? Number(accounts[0].account.data.parsed.info.tokenAmount.uiAmountString).toFixed(2) : "0.00"
+	};
+}
+function balanceLine(usdc, native, nativeSymbol) {
+	return pc.dim(` (${usdc} USDC, ${native} ${nativeSymbol})`);
+}
+const walletInfoCommand = buildCommand({
+	docs: { brief: "Show wallet addresses and balances" },
+	parameters: {
+		flags: { verbose: {
+			kind: "boolean",
+			brief: "Show transaction IDs",
+			default: false
+		} },
+		positional: {
+			kind: "tuple",
+			parameters: []
+		}
+	},
+	async func(flags) {
+		const wallet = resolveWallet();
+		if (wallet.source === "none") {
+			console.log(pc.yellow("No wallet configured."));
+			console.log(pc.dim(`Run ${pc.cyan("x402-proxy setup")} to create one.`));
+			console.log(pc.dim(`Or set ${pc.cyan("X402_PROXY_WALLET_MNEMONIC")} environment variable.`));
+			process.exit(1);
+		}
+		console.log();
+		info("Wallet");
+		console.log();
+		console.log(pc.dim(`  Source: ${wallet.source}`));
+		const [evmResult, solResult] = await Promise.allSettled([wallet.evmAddress ? fetchEvmBalances(wallet.evmAddress) : Promise.resolve(null), wallet.solanaAddress ? fetchSolanaBalances(wallet.solanaAddress) : Promise.resolve(null)]);
+		const evm = evmResult.status === "fulfilled" ? evmResult.value : null;
+		const sol = solResult.status === "fulfilled" ? solResult.value : null;
+		if (wallet.evmAddress) {
+			const bal = evm ? balanceLine(evm.usdc, evm.eth, "ETH") : pc.dim(" (network error)");
+			console.log(`  Base:   ${pc.green(wallet.evmAddress)}${bal}`);
+		}
+		if (wallet.solanaAddress) {
+			const bal = sol ? balanceLine(sol.usdc, sol.sol, "SOL") : pc.dim(" (network error)");
+			console.log(`  Solana: ${pc.green(wallet.solanaAddress)}${bal}`);
+		}
+		console.log();
+		const records = readHistory(getHistoryPath());
+		if (records.length > 0) {
+			const spend = calcSpend(records);
+			const recent = records.slice(-10);
+			dim("  Recent transactions:");
+			for (const r of recent) {
+				const line = formatTxLine(r, { verbose: flags.verbose }).replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+				console.log(line);
+			}
+			console.log();
+			console.log(pc.dim(`  Today: ${spend.today.toFixed(4)} USDC | Total: ${spend.total.toFixed(4)} USDC | ${spend.count} tx`));
+		} else dim("  No transactions yet.");
+		console.log();
+		console.log(pc.dim("  See also: wallet history, wallet fund, wallet export-key"));
+		console.log();
+	}
+});
+
 //#endregion
 //#region src/commands/status.ts
-function displayStatus() {
+async function displayStatus() {
 	const wallet = resolveWallet();
 	const config = loadConfig();
+	const records = readHistory(getHistoryPath());
+	const spend = calcSpend(records);
 	console.log();
-	info("x402-proxy status");
-	console.log();
-	dim(`  Config directory: ${getConfigDir()}`);
-	if (config) {
-		if (config.spendLimit) dim(`  Spend limit:      ${config.spendLimit} USDC`);
-		if (config.defaultNetwork) dim(`  Default network:  ${config.defaultNetwork}`);
-	}
+	console.log(pc.cyan(pc.bold("x402-proxy")));
+	console.log(pc.dim("curl for x402 paid APIs"));
 	console.log();
 	if (wallet.source === "none") {
 		console.log(pc.yellow("  No wallet configured."));
-		console.log(pc.dim(`  Run ${pc.cyan("x402-proxy setup")} to create one.`));
+		console.log(pc.dim(`  Run ${pc.cyan("$ npx x402-proxy setup")} to create one.`));
 	} else {
-		dim(`  Wallet source: ${wallet.source}`);
-		if (wallet.evmAddress) console.log(`  EVM:    ${pc.green(wallet.evmAddress)}`);
-		if (wallet.solanaAddress) console.log(`  Solana: ${pc.green(wallet.solanaAddress)}`);
+		const [evmResult, solResult] = await Promise.allSettled([wallet.evmAddress ? fetchEvmBalances(wallet.evmAddress) : Promise.resolve(null), wallet.solanaAddress ? fetchSolanaBalances(wallet.solanaAddress) : Promise.resolve(null)]);
+		const evm = evmResult.status === "fulfilled" ? evmResult.value : null;
+		const sol = solResult.status === "fulfilled" ? solResult.value : null;
+		if (wallet.evmAddress) {
+			const bal = evm ? balanceLine(evm.usdc, evm.eth, "ETH") : pc.dim(" (network error)");
+			console.log(`  Base:   ${pc.green(wallet.evmAddress)}${bal}`);
+		}
+		if (wallet.solanaAddress) {
+			const bal = sol ? balanceLine(sol.usdc, sol.sol, "SOL") : pc.dim(" (network error)");
+			console.log(`  Solana: ${pc.green(wallet.solanaAddress)}${bal}`);
+		}
+		if (config?.spendLimitDaily || config?.spendLimitPerTx) {
+			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}%)`);
+			}
+			if (config.spendLimitPerTx) dim(`  Per-tx limit:   ${config.spendLimitPerTx} USDC`);
+		}
 	}
 	console.log();
-	const spend = calcSpend(readHistory(getHistoryPath()));
 	if (spend.count > 0) {
-		dim(`  Transactions: ${spend.count}`);
-		dim(`  Today:        ${spend.today.toFixed(4)} USDC`);
-		dim(`  Total:        ${spend.total.toFixed(4)} USDC`);
+		const recent = records.slice(-5);
+		dim("  Recent transactions:");
+		for (const r of recent) {
+			const line = formatTxLine(r).replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+			console.log(line);
+		}
+		console.log();
+		dim(`  Today: ${spend.today.toFixed(4)} USDC | Total: ${spend.total.toFixed(4)} USDC | ${spend.count} tx`);
 	} else dim("  No payment history yet.");
 	console.log();
+	if (config?.defaultNetwork) dim(`  Network: ${config.defaultNetwork}`);
+	dim(`  Config:  ${getConfigDirShort()}`);
 }
 const statusCommand = buildCommand({
 	docs: { brief: "Show configuration and wallet status" },
@@ -400,10 +565,11 @@ const statusCommand = buildCommand({
 			parameters: []
 		}
 	},
-	func() {
-		displayStatus();
+	async func() {
+		await displayStatus();
+		console.log();
 	}
 });
 
 //#endregion
-export { readHistory as C, formatTxLine as S, isConfigured as _, deriveEvmKeypair as a, appendHistory as b, dim as c, isTTY as d, warn as f, getWalletPath as g, getHistoryPath as h, resolveWallet as i, error as l, getConfigDir as m, statusCommand as n, deriveSolanaKeypair as o, ensureConfigDir as p, buildX402Client as r, generateMnemonic$1 as s, displayStatus as t, info as u, saveConfig as v, calcSpend as x, saveWalletFile as y };
+export { appendHistory as C, readHistory as E, saveWalletFile as S, formatTxLine as T, getWalletPath as _, resolveWallet as a, loadWalletFile as b, generateMnemonic$1 as c, info as d, isTTY as f, getHistoryPath as g, getConfigDirShort as h, buildX402Client as i, dim as l, ensureConfigDir as m, statusCommand as n, deriveEvmKeypair as o, warn as p, walletInfoCommand as r, deriveSolanaKeypair as s, displayStatus as t, error as u, isConfigured as v, calcSpend as w, saveConfig as x, loadConfig as y };

package/dist/{status-DnxuVdOP.js → status-CeXiUR6L.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base and Solana.",
   "type": "module",
   "sideEffects": false,
@@ -26,26 +26,22 @@
     "@scure/base": "^2.0.0",
     "@scure/bip32": "^2.0.1",
     "@scure/bip39": "^2.0.1",
+    "@solana/kit": "^6.0.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",
     "picocolors": "^1.1.1",
+    "viem": "^2.0.0",
     "yaml": "^2.8.2"
   },
-  "peerDependencies": {
-    "@solana/kit": "^6.0.0",
-    "ethers": "^6.0.0",
-    "viem": "^2.0.0"
-  },
   "devDependencies": {
-    "@solana/kit": "^6.0.0",
     "@types/node": "^22.0.0",
     "publint": "^0.3.17",
     "tsdown": "^0.20.3",
-    "typescript": "^5.9.0",
-    "viem": "^2.0.0"
+    "typescript": "^5.9.0"
   },
   "files": [
     "dist/**",