update to latest deployment

Author: phdargen

e2e/clients/httpx/uv.lock

@@ -58,6 +58,14 @@ cd clients/batch-settlement
 pnpm start
 ```
 
+## Concurrent requests
+
+Use the concurrent example to send requests over multiple channels in parallel. Each slot uses a unique salt derived from `CHANNEL_SALT`, so the server can serialize work per channel while still processing channels concurrently.
+
+```bash
+CONCURRENCY=3 NUMBER_OF_ROUNDS=3 pnpm dev:concurrent
+```
+
 ## Environment
 
 | Variable | Required | Description |
@@ -70,5 +78,7 @@ pnpm start
 | `DEPOSIT_MULTIPLIER` | no | Per-request deposit is payment amount × this multiplier (must be integer **≥ 3**; default `5`) |
 | `STORAGE_DIR` | no | Persist client session state (defaults to in-memory) |
 | `NUMBER_OF_REQUESTS` | no | How many paid requests to issue (default 3) |
+| `CONCURRENCY` | no | How many channels to run in parallel in `pnpm dev:concurrent` (default 3) |
+| `NUMBER_OF_ROUNDS` | no | How many concurrent rounds to run in `pnpm dev:concurrent` (default 3) |
 | `REFUND_AFTER_REQUESTS` | no | If `true`, issue a self-contained refund via `scheme.refund(url)` after the request loop |
 | `REFUND_AMOUNT` | no | Partial refund amount in base units; omit for a full refund |

e2e/clients/requests/uv.lock

@@ -5,6 +5,7 @@
   "scripts": {
     "start": "tsx index.ts",
     "dev": "tsx index.ts",
+    "dev:concurrent": "tsx concurrent.ts",
     "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
     "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
     "lint": "eslint . --ext .ts --fix",
@@ -29,4 +30,4 @@
     "tsx": "^4.7.0",
     "typescript": "^5.3.0"
   }
-}
+}

e2e/servers/fastapi/uv.lock

@@ -10,7 +10,7 @@ See the [scheme specification](../../../../specs/schemes/batch-settlement/scheme
 
 Every channel commits to a `receiverAuthorizer` — the address whose EIP-712 signatures authorize `claimWithSignature` and `refundWithSignature`. This server lets you choose between two strategies:
 
-### 1. Self-managed
+### 1. Self-managed (recommended)
 
 Set `EVM_RECEIVER_AUTHORIZER_PRIVATE_KEY` to an EOA you own. The scheme uses it to sign claims/refunds locally; **any facilitator** can relay the resulting transactions.
 
@@ -39,7 +39,37 @@ This demo uses local-friendly timing: claim every 1 minute, settle every 2 minut
 
 For production, choose a `withdrawDelay` greater than your claim cadence plus an operational safety margin. A daily claim job pairs well with a `withdrawDelay` longer than one day; settle less frequently when gas savings matter more than receiver cash-flow latency. Idle refunds are usually best on a week-scale cadence unless your product needs faster channel cleanup.
 
-The `ChannelManager` can also be used with one-shot calls such as `claimAndSettle()` and `refundIdleChannels()` from a cron job or external worker.
+The `ChannelManager` runs the server-side lifecycle: claim vouchers from stored channels, settle claimed funds to `payTo`, and optionally refund idle channels. `start()` enables each job at the configured interval, while callbacks let you choose channels, gate settlement, and hook logging/metrics:
+
+```typescript
+manager.start({
+  claimIntervalSecs: 60,
+  settleIntervalSecs: 120,
+  refundIntervalSecs: 180,
+  maxClaimsPerBatch: 100,
+  selectClaimChannels: (channels, { now }) =>
+    channels.filter(
+      channel =>
+        channel.withdrawRequestedAt > 0 ||
+        now - channel.lastRequestTimestamp >= 60_000,
+    ),
+  shouldSettle: ({ pendingSettle }) => pendingSettle,
+  selectRefundChannels: (channels, { now }) =>
+    channels.filter(channel => now - channel.lastRequestTimestamp >= 180_000),
+  onClaim: result => console.log(`Claimed ${result.vouchers} vouchers`),
+  onSettle: result => console.log(`Settled ${result.transaction}`),
+  onRefund: result => console.log(`Refunded ${result.channel}`),
+  onError: error => console.error("Settlement error:", error),
+});
+```
+
+In this example, `selectClaimChannels` prioritizes channels with pending withdrawals and channels idle for at least 1 minute, so their vouchers are claimed before a withdrawal can finalize. The same selection callbacks can be reused with one-shot calls such as `claimAndSettle()` and `refundIdleChannels()` from a cron job or external worker.
+
+## Storage
+
+By default, channel sessions are in memory. Set `STORAGE_DIR` to persist them on disk for local restarts.
+
+For serverless deployments or multi-instance servers, configure the scheme with `RedisChannelStorage`; it stores channel sessions in Redis/Valkey so they survive cold starts and update atomically across processes.
 
 ## Prerequisites
 

e2e/servers/flask/uv.lock

@@ -110,6 +110,7 @@ import { x402ResourceServer } from "@x402/core/server";
 import {
   BatchSettlementEvmScheme,
   FileChannelStorage,
+  RedisChannelStorage,
 } from "@x402/evm/batch-settlement/server";
 
 const scheme = new BatchSettlementEvmScheme(receiverAddress, {
@@ -131,6 +132,14 @@ manager.start({
 });
 ```
 
+For serverless deployments or multi-instance servers, use Redis/Valkey-backed storage so channel updates survive cold starts and are atomic across processes:
+
+```typescript
+const scheme = new BatchSettlementEvmScheme(receiverAddress, {
+  storage: new RedisChannelStorage({ client: redisClient }),
+});
+```
+
 Use the same `selectClaimChannels` policy with one-shot cron jobs when you need to claim a specific channel subset:
 
 ```typescript

examples/typescript/clients/batch-settlement/README.md

@@ -4,15 +4,15 @@ import { keccak256, toBytes } from "viem";
 export const BATCH_SETTLEMENT_SCHEME = "batch-settlement" as const;
 
 /** Deployed address of the x402BatchSettlement contract. */
-export const BATCH_SETTLEMENT_ADDRESS = "0x8f79473b50d67733349191d7349FE45977d44AF7" as const;
+export const BATCH_SETTLEMENT_ADDRESS = "0x4020074e9dF2ce1deE5A9C1b5c3f541D02a10003" as const;
 
 /** Deployed address of the ERC3009DepositCollector contract. */
 export const ERC3009_DEPOSIT_COLLECTOR_ADDRESS =
-  "0xE9460Cb807D97325E70e41De191430Bea39497f5" as const;
+  "0x4020806089470a89826cB9fB1f4059150b550004" as const;
 
 /** Deployed address of the Permit2DepositCollector contract. */
 export const PERMIT2_DEPOSIT_COLLECTOR_ADDRESS =
-  "0x1D859871C289cB1e28DB38077272244C6343F7B9" as const;
+  "0x4020425FAf3B746C082C2f942b4E5159887B0005" as const;
 
 /** Minimum withdraw delay in seconds (15 minutes), matching the onchain constant. */
 export const MIN_WITHDRAW_DELAY = 900;