fix(cli): add curl-style short flags and SSE stream resilience

- Add -X (method), -d (body) aliases via Stricli
- Add -H (header) via argv preprocessing (Stricli reserves -H)
- Swallow Node.js "terminated" errors on SSE stream close
- Bump mppx to ^0.4.9 (204-safe receipts, idempotent vouchers)

Author: tenequm

packages/x402-proxy/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.1] - 2026-03-24
+
+### Added
+- Curl-style short flags: `-X` (method), `-H` (header), `-d` (body) for the `fetch` command
+- `-H` preprocessing in CLI entry point to work around Stricli reserving `-H` for `--help-all`
+
+### Fixed
+- SSE streaming resilience: swallow Node.js "terminated" errors when server closes connection after final event, so payment logging still completes
+- Bumped `mppx` to ^0.4.9 (fixes 204-safe SSE receipt wrapping and idempotent voucher replay)
+
 ## [0.8.0] - 2026-03-21
 
 ### Added
@@ -204,7 +214,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.8.0...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.1...HEAD
+[0.8.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.0...v0.8.1
 [0.8.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.7.1...v0.8.0
 [0.7.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.6.0...v0.7.0

packages/x402-proxy/README.md

@@ -40,10 +40,10 @@ Works like curl. Response body streams to stdout, payment info goes to stderr.
 # GET request
 $ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi
 
-# POST with body and headers
-$ npx x402-proxy --method POST \
-  --header "Content-Type: application/json" \
-  --body '{"url":"https://x402.org"}' \
+# 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
 
 # Force a specific network
@@ -54,9 +54,8 @@ $ npx x402-proxy --verbose https://api.example.com/data
 
 # Use MPP protocol for streaming payments
 $ npx x402-proxy --protocol mpp \
-  --method POST \
-  --header "Content-Type: application/json" \
-  --body '{"model":"minimax/minimax-m2.5","stream":true,"messages":[{"role":"user","content":"Hello"}]}' \
+  -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
 
 # Pipe-safe

packages/x402-proxy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "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,
@@ -47,7 +47,7 @@
     "@x402/evm": "^2.6.0",
     "@x402/fetch": "^2.6.0",
     "@x402/mcp": "^2.6.0",
-    "mppx": "^0.4.7",
+    "mppx": "^0.4.9",
     "@x402/svm": "^2.6.0",
     "ethers": "^6.0.0",
     "picocolors": "^1.1.1",

packages/x402-proxy/src/bin/cli.ts

@@ -2,4 +2,6 @@ import { run } from "@stricli/core";
 import { app } from "../app.js";
 import { buildContext } from "../context.js";
 
-await run(app, process.argv.slice(2), buildContext(process));
+// Stricli reserves -H for --help-all. Pre-process to support curl-style -H for headers.
+const args = process.argv.slice(2).map((a) => (a === "-H" ? "--header" : a));
+await run(app, args, buildContext(process));

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

@@ -99,6 +99,10 @@ Examples:
         default: false,
       },
     },
+    aliases: {
+      X: "method",
+      d: "body",
+    },
     positional: {
       kind: "tuple",
       parameters: [
@@ -273,8 +277,16 @@ Examples:
             verbose("opening SSE session...");
             const tokens = await mppHandler.sse(parsedUrl.toString(), init);
             verbose("SSE stream opened, reading tokens...");
-            for await (const token of tokens) {
-              process.stdout.write(token);
+            try {
+              for await (const token of tokens) {
+                process.stdout.write(token);
+              }
+            } catch (streamErr) {
+              // Server may close connection after final SSE event (e.g. mppx 204 receipt bug).
+              // Swallow "terminated" so payment/history logging still runs.
+              const msg = streamErr instanceof Error ? streamErr.message : String(streamErr);
+              verbose(`SSE stream error: ${msg}`);
+              if (!msg.includes("terminated")) throw streamErr;
             }
             verbose("SSE stream complete");
           } finally {