x402-proxy 0.5.2 → 0.7.0

package/CHANGELOG.md

@@ -7,6 +7,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-03-20
+
+### Added
+- `--verbose` flag on `fetch` command - debug logging for protocol negotiation, headers, session lifecycle, and payment flow
+- OpenClaw plugin integration (`x402-proxy/openclaw`) - registers `x_balance` tool, `x_payment` tool, `/x_wallet` command, and HTTP route proxy for upstream x402 endpoints
+- `openclaw.plugin.json` manifest with config schema for providers, keypair path, RPC URL, and dashboard URL
+- `./openclaw` subpath export in package.json
+
+### Fixed
+- MPP SSE requests silently losing `Content-Type` and other headers when `Headers` instances are spread (workaround for mppx SDK bug, upstream fix: wevm/mppx#209)
+- MPP session `close()` errors no longer crash the CLI - wrapped in try/catch with verbose error reporting
+- MPP payment history now includes `amount` (converted from base units) and `channelId` in transaction records
+- MPP streaming history records now use `channelId` as fallback for `tx` field when no receipt reference is available
+
+## [0.6.0] - 2026-03-19
+
+### Added
+- MPP (Machine Payments Protocol) support via `mppx` SDK - pay-per-token streaming and charge-per-request on the Tempo network
+- `--protocol` flag for `fetch` and `mcp` commands - choose between `x402` and `mpp` payment protocols
+- MPP streaming: `--protocol mpp` with `"stream": true` in body uses session-based SSE with mid-stream voucher cycling
+- MPP MCP proxy: `--protocol mpp` on `mcp` command wraps tool calls with MPP payments via `mppx/mcp-sdk`
+- Auto-detect fallback: if x402 returns 402 and server advertises MPP via `WWW-Authenticate: Payment`, falls through to MPP automatically
+- Tempo USDC balance shown in `wallet` and `status` commands
+- `preferredProtocol` and `mppSessionBudget` config options
+- `detectProtocols()`, `createMppProxyHandler()`, `TEMPO_NETWORK` exported from library
+- `MppPaymentInfo`, `MppProxyHandler`, `DetectedProtocols` types exported
+
+### Changed
+- `PaymentInfo` type now includes `protocol: "x402"` discriminator
+- `extractTxSignature()` now also extracts references from MPP `Payment-Receipt` headers
+- 402 error display shows Tempo balances and MPP-accepting endpoints
+- `appendHistory` creates parent directory automatically (removed `ensureConfigDir` calls)
+- Balance fetching consolidated into `fetchAllBalances()` helper
+
 ## [0.5.2] - 2026-03-19
 
 ### Fixed
@@ -152,7 +186,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.5.2...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.7.0...HEAD
+[0.7.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.6.0...v0.7.0
+[0.6.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.5.2...v0.6.0
 [0.5.2]: https://github.com/cascade-protocol/x402-proxy/compare/v0.5.1...v0.5.2
 [0.5.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.4.2...v0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # x402-proxy
 
-`curl` for [x402](https://www.x402.org/) paid APIs. Auto-pays HTTP 402 responses with USDC on Base and Solana - zero crypto code on the buyer side.
+`curl` for [x402](https://www.x402.org/) paid APIs. Auto-pays HTTP 402 responses with USDC on Base, Solana, and Tempo - zero crypto code on the buyer side. Supports both [x402](https://www.x402.org/) and [MPP](https://mpp.dev/) payment protocols.
 
 ## Quick Start
 
@@ -10,7 +10,7 @@ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi
 
 That's it. The endpoint returns 402, x402-proxy pays and streams the response.
 
-No wallet? It'll walk you through setup automatically. One mnemonic derives both EVM (Base) and Solana keypairs. Fund either chain and go.
+No wallet? It'll walk you through setup automatically. One mnemonic derives both EVM (Base/Tempo) and Solana keypairs. Fund any chain and go.
 
 ## MCP Proxy
 
@@ -49,6 +49,16 @@ $ npx x402-proxy --method POST \
 # Force a specific network
 $ npx x402-proxy --network base https://api.example.com/data
 
+# Debug protocol negotiation and payment flow
+$ 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"}]}' \
+  https://inference.surf.cascade.fyi/v1/chat/completions
+
 # Pipe-safe
 $ npx x402-proxy https://api.example.com/data | jq '.results'
 ```
@@ -100,7 +110,9 @@ Resolution order: flags > env vars > mnemonic env > `wallet.json` file.
 ```ts
 import {
   createX402ProxyHandler,
+  createMppProxyHandler,
   extractTxSignature,
+  detectProtocols,
   appendHistory,
   readHistory,
   calcSpend,
@@ -109,6 +121,12 @@ import {
 
 See the [library API docs](https://github.com/cascade-protocol/x402-proxy/tree/main/packages/x402-proxy#library-api) for details.
 
+## 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.
+
+Configure providers and models in OpenClaw plugin settings. Uses the standard wallet resolution (env vars or `wallet.json`).
+
 ## License
 
 Apache-2.0