@dexterai/x402 1.7.2 → 1.8.1

package/README.md

@@ -70,7 +70,7 @@ Quality-verified endpoints (score 75+) get promoted in search results. The verif
 npm install @dexterai/x402
 ```
 
-### Client (Node.js) — NEW!
+### Client (Node.js)
 
 The simplest way to make x402 payments from scripts:
 
@@ -85,6 +85,20 @@ const x402Fetch = wrapFetch(fetch, {
 const response = await x402Fetch('https://api.example.com/protected');
 ```
 
+Check the payment receipt:
+
+```typescript
+import { wrapFetch, getPaymentReceipt } from '@dexterai/x402/client';
+
+const x402Fetch = wrapFetch(fetch, { walletPrivateKey: process.env.SOLANA_PRIVATE_KEY });
+const response = await x402Fetch('https://api.example.com/protected');
+
+const receipt = getPaymentReceipt(response);
+if (receipt) {
+  console.log('Paid:', receipt.transaction, 'on', receipt.network);
+}
+```
+
 ### Client (Browser)
 
 ```typescript
@@ -152,12 +166,48 @@ function PayButton() {
 
 ## Supported Networks
 
-| Network | Identifier | Client | Server |
-|---------|------------|--------|--------|
-| Solana Mainnet | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` | ✅ Verified | ✅ Verified |
-| Base Mainnet | `eip155:8453` | ✅ Verified | ✅ Verified |
+All networks supported by the [Dexter facilitator](https://x402.dexter.cash/supported). USDC on every chain.
 
-All networks use USDC. Both client and server SDKs are production-tested with real payments.
+**Mainnets:**
+
+| Network | CAIP-2 | Status |
+|---------|--------|--------|
+| Solana | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` | Production |
+| Base | `eip155:8453` | Production |
+| Polygon | `eip155:137` | Production |
+| Arbitrum | `eip155:42161` | Production |
+| Optimism | `eip155:10` | Production |
+| Avalanche | `eip155:43114` | Production |
+| SKALE Base | `eip155:1187947933` | Production (zero gas) |
+
+**Testnets:**
+
+| Network | CAIP-2 |
+|---------|--------|
+| Solana Devnet | `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1` |
+| Base Sepolia | `eip155:84532` |
+| SKALE Sepolia | `eip155:324705682` |
+
+Accept payments on multiple chains simultaneously:
+
+```typescript
+// Same address across EVM chains
+app.get('/api/data', x402Middleware({
+  payTo: '0xYourAddress',
+  amount: '0.01',
+  network: ['eip155:8453', 'eip155:137', 'eip155:42161', 'eip155:10'],
+}));
+
+// Different addresses per chain family
+app.get('/api/data', x402Middleware({
+  payTo: {
+    'solana:*': 'YourSolanaAddress...',
+    'eip155:*': '0xYourEvmAddress...',
+  },
+  amount: '0.01',
+  network: ['solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp', 'eip155:8453', 'eip155:137'],
+}));
+```
 
 ---
 
@@ -530,6 +580,23 @@ tiktoken's default encoding works well for most transformer models. Only use a c
 
 ---
 
+## Sponsored Access (v1.7.2)
+
+**Server middleware** accepts `sponsoredAccess: true` in its config. When enabled, it reads `extensions["sponsored-access"]` from the facilitator's settlement response and injects `_x402_sponsored` into the JSON response body so agents can see recommendations.
+
+```typescript
+app.use(x402Middleware({
+  facilitatorUrl: "https://x402.dexter.cash",
+  sponsoredAccess: true,  // opt-in to recommendation injection
+}));
+```
+
+**Client SDK** decodes the `PAYMENT-RESPONSE` header from x402 responses and attaches the full settlement receipt (including extensions) as `response._x402` for programmatic access.
+
+**Types:** `SettleResponse` now includes an optional `extensions` field.
+
+---
+
 ## API Reference
 
 ### `createX402Client(options)`