x402-proxy 0.4.2 → 0.5.1

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.1] - 2026-03-19
+
+### Fixed
+- Solana USDC balance showing 0.0000 instead of actual balance due to `getTokenAccountsByOwner` being rate-limited (429) on public Solana RPC
+- Replaced with offline ATA derivation via `@solana/kit` + lightweight `getTokenAccountBalance` call that works reliably on any public RPC
+- RPC errors now show `?` instead of silently displaying `0.0000`
+
+## [0.5.0] - 2026-03-16
+
+### Changed
+- MCP proxy graduated from alpha to stable - removed alpha warning and label
+- MCP proxy uses low-level `Server` class instead of `McpServer` to proxy raw JSON schemas verbatim without Zod conversion
+- MCP proxy now forwards blob resource contents (previously only text was proxied)
+- MCP content type widened to pass through all MCP content types (image, audio, resource_link) not just text
+
+### Added
+- MCP proxy forwards `notifications/tools/list_changed` and `notifications/resources/list_changed` from remote servers so local clients stay in sync with dynamic tool/resource updates
+
 ## [0.4.2] - 2026-03-16
 
 ### Fixed
@@ -105,7 +123,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - CLI binary accessible via `npx x402-proxy`
 - `fetch` command (default) - curl-like HTTP client with automatic x402 payment
-- `mcp` command (alpha) - MCP stdio proxy with auto-payment for AI agents
+- `mcp` command - MCP stdio proxy with auto-payment for AI agents
 - `setup` command - interactive onboarding wizard with @clack/prompts
 - `status` command - config, wallet, and spend summary
 - `wallet` subcommand with `info`, `history`, `fund`, `export-key`
@@ -129,7 +147,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.4.2...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.5.1...HEAD
+[0.5.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.5.0...v0.5.1
+[0.5.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.4.2...v0.5.0
 [0.4.2]: https://github.com/cascade-protocol/x402-proxy/compare/v0.4.1...v0.4.2
 [0.4.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.3.2...v0.4.0

package/dist/bin/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { a as buildX402Client, c as error, d as warn, f as appendHistory, g as readHistory, h as formatTxLine, i as walletInfoCommand, l as info, m as displayNetwork, o as resolveWallet, p as calcSpend, s as dim, u as isTTY } from "../wallet-BHywTzdN.js";
+import { a as buildX402Client, c as error, d as warn, f as appendHistory, g as readHistory, h as formatTxLine, i as walletInfoCommand, l as info, m as displayNetwork, o as resolveWallet, p as calcSpend, s as dim, u as isTTY } from "../wallet-BMYYtAP6.js";
 import { c as isConfigured, i as ensureConfigDir, l as loadConfig, o as getHistoryPath, u as loadWalletFile } from "../derive-CISr_ond.js";
 import { n as setupCommand } from "../setup-gla-Qyqi.js";
-import { n as statusCommand } from "../status-DxW72Hx6.js";
+import { n as statusCommand } from "../status-BoH_1kIH.js";
 import { buildApplication, buildCommand, buildRouteMap, run } from "@stricli/core";
 import pc from "picocolors";
 import { decodePaymentResponseHeader, wrapFetchWithPayment } from "@x402/fetch";
@@ -118,7 +118,7 @@ Examples:
 	async func(flags, url) {
 		if (!url) {
 			if (isConfigured()) {
-				const { displayStatus } = await import("../status-DrC0uxCS.js");
+				const { displayStatus } = await import("../status-BVIU3-b6.js");
 				await displayStatus();
 				console.log();
 				console.log(pc.dim("  Commands:"));
@@ -179,7 +179,7 @@ Examples:
 		const config = loadConfig();
 		let preferredNetwork = config?.defaultNetwork;
 		if (!preferredNetwork && wallet.evmAddress && wallet.solanaAddress) {
-			const { fetchEvmBalances, fetchSolanaBalances } = await import("../wallet-DFhJWn3o.js");
+			const { fetchEvmBalances, fetchSolanaBalances } = await import("../wallet-BoY0fgX7.js");
 			const [evmBal, solBal] = await Promise.allSettled([fetchEvmBalances(wallet.evmAddress), fetchSolanaBalances(wallet.solanaAddress)]);
 			const evmUsdc = evmBal.status === "fulfilled" ? Number(evmBal.value?.usdc ?? 0) : 0;
 			const solUsdc = solBal.status === "fulfilled" ? Number(solBal.value?.usdc ?? 0) : 0;
@@ -231,7 +231,7 @@ Examples:
 			const hasEvm = accepts.some((a) => a.network.startsWith("eip155:"));
 			const hasSolana = accepts.some((a) => a.network.startsWith("solana:"));
 			const hasOther = accepts.some((a) => !a.network.startsWith("eip155:") && !a.network.startsWith("solana:"));
-			const { fetchEvmBalances, fetchSolanaBalances } = await import("../wallet-DFhJWn3o.js");
+			const { fetchEvmBalances, fetchSolanaBalances } = await import("../wallet-BoY0fgX7.js");
 			let evmUsdc = 0;
 			let solUsdc = 0;
 			if (hasEvm && wallet.evmAddress) try {
@@ -330,7 +330,7 @@ Examples:
 //#region src/commands/mcp.ts
 const mcpCommand = buildCommand({
 	docs: {
-		brief: "Start MCP stdio proxy with x402 payment (alpha)",
+		brief: "Start MCP stdio proxy with x402 payment",
 		fullDescription: `Start an MCP stdio proxy with automatic x402 payment for AI agents.
 
 Add to your MCP client config (Claude, Cursor, etc.):
@@ -376,14 +376,13 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			error("No wallet configured.\nRun:\n  $ npx x402-proxy setup\n\nOr set X402_PROXY_WALLET_MNEMONIC");
 			process.exit(1);
 		}
-		warn("Note: MCP proxy is alpha - please report issues.");
 		dim(`x402-proxy MCP proxy -> ${remoteUrl}`);
 		if (wallet.evmAddress) dim(`  EVM:    ${wallet.evmAddress}`);
 		if (wallet.solanaAddress) dim(`  Solana: ${wallet.solanaAddress}`);
 		const config = loadConfig();
 		let preferredNetwork = config?.defaultNetwork;
 		if (!preferredNetwork && wallet.evmAddress && wallet.solanaAddress) {
-			const { fetchEvmBalances, fetchSolanaBalances } = await import("../wallet-DFhJWn3o.js");
+			const { fetchEvmBalances, fetchSolanaBalances } = await import("../wallet-BoY0fgX7.js");
 			const [evmBal, solBal] = await Promise.allSettled([fetchEvmBalances(wallet.evmAddress), fetchSolanaBalances(wallet.solanaAddress)]);
 			const evmUsdc = evmBal.status === "fulfilled" ? Number(evmBal.value?.usdc ?? 0) : 0;
 			const solUsdc = solBal.status === "fulfilled" ? Number(solBal.value?.usdc ?? 0) : 0;
@@ -399,13 +398,14 @@ Add to your MCP client config (Claude, Cursor, etc.):
 		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");
-		const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+		const { Server } = await import("@modelcontextprotocol/sdk/server/index.js");
 		const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
 		const { x402MCPClient } = await import("@x402/mcp");
-		const x402Mcp = new x402MCPClient(new Client({
+		const remoteClient = new Client({
 			name: "x402-proxy",
-			version: "0.4.2"
-		}), x402PaymentClient, {
+			version: "0.5.1"
+		});
+		const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 			autoPayment: true,
 			onPaymentRequested: (ctx) => {
 				const accept = ctx.paymentRequired.accepts?.[0];
@@ -447,31 +447,58 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			error(`Failed to connect to ${remoteUrl}: ${err instanceof Error ? err.message : String(err)}`);
 			process.exit(1);
 		}
-		const { tools } = await x402Mcp.listTools();
+		let { tools } = await x402Mcp.listTools();
 		dim(`  ${tools.length} tools available`);
-		const localServer = new McpServer({
+		let remoteResources = [];
+		try {
+			remoteResources = (await x402Mcp.listResources()).resources;
+			if (remoteResources.length > 0) dim(`  ${remoteResources.length} resources available`);
+		} catch {
+			dim("  Resources not available from remote");
+		}
+		const localServer = new Server({
 			name: "x402-proxy",
-			version: "0.4.2"
-		});
-		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);
+			version: "0.5.1"
+		}, { capabilities: {
+			tools: tools.length > 0 ? {} : void 0,
+			resources: remoteResources.length > 0 ? {} : void 0
+		} });
+		const { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ToolListChangedNotificationSchema, ResourceListChangedNotificationSchema } = await import("@modelcontextprotocol/sdk/types.js");
+		localServer.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: tools.map((t) => ({
+			name: t.name,
+			description: t.description,
+			inputSchema: t.inputSchema,
+			annotations: t.annotations
+		})) }));
+		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 { resources } = await x402Mcp.listResources();
-			if (resources.length > 0) {
-				dim(`  ${resources.length} resources available`);
-				for (const resource of resources) localServer.resource(resource.name, resource.uri, resource.description ? { description: resource.description } : {}, async (uri) => {
-					return { contents: (await x402Mcp.readResource({ uri: uri.href })).contents.map((c) => ({
-						uri: c.uri,
-						text: "text" in c ? c.text : ""
-					})) };
-				});
-			}
-		} catch {}
+		if (remoteResources.length > 0) {
+			localServer.setRequestHandler(ListResourcesRequestSchema, async () => ({ resources: remoteResources.map((r) => ({
+				name: r.name,
+				uri: r.uri,
+				description: r.description,
+				mimeType: r.mimeType
+			})) }));
+			localServer.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+				return { contents: (await x402Mcp.readResource({ uri: request.params.uri })).contents.map((c) => ({ ...c })) };
+			});
+		}
+		remoteClient.setNotificationHandler(ToolListChangedNotificationSchema, async () => {
+			tools = (await x402Mcp.listTools()).tools;
+			dim(`  Tools updated: ${tools.length} available`);
+			await localServer.notification({ method: "notifications/tools/list_changed" });
+		});
+		if (remoteResources.length > 0) remoteClient.setNotificationHandler(ResourceListChangedNotificationSchema, async () => {
+			remoteResources = (await x402Mcp.listResources()).resources;
+			dim(`  Resources updated: ${remoteResources.length} available`);
+			await localServer.notification({ method: "notifications/resources/list_changed" });
+		});
 		const stdioTransport = new StdioServerTransport();
 		await localServer.connect(stdioTransport);
 		dim("  MCP proxy running (stdio)");
@@ -608,7 +635,7 @@ const routes = buildRouteMap({
 });
 const app = buildApplication(routes, {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.4.2" },
+	versionInfo: { currentVersion: "0.5.1" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 

package/dist/{status-DrC0uxCS.js → status-BVIU3-b6.js}

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

package/dist/{status-DxW72Hx6.js → status-BoH_1kIH.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { g as readHistory, h as formatTxLine, n as fetchEvmBalances, o as resolveWallet, p as calcSpend, r as fetchSolanaBalances, s as dim, t as balanceLine } from "./wallet-BHywTzdN.js";
+import { g as readHistory, h as formatTxLine, n as fetchEvmBalances, o as resolveWallet, p as calcSpend, r as fetchSolanaBalances, s as dim, t as balanceLine } from "./wallet-BMYYtAP6.js";
 import { a as getConfigDirShort, l as loadConfig, o as getHistoryPath } from "./derive-CISr_ond.js";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";

package/dist/{wallet-BHywTzdN.js → wallet-BMYYtAP6.js}

@@ -12,6 +12,7 @@ import { registerExactSvmScheme } from "@x402/svm/exact/client";
 import { createPublicClient, http } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 import { base } from "viem/chains";
+import { address, getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";
 
 //#region src/history.ts
 const HISTORY_MAX_LINES = 1e3;
@@ -285,6 +286,8 @@ 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";
+const TOKEN_PROGRAM = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+const ATA_PROGRAM = "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
 async function rpcCall(url, method, params) {
 	return (await fetch(url, {
 		method: "POST",
@@ -308,17 +311,26 @@ async function fetchEvmBalances(address) {
 		usdc: usdcRes.result ? (Number(BigInt(usdcRes.result)) / 1e6).toFixed(4) : "?"
 	};
 }
-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" }
-	])]);
+async function getUsdcAta(owner) {
+	const encoder = getAddressEncoder();
+	const [ata] = await getProgramDerivedAddress({
+		programAddress: address(ATA_PROGRAM),
+		seeds: [
+			encoder.encode(address(owner)),
+			encoder.encode(address(TOKEN_PROGRAM)),
+			encoder.encode(address(USDC_SOLANA_MINT))
+		]
+	});
+	return ata;
+}
+async function fetchSolanaBalances(ownerAddress) {
+	const ata = await getUsdcAta(ownerAddress);
+	const [solRes, usdcRes] = await Promise.all([rpcCall(SOLANA_RPC, "getBalance", [ownerAddress]), rpcCall(SOLANA_RPC, "getTokenAccountBalance", [ata])]);
 	const sol = solRes.result?.value != null ? (solRes.result.value / 1e9).toFixed(6) : "?";
-	const accounts = usdcRes.result?.value;
+	const usdcVal = usdcRes.result?.value;
 	return {
 		sol,
-		usdc: accounts?.length ? Number(accounts[0].account.data.parsed.info.tokenAmount.uiAmountString).toFixed(4) : "0.0000"
+		usdc: usdcVal ? Number(usdcVal.uiAmountString).toFixed(4) : usdcVal === void 0 ? "?" : "0.0000"
 	};
 }
 function balanceLine(usdc, native, nativeSymbol) {

package/dist/wallet-BoY0fgX7.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base and Solana.",
   "type": "module",
   "sideEffects": false,

package/dist/wallet-DFhJWn3o.js

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