x402-proxy 0.9.3 → 0.10.0

package/CHANGELOG.md

@@ -7,6 +7,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-04-01
+
+### Added
+- `serve` command - local HTTP proxy server for paid inference endpoints, auto-detects wallet and preferred network
+- `claude` command - run Claude Code through a paid local proxy with `ANTHROPIC_BASE_URL` auto-configured
+- `--model` flag on `claude` command (default: `minimax/minimax-m2.7`) - sets `ANTHROPIC_CUSTOM_MODEL_OPTION` for non-Anthropic models
+- MPP payment support in OpenClaw plugin - inference proxy and `x_request` tool now handle both x402 (Solana) and MPP (Tempo/Base) protocols
+- `/x_send` slash command with confirmation flow (5-min TTL) for USDC transfers from the OpenClaw gateway
+- Default Surf provider config - plugin works out of the box without explicit provider configuration
+- `defaults.ts` module with provider config types, resolution logic, and built-in model catalog
+- Dual-wallet support in OpenClaw plugin - EVM and Solana addresses resolved independently
+- `addressForNetwork` and `parseMppAmount` exported as shared helpers from `tools.ts`
+
+### Changed
+- OpenClaw plugin migrated to `definePluginEntry` SDK (from hand-rolled types)
+- `x_balance` tool renamed to `x_wallet` (alias: `x_balance`)
+- `x_payment` tool renamed to `x_request` (alias: `x_payment`) with x402/MPP protocol branching
+- `/x_wallet` command: `send` subcommand now redirects to `/x_send`
+- Inference proxy route handler renamed from `createX402RouteHandler` to `createInferenceProxyRouteHandler`
+- SSE token tracking deduplicated into `createSseTracker()` helper shared by x402 and MPP paths
+- Replaced hardcoded `"eip155:4217"` with imported `TEMPO_NETWORK` constant
+- `serve` and `claude` commands handle their own SIGINT/SIGTERM (CLI entry point skips default handler for them)
+- Wallet loading in plugin uses proper promise dedup (`walletLoadPromise`) instead of boolean flag
+- Providers sorted once in route handler closure instead of per-request
+
+### Fixed
+- `preferredNetwork === "undefined"` string comparison in serve command replaced with proper `preferredNetwork || undefined` check
+
+## [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
@@ -295,7 +328,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.3...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.0...HEAD
+[0.10.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.4...v0.10.0
+[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

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/v1/chat/completions
 
 # Pipe-safe
 $ npx x402-proxy https://api.example.com/data | jq '.results'
@@ -81,6 +81,8 @@ $ npx x402-proxy https://api.example.com/data | jq '.results'
 
 ```bash
 $ npx x402-proxy <url>                    # paid HTTP request (default command)
+$ npx x402-proxy serve                    # local paid inference proxy server
+$ npx x402-proxy claude                   # run Claude Code through a paid local proxy
 $ npx x402-proxy mcp <url>                # MCP stdio proxy for agents
 $ npx x402-proxy mcp add <name> <url>     # install MCP server into your AI client
 $ npx x402-proxy setup                    # onboarding wizard
@@ -141,9 +143,11 @@ See the [library API docs](https://github.com/cascade-protocol/x402-proxy/tree/m
 
 ## OpenClaw Plugin
 
-x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin, giving your gateway automatic x402 payment capabilities. Registers `x_balance` and `x_payment` tools, `/x_wallet` command, and an HTTP route proxy for upstream x402 endpoints.
+x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin, giving your gateway automatic x402 and MPP payment capabilities. Registers `x_wallet` and `x_request` tools (aliased as `x_balance`/`x_payment`), `/x_wallet` and `/x_send` commands, and an HTTP route proxy for upstream inference endpoints.
 
-Configure providers and models in OpenClaw plugin settings. Uses the standard wallet resolution (env vars or `wallet.json`).
+By default, the plugin registers a built-in `surf` provider at `/x402-proxy/v1` that points at `https://surf.cascade.fyi/api/v1/inference` and prefers MPP. Uses the standard wallet resolution (env vars or `wallet.json`).
+
+For MPP-backed inference, make sure the wallet source includes an EVM key as well as Solana. `npx x402-proxy setup` does this automatically.
 
 ## License