x402-proxy 0.10.4 → 0.10.5

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.10.5] - 2026-04-01
+
+### Fixed
+- `--debug` flag now works with inference proxy - route.ts debug check was captured at import time (before `cli.ts` sets the env var), so `dbg()` never fired; now evaluates lazily per call
+- `--debug` on `claude` command now shows proxy logs (sets `quiet: false`)
+- MPP `X-Payer-Address` header injection preserves headers as plain objects instead of converting to `Headers` instance, avoiding mppx headers-spreading bug that silently drops `Content-Type` on SSE requests
+
 ## [0.10.4] - 2026-04-01
 
 ### Fixed
@@ -367,7 +374,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.10.4...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.5...HEAD
+[0.10.5]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.4...v0.10.5
 [0.10.4]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.3...v0.10.4
 [0.10.3]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.2...v0.10.3
 [0.10.2]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.1...v0.10.2

package/dist/bin/cli.js

@@ -216,11 +216,13 @@ async function createMppProxyHandler(opts) {
 	});
 	const payerAddress = account.address;
 	function injectPayerHeader(init) {
-		const headers = new Headers(init?.headers);
-		headers.set("X-Payer-Address", payerAddress);
+		const existing = init?.headers instanceof Headers ? Object.fromEntries(init.headers.entries()) : init?.headers ?? {};
 		return {
 			...init,
-			headers
+			headers: {
+				...existing,
+				"X-Payer-Address": payerAddress
+			}
 		};
 	}
 	let session;
@@ -323,9 +325,8 @@ function addressForNetwork(evmAddress, solanaAddress, network) {
 }
 //#endregion
 //#region src/openclaw/route.ts
-const debug = process.env.X402_PROXY_DEBUG === "1";
 function dbg(msg) {
-	if (debug) process.stderr.write(`[x402-proxy] ${msg}\n`);
+	if (process.env.X402_PROXY_DEBUG === "1") process.stderr.write(`[x402-proxy] ${msg}\n`);
 }
 function createInferenceProxyRouteHandler(opts) {
 	const { providers, getX402Proxy, getMppHandler, getWalletAddress, getWalletAddressForNetwork, historyPath, allModels, logger } = opts;
@@ -849,6 +850,7 @@ function createRequestHandler(routeHandler) {
 	};
 }
 async function startServeServer(options = {}) {
+	if (options.debug) options.quiet = false;
 	const config = loadConfig();
 	const wallet = await resolveWalletForServe(options);
 	const resolvedProtocol = resolveProtocol(options.protocol ?? config?.preferredProtocol);
@@ -1069,6 +1071,7 @@ Examples:
 		}
 	},
 	async func(flags, ...rawClaudeArgs) {
+		const debug = process.env.X402_PROXY_DEBUG === "1";
 		const started = await startServeServer({
 			upstreamUrl: flags.upstream ?? "https://surf.cascade.fyi/api/v1/inference",
 			port: Number(flags.port),
@@ -1076,7 +1079,8 @@ Examples:
 			network: flags.network,
 			evmKey: flags.evmKey,
 			solanaKey: flags.solanaKey,
-			quiet: true
+			quiet: !debug,
+			debug
 		});
 		const child = spawn("claude", normalizeClaudeArgs(rawClaudeArgs), {
 			stdio: "inherit",
@@ -1836,7 +1840,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.10.4"
+				version: "0.10.5"
 			});
 			const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 				autoPayment: true,
@@ -1874,7 +1878,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.10.4"
+				version: "0.10.5"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -1969,7 +1973,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.10.4"
+				version: "0.10.5"
 			});
 			await connectTransport(remoteClient);
 			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
@@ -1984,7 +1988,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.10.4"
+				version: "0.10.5"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -2383,7 +2387,7 @@ const app = buildApplication(buildRouteMap({
 	docs: { brief: "curl for x402 paid APIs" }
 }), {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.10.4" },
+	versionInfo: { currentVersion: "0.10.5" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 //#endregion

package/dist/index.js

@@ -82,11 +82,13 @@ async function createMppProxyHandler(opts) {
 	});
 	const payerAddress = account.address;
 	function injectPayerHeader(init) {
-		const headers = new Headers(init?.headers);
-		headers.set("X-Payer-Address", payerAddress);
+		const existing = init?.headers instanceof Headers ? Object.fromEntries(init.headers.entries()) : init?.headers ?? {};
 		return {
 			...init,
-			headers
+			headers: {
+				...existing,
+				"X-Payer-Address": payerAddress
+			}
 		};
 	}
 	let session;

package/dist/openclaw/plugin.js

@@ -87,11 +87,13 @@ async function createMppProxyHandler(opts) {
 	});
 	const payerAddress = account.address;
 	function injectPayerHeader(init) {
-		const headers = new Headers(init?.headers);
-		headers.set("X-Payer-Address", payerAddress);
+		const existing = init?.headers instanceof Headers ? Object.fromEntries(init.headers.entries()) : init?.headers ?? {};
 		return {
 			...init,
-			headers
+			headers: {
+				...existing,
+				"X-Payer-Address": payerAddress
+			}
 		};
 	}
 	let session;
@@ -1151,7 +1153,7 @@ function createWalletCommand(ctx) {
 			if (parts[0]?.toLowerCase() === "send") return { text: "Use `/x_send <amount|all> <address>` for transfers." };
 			try {
 				const snap = await getWalletSnapshot(ctx.rpcUrl, solanaWallet, evmWallet, ctx.historyPath);
-				const lines = [`x402-proxy v0.10.4`];
+				const lines = [`x402-proxy v0.10.5`];
 				const defaultModel = ctx.allModels[0];
 				if (defaultModel) lines.push("", `**Model** - ${defaultModel.name} (${defaultModel.provider})`);
 				lines.push("", `**Protocol** - ${ctx.getDefaultRequestProtocol()}`);
@@ -1367,9 +1369,8 @@ function resolveMppSessionBudget(value, fallback = "0.5") {
 }
 //#endregion
 //#region src/openclaw/route.ts
-const debug = process.env.X402_PROXY_DEBUG === "1";
 function dbg(msg) {
-	if (debug) process.stderr.write(`[x402-proxy] ${msg}\n`);
+	if (process.env.X402_PROXY_DEBUG === "1") process.stderr.write(`[x402-proxy] ${msg}\n`);
 }
 function createInferenceProxyRouteHandler(opts) {
 	const { providers, getX402Proxy, getMppHandler, getWalletAddress, getWalletAddressForNetwork, historyPath, allModels, logger } = opts;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.10.4",
+  "version": "0.10.5",
   "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,