x402-proxy 0.11.2 → 0.11.4

package/README.md

@@ -1,53 +1,37 @@
 # x402-proxy
 
-`curl` for [x402](https://www.x402.org/) and [MPP](https://mpp.dev/) paid APIs. Auto-pays HTTP 402 responses with USDC on Base, Solana, and [Tempo](https://tempo.xyz/) - zero crypto code on the buyer side. Supports one-time payments (x402, MPP charge) and pay-per-token streaming (MPP sessions).
+[![npm version](https://img.shields.io/npm/v/x402-proxy.svg?style=flat-square)](https://www.npmjs.com/package/x402-proxy)
+[![license](https://img.shields.io/npm/l/x402-proxy.svg?style=flat-square)](LICENSE)
+[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
 
-## Quick Start
+curl for x402 and MPP paid APIs with MCP proxy support. Auto-pays HTTP 402 on Base, Solana, and Tempo.
 
-```bash
-npx x402-proxy https://surf.cascade.fyi/api/v1/twitter/user/openclaw
-```
-
-That's it. The endpoint returns 402, x402-proxy pays and streams the response.
+Zero crypto code on the buyer side. One mnemonic derives both EVM (Base/Tempo) and Solana keypairs - fund any chain and go. Supports one-time payments (x402, MPP charge) and pay-per-token streaming (MPP sessions). Use it as a CLI, an MCP proxy for AI agents, or as a Node.js library.
 
-No wallet? It'll walk you through setup automatically. One mnemonic derives both EVM (Base/Tempo) and Solana keypairs. Fund any chain and go.
+## Table of Contents
 
-## MCP Proxy
+- [Install](#install)
+- [Usage](#usage)
+- [Commands](#commands)
+- [MCP Proxy](#mcp-proxy)
+- [Wallet](#wallet)
+- [Env Vars](#env-vars)
+- [Library Usage](#library-usage)
+- [OpenClaw Plugin](#openclaw-plugin)
+- [Contributing](#contributing)
+- [License](#license)
 
-Let your AI agent consume any paid MCP server.
-
-### Quick setup
+## Install
 
 ```bash
-npx x402-proxy mcp add surf https://surf.cascade.fyi/mcp
-```
-
-Auto-detects installed AI clients (Claude Code, Cursor, VS Code, and 16+ others), shows a config preview, and writes it for you. Runs wallet setup if needed.
-
-### Manual config
-
-Or add to your client config directly:
-
-```json
-{
-  "mcpServers": {
-    "surf": {
-      "command": "npx",
-      "args": ["-y", "x402-proxy", "mcp", "https://surf.cascade.fyi/mcp"]
-    }
-  }
-}
+npx x402-proxy https://surf.cascade.fyi/api/v1/twitter/user/openclaw
 ```
 
-The proxy auto-generates a wallet on first run and uses `~/.config/x402-proxy/wallet.json`. No env vars needed. Your agent never touches crypto.
-
-For OpenClaw:
+That's it. The endpoint returns 402, x402-proxy pays and streams the response.
 
-```bash
-openclaw mcp set surf '{"command":"npx","args":["-y","x402-proxy","mcp","https://surf.cascade.fyi/mcp"]}'
-```
+No wallet? It'll walk you through setup automatically. One mnemonic derives both EVM (Base/Tempo) and Solana keypairs. Fund any chain and go.
 
-## HTTP Requests
+## Usage
 
 Works like curl. Response body streams to stdout, payment info goes to stderr.
 
@@ -97,6 +81,41 @@ $ npx x402-proxy wallet export-key <target> # bare key/mnemonic to stdout (evm|s
 
 All commands support `--help` for details. Use `-c <dir>` to override the config directory.
 
+## MCP Proxy
+
+Let your AI agent consume any paid MCP server.
+
+### Quick setup
+
+```bash
+npx x402-proxy mcp add surf https://surf.cascade.fyi/mcp
+```
+
+Auto-detects installed AI clients (Claude Code, Cursor, VS Code, and 16+ others), shows a config preview, and writes it for you. Runs wallet setup if needed.
+
+### Manual config
+
+Or add to your client config directly:
+
+```json
+{
+  "mcpServers": {
+    "surf": {
+      "command": "npx",
+      "args": ["-y", "x402-proxy", "mcp", "https://surf.cascade.fyi/mcp"]
+    }
+  }
+}
+```
+
+The proxy auto-generates a wallet on first run and uses `~/.config/x402-proxy/wallet.json`. No env vars needed. Your agent never touches crypto.
+
+For OpenClaw:
+
+```bash
+openclaw mcp set surf '{"command":"npx","args":["-y","x402-proxy","mcp","https://surf.cascade.fyi/mcp"]}'
+```
+
 ## Wallet
 
 A single BIP-39 mnemonic derives both chains:
@@ -143,7 +162,7 @@ See the [library API docs](https://github.com/cascade-protocol/x402-proxy/tree/m
 
 ## OpenClaw Plugin
 
-The OpenClaw plugin now ships as a separate npm package: `x402-proxy-openclaw`.
+The OpenClaw plugin ships as a separate npm package: `x402-proxy-openclaw`.
 
 ```bash
 openclaw plugins install x402-proxy-openclaw
@@ -155,6 +174,10 @@ By default, the plugin registers a built-in `surf` provider at `/x402-proxy/v1`
 
 For MPP-backed inference, make sure the wallet source includes an EVM key as well as Solana. `npx x402-proxy setup` does this automatically.
 
+## Contributing
+
+PRs welcome. Feel free to [open an issue](https://github.com/cascade-protocol/x402-proxy/issues) for bug reports or feature requests.
+
 ## License
 
-Apache-2.0
+[Apache-2.0](LICENSE) (c) Cascade Protocol

package/dist/bin/cli.js

@@ -4,7 +4,7 @@ import { C as run, S as buildRouteMap, _ as base58, a as getDebugLogPath, b as b
 import { C as warn, S as success, _ as decodePaymentResponseHeader, b as info, c as resolveWallet, d as displayNetwork, f as formatAmount, g as wrapFetchWithPayment, 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 dim, x as isTTY, y as error } from "../wallet-CUCoLEqs.js";
 import { i as deserializeSessionReceipt, n as tempo, o as parseUnits, r as parseEvent, t as create } from "../client-DqtxTnu6.js";
 import { t as privateKeyToAccount } from "../accounts-D9KsVVpJ.js";
-import { a as Nt, c as Wt, i as Jt, l as Ct, n as setupCommand, o as R, r as Gt, s as Rt, t as runSetup } from "../setup-q91MbrZT.js";
+import { a as Nt, c as Wt, i as Jt, l as Ct, n as setupCommand, o as R, r as Gt, s as Rt, t as runSetup } from "../setup-C10O8N36.js";
 import { n as statusCommand } from "../status-DjZdIeES.js";
 import { dirname, join, normalize, resolve } from "node:path";
 import { spawn } from "node:child_process";
@@ -17,9 +17,9 @@ import { homedir } from "node:os";
 const DEFAULT_SURF_PROVIDER_ID = "surf";
 const DEFAULT_SURF_BASE_URL = "/x402-proxy/v1";
 const DEFAULT_SURF_UPSTREAM_URL = "https://surf.cascade.fyi/api/v1/inference";
-const DEFAULT_SURF_MODELS = [
-	{
-		id: "anthropic/claude-opus-4.6",
+/** Known model metadata for cost/capability enrichment. */
+const MODEL_METADATA = {
+	"anthropic/claude-opus-4.6": {
 		name: "Claude Opus 4.6",
 		maxTokens: 2e5,
 		reasoning: true,
@@ -32,8 +32,20 @@ const DEFAULT_SURF_MODELS = [
 		},
 		contextWindow: 2e5
 	},
-	{
-		id: "anthropic/claude-sonnet-4.6",
+	"anthropic/claude-opus-4.5": {
+		name: "Claude Opus 4.5",
+		maxTokens: 2e5,
+		reasoning: true,
+		input: ["text", "image"],
+		cost: {
+			input: .015,
+			output: .075,
+			cacheRead: .0015,
+			cacheWrite: .01875
+		},
+		contextWindow: 2e5
+	},
+	"anthropic/claude-sonnet-4.6": {
 		name: "Claude Sonnet 4.6",
 		maxTokens: 2e5,
 		reasoning: true,
@@ -46,8 +58,20 @@ const DEFAULT_SURF_MODELS = [
 		},
 		contextWindow: 2e5
 	},
-	{
-		id: "x-ai/grok-4.20-beta",
+	"anthropic/claude-sonnet-4.5": {
+		name: "Claude Sonnet 4.5",
+		maxTokens: 2e5,
+		reasoning: true,
+		input: ["text", "image"],
+		cost: {
+			input: .003,
+			output: .015,
+			cacheRead: 3e-4,
+			cacheWrite: .00375
+		},
+		contextWindow: 2e5
+	},
+	"x-ai/grok-4.20-beta": {
 		name: "Grok 4.20 Beta",
 		maxTokens: 131072,
 		reasoning: true,
@@ -60,8 +84,33 @@ const DEFAULT_SURF_MODELS = [
 		},
 		contextWindow: 131072
 	},
-	{
-		id: "minimax/minimax-m2.5",
+	"x-ai/grok-4.1-fast": {
+		name: "Grok 4.1 Fast",
+		maxTokens: 131072,
+		reasoning: false,
+		input: ["text"],
+		cost: {
+			input: .001,
+			output: .005,
+			cacheRead: 0,
+			cacheWrite: 0
+		},
+		contextWindow: 131072
+	},
+	"minimax/minimax-m2.7": {
+		name: "MiniMax M2.7",
+		maxTokens: 1e6,
+		reasoning: false,
+		input: ["text"],
+		cost: {
+			input: .001,
+			output: .005,
+			cacheRead: 0,
+			cacheWrite: 0
+		},
+		contextWindow: 1e6
+	},
+	"minimax/minimax-m2.5": {
 		name: "MiniMax M2.5",
 		maxTokens: 1e6,
 		reasoning: false,
@@ -74,8 +123,7 @@ const DEFAULT_SURF_MODELS = [
 		},
 		contextWindow: 1e6
 	},
-	{
-		id: "moonshotai/kimi-k2.5",
+	"moonshotai/kimi-k2.5": {
 		name: "Kimi K2.5",
 		maxTokens: 131072,
 		reasoning: true,
@@ -88,8 +136,7 @@ const DEFAULT_SURF_MODELS = [
 		},
 		contextWindow: 131072
 	},
-	{
-		id: "z-ai/glm-5",
+	"z-ai/glm-5": {
 		name: "GLM-5",
 		maxTokens: 128e3,
 		reasoning: false,
@@ -101,8 +148,85 @@ const DEFAULT_SURF_MODELS = [
 			cacheWrite: 0
 		},
 		contextWindow: 128e3
+	},
+	"z-ai/glm-5-turbo": {
+		name: "GLM-5 Turbo",
+		maxTokens: 128e3,
+		reasoning: false,
+		input: ["text"],
+		cost: {
+			input: .001,
+			output: .005,
+			cacheRead: 0,
+			cacheWrite: 0
+		},
+		contextWindow: 128e3
+	},
+	"qwen/qwen-2.5-7b-instruct": {
+		name: "Qwen 2.5 7B Instruct",
+		maxTokens: 32768,
+		reasoning: false,
+		input: ["text"],
+		cost: {
+			input: 5e-4,
+			output: .002,
+			cacheRead: 0,
+			cacheWrite: 0
+		},
+		contextWindow: 131072
+	},
+	"stepfun/step-3.5-flash": {
+		name: "Step 3.5 Flash",
+		maxTokens: 131072,
+		reasoning: false,
+		input: ["text"],
+		cost: {
+			input: .001,
+			output: .005,
+			cacheRead: 0,
+			cacheWrite: 0
+		},
+		contextWindow: 131072
+	},
+	"xiaomi/mimo-v2-pro": {
+		name: "MiMo V2 Pro",
+		maxTokens: 131072,
+		reasoning: true,
+		input: ["text"],
+		cost: {
+			input: .001,
+			output: .005,
+			cacheRead: 0,
+			cacheWrite: 0
+		},
+		contextWindow: 131072
 	}
-];
+};
+const DEFAULT_CONTEXT_WINDOW = 131072;
+const ZERO_COST = {
+	input: 0,
+	output: 0,
+	cacheRead: 0,
+	cacheWrite: 0
+};
+function modelFromId(id) {
+	const known = MODEL_METADATA[id];
+	if (known) return {
+		id,
+		...known
+	};
+	return {
+		id,
+		name: (id.split("/").pop() ?? id).replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()),
+		maxTokens: DEFAULT_CONTEXT_WINDOW,
+		reasoning: false,
+		input: ["text"],
+		cost: ZERO_COST,
+		contextWindow: DEFAULT_CONTEXT_WINDOW
+	};
+}
+/** Static fallback models used when upstream fetch fails. */
+const DEFAULT_SURF_MODELS = Object.keys(MODEL_METADATA).map(modelFromId);
 function resolveProviders(config) {
 	const defaultProtocol = resolveProtocol(config.protocol);
 	const defaultMppSessionBudget = resolveMppSessionBudget(config.mppSessionBudget);
@@ -1184,7 +1308,7 @@ async function resolveWalletForServe(flags) {
 		solanaKey: flags.solanaKey
 	});
 	if (wallet.source !== "none") return wallet;
-	const { runSetup } = await import("../setup-DPuLACk7.js");
+	const { runSetup } = await import("../setup-BdSfEdx4.js");
 	if (isTTY()) {
 		dim("  No wallet found. Let's set one up first.\n");
 		await runSetup();
@@ -1825,7 +1949,7 @@ Examples:
 				process.exit(1);
 			}
 			dim("  No wallet found. Let's set one up first.\n");
-			const { runSetup } = await import("../setup-DPuLACk7.js");
+			const { runSetup } = await import("../setup-BdSfEdx4.js");
 			await runSetup();
 			console.log();
 			wallet = resolveWallet();
@@ -2258,7 +2382,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-DPuLACk7.js");
+			const { runSetup } = await import("../setup-BdSfEdx4.js");
 			await runSetup({ nonInteractive: true });
 			const fresh = resolveWallet({
 				evmKey: flags.evmKey,
@@ -2279,7 +2403,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 		const { SSEClientTransport } = await import("../sse-kba68iqF.js");
 		const { StreamableHTTPClientTransport } = await import("../streamableHttp-DRntYTFN.js");
 		const { Server } = await import("../server-Dbsk9dql.js");
-		const { StdioServerTransport } = await import("../stdio-BCoJJXun.js");
+		const { StdioServerTransport } = await import("../stdio-CdmkLt8r.js");
 		const { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ToolListChangedNotificationSchema, ResourceListChangedNotificationSchema } = await import("../types-DH9rDVeP.js");
 		async function connectTransport(target) {
 			try {
@@ -2321,7 +2445,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.11.2"
+				version: "0.11.4"
 			});
 			await connectTransport(remoteClient);
 			function recordX402Payment(ctx) {
@@ -2352,7 +2476,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.11.2"
+				version: "0.11.4"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -2425,7 +2549,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.11.2"
+				version: "0.11.4"
 			});
 			await connectTransport(remoteClient);
 			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
@@ -2440,7 +2564,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.11.2"
+				version: "0.11.4"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -2826,7 +2950,7 @@ const app = buildApplication(buildRouteMap({
 	docs: { brief: "curl for x402 paid APIs" }
 }), {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.11.2" },
+	versionInfo: { currentVersion: "0.11.4" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 //#endregion

package/dist/setup-BdSfEdx4.js

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

package/dist/{setup-q91MbrZT.js → setup-C10O8N36.js}

@@ -4,7 +4,7 @@ import { c as isConfigured, d as saveConfig, g as generateMnemonic, i as getConf
 import "node:path";
 import "node:fs";
 import { stripVTControlCharacters, styleText } from "node:util";
-import N, { stdin, stdout } from "node:process";
+import process$1, { stdin, stdout } from "node:process";
 import "node:readline";
 import ot from "node:readline";
 import "node:tty";
@@ -493,7 +493,7 @@ var $t = class extends B {
 //#endregion
 //#region node_modules/.pnpm/@clack+prompts@1.1.0/node_modules/@clack/prompts/dist/index.mjs
 function pt() {
-	return N.platform !== "win32" ? N.env.TERM !== "linux" : !!N.env.CI || !!N.env.WT_SESSION || !!N.env.TERMINUS_SUBLIME || N.env.ConEmuTask === "{cmd::Cmder}" || N.env.TERM_PROGRAM === "Terminus-Sublime" || N.env.TERM_PROGRAM === "vscode" || N.env.TERM === "xterm-256color" || N.env.TERM === "alacritty" || N.env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
+	return process$1.platform !== "win32" ? process$1.env.TERM !== "linux" : !!process$1.env.CI || !!process$1.env.WT_SESSION || !!process$1.env.TERMINUS_SUBLIME || process$1.env.ConEmuTask === "{cmd::Cmder}" || process$1.env.TERM_PROGRAM === "Terminus-Sublime" || process$1.env.TERM_PROGRAM === "vscode" || process$1.env.TERM === "xterm-256color" || process$1.env.TERM === "alacritty" || process$1.env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
 }
 const ee = pt(), I = (e, r) => ee ? e : r, Re = I("◆", "*"), $e = I("■", "x"), de = I("▲", "x"), V = I("◇", "o"), he = I("┌", "T"), h = I("│", "|"), x = I("└", "—");
 I("┐", "T");

package/dist/{stdio-BCoJJXun.js → stdio-CdmkLt8r.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Z as JSONRPCMessageSchema } from "./types-BQ17ZF7g.js";
-import N from "node:process";
+import process from "node:process";
 //#region node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
 /**
 * Buffers a continuous stdio stream into discrete JSON-RPC messages.
@@ -35,7 +35,7 @@ function serializeMessage(message) {
 * This transport is only available in Node.js environments.
 */
 var StdioServerTransport = class {
-	constructor(_stdin = N.stdin, _stdout = N.stdout) {
+	constructor(_stdin = process.stdin, _stdout = process.stdout) {
 		this._stdin = _stdin;
 		this._stdout = _stdout;
 		this._readBuffer = new ReadBuffer();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "x402-proxy",
   "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base, Solana, and Tempo.",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "type": "module",
   "sideEffects": false,
   "license": "Apache-2.0",

package/dist/setup-DPuLACk7.js

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