x402-proxy-openclaw 0.10.12 → 0.11.2

package/dist/commands.js

@@ -1,3 +1,5 @@
+import { generateMnemonic, isValidMnemonic } from "./lib/derive.js";
+import { createWalletFile, getWalletPath, saveWalletFile } from "./lib/config.js";
 import { appendHistory, formatTxLine, readHistory } from "./history.js";
 import { checkAtaExists, getUsdcBalance, transferUsdc } from "./solana.js";
 import { SOL_MAINNET, getWalletSnapshot } from "./tools.js";
@@ -108,6 +110,43 @@ function handleHistory(histPath, page) {
 	if (nav.length > 0) lines.push("", nav.join(" · "));
 	return { text: lines.join("\n") };
 }
+/** Parse mnemonic from import args, stripping surrounding quotes. Returns error string or clean mnemonic. */
+function parseMnemonicImport(parts) {
+	const words = parts.join(" ").replace(/^["'""\u201C\u201D]+|["'""\u201C\u201D]+$/g, "").split(/\s+/).filter(Boolean);
+	if (words.length !== 12 && words.length !== 24) return { error: `Mnemonic must be 12 or 24 words (got ${words.length}).\nUsage: \`/x_wallet setup import word1 word2 ... word24\`` };
+	const mnemonic = words.join(" ");
+	if (!isValidMnemonic(mnemonic)) return { error: "Invalid BIP-39 mnemonic. Check the words and try again." };
+	return { mnemonic };
+}
+async function handleSetup(ctx, parts) {
+	const action = parts[0]?.toLowerCase();
+	let mnemonic = null;
+	if (action === "generate") mnemonic = generateMnemonic();
+	else if (action === "import") {
+		const result = parseMnemonicImport(parts.slice(1));
+		if ("error" in result) return { text: result.error };
+		mnemonic = result.mnemonic;
+	}
+	if (!mnemonic) return { text: [
+		"No wallet configured.",
+		"",
+		"  `/x_wallet setup generate` - generate a new wallet",
+		"  `/x_wallet setup import <mnemonic>` - import a BIP-39 mnemonic (12 or 24 words)"
+	].join("\n") };
+	const wallet = createWalletFile(mnemonic);
+	saveWalletFile(wallet);
+	await ctx.ensureReady({ reload: true });
+	const lines = [
+		action === "generate" ? "Wallet generated." : "Wallet imported.",
+		"",
+		`**EVM**: \`${wallet.addresses.evm}\``,
+		`**Solana**: \`${wallet.addresses.solana}\``,
+		"",
+		`Saved to \`${getWalletPath()}\``
+	];
+	if (action === "generate") lines.push("Fund these addresses with USDC to start using paid tools.", "", "Recover mnemonic later: `npx x402-proxy wallet export-key mnemonic`");
+	return { text: lines.join("\n") };
+}
 function createWalletCommand(ctx) {
 	return {
 		name: "x_wallet",
@@ -116,11 +155,13 @@ function createWalletCommand(ctx) {
 		requireAuth: true,
 		handler: async (cmdCtx) => {
 			await ctx.ensureReady();
+			const parts = (cmdCtx.args?.trim() ?? "").split(/\s+/).filter(Boolean);
+			const sub = parts[0]?.toLowerCase();
+			if (sub === "setup") return handleSetup(ctx, parts.slice(1));
 			const solanaWallet = ctx.getSolanaWalletAddress();
 			const evmWallet = ctx.getEvmWalletAddress();
-			if (!solanaWallet && !evmWallet) return { text: "Wallet not configured yet.\nRun `x402-proxy setup` or set `X402_PROXY_WALLET_MNEMONIC` on the gateway host." };
-			const parts = (cmdCtx.args?.trim() ?? "").split(/\s+/).filter(Boolean);
-			if (parts[0]?.toLowerCase() === "history") {
+			if (!solanaWallet && !evmWallet) return handleSetup(ctx, []);
+			if (sub === "history") {
 				const pageArg = parts[1];
 				const page = pageArg ? Math.max(1, Number.parseInt(pageArg, 10) || 1) : 1;
 				return handleHistory(ctx.historyPath, page);
@@ -128,9 +169,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.12`];
-				const defaultModel = ctx.allModels[0];
-				if (defaultModel) lines.push("", `**Model** - ${defaultModel.name} (${defaultModel.provider})`);
+				const lines = [`x402-proxy v0.11.2`];
 				lines.push("", `**Protocol** - ${ctx.getDefaultRequestProtocol()}`);
 				lines.push(`MPP session budget: ${ctx.getDefaultMppSessionBudget()} USDC`);
 				lines.push(`MPP ready: ${evmWallet ? "yes" : "no"}`);

package/dist/handler.js

@@ -1,6 +1,10 @@
+import { clearSession, saveSession } from "./lib/config.js";
 import { getMppVoucherHeadroomUsdc, isDebugEnabled } from "./lib/env.js";
 import { decodePaymentResponseHeader, wrapFetchWithPayment } from "@x402/fetch";
+import { Mppx, tempo } from "mppx/client";
+import { Session } from "mppx/tempo";
 import { parseUnits } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
 //#region packages/x402-proxy/src/handler.ts
 /**
 * Extract the on-chain transaction signature from an x402 payment response header.
@@ -58,13 +62,8 @@ function parseVoucherHeadroom(value) {
 }
 /**
 * Create an MPP proxy handler using mppx client.
-* Dynamically imports mppx/client to keep startup fast.
 */
 async function createMppProxyHandler(opts) {
-	const { Mppx, tempo } = await import("mppx/client");
-	const { Session } = await import("mppx/tempo");
-	const { privateKeyToAccount } = await import("viem/accounts");
-	const { saveSession, clearSession } = await import("./lib/config.js");
 	const account = privateKeyToAccount(opts.evmKey);
 	const maxDeposit = opts.maxDeposit ?? "1";
 	const voucherHeadroomRaw = parseVoucherHeadroom(getMppVoucherHeadroomUsdc());

package/dist/lib/config.js

@@ -1,3 +1,4 @@
+import { deriveEvmKeypair, deriveSolanaKeypair } from "./derive.js";
 import os from "node:os";
 import path from "node:path";
 import fs from "node:fs";
@@ -31,6 +32,25 @@ function loadWalletFile() {
 		return null;
 	}
 }
+function createWalletFile(mnemonic) {
+	const evm = deriveEvmKeypair(mnemonic);
+	const sol = deriveSolanaKeypair(mnemonic);
+	return {
+		version: 1,
+		mnemonic,
+		addresses: {
+			evm: evm.address,
+			solana: sol.address
+		}
+	};
+}
+function saveWalletFile(wallet) {
+	ensureConfigDir();
+	fs.writeFileSync(getWalletPath(), JSON.stringify(wallet, null, 2), {
+		mode: 384,
+		encoding: "utf-8"
+	});
+}
 function getSessionPath() {
 	return path.join(getConfigDir(), "session.json");
 }
@@ -44,4 +64,4 @@ function clearSession() {
 	} catch {}
 }
 //#endregion
-export { clearSession, ensureConfigDir, getDebugLogPath, getHistoryPath, loadWalletFile, saveSession };
+export { clearSession, createWalletFile, ensureConfigDir, getDebugLogPath, getHistoryPath, getWalletPath, loadWalletFile, saveSession, saveWalletFile };

package/dist/lib/derive.js

@@ -1,12 +1,12 @@
 import { ed25519 } from "@noble/curves/ed25519.js";
-import { base58 } from "@scure/base";
 import { secp256k1 } from "@noble/curves/secp256k1.js";
 import { hmac } from "@noble/hashes/hmac.js";
 import { sha512 } from "@noble/hashes/sha2.js";
 import { keccak_256 } from "@noble/hashes/sha3.js";
+import { base58 } from "@scure/base";
 import { HDKey } from "@scure/bip32";
-import { mnemonicToSeedSync } from "@scure/bip39";
-import "@scure/bip39/wordlists/english.js";
+import { generateMnemonic, mnemonicToSeedSync, validateMnemonic } from "@scure/bip39";
+import { wordlist } from "@scure/bip39/wordlists/english.js";
 //#region packages/x402-proxy/src/lib/derive.ts
 /**
 * Wallet derivation from BIP-39 mnemonic.
@@ -19,6 +19,12 @@ import "@scure/bip39/wordlists/english.js";
 *
 * Ported from agentbox/packages/openclaw-x402/src/wallet.ts
 */
+function generateMnemonic$1() {
+	return generateMnemonic(wordlist, 256);
+}
+function isValidMnemonic(mnemonic) {
+	return validateMnemonic(mnemonic, wordlist);
+}
 /**
 * SLIP-10 Ed25519 derivation at m/44'/501'/0'/0' (Phantom/Backpack compatible).
 */
@@ -74,4 +80,4 @@ function checksumAddress(addr) {
 	return out;
 }
 //#endregion
-export { deriveEvmKeypair, deriveSolanaKeypair };
+export { deriveEvmKeypair, deriveSolanaKeypair, generateMnemonic$1 as generateMnemonic, isValidMnemonic };

package/dist/lib/wallet-resolution.js

@@ -1,8 +1,8 @@
-import { loadWalletFile } from "./config.js";
 import { deriveEvmKeypair, deriveSolanaKeypair } from "./derive.js";
+import { loadWalletFile } from "./config.js";
+import { privateKeyToAccount } from "viem/accounts";
 import { ed25519 } from "@noble/curves/ed25519.js";
 import { base58 } from "@scure/base";
-import { privateKeyToAccount } from "viem/accounts";
 //#region packages/x402-proxy/src/lib/wallet-resolution.ts
 /**
 * Resolve wallet keys following the priority cascade:

package/dist/openclaw/plugin.d.ts

@@ -1,6 +1,5 @@
+import * as openclaw_plugin_sdk_plugin_entry0 from "openclaw/plugin-sdk/plugin-entry";
 import { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
-import * as openclaw_plugin_sdk0 from "openclaw/plugin-sdk";
-import * as openclaw_plugin_sdk_core0 from "openclaw/plugin-sdk/core";
 
 //#region packages/x402-proxy/src/openclaw/plugin.d.ts
 declare function register(api: OpenClawPluginApi): void;
@@ -8,8 +7,8 @@ declare const _default: {
   id: string;
   name: string;
   description: string;
-  configSchema: openclaw_plugin_sdk0.OpenClawPluginConfigSchema;
-  register: NonNullable<openclaw_plugin_sdk_core0.OpenClawPluginDefinition["register"]>;
-} & Pick<openclaw_plugin_sdk_core0.OpenClawPluginDefinition, "kind">;
+  configSchema: openclaw_plugin_sdk_plugin_entry0.OpenClawPluginConfigSchema;
+  register: NonNullable<openclaw_plugin_sdk_plugin_entry0.OpenClawPluginDefinition["register"]>;
+} & Pick<openclaw_plugin_sdk_plugin_entry0.OpenClawPluginDefinition, "kind">;
 //#endregion
 export { _default as default, register };

package/dist/openclaw/plugin.js

@@ -1,5 +1,6 @@
+import { generateMnemonic, isValidMnemonic } from "../lib/derive.js";
+import { createWalletFile, getHistoryPath, getWalletPath, saveWalletFile } from "../lib/config.js";
 import { createMppProxyHandler, createX402ProxyHandler } from "../handler.js";
-import { getHistoryPath } from "../lib/config.js";
 import { OptimizedSvmScheme } from "../lib/optimized-svm-scheme.js";
 import { resolveWallet } from "../lib/wallet-resolution.js";
 import { loadSvmWallet } from "../wallet.js";
@@ -20,20 +21,80 @@ function register(api) {
 	const dashboardUrl = config.dashboardUrl || "";
 	const { providers, models: allModels } = resolveProviders(config);
 	const defaultProvider = providers[0];
-	for (const provider of providers) api.registerProvider({
-		id: provider.id,
-		label: provider.id,
-		auth: [],
-		catalog: {
-			order: "simple",
-			run: async () => ({ provider: {
-				baseUrl: provider.baseUrl,
-				api: "openai-completions",
-				authHeader: false,
-				models: provider.models
-			} })
+	const walletAuthMethod = {
+		id: "wallet-setup",
+		label: "x402-proxy wallet setup",
+		hint: "Generate or import a crypto wallet for paid inference",
+		kind: "custom",
+		run: async (ctx) => {
+			const existing = resolveWallet();
+			if (existing.source !== "none") {
+				const addresses = [existing.evmAddress ? `EVM: ${existing.evmAddress}` : null, existing.solanaAddress ? `Solana: ${existing.solanaAddress}` : null].filter(Boolean).join("\n");
+				await ctx.prompter.note(`Wallet already configured (source: ${existing.source}).\n\n${addresses}`, "x402-proxy wallet");
+				return { profiles: [] };
+			}
+			const action = await ctx.prompter.select({
+				message: "How would you like to set up your x402-proxy wallet?",
+				options: [{
+					value: "generate",
+					label: "Generate a new wallet"
+				}, {
+					value: "import",
+					label: "Import an existing BIP-39 mnemonic"
+				}]
+			});
+			let mnemonic;
+			if (action === "import") {
+				mnemonic = await ctx.prompter.text({
+					message: "Enter your BIP-39 mnemonic (12 or 24 words):",
+					validate: (v) => {
+						const words = String(v ?? "").trim().split(/\s+/);
+						if (words.length !== 12 && words.length !== 24) return "Mnemonic must be 12 or 24 words";
+						if (!isValidMnemonic(words.join(" "))) return "Invalid BIP-39 mnemonic. Check the words and try again.";
+					}
+				});
+				mnemonic = String(mnemonic).trim();
+			} else mnemonic = generateMnemonic();
+			const wallet = createWalletFile(mnemonic);
+			saveWalletFile(wallet);
+			const msg = [
+				`EVM:    ${wallet.addresses.evm}`,
+				`Solana: ${wallet.addresses.solana}`,
+				"",
+				`Wallet saved to ${getWalletPath()}`,
+				"",
+				"Fund these addresses with USDC to start using paid inference.",
+				action === "generate" ? "\nRecover your mnemonic later with: npx x402-proxy wallet export-key mnemonic" : ""
+			].filter(Boolean).join("\n");
+			await ctx.prompter.note(msg, "Wallet created");
+			return { profiles: [{
+				profileId: "surf:x402-proxy",
+				credential: {
+					type: "api_key",
+					provider: "surf",
+					key: "x402-proxy-managed"
+				}
+			}] };
 		}
-	});
+	};
+	for (const provider of providers) {
+		const isFirst = provider === providers[0];
+		api.registerProvider({
+			id: provider.id,
+			label: provider.id,
+			auth: isFirst ? [walletAuthMethod] : [],
+			resolveConfigApiKey: () => "x402-proxy-managed",
+			catalog: {
+				order: "simple",
+				run: async () => ({ provider: {
+					baseUrl: provider.baseUrl,
+					api: "openai-completions",
+					authHeader: false,
+					models: provider.models
+				} })
+			}
+		});
+	}
 	api.logger.info(`x402-proxy: ${providers.map((provider) => `${provider.id}:${provider.protocol}`).join(", ")} - ${allModels.length} models`);
 	let solanaWalletAddress = null;
 	let evmWalletAddress = null;
@@ -60,8 +121,20 @@ function register(api) {
 		auth: "plugin",
 		handler
 	});
-	api.logger.info(`proxy: HTTP routes ${routePrefixes.join(", ")} registered for ${providers.map((provider) => provider.upstreamUrl).join(", ")}`);
-	async function ensureWalletLoaded() {
+	api.logger.info(`x402-proxy: HTTP routes ${routePrefixes.join(", ")} registered for ${providers.map((provider) => provider.upstreamUrl).join(", ")}`);
+	async function ensureWalletLoaded(opts) {
+		if (opts?.reload) {
+			if (mppHandlerRef) try {
+				await mppHandlerRef.close();
+			} catch {}
+			walletLoadPromise = null;
+			solanaWalletAddress = null;
+			evmWalletAddress = null;
+			signerRef = null;
+			proxyRef = null;
+			mppHandlerRef = null;
+			evmKeyRef = null;
+		}
 		if (walletLoadPromise) {
 			await walletLoadPromise;
 			return;
@@ -82,7 +155,7 @@ function register(api) {
 					solanaWalletAddress = null;
 				}
 				if (!solanaWalletAddress && !evmWalletAddress) {
-					api.logger.error("x402-proxy: no wallet found. Run `x402-proxy setup` to create one, or set X402_PROXY_WALLET_MNEMONIC / X402_PROXY_WALLET_EVM_KEY.");
+					api.logger.error("x402-proxy: no wallet found. Use /x_wallet setup or run `npx x402-proxy setup` on the host.");
 					return;
 				}
 				if (signerRef) {

package/dist/openclaw.plugin.json

@@ -2,13 +2,24 @@
   "id": "x402-proxy",
   "name": "mpp/x402 Payments Proxy",
   "description": "x402 and MPP payments, wallet tools, and paid inference proxying",
-  "version": "0.10.12",
   "providers": [
     "surf"
   ],
   "autoEnableWhenConfiguredProviders": [
     "surf"
   ],
+  "providerAuthChoices": [
+    {
+      "provider": "surf",
+      "method": "wallet-setup",
+      "choiceId": "x402-wallet-setup",
+      "choiceLabel": "x402-proxy wallet",
+      "choiceHint": "Generate or import a crypto wallet for paid inference",
+      "groupId": "x402-proxy",
+      "groupLabel": "x402-proxy",
+      "groupHint": "Crypto wallet for x402/MPP payments"
+    }
+  ],
   "skills": [
     "skills"
   ],
@@ -108,5 +119,6 @@
       "label": "Dashboard URL",
       "advanced": true
     }
-  }
+  },
+  "version": "0.11.2"
 }

package/dist/wallet.js

@@ -1,6 +1,6 @@
 import { createKeyPairSignerFromBytes } from "@solana/kit";
-import { readFileSync } from "node:fs";
 import "viem/accounts";
+import { readFileSync } from "node:fs";
 import "@x402/evm";
 //#region packages/x402-proxy/src/wallet.ts
 /**

package/openclaw.plugin.json

@@ -2,13 +2,24 @@
   "id": "x402-proxy",
   "name": "mpp/x402 Payments Proxy",
   "description": "x402 and MPP payments, wallet tools, and paid inference proxying",
-  "version": "0.10.12",
   "providers": [
     "surf"
   ],
   "autoEnableWhenConfiguredProviders": [
     "surf"
   ],
+  "providerAuthChoices": [
+    {
+      "provider": "surf",
+      "method": "wallet-setup",
+      "choiceId": "x402-wallet-setup",
+      "choiceLabel": "x402-proxy wallet",
+      "choiceHint": "Generate or import a crypto wallet for paid inference",
+      "groupId": "x402-proxy",
+      "groupLabel": "x402-proxy",
+      "groupHint": "Crypto wallet for x402/MPP payments"
+    }
+  ],
   "skills": [
     "skills"
   ],
@@ -108,5 +119,6 @@
       "label": "Dashboard URL",
       "advanced": true
     }
-  }
+  },
+  "version": "0.11.2"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "x402-proxy-openclaw",
   "description": "OpenClaw plugin for x402 and MPP payments, wallet tools, and paid inference proxying.",
-  "version": "0.10.12",
+  "version": "0.11.2",
   "type": "module",
   "sideEffects": false,
   "license": "Apache-2.0",
@@ -34,16 +34,16 @@
       "surf"
     ],
     "compat": {
-      "pluginApi": ">=2026.3.24",
-      "minGatewayVersion": "2026.3.24"
+      "pluginApi": ">=2026.4.1",
+      "minGatewayVersion": "2026.4.1"
     },
     "build": {
-      "openclawVersion": "2026.3.24",
-      "pluginSdkVersion": "2026.3.24"
+      "openclawVersion": "2026.4.1",
+      "pluginSdkVersion": "2026.4.1"
     }
   },
   "peerDependencies": {
-    "openclaw": ">=2026.3.8"
+    "openclaw": ">=2026.3.24"
   },
   "peerDependenciesMeta": {
     "openclaw": {

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 -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user
+npx x402-proxy https://surf.cascade.fyi/api/v1/twitter/user/openclaw
 ```
 
 First run auto-creates a wallet. No setup needed.