x402-proxy 0.9.2 → 0.9.4

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.4] - 2026-03-27
+
+### Fixed
+- All example URLs migrated from legacy individual service subdomains (`twitter.surf.cascade.fyi`, `web.surf.cascade.fyi`, `inference.surf.cascade.fyi`) to unified `surf.cascade.fyi/api/v1/` endpoints across CLI help text, README, SKILL.md, and OpenClaw plugin docs
+
+## [0.9.3] - 2026-03-26
+
+### Fixed
+- Solana RPC 429 rate-limit failures on concurrent payments - replaced upstream `ExactSvmScheme` (creates new RPC client per call) with `OptimizedSvmScheme` that shares a single RPC client with `@solana/kit` request coalescing (identical calls in the same microtask merge into one network request)
+- Hardcoded USDC mint metadata (Token Program address, 6 decimals) to skip `fetchMint` RPC call entirely for USDC payments
+- Added RPC failover transport: on 429 from one endpoint, immediately tries the next instead of failing. Two public mainnet RPCs: `api.mainnet.solana.com` (Solana Labs, 100 req/10s) and `public.rpc.solanavibestation.com` (community, 5 RPS)
+- Custom RPC URL (via config or OpenClaw plugin) is tried first, with public RPCs as fallback
+
+### Changed
+- Added `@solana-program/compute-budget`, `@solana-program/token`, `@solana-program/token-2022`, `@x402/core` as direct dependencies (previously transitive via `@x402/svm`)
+
 ## [0.9.2] - 2026-03-26
 
 ### Changed
@@ -284,7 +300,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.2...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.4...HEAD
+[0.9.4]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.3...v0.9.4
+[0.9.3]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.2...v0.9.3
 [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

package/README.md

@@ -5,7 +5,7 @@
 ## Quick Start
 
 ```bash
-npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi
+npx x402-proxy -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user
 ```
 
 That's it. The endpoint returns 402, x402-proxy pays and streams the response.
@@ -52,14 +52,14 @@ openclaw mcp set surf '{"command":"npx","args":["-y","x402-proxy","mcp","https:/
 Works like curl. Response body streams to stdout, payment info goes to stderr.
 
 ```bash
-# GET request
-$ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi
+# POST request
+$ npx x402-proxy -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user
 
 # POST with body and headers (curl-style short flags: -X, -H, -d)
 $ npx x402-proxy -X POST \
   -H "Content-Type: application/json" \
   -d '{"url":"https://x402.org"}' \
-  https://web.surf.cascade.fyi/v1/crawl
+  https://surf.cascade.fyi/api/v1/web/crawl
 
 # Force a specific network
 $ npx x402-proxy --network base https://api.example.com/data
@@ -71,7 +71,7 @@ $ npx x402-proxy --verbose https://api.example.com/data
 $ npx x402-proxy --protocol mpp \
   -X POST -H "Content-Type: application/json" \
   -d '{"model":"minimax/minimax-m2.5","stream":true,"messages":[{"role":"user","content":"Hello"}]}' \
-  https://inference.surf.cascade.fyi/v1/chat/completions
+  https://surf.cascade.fyi/api/v1/inference/completions
 
 # Pipe-safe
 $ npx x402-proxy https://api.example.com/data | jq '.results'

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-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 { _ 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-CqUc-ZFn.js";
+import { n as setupCommand, t as runSetup } from "../setup-Dp5fS7ob.js";
+import { n as statusCommand } from "../status-BZTToWE_.js";
 import { dirname, join, normalize, resolve } from "node:path";
 import { buildApplication, buildCommand, buildRouteMap, run } from "@stricli/core";
 import pc from "picocolors";
@@ -310,8 +310,8 @@ const fetchCommand = buildCommand({
 		fullDescription: `Make a paid HTTP request. Payment is automatic when the server returns 402.
 
 Examples:
-  $ x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi
-  $ x402-proxy -X POST -d '{"url":"https://x402.org"}' https://web.surf.cascade.fyi/v1/crawl
+  $ x402-proxy -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user
+  $ x402-proxy -X POST -d '{"url":"https://x402.org"}' https://surf.cascade.fyi/api/v1/web/crawl
   $ x402-proxy https://api.example.com/data | jq '.results'`
 	},
 	parameters: {
@@ -398,7 +398,7 @@ Examples:
 		};
 		if (!url) {
 			if (isConfigured()) {
-				const { displayStatus } = await import("../status-Dt8be_kW.js");
+				const { displayStatus } = await import("../status-Bj3U-W2M.js");
 				await displayStatus();
 				console.log();
 				console.log(pc.dim("  Commands:"));
@@ -408,7 +408,7 @@ Examples:
 				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();
-				console.log(pc.dim("  try: ") + pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi"));
+				console.log(pc.dim("  try: ") + pc.cyan(`$ npx x402-proxy -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user`));
 				console.log();
 				console.log(pc.dim("  https://github.com/cascade-protocol/x402-proxy"));
 				console.log();
@@ -450,7 +450,7 @@ Examples:
 				process.exit(1);
 			}
 			dim("  No wallet found. Let's set one up first.\n");
-			const { runSetup } = await import("../setup-lCsiivm2.js");
+			const { runSetup } = await import("../setup-B6xRV8Ue.js");
 			await runSetup();
 			console.log();
 			wallet = resolveWallet();
@@ -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-8evCw-5Z.js");
+			const { fetchAllBalances } = await import("../wallet-4C9EL4Iv.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-8evCw-5Z.js");
+			const { fetchAllBalances } = await import("../wallet-4C9EL4Iv.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;
@@ -806,7 +806,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 		});
 		if (wallet.source === "none") {
 			dim("No wallet found. Auto-generating...");
-			const { runSetup } = await import("../setup-lCsiivm2.js");
+			const { runSetup } = await import("../setup-B6xRV8Ue.js");
 			await runSetup({ nonInteractive: true });
 			const fresh = resolveWallet({
 				evmKey: flags.evmKey,
@@ -850,7 +850,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 		async function startX402Proxy() {
 			let preferredNetwork = config?.defaultNetwork;
 			if (!preferredNetwork && wallet.evmAddress && wallet.solanaAddress) {
-				const { fetchAllBalances } = await import("../wallet-8evCw-5Z.js");
+				const { fetchAllBalances } = await import("../wallet-4C9EL4Iv.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;
@@ -870,7 +870,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.9.2"
+				version: "0.9.4"
 			});
 			const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 				autoPayment: true,
@@ -908,7 +908,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.9.2"
+				version: "0.9.4"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -1003,7 +1003,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.9.2"
+				version: "0.9.4"
 			});
 			await connectTransport(remoteClient);
 			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
@@ -1018,7 +1018,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.9.2"
+				version: "0.9.4"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -1272,7 +1272,7 @@ const mcpAddCommand = buildCommand({
 			}
 		}
 		prompts.log.step("Try your first request:");
-		prompts.log.message(`  ${pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi")}`);
+		prompts.log.message(`  ${pc.cyan(`$ npx x402-proxy -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user`)}`);
 		prompts.log.message(`  ${pc.dim("Run")} ${pc.cyan("npx x402-proxy")} ${pc.dim("to see your wallet and balance")}`);
 		prompts.outro(pc.green(`MCP server ${pc.bold(serverName)} is ready to use!`));
 	}
@@ -1415,7 +1415,7 @@ const app = buildApplication(buildRouteMap({
 	docs: { brief: "curl for x402 paid APIs" }
 }), {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.9.2" },
+	versionInfo: { currentVersion: "0.9.4" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 //#endregion

package/dist/openclaw/plugin.js

@@ -1,10 +1,12 @@
 import os, { homedir } from "node:os";
 import path, { dirname, join } from "node:path";
-import { address, appendTransactionMessageInstructions, createKeyPairSignerFromBytes, createSolanaRpc, createTransactionMessage, getAddressEncoder, getBase64EncodedWireTransaction, getProgramDerivedAddress, partiallySignTransactionMessageWithSigners, pipe, setTransactionMessageFeePayer, setTransactionMessageLifetimeUsingBlockhash } from "@solana/kit";
+import { SOLANA_ERROR__RPC__TRANSPORT_HTTP_ERROR, address, appendTransactionMessageInstructions, createDefaultRpcTransport, createKeyPairSignerFromBytes, createSolanaRpc, createSolanaRpcFromTransport, createTransactionMessage, getAddressEncoder, getBase64EncodedWireTransaction, getProgramDerivedAddress, isSolanaError, mainnet, partiallySignTransactionMessageWithSigners, pipe, prependTransactionMessageInstruction, setTransactionMessageFeePayer, setTransactionMessageLifetimeUsingBlockhash } from "@solana/kit";
 import { decodePaymentResponseHeader, wrapFetchWithPayment, x402Client } from "@x402/fetch";
-import { ExactSvmScheme } from "@x402/svm/exact/client";
 import fs, { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import "yaml";
+import { getSetComputeUnitLimitInstruction, setTransactionMessageComputeUnitPrice } from "@solana-program/compute-budget";
+import { TOKEN_PROGRAM_ADDRESS } from "@solana-program/token";
+import { TOKEN_2022_PROGRAM_ADDRESS, fetchMint, findAssociatedTokenPda, getTransferCheckedInstruction } from "@solana-program/token-2022";
 import { ed25519 } from "@noble/curves/ed25519.js";
 import { base58 } from "@scure/base";
 import "@x402/evm";
@@ -81,6 +83,100 @@ function loadWalletFile() {
 		return null;
 	}
 }
+//#endregion
+//#region src/lib/optimized-svm-scheme.ts
+const MEMO_PROGRAM_ADDRESS = "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr";
+const COMPUTE_UNIT_LIMIT = 2e4;
+const COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;
+const USDC_MINT$1 = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+const USDC_DECIMALS$1 = 6;
+const MAINNET_RPC_URLS = ["https://api.mainnet.solana.com", "https://public.rpc.solanavibestation.com"];
+/**
+* Create a failover transport that tries each RPC in order.
+* On 429 from one endpoint, immediately tries the next instead of waiting.
+* Each transport gets its own coalescing via createDefaultRpcTransport.
+*/
+function createFailoverTransport(urls) {
+	const transports = urls.map((url) => createDefaultRpcTransport({ url }));
+	const failover = (async (config) => {
+		let lastError;
+		for (const transport of transports) try {
+			return await transport(config);
+		} catch (e) {
+			lastError = e;
+			if (isSolanaError(e, SOLANA_ERROR__RPC__TRANSPORT_HTTP_ERROR) && e.context.statusCode === 429) continue;
+			throw e;
+		}
+		throw lastError;
+	});
+	return failover;
+}
+function createRpcClient(customRpcUrl) {
+	return createSolanaRpcFromTransport(createFailoverTransport((customRpcUrl ? [customRpcUrl, ...MAINNET_RPC_URLS] : MAINNET_RPC_URLS).map((u) => mainnet(u))));
+}
+/**
+* Optimized ExactSvmScheme that replaces upstream @x402/svm to prevent
+* RPC rate-limit failures on parallel payments.
+*
+* Two optimizations over upstream:
+* 1. Shared RPC client - @solana/kit's built-in request coalescing
+*    merges identical getLatestBlockhash calls in the same tick into 1.
+* 2. Hardcoded USDC - skips fetchMint RPC call for USDC (immutable data).
+*/
+var OptimizedSvmScheme = class {
+	scheme = "exact";
+	rpc;
+	constructor(signer, config) {
+		this.signer = signer;
+		this.rpc = createRpcClient(config?.rpcUrl);
+	}
+	async createPaymentPayload(x402Version, paymentRequirements) {
+		const rpc = this.rpc;
+		const asset = paymentRequirements.asset;
+		let tokenProgramAddress;
+		let decimals;
+		if (asset === USDC_MINT$1) {
+			tokenProgramAddress = TOKEN_PROGRAM_ADDRESS;
+			decimals = USDC_DECIMALS$1;
+		} else {
+			const tokenMint = await fetchMint(rpc, asset);
+			tokenProgramAddress = tokenMint.programAddress;
+			if (tokenProgramAddress !== TOKEN_PROGRAM_ADDRESS && tokenProgramAddress !== TOKEN_2022_PROGRAM_ADDRESS) throw new Error("Asset was not created by a known token program");
+			decimals = tokenMint.data.decimals;
+		}
+		const [sourceATA] = await findAssociatedTokenPda({
+			mint: asset,
+			owner: this.signer.address,
+			tokenProgram: tokenProgramAddress
+		});
+		const [destinationATA] = await findAssociatedTokenPda({
+			mint: asset,
+			owner: paymentRequirements.payTo,
+			tokenProgram: tokenProgramAddress
+		});
+		const transferIx = getTransferCheckedInstruction({
+			source: sourceATA,
+			mint: asset,
+			destination: destinationATA,
+			authority: this.signer,
+			amount: BigInt(paymentRequirements.amount),
+			decimals
+		}, { programAddress: tokenProgramAddress });
+		const feePayer = paymentRequirements.extra?.feePayer;
+		if (!feePayer) throw new Error("feePayer is required in paymentRequirements.extra for SVM transactions");
+		const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
+		const nonce = crypto.getRandomValues(new Uint8Array(16));
+		const memoIx = {
+			programAddress: MEMO_PROGRAM_ADDRESS,
+			accounts: [],
+			data: new TextEncoder().encode(Array.from(nonce).map((b) => b.toString(16).padStart(2, "0")).join(""))
+		};
+		return {
+			x402Version,
+			payload: { transaction: getBase64EncodedWireTransaction(await partiallySignTransactionMessageWithSigners(pipe(createTransactionMessage({ version: 0 }), (tx) => setTransactionMessageComputeUnitPrice(COMPUTE_UNIT_PRICE_MICROLAMPORTS, tx), (tx) => setTransactionMessageFeePayer(feePayer, tx), (tx) => prependTransactionMessageInstruction(getSetComputeUnitLimitInstruction({ units: COMPUTE_UNIT_LIMIT }), tx), (tx) => appendTransactionMessageInstructions([transferIx, memoIx], tx), (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx)))) }
+		};
+	}
+};
 function appendHistory(historyPath, record) {
 	try {
 		mkdirSync(dirname(historyPath), { recursive: true });
@@ -713,7 +809,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.2`];
+				const lines = [`x402-proxy v0.9.4`];
 				const defaultModel = ctx.allModels[0];
 				if (defaultModel) lines.push("", `**Model** - ${defaultModel.name} (${defaultModel.provider})`);
 				lines.push("", `**[Wallet](${solscanUrl})**`, `\`${walletAddress}\``);
@@ -1053,7 +1149,7 @@ function register(api) {
 			return;
 		}
 		const client = new x402Client();
-		client.register(SOL_MAINNET, new ExactSvmScheme(signer, { rpcUrl }));
+		client.register(SOL_MAINNET, new OptimizedSvmScheme(signer, { rpcUrl }));
 		proxyRef = createX402ProxyHandler({ client });
 		const upstreamOrigin = upstreamOrigins[0];
 		if (upstreamOrigin) {

package/dist/setup-B6xRV8Ue.js

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

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

@@ -143,7 +143,7 @@ async function runSetup(opts) {
 	prompts.log.message(`  Solana (USDC): Send USDC to ${pc.cyan(sol.address)}`);
 	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/users/cascade_fyi")}`);
+	prompts.log.message(`  ${pc.cyan(`$ npx x402-proxy -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user`)}`);
 	prompts.outro(pc.green("Setup complete!"));
 }
 const setupCommand = buildCommand({

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

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

package/dist/status-Bj3U-W2M.js

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

package/dist/wallet-4C9EL4Iv.js

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

package/dist/{wallet-Bs8cBOv7.js → wallet-CqUc-ZFn.js}

@@ -9,11 +9,13 @@ import { ed25519 } from "@noble/curves/ed25519.js";
 import { base58 } from "@scure/base";
 import { toClientEvmSigner } from "@x402/evm";
 import { registerExactEvmScheme } from "@x402/evm/exact/client";
-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";
+import { SOLANA_ERROR__RPC__TRANSPORT_HTTP_ERROR, address, appendTransactionMessageInstructions, createDefaultRpcTransport, createSolanaRpcFromTransport, createTransactionMessage, getAddressEncoder, getBase64EncodedWireTransaction, getProgramDerivedAddress, isSolanaError, mainnet, partiallySignTransactionMessageWithSigners, pipe, prependTransactionMessageInstruction, setTransactionMessageFeePayer, setTransactionMessageLifetimeUsingBlockhash } from "@solana/kit";
+import { getSetComputeUnitLimitInstruction, setTransactionMessageComputeUnitPrice } from "@solana-program/compute-budget";
+import { TOKEN_PROGRAM_ADDRESS } from "@solana-program/token";
+import { TOKEN_2022_PROGRAM_ADDRESS, fetchMint, findAssociatedTokenPda, getTransferCheckedInstruction } from "@solana-program/token-2022";
 //#region src/lib/output.ts
 function isTTY() {
 	return !!process.stderr.isTTY;
@@ -152,6 +154,100 @@ function formatTxLine(r, opts) {
 	return `  ${timeStr} ${r.ok ? "" : "✗ "}${parts.join(" · ")}`;
 }
 //#endregion
+//#region src/lib/optimized-svm-scheme.ts
+const MEMO_PROGRAM_ADDRESS = "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr";
+const COMPUTE_UNIT_LIMIT = 2e4;
+const COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;
+const USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+const USDC_DECIMALS = 6;
+const MAINNET_RPC_URLS = ["https://api.mainnet.solana.com", "https://public.rpc.solanavibestation.com"];
+/**
+* Create a failover transport that tries each RPC in order.
+* On 429 from one endpoint, immediately tries the next instead of waiting.
+* Each transport gets its own coalescing via createDefaultRpcTransport.
+*/
+function createFailoverTransport(urls) {
+	const transports = urls.map((url) => createDefaultRpcTransport({ url }));
+	const failover = (async (config) => {
+		let lastError;
+		for (const transport of transports) try {
+			return await transport(config);
+		} catch (e) {
+			lastError = e;
+			if (isSolanaError(e, SOLANA_ERROR__RPC__TRANSPORT_HTTP_ERROR) && e.context.statusCode === 429) continue;
+			throw e;
+		}
+		throw lastError;
+	});
+	return failover;
+}
+function createRpcClient(customRpcUrl) {
+	return createSolanaRpcFromTransport(createFailoverTransport((customRpcUrl ? [customRpcUrl, ...MAINNET_RPC_URLS] : MAINNET_RPC_URLS).map((u) => mainnet(u))));
+}
+/**
+* Optimized ExactSvmScheme that replaces upstream @x402/svm to prevent
+* RPC rate-limit failures on parallel payments.
+*
+* Two optimizations over upstream:
+* 1. Shared RPC client - @solana/kit's built-in request coalescing
+*    merges identical getLatestBlockhash calls in the same tick into 1.
+* 2. Hardcoded USDC - skips fetchMint RPC call for USDC (immutable data).
+*/
+var OptimizedSvmScheme = class {
+	scheme = "exact";
+	rpc;
+	constructor(signer, config) {
+		this.signer = signer;
+		this.rpc = createRpcClient(config?.rpcUrl);
+	}
+	async createPaymentPayload(x402Version, paymentRequirements) {
+		const rpc = this.rpc;
+		const asset = paymentRequirements.asset;
+		let tokenProgramAddress;
+		let decimals;
+		if (asset === USDC_MINT) {
+			tokenProgramAddress = TOKEN_PROGRAM_ADDRESS;
+			decimals = USDC_DECIMALS;
+		} else {
+			const tokenMint = await fetchMint(rpc, asset);
+			tokenProgramAddress = tokenMint.programAddress;
+			if (tokenProgramAddress !== TOKEN_PROGRAM_ADDRESS && tokenProgramAddress !== TOKEN_2022_PROGRAM_ADDRESS) throw new Error("Asset was not created by a known token program");
+			decimals = tokenMint.data.decimals;
+		}
+		const [sourceATA] = await findAssociatedTokenPda({
+			mint: asset,
+			owner: this.signer.address,
+			tokenProgram: tokenProgramAddress
+		});
+		const [destinationATA] = await findAssociatedTokenPda({
+			mint: asset,
+			owner: paymentRequirements.payTo,
+			tokenProgram: tokenProgramAddress
+		});
+		const transferIx = getTransferCheckedInstruction({
+			source: sourceATA,
+			mint: asset,
+			destination: destinationATA,
+			authority: this.signer,
+			amount: BigInt(paymentRequirements.amount),
+			decimals
+		}, { programAddress: tokenProgramAddress });
+		const feePayer = paymentRequirements.extra?.feePayer;
+		if (!feePayer) throw new Error("feePayer is required in paymentRequirements.extra for SVM transactions");
+		const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
+		const nonce = crypto.getRandomValues(new Uint8Array(16));
+		const memoIx = {
+			programAddress: MEMO_PROGRAM_ADDRESS,
+			accounts: [],
+			data: new TextEncoder().encode(Array.from(nonce).map((b) => b.toString(16).padStart(2, "0")).join(""))
+		};
+		return {
+			x402Version,
+			payload: { transaction: getBase64EncodedWireTransaction(await partiallySignTransactionMessageWithSigners(pipe(createTransactionMessage({ version: 0 }), (tx) => setTransactionMessageComputeUnitPrice(COMPUTE_UNIT_PRICE_MICROLAMPORTS, tx), (tx) => setTransactionMessageFeePayer(feePayer, tx), (tx) => prependTransactionMessageInstruction(getSetComputeUnitLimitInstruction({ units: COMPUTE_UNIT_LIMIT }), tx), (tx) => appendTransactionMessageInstructions([transferIx, memoIx], tx), (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx)))) }
+		};
+	}
+};
+//#endregion
 //#region src/lib/resolve-wallet.ts
 /**
 * Resolve wallet keys following the priority cascade:
@@ -282,7 +378,8 @@ async function buildX402Client(wallet, opts) {
 	}
 	if (wallet.solanaKey) {
 		const { createKeyPairSignerFromBytes } = await import("@solana/kit");
-		registerExactSvmScheme(client, { signer: await createKeyPairSignerFromBytes(wallet.solanaKey) });
+		const signer = await createKeyPairSignerFromBytes(wallet.solanaKey);
+		client.register("solana:*", new OptimizedSvmScheme(signer));
 	}
 	client.registerPolicy(createAddressValidationPolicy());
 	if (opts?.network) client.registerPolicy(createNetworkFilter(opts.network));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "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,
@@ -35,8 +35,12 @@
     "@scure/bip32": "^2.0.1",
     "@scure/bip39": "^2.0.1",
     "@sinclair/typebox": "^0.34.48",
+    "@solana-program/compute-budget": "^0.15.0",
+    "@solana-program/token": "^0.12.0",
+    "@solana-program/token-2022": "^0.9.0",
     "@solana/kit": "^6.5.0",
     "@stricli/core": "^1.2.6",
+    "@x402/core": "^2.8.0",
     "@x402/evm": "^2.8.0",
     "@x402/fetch": "^2.8.0",
     "@x402/mcp": "^2.8.0",

package/skills/SKILL.md

@@ -10,7 +10,7 @@ description: Use x402-proxy CLI for consuming and debugging x402 and MPP paid AP
 ## Quick start
 
 ```bash
-npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi
+npx x402-proxy -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user
 ```
 
 First run auto-creates a wallet. No setup needed.
@@ -165,14 +165,16 @@ stdout = response body, stderr = payment info. Pipes, redirects, and `jq` all wo
 
 ## OpenClaw Plugin
 
-x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin. Install it to give your OpenClaw gateway automatic x402 payment capabilities:
+x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin for automatic x402 payments, wallet management, and pay-per-use inference proxying. For full installation, provider/model configuration, and troubleshooting, read `references/openclaw-plugin.md`.
 
-- `x_balance` tool - check wallet SOL/USDC balances
-- `x_payment` tool - call any x402-enabled endpoint with automatic payment
-- `/x_wallet` command - wallet status, send USDC, transaction history
-- HTTP route proxy (`/x402/*`) - proxies requests to upstream x402 endpoints with payment
+Quick install:
 
-Configure in your OpenClaw plugin settings with `providers` (upstream x402 endpoints and models) and optionally `keypairPath` or use the standard `X402_PROXY_WALLET_MNEMONIC` env var.
+```bash
+openclaw plugins install x402-proxy
+npx x402-proxy setup   # creates wallet if needed
+```
+
+Registers: `x_balance` tool, `x_payment` tool, `/x_wallet` command, `/x402/*` HTTP route for inference proxying.
 
 ## Library API
 

package/skills/references/openclaw-plugin.md

@@ -0,0 +1,135 @@
+# OpenClaw Plugin Setup
+
+x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin. Gives your gateway automatic x402 payment, wallet management, and pay-per-use inference proxying via Solana USDC.
+
+## What it registers
+
+- **`x_balance` tool** - check wallet SOL/USDC balances, daily spend, available funds
+- **`x_payment` tool** - call any x402-enabled endpoint with automatic payment (params: `url`, `method`, `params`, `headers`)
+- **`/x_wallet` command** - wallet status dashboard, `send <amount|all> <address>`, `history [page]`
+- **HTTP route `/x402/*`** - proxies requests to upstream inference endpoints with payment, tracks token usage and cost
+
+## Step 1: Install the plugin
+
+```bash
+openclaw plugins install x402-proxy
+```
+
+This downloads from npm, validates `openclaw.plugin.json`, and installs to `~/.openclaw/extensions/x402-proxy/`.
+
+## Step 2: Configure wallet
+
+The plugin resolves a Solana wallet using the same cascade as the CLI:
+
+1. `keypairPath` in plugin config (solana-keygen JSON file)
+2. `X402_PROXY_WALLET_SOLANA_KEY` env var (base58 or JSON array)
+3. `X402_PROXY_WALLET_MNEMONIC` env var (BIP-39, derives both Solana and EVM)
+4. `~/.config/x402-proxy/wallet.json` (auto-created by `npx x402-proxy setup`)
+
+Easiest path - run setup first, then the plugin picks up the wallet automatically:
+
+```bash
+npx x402-proxy setup
+```
+
+Or set an explicit keypair in plugin config (step 3).
+
+## Step 3: Configure providers and models
+
+Add the plugin config to your `openclaw.json` (or via `openclaw config edit`):
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "x402-proxy": {
+        "config": {
+          "providers": {
+            "surf-inference": {
+              "baseUrl": "/x402/v1",
+              "upstreamUrl": "https://surf.cascade.fyi/api/v1/inference",
+              "models": [
+                { "id": "anthropic/claude-opus-4.6", "name": "Claude Opus 4.6", "maxTokens": 200000, "reasoning": true, "input": ["text", "image"], "cost": { "input": 0.015, "output": 0.075, "cacheRead": 0.0015, "cacheWrite": 0.01875 }, "contextWindow": 200000 },
+                { "id": "anthropic/claude-sonnet-4.6", "name": "Claude Sonnet 4.6", "maxTokens": 200000, "reasoning": true, "input": ["text", "image"], "cost": { "input": 0.003, "output": 0.015, "cacheRead": 0.0003, "cacheWrite": 0.00375 }, "contextWindow": 200000 },
+                { "id": "anthropic/claude-opus-4.5", "name": "Claude Opus 4.5", "maxTokens": 200000, "reasoning": true, "input": ["text", "image"], "cost": { "input": 0.015, "output": 0.075, "cacheRead": 0.0015, "cacheWrite": 0.01875 }, "contextWindow": 200000 },
+                { "id": "anthropic/claude-sonnet-4.5", "name": "Claude Sonnet 4.5", "maxTokens": 200000, "reasoning": true, "input": ["text", "image"], "cost": { "input": 0.003, "output": 0.015, "cacheRead": 0.0003, "cacheWrite": 0.00375 }, "contextWindow": 200000 },
+                { "id": "x-ai/grok-4.20-beta", "name": "Grok 4.20 Beta", "maxTokens": 131072, "reasoning": true, "input": ["text"], "cost": { "input": 0.003, "output": 0.015, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072 },
+                { "id": "x-ai/grok-4.20-multi-agent-beta", "name": "Grok 4.20 Multi-Agent", "maxTokens": 131072, "reasoning": true, "input": ["text"], "cost": { "input": 0.003, "output": 0.015, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072 },
+                { "id": "x-ai/grok-4.1-fast", "name": "Grok 4.1 Fast", "maxTokens": 131072, "reasoning": false, "input": ["text"], "cost": { "input": 0.001, "output": 0.005, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072 },
+                { "id": "x-ai/grok-4.20-beta:online", "name": "Grok 4.20 Beta (Online)", "maxTokens": 131072, "reasoning": true, "input": ["text"], "cost": { "input": 0.005, "output": 0.025, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072 },
+                { "id": "x-ai/grok-4.20-multi-agent-beta:online", "name": "Grok 4.20 Multi-Agent (Online)", "maxTokens": 131072, "reasoning": true, "input": ["text"], "cost": { "input": 0.005, "output": 0.025, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072 },
+                { "id": "x-ai/grok-4.1-fast:online", "name": "Grok 4.1 Fast (Online)", "maxTokens": 131072, "reasoning": false, "input": ["text"], "cost": { "input": 0.003, "output": 0.015, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072 },
+                { "id": "minimax/minimax-m2.7", "name": "MiniMax M2.7", "maxTokens": 1000000, "reasoning": false, "input": ["text"], "cost": { "input": 0.001, "output": 0.005, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 1000000 },
+                { "id": "minimax/minimax-m2.5", "name": "MiniMax M2.5", "maxTokens": 1000000, "reasoning": false, "input": ["text"], "cost": { "input": 0.001, "output": 0.005, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 1000000 },
+                { "id": "moonshotai/kimi-k2.5", "name": "Kimi K2.5", "maxTokens": 131072, "reasoning": true, "input": ["text"], "cost": { "input": 0.002, "output": 0.008, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072 },
+                { "id": "z-ai/glm-5", "name": "GLM-5", "maxTokens": 128000, "reasoning": false, "input": ["text"], "cost": { "input": 0.001, "output": 0.005, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 128000 },
+                { "id": "qwen/qwen-2.5-7b-instruct", "name": "Qwen 2.5 7B Instruct", "maxTokens": 32768, "reasoning": false, "input": ["text"], "cost": { "input": 0.0003, "output": 0.001, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 32768 }
+              ]
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+### Config fields
+
+| Field | Description |
+|-------|-------------|
+| `providers.<name>.baseUrl` | Route path registered in OpenClaw (e.g., `/x402/v1`) |
+| `providers.<name>.upstreamUrl` | Actual upstream endpoint (e.g., `https://surf.cascade.fyi/api/v1/inference`) |
+| `providers.<name>.models[]` | Model catalog array |
+| `keypairPath` | Optional path to solana-keygen JSON file (overrides wallet resolution) |
+| `rpcUrl` | Solana RPC URL (defaults to mainnet public endpoints with failover) |
+| `dashboardUrl` | URL linked from `/x_wallet` dashboard |
+
+### Model entry fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | string | Model identifier (e.g., `anthropic/claude-opus-4.6`) |
+| `name` | string | Display name |
+| `maxTokens` | number | Max context length |
+| `reasoning` | boolean | Supports extended thinking |
+| `input` | string[] | Input modalities: `["text"]` or `["text", "image"]` |
+| `cost.input` | number | USDC per 1K input tokens |
+| `cost.output` | number | USDC per 1K output tokens |
+| `cost.cacheRead` | number | USDC per 1K cached read tokens |
+| `cost.cacheWrite` | number | USDC per 1K cache write tokens |
+| `contextWindow` | number | Full context window size |
+
+## Step 4: Restart gateway and verify
+
+```bash
+openclaw gateway restart
+openclaw models    # verify models appear
+```
+
+## How it works
+
+1. Plugin boots, loads wallet via the resolution cascade
+2. Registers each provider from config into OpenClaw's model catalog (API type: `openai-completions`, no auth required)
+3. HTTP route `/x402/*` intercepts inference requests, strips prefix, proxies to `upstreamUrl`
+4. On 402 response, auto-signs a Solana USDC payment and retries
+5. SSE streaming responses are parsed for token usage and logged to `~/.config/x402-proxy/history.jsonl`
+6. Tools and command are available to all agents on the gateway
+
+## Fetching latest models
+
+The model list on `surf.cascade.fyi` changes over time. Fetch the current catalog:
+
+```bash
+npx x402-proxy --protocol mpp --network solana \
+  https://surf.cascade.fyi/api/v1/inference/models
+```
+
+Then update the `models` array in your plugin config accordingly.
+
+## Troubleshooting
+
+- **Models don't appear in `openclaw models`** - the plugin uses a `catalog` hook (not `models` field). Make sure you're on x402-proxy >= 0.8.5.
+- **"no wallet found" in logs** - run `npx x402-proxy setup` or set `X402_PROXY_WALLET_MNEMONIC` env var before starting the gateway.
+- **402 errors on inference** - check wallet has USDC balance: use `x_balance` tool or `npx x402-proxy wallet`.
+- **Gateway cold start slow** - normal on small VMs (~72s). The `x402-wallet` service eagerly loads the wallet during boot.

package/dist/setup-lCsiivm2.js

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

package/dist/status-Dt8be_kW.js

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

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

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