fix(docs): migrate all endpoints to unified surf.cascade.fyi domain

Replace legacy individual service URLs (twitter.surf.cascade.fyi,
web.surf.cascade.fyi, inference.surf.cascade.fyi) with the unified
surf.cascade.fyi/api/v1/ endpoints across CLI help text, README,
SKILL.md, CLAUDE.md, and OpenClaw plugin docs.

Author: tenequm

.claude/CLAUDE.md

@@ -110,7 +110,7 @@ All commands run from the repo root. Always `pnpm build` first.
 ### CLI smoke test
 ```bash
 # Direct HTTP request (single process, no concurrency concerns)
-node packages/x402-proxy/dist/bin/cli.js https://twitter.surf.cascade.fyi/users/cascade_fyi --network solana
+node packages/x402-proxy/dist/bin/cli.js -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user --network solana
 
 # Wallet info
 node packages/x402-proxy/dist/bin/cli.js wallet info

packages/x402-proxy/CHANGELOG.md

@@ -7,6 +7,11 @@ 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
@@ -295,7 +300,8 @@ 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.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

packages/x402-proxy/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'

packages/x402-proxy/package.json

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

packages/x402-proxy/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.

packages/x402-proxy/skills/references/openclaw-plugin.md

@@ -47,7 +47,7 @@ Add the plugin config to your `openclaw.json` (or via `openclaw config edit`):
           "providers": {
             "surf-inference": {
               "baseUrl": "/x402/v1",
-              "upstreamUrl": "https://inference.surf.cascade.fyi",
+              "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 },
@@ -79,7 +79,7 @@ Add the plugin config to your `openclaw.json` (or via `openclaw config edit`):
 | Field | Description |
 |-------|-------------|
 | `providers.<name>.baseUrl` | Route path registered in OpenClaw (e.g., `/x402/v1`) |
-| `providers.<name>.upstreamUrl` | Actual upstream endpoint (e.g., `https://inference.surf.cascade.fyi`) |
+| `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) |
@@ -118,11 +118,11 @@ openclaw models    # verify models appear
 
 ## Fetching latest models
 
-The model list on `inference.surf.cascade.fyi` changes over time. Fetch the current catalog:
+The model list on `surf.cascade.fyi` changes over time. Fetch the current catalog:
 
 ```bash
 npx x402-proxy --protocol mpp --network solana \
-  https://inference.surf.cascade.fyi/v1/models
+  https://surf.cascade.fyi/api/v1/inference/models
 ```
 
 Then update the `models` array in your plugin config accordingly.

packages/x402-proxy/src/commands/fetch.ts

@@ -43,8 +43,8 @@ export const fetchCommand = buildCommand<FetchFlags, [url?: string], CommandCont
     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: {
@@ -153,7 +153,9 @@ Examples:
         console.log();
         console.log(
           pc.dim("  try: ") +
-            pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi"),
+            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"));

packages/x402-proxy/src/commands/mcp-add.ts

@@ -251,7 +251,7 @@ export const mcpAddCommand = buildCommand<McpAddFlags, [name: string, url: strin
 
       prompts.log.step("Try your first request:");
       prompts.log.message(
-        `  ${pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi")}`,
+        `  ${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")}`,

packages/x402-proxy/src/commands/setup.ts

@@ -172,7 +172,7 @@ export async function runSetup(opts?: {
 
   prompts.log.step("Try your first request:");
   prompts.log.message(
-    `  ${pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi")}`,
+    `  ${pc.cyan(`$ npx x402-proxy -X POST -d '{"ref":"CoinbaseDev"}' https://surf.cascade.fyi/api/v1/twitter/user`)}`,
   );
 
   prompts.outro(pc.green("Setup complete!"));