x402-proxy 0.8.3 → 0.8.5

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.5] - 2026-03-24
+
+### Fixed
+- OpenClaw plugin: models now appear in `openclaw models` list - replaced invalid `models` field on `registerProvider()` with a `catalog` hook returning `ProviderCatalogResult`, which is required by OpenClaw's provider discovery filter
+
+## [0.8.4] - 2026-03-24
+
+### Fixed
+- Servers returning Solana payment options with EVM-format `payTo` addresses (e.g. `0x...`) no longer crash with a base58 decode error - malformed options are filtered out and valid options are used instead
+- When all payment options from a server have mismatched address formats, a clear error is shown instead of a cryptic codec failure
+
 ## [0.8.3] - 2026-03-24
 
 ### Added
@@ -230,7 +241,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.8.3...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.4...HEAD
+[0.8.5]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.4...v0.8.5
+[0.8.4]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.3...v0.8.4
 [0.8.3]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.2...v0.8.3
 [0.8.2]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.1...v0.8.2
 [0.8.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.0...v0.8.1

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-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 { _ 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-BiX5_XFY.js";
 import { n as setupCommand } from "../setup-Di_b5Vp9.js";
-import { n as statusCommand } from "../status-S3t-XV_M.js";
+import { n as statusCommand } from "../status-DvSu8reM.js";
 import { buildApplication, buildCommand, buildRouteMap, run } from "@stricli/core";
 import pc from "picocolors";
 import { decodePaymentResponseHeader, wrapFetchWithPayment } from "@x402/fetch";
@@ -398,7 +398,7 @@ Examples:
 		};
 		if (!url) {
 			if (isConfigured()) {
-				const { displayStatus } = await import("../status-CJPUbh6Z.js");
+				const { displayStatus } = await import("../status-DjudJ6fD.js");
 				await displayStatus();
 				console.log();
 				console.log(pc.dim("  Commands:"));
@@ -463,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-CJBRFJw8.js");
+			const { fetchAllBalances } = await import("../wallet-BkZ0DOJL.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;
@@ -630,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-CJBRFJw8.js");
+			const { fetchAllBalances } = await import("../wallet-BkZ0DOJL.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;
@@ -840,7 +840,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-CJBRFJw8.js");
+				const { fetchAllBalances } = await import("../wallet-BkZ0DOJL.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;
@@ -860,7 +860,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.8.3"
+				version: "0.8.5"
 			});
 			const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 				autoPayment: true,
@@ -898,7 +898,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.8.3"
+				version: "0.8.5"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -993,7 +993,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.8.3"
+				version: "0.8.5"
 			});
 			await connectTransport(remoteClient);
 			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
@@ -1008,7 +1008,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.8.3"
+				version: "0.8.5"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -1220,7 +1220,7 @@ const routes = buildRouteMap({
 });
 const app = buildApplication(routes, {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.8.3" },
+	versionInfo: { currentVersion: "0.8.5" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 

package/dist/openclaw/plugin.d.ts

@@ -17,6 +17,14 @@ type ModelEntry = {
 };
 //#endregion
 //#region src/openclaw/plugin.d.ts
+type ProviderCatalogResult = {
+  provider: {
+    baseUrl: string;
+    api?: string;
+    authHeader?: boolean;
+    models: Array<Omit<ModelEntry, "provider">>;
+  };
+} | null;
 type OpenClawPluginApi = {
   pluginConfig?: Record<string, unknown>;
   logger: {
@@ -27,13 +35,9 @@ type OpenClawPluginApi = {
     id: string;
     label: string;
     auth: unknown[];
-    models: {
-      baseUrl: string;
-      api: string;
-      authHeader: boolean;
-      models: Array<Omit<ModelEntry, "provider"> & {
-        input: Array<"text" | "image">;
-      }>;
+    catalog: {
+      order?: "simple" | "profile" | "paired" | "late";
+      run: (ctx: unknown) => Promise<ProviderCatalogResult>;
     };
   }) => void;
   registerTool: (tool: unknown) => void;

package/dist/openclaw/plugin.js

@@ -726,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.8.3`];
+				const lines = [`x402-proxy v0.8.5`];
 				const defaultModel = ctx.allModels[0];
 				if (defaultModel) lines.push("", `**Model** - ${defaultModel.name} (${defaultModel.provider})`);
 				lines.push("", `**[Wallet](${solscanUrl})**`, `\`${walletAddress}\``);
@@ -1026,11 +1026,14 @@ function register(api) {
 		id: name,
 		label: `${name} (x402)`,
 		auth: [],
-		models: {
-			baseUrl: prov.baseUrl,
-			api: "openai-completions",
-			authHeader: false,
-			models: prov.models
+		catalog: {
+			order: "simple",
+			run: async () => ({ provider: {
+				baseUrl: prov.baseUrl,
+				api: "openai-completions",
+				authHeader: false,
+				models: prov.models
+			} })
 		}
 	});
 	api.logger.info(`x402-proxy: ${Object.keys(raw).join(", ")} - ${allModels.length} models, ${upstreamOrigins.length} x402 endpoints`);

package/dist/{status-CJPUbh6Z.js → status-DjudJ6fD.js}

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

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 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 { 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-BiX5_XFY.js";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
 

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

@@ -236,6 +236,28 @@ function networkToCaipPrefix(name) {
 		default: return name;
 	}
 }
+/**
+* Validate that payTo addresses match the network format.
+* Filters out malformed entries (e.g. EVM hex address on a Solana network).
+*/
+function createAddressValidationPolicy() {
+	return (_version, reqs) => {
+		const malformed = [];
+		const valid = reqs.filter((r) => {
+			if (r.network.startsWith("solana:") && r.payTo.startsWith("0x")) {
+				malformed.push(`Solana option has EVM-format payTo (${r.payTo})`);
+				return false;
+			}
+			if (r.network.startsWith("eip155:") && !r.payTo.startsWith("0x")) {
+				malformed.push(`EVM option has non-EVM payTo (${r.payTo})`);
+				return false;
+			}
+			return true;
+		});
+		if (valid.length === 0 && malformed.length > 0) throw new Error(`Server returned only malformed payment options:\n  ${malformed.join("\n  ")}\nThe server's payTo addresses don't match the advertised networks.`);
+		return valid;
+	};
+}
 function createNetworkFilter(network) {
 	const prefix = networkToCaipPrefix(network);
 	return (_version, reqs) => {
@@ -269,6 +291,7 @@ async function buildX402Client(wallet, opts) {
 		const { createKeyPairSignerFromBytes } = await import("@solana/kit");
 		registerExactSvmScheme(client, { signer: await createKeyPairSignerFromBytes(wallet.solanaKey) });
 	}
+	client.registerPolicy(createAddressValidationPolicy());
 	if (opts?.network) client.registerPolicy(createNetworkFilter(opts.network));
 	const daily = opts?.spendLimitDaily;
 	const perTx = opts?.spendLimitPerTx;

package/dist/{wallet-CJBRFJw8.js → wallet-BkZ0DOJL.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-CeY5DPj-.js";
+import { a as fetchTempoBalances, i as fetchSolanaBalances, n as fetchAllBalances, o as walletInfoCommand, r as fetchEvmBalances, t as balanceLine } from "./wallet-BiX5_XFY.js";
 
 export { fetchAllBalances };

package/package.json

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