@zkp2p/cash 0.1.6 → 0.1.8

package/AGENTS.md

@@ -54,6 +54,9 @@ const relayCaps = await cash.capabilities({ includeRelaySources: true });
 // 2. Estimate - idempotent, cacheable, no side effects. Includes rolling ETA.
 const est = await cash.estimate({ amount: usdc(500), currency: 'EUR' });
 
+// Optional: raw demand + speed evidence per offered platform:currency pair.
+const stats = await cash.fillStats();
+
 // 3. Execute.
 const { depositId } = await cash.cashout(
   {
@@ -101,19 +104,28 @@ console.log(routed.source?.transactions?.origin, routed.source?.transactions?.de
   binding rate resolves at the oracle when a buyer fills. Do not display or
   log it as a locked price.
 - **Do not invent an ETA.** Use `estimate().eta`: `{ seconds, label }` backed
-  by rolling 30-day indexer data from zero-spread (`spreadBps: 0`) market-rate
-  deposits in the same payout corridor, measured from deposit creation to first
-  fill. Use `order.explain()` for live order state.
+  by the same rolling 30-day, intent-attributed pair sample as `fillStats()`,
+  measured from deposit creation to first fill. Use `order.explain()` for live
+  order state.
 - **Do not hardcode Relay source assets.** Use Relay SDK-backed EVM
   `capabilities({ includeRelaySources: true })` and `cashout({ source, ... })`.
   Destination is always Base USDC. Non-Base source chains require
   `sourceSigner`. Use `EXACT_INPUT` in high-level cash-out flows so `amount`
   remains source-token base units. `source.amount` is Relay's guaranteed
   minimum output and the exact Base USDC deposit amount.
+- **Use a nonce-managed source signer for routed cashouts.** Relay routes
+  with more than one source-chain transaction (approve, then route) are
+  refused preflight with `SOURCE_NONCE_MANAGER_REQUIRED` on plain local
+  accounts - create the source signer with
+  `privateKeyToAccount(pk, { nonceManager })`. Browser (`json-rpc`) wallets
+  are unaffected.
 - **Persist source evidence.** A routed result carries `requestId`, flat
   `txHashes`, and chain-aware `transactions.origin` / `.destination` arrays.
 - **Never repeat a completed or uncertain route.** On `SOURCE_EXECUTION_FAILED`,
-  inspect its Relay request and transaction recovery evidence. On
+  inspect its Relay request and transaction recovery evidence. A failed
+  approval-only route can sit in `relayStatus` `waiting` indefinitely - decide
+  from the recovery payload and origin transactions, never by waiting for a
+  terminal Relay status. On
   `SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED`, retry without `source` using
   `BigInt(err.recovery.amount)`. On `SOURCE_CASHOUT_SUBMISSION_UNKNOWN`, inspect
   Base wallet activity and `orders(err.recovery.depositor)`. On
@@ -128,7 +140,8 @@ console.log(routed.source?.transactions?.origin, routed.source?.transactions?.de
   deposit. The tx receipt you hold is the truth. Retry; `watch()` absorbs
   this automatically.
 - **Unwind with `withdraw()` only.** It is state-aware (prunes expired
-  intents first). Do not call escrow functions directly.
+  intents first). Do not call escrow functions directly. Partial withdrawals
+  increment `returnedAmount`; `totalAmount` is historical and never shrinks.
 - **Read fills as receipts.** `fiatOwed` is the buyer's obligation at the
   locked rate; after the proof, `fiatPaid`/`paymentId`/`releasedAmount` are
   the verified outcome. Reconcile against those, not your own math.
@@ -161,6 +174,7 @@ Every `CashError` carries `code`, `retryable`, `remediation`. Behavior:
 | `SOURCE_RECIPIENT_MISMATCH`             | no        | Route Base USDC to the cashout depositor                                                   |
 | `SOURCE_CAPABILITIES_FAILED`            | yes       | Retry discovery or fall back to Base USDC                                                  |
 | `SOURCE_QUOTE_FAILED`                   | yes       | Refresh capabilities and request a new canonical Base-USDC quote                           |
+| `SOURCE_NONCE_MANAGER_REQUIRED`         | no        | Preflight; recreate the source signer with viem's `nonceManager`, then quote again         |
 | `SOURCE_EXECUTION_FAILED`               | no        | Inspect source transactions and Relay status before any retry                              |
 | `SOURCE_STATUS_FAILED`                  | yes       | Retry only the status read                                                                 |
 | `SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED` | no        | Do not route again; retry Base-only with `recovery.amount`                                 |

package/README.md

@@ -76,6 +76,7 @@ console.log(source?.transactions?.origin, source?.transactions?.destination);
 | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
 | `capabilities()`                                               | Sync discovery: Base USDC destination/default source, platforms × currencies × payee hints × amount bounds                      |
 | `capabilities({ includeRelaySources: true })`                  | Async discovery: adds live Relay SDK EVM source chains/tokens                                                                   |
+| `fillStats()`                                                  | Raw 30-day fill counts and median first-fill time per `platform:currency` pair                                                  |
 | `quoteSource(input)` / `executeSourceQuote(quote, { signer })` | Relay SDK EVM source routing into Base USDC before cashout                                                                      |
 | `relayStatus(requestId)`                                       | Relay request status from the Relay SDK request path                                                                            |
 | `estimate({ amount, currency })`                               | Base USDC oracle estimate plus simple recent-fill ETA                                                                           |
@@ -97,6 +98,11 @@ must execute and confirm its Relay route before preparing the Base-USDC
 cashout. Every Peer Cash transaction, including approves, carries ERC-8021
 attribution: `peer-cash` first, your own `referrer` code(s) after it.
 
+`capabilities()` presents Zelle as one platform. A cashout with
+`receive.platform: 'zelle'` automatically attaches the generic Zelle method
+and its Chase, Bank of America, and Citi buyer routes to the deposit; the payee
+handle and public API remain bank-agnostic.
+
 The default/minimal flow is unchanged: pass Base USDC base units to
 `estimate()` and `cashout()`. For any other source asset, pass `source` to
 `cashout()` with a source-chain signer. The SDK settles the Base allowance,
@@ -107,6 +113,13 @@ The destination is always canonical Base USDC
 discovered and quoted by `@relayprotocol/relay-sdk`, not a static token
 allowlist.
 
+Routes that submit more than one source-chain transaction (approve, then
+route) require a nonce-managed source signer -
+`privateKeyToAccount(pk, { nonceManager })` from viem. Without one the SDK
+refuses the route preflight with `SOURCE_NONCE_MANAGER_REQUIRED` instead of
+letting the route transaction reuse the approval's nonce and revert
+mid-route. Browser wallets are unaffected.
+
 `capabilities()` tells you which platforms need a verified identity for a new
 payee registration (`requiresIdentityAttestation` - Wise and PayPal today).
 An already-registered Wise or PayPal handle can be reused with bare payee data.
@@ -120,6 +133,10 @@ they are available. A source-routed result includes both a flat
 `source.txHashes` list and chain-aware `source.transactions.origin` /
 `.destination` entries.
 
+- `SOURCE_EXECUTION_FAILED` where only the approval landed: the Relay request
+  can stay in `relayStatus` `waiting` indefinitely. Decide from the error's
+  recovery payload and origin transactions, never by waiting for a terminal
+  Relay status.
 - `SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED`: Relay completed, but the Base
   cashout was not created. Do not route again. Retry a Base-USDC-only
   `cashout()` with `BigInt(error.recovery.amount)`.
@@ -161,9 +178,12 @@ awaiting-buyer ──────────► matched ───────
   fills. `estimate()` says "approximately"; nothing in this API pretends to
   lock a price.
 - **ETA is historical.** `estimate().eta` is just `{ seconds, label }`, backed
-  by rolling 30-day indexer data from zero-spread (`spreadBps: 0`) market-rate
-  deposits in the same payout corridor, measured from deposit creation to first
-  fulfilled fill.
+  by the same rolling 30-day, intent-attributed pair sampler as `fillStats()`,
+  measured from deposit creation to the first fulfilled fill through the pair.
+- **Availability thresholds belong to the consumer.** `fillStats()` returns raw
+  evidence. A recommended gate is `fills >= 10 && medianFillSeconds <= 48h`.
+  Fail open to the full `capabilities()` catalog when stats are unavailable or
+  the gate would empty the offered catalog.
 - **Everything is resumable.** An order is reconstructed from the chain by
   `depositId` alone. Close the tab, switch devices, crash the process - then
   call `order(depositId)`.

package/dist/{chunk-P3KYZ2FX.js → chunk-TR6JVYYF.js}

@@ -189,6 +189,12 @@ var errors = {
     },
     { cause }
   ),
+  sourceNonceManagerRequired: (transactionCount) => new CashError({
+    code: "SOURCE_NONCE_MANAGER_REQUIRED",
+    message: `This Relay route submits ${transactionCount} source-chain transactions, but the local signer has no nonce manager; the route transaction would reuse the approval nonce and revert.`,
+    retryable: false,
+    remediation: `Create the source signer with viem's nonce manager - privateKeyToAccount(pk, { nonceManager }) - then request a fresh quote and retry. No transaction was submitted.`
+  }),
   sourceExecutionFailed: (cause, evidence) => new CashError(
     {
       code: "SOURCE_EXECUTION_FAILED",

package/dist/{createCashClient-jUA_GNdh.d.cts → createCashClient-BIzOLHjF.d.cts}

@@ -357,6 +357,14 @@ interface CashCapabilities {
 }
 declare function buildCapabilities(environment: RuntimeEnv): CashCapabilities;
 
+interface CashPairFillStats {
+    /** Fulfilled intents through this pair inside the rolling 30-day window. */
+    fills: number;
+    /** Median deposit-to-first-fill seconds, sampled once per deposit for this pair. */
+    medianFillSeconds?: number;
+}
+/** Raw demand and speed evidence keyed by `basePlatform:currencyCode`. */
+type CashFillStats = Record<string, CashPairFillStats>;
 interface CashFillEta {
     /** Simple headline ETA from recent deposits. Undefined when no recent sample exists. */
     seconds?: number;
@@ -581,6 +589,13 @@ interface CashClient {
     capabilities(options: {
         includeRelaySources: true;
     }): Promise<CashCapabilities>;
+    /**
+     * 0c - Raw 30-day demand and first-fill speed evidence keyed by
+     * `platform:currency`. A recommended consumer gate is `fills >= 10 &&
+     * medianFillSeconds <= 48h`; fail open to the full capability catalog when
+     * stats are unavailable or the gate would remove every pair.
+     */
+    fillStats(): Promise<CashFillStats>;
     /** Relay-only source discovery helper. */
     sourceCapabilities(): Promise<CashSourceCapabilities>;
     /** Quote any Relay-supported EVM source asset into Base USDC. */
@@ -640,4 +655,4 @@ interface CashClient {
 }
 declare function createCashClient(options: CashClientOptions): CashClient;
 
-export { type CashoutInput as A, type CashoutOptions as B, type CashPayoutInfo as C, type CuratorPayeeDataInput as D, type EstimateInput as E, RECOMMENDED_MIN_CASHOUT_AMOUNT as F, type RelayOptions as G, type RelayQuoteInput as H, type IntentStatus as I, type RelaySourceInput as J, type RelayTransaction as K, type WatchOptions as L, MIN_CASHOUT_AMOUNT as M, type WithdrawOptions as N, type OrdersOptions as O, type PrepareResult as P, buildCapabilities as Q, type RelayExecutionResult as R, type SignerOptions as S, type TopUpResult as T, createCashClient as U, type WithdrawResult as W, type IntentEntity as a, type CashBuyerProfile as b, type CashDepositInput as c, type CreateDepositParamsArg as d, type CashOrder as e, type CashFill as f, type CashCapabilities as g, type CashoutResult as h, type CashEstimate as i, type CashPreparedStep as j, type RelayQuote as k, type RelayStatus as l, type CashSourceCapabilities as m, CASH_ATTRIBUTION_CODE as n, type CashAsset as o, type CashChain as p, type CashClient as q, type CashClientOptions as r, type CashFillEta as s, type CashLeg as t, type CashNextAction as u, type CashOrderState as v, type CashPayout as w, type CashPayoutPricing as x, type CashPlatformCapability as y, type CashPreparedStepKind as z };
+export { type CashPlatformCapability as A, type CashPreparedStepKind as B, type CashPayoutInfo as C, type CashoutInput as D, type CashoutOptions as E, type CuratorPayeeDataInput as F, type EstimateInput as G, RECOMMENDED_MIN_CASHOUT_AMOUNT as H, type IntentStatus as I, type RelayOptions as J, type RelayQuoteInput as K, type RelaySourceInput as L, MIN_CASHOUT_AMOUNT as M, type RelayTransaction as N, type OrdersOptions as O, type PrepareResult as P, type WatchOptions as Q, type RelayExecutionResult as R, type SignerOptions as S, type TopUpResult as T, type WithdrawOptions as U, buildCapabilities as V, type WithdrawResult as W, createCashClient as X, type IntentEntity as a, type CashBuyerProfile as b, type CashDepositInput as c, type CreateDepositParamsArg as d, type CashOrder as e, type CashFill as f, type CashCapabilities as g, type CashoutResult as h, type CashEstimate as i, type CashFillStats as j, type CashPreparedStep as k, type RelayQuote as l, type RelayStatus as m, type CashSourceCapabilities as n, CASH_ATTRIBUTION_CODE as o, type CashAsset as p, type CashChain as q, type CashClient as r, type CashClientOptions as s, type CashFillEta as t, type CashLeg as u, type CashNextAction as v, type CashOrderState as w, type CashPairFillStats as x, type CashPayout as y, type CashPayoutPricing as z };

package/dist/{createCashClient-jUA_GNdh.d.ts → createCashClient-BIzOLHjF.d.ts}

@@ -357,6 +357,14 @@ interface CashCapabilities {
 }
 declare function buildCapabilities(environment: RuntimeEnv): CashCapabilities;
 
+interface CashPairFillStats {
+    /** Fulfilled intents through this pair inside the rolling 30-day window. */
+    fills: number;
+    /** Median deposit-to-first-fill seconds, sampled once per deposit for this pair. */
+    medianFillSeconds?: number;
+}
+/** Raw demand and speed evidence keyed by `basePlatform:currencyCode`. */
+type CashFillStats = Record<string, CashPairFillStats>;
 interface CashFillEta {
     /** Simple headline ETA from recent deposits. Undefined when no recent sample exists. */
     seconds?: number;
@@ -581,6 +589,13 @@ interface CashClient {
     capabilities(options: {
         includeRelaySources: true;
     }): Promise<CashCapabilities>;
+    /**
+     * 0c - Raw 30-day demand and first-fill speed evidence keyed by
+     * `platform:currency`. A recommended consumer gate is `fills >= 10 &&
+     * medianFillSeconds <= 48h`; fail open to the full capability catalog when
+     * stats are unavailable or the gate would remove every pair.
+     */
+    fillStats(): Promise<CashFillStats>;
     /** Relay-only source discovery helper. */
     sourceCapabilities(): Promise<CashSourceCapabilities>;
     /** Quote any Relay-supported EVM source asset into Base USDC. */
@@ -640,4 +655,4 @@ interface CashClient {
 }
 declare function createCashClient(options: CashClientOptions): CashClient;
 
-export { type CashoutInput as A, type CashoutOptions as B, type CashPayoutInfo as C, type CuratorPayeeDataInput as D, type EstimateInput as E, RECOMMENDED_MIN_CASHOUT_AMOUNT as F, type RelayOptions as G, type RelayQuoteInput as H, type IntentStatus as I, type RelaySourceInput as J, type RelayTransaction as K, type WatchOptions as L, MIN_CASHOUT_AMOUNT as M, type WithdrawOptions as N, type OrdersOptions as O, type PrepareResult as P, buildCapabilities as Q, type RelayExecutionResult as R, type SignerOptions as S, type TopUpResult as T, createCashClient as U, type WithdrawResult as W, type IntentEntity as a, type CashBuyerProfile as b, type CashDepositInput as c, type CreateDepositParamsArg as d, type CashOrder as e, type CashFill as f, type CashCapabilities as g, type CashoutResult as h, type CashEstimate as i, type CashPreparedStep as j, type RelayQuote as k, type RelayStatus as l, type CashSourceCapabilities as m, CASH_ATTRIBUTION_CODE as n, type CashAsset as o, type CashChain as p, type CashClient as q, type CashClientOptions as r, type CashFillEta as s, type CashLeg as t, type CashNextAction as u, type CashOrderState as v, type CashPayout as w, type CashPayoutPricing as x, type CashPlatformCapability as y, type CashPreparedStepKind as z };
+export { type CashPlatformCapability as A, type CashPreparedStepKind as B, type CashPayoutInfo as C, type CashoutInput as D, type CashoutOptions as E, type CuratorPayeeDataInput as F, type EstimateInput as G, RECOMMENDED_MIN_CASHOUT_AMOUNT as H, type IntentStatus as I, type RelayOptions as J, type RelayQuoteInput as K, type RelaySourceInput as L, MIN_CASHOUT_AMOUNT as M, type RelayTransaction as N, type OrdersOptions as O, type PrepareResult as P, type WatchOptions as Q, type RelayExecutionResult as R, type SignerOptions as S, type TopUpResult as T, type WithdrawOptions as U, buildCapabilities as V, type WithdrawResult as W, createCashClient as X, type IntentEntity as a, type CashBuyerProfile as b, type CashDepositInput as c, type CreateDepositParamsArg as d, type CashOrder as e, type CashFill as f, type CashCapabilities as g, type CashoutResult as h, type CashEstimate as i, type CashFillStats as j, type CashPreparedStep as k, type RelayQuote as l, type RelayStatus as m, type CashSourceCapabilities as n, CASH_ATTRIBUTION_CODE as o, type CashAsset as p, type CashChain as q, type CashClient as r, type CashClientOptions as s, type CashFillEta as t, type CashLeg as u, type CashNextAction as v, type CashOrderState as w, type CashPairFillStats as x, type CashPayout as y, type CashPayoutPricing as z };

package/dist/index.cjs

@@ -403,6 +403,26 @@ function parseCompositeDepositId(compositeId) {
   const onchainDepositId = BigInt(rawDepositId);
   return { escrowAddress: canonicalEscrowAddress, onchainDepositId };
 }
+
+// src/client/platformGroups.ts
+var PLATFORM_METHOD_GROUPS = {
+  zelle: ["zelle", "zelle-chase", "zelle-bofa", "zelle-citi"]
+};
+var METHOD_TO_BASE_PLATFORM = new Map(
+  Object.entries(PLATFORM_METHOD_GROUPS).flatMap(
+    ([platform, methods]) => methods.map((method) => [method, platform])
+  )
+);
+function basePlatformForMethod(method) {
+  return METHOD_TO_BASE_PLATFORM.get(method) ?? method;
+}
+function paymentMethodsForPlatform(platform, catalog) {
+  const configured = PLATFORM_METHOD_GROUPS[platform];
+  const methods = configured ?? [platform];
+  return methods.filter((method) => catalog[method] !== void 0);
+}
+
+// src/client/capabilities.ts
 var MIN_CASHOUT_AMOUNT = 10000n;
 var RECOMMENDED_MIN_CASHOUT_AMOUNT = 1000000n;
 var PAYEE_HINTS = {
@@ -421,13 +441,20 @@ var PAYEE_HINTS = {
 var IDENTITY_ATTESTATION_PLATFORMS = /* @__PURE__ */ new Set(["wise", "paypal"]);
 function buildCapabilities(environment) {
   const catalog = sdk.getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
-  const platforms = Object.entries(catalog).map(([platform, entry]) => {
+  const currenciesByPlatform = /* @__PURE__ */ new Map();
+  for (const [method, entry] of Object.entries(catalog)) {
+    const platform = basePlatformForMethod(method);
     const currencies2 = (entry.currencies ?? []).map((hash) => sdk.getCurrencyCodeFromHash(hash)).filter(
       (code) => code != null && isMarketRateSupported(code)
     );
+    const aggregate = currenciesByPlatform.get(platform) ?? /* @__PURE__ */ new Set();
+    for (const currency of currencies2) aggregate.add(currency);
+    currenciesByPlatform.set(platform, aggregate);
+  }
+  const platforms = [...currenciesByPlatform.entries()].map(([platform, currencies2]) => {
     return {
       platform,
-      currencies: [...new Set(currencies2)],
+      currencies: [...currencies2].sort(),
       payeeHint: PAYEE_HINTS[platform] ?? "Your payment handle for this platform",
       requiresIdentityAttestation: IDENTITY_ATTESTATION_PLATFORMS.has(platform)
     };
@@ -623,6 +650,12 @@ var errors = {
     },
     { cause }
   ),
+  sourceNonceManagerRequired: (transactionCount) => new CashError({
+    code: "SOURCE_NONCE_MANAGER_REQUIRED",
+    message: `This Relay route submits ${transactionCount} source-chain transactions, but the local signer has no nonce manager; the route transaction would reuse the approval nonce and revert.`,
+    retryable: false,
+    remediation: `Create the source signer with viem's nonce manager - privateKeyToAccount(pk, { nonceManager }) - then request a fresh quote and retry. No transaction was submitted.`
+  }),
   sourceExecutionFailed: (cause, evidence) => new CashError(
     {
       code: "SOURCE_EXECUTION_FAILED",
@@ -803,11 +836,8 @@ function mapChainError(verb, err, context = {}) {
   }
   return errors.chainCallFailed(verb, err);
 }
-var ETA_WINDOW_DAYS = 30;
-var ETA_WINDOW_SECONDS = ETA_WINDOW_DAYS * 24 * 60 * 60;
-var ETA_PAGE_LIMIT = 250;
-var ETA_MAX_DEPOSIT_SCAN = 2e3;
-var FULFILLED = /* @__PURE__ */ new Set(["FULFILLED", "MANUALLY_RELEASED"]);
+var FILL_STATS_WINDOW_SECONDS = 30 * 24 * 60 * 60;
+var FILL_STATS_PAGE_LIMIT = 250;
 function toUnixSeconds2(value) {
   if (value === null || value === void 0 || value === "") return void 0;
   if (value instanceof Date) {
@@ -818,12 +848,22 @@ function toUnixSeconds2(value) {
     const parsed = Date.parse(value);
     if (Number.isFinite(parsed)) return Math.floor(parsed / 1e3);
   }
-  const n = Number(value);
-  return Number.isFinite(n) && n > 0 ? n : void 0;
+  const numeric = Number(value);
+  return Number.isFinite(numeric) && numeric > 0 ? numeric : void 0;
+}
+function normalizeCurrencyCode(value) {
+  const raw = value?.trim();
+  if (!raw) return void 0;
+  if (!raw.toLowerCase().startsWith("0x")) return raw.toUpperCase();
+  try {
+    return sdk.getCurrencyCodeFromHash(raw)?.toUpperCase();
+  } catch {
+    return void 0;
+  }
 }
 function median(values) {
   if (values.length === 0) return void 0;
-  const sorted = [...values].sort((a, b) => a - b);
+  const sorted = [...values].sort((left, right) => left - right);
   const mid = Math.floor(sorted.length / 2);
   return sorted.length % 2 === 1 ? sorted[mid] : Math.round((sorted[mid - 1] + sorted[mid]) / 2);
 }
@@ -835,47 +875,97 @@ function etaLabel(seconds) {
   const hours = Math.max(1, Math.round(minutes / 60));
   return `Usually starts in about ${hours} hr`;
 }
-function matchesPayout(deposit, environment, platform, currency) {
-  const payouts = derivePayouts(
-    deposit.paymentMethods ?? [],
-    deposit.currencies ?? [],
-    sdk.getPaymentMethodsCatalog(BASE_CHAIN_ID, environment)
-  );
-  return payouts.some(
-    (payout) => payout.pricing.marketRate && payout.pricing.spreadBps === 0 && (platform === void 0 || payout.platform === platform) && (currency === void 0 || payout.currency === currency)
-  );
+function computeFillStatsSample(deposits, nowSeconds, environment) {
+  const catalog = sdk.getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
+  const windowStart = nowSeconds - FILL_STATS_WINDOW_SECONDS;
+  const fillCounts = /* @__PURE__ */ new Map();
+  const latenciesByPair = /* @__PURE__ */ new Map();
+  const latenciesByCurrency = /* @__PURE__ */ new Map();
+  for (const deposit of deposits) {
+    const createdAt = toUnixSeconds2(deposit.createdAt ?? deposit.timestamp);
+    const firstFillByPair = /* @__PURE__ */ new Map();
+    const firstFillByCurrency = /* @__PURE__ */ new Map();
+    for (const intent of deposit.intents ?? []) {
+      const fulfilledAt = toUnixSeconds2(intent.fulfillTimestamp);
+      if (fulfilledAt === void 0 || fulfilledAt < windowStart) continue;
+      let method;
+      try {
+        method = intent.paymentMethodHash ? sdk.resolvePaymentMethodNameFromHash(intent.paymentMethodHash, catalog) : void 0;
+      } catch {
+        method = void 0;
+      }
+      const currency = normalizeCurrencyCode(intent.fiatCurrency);
+      if (!method || !currency) continue;
+      const pair = `${basePlatformForMethod(method)}:${currency}`;
+      fillCounts.set(pair, (fillCounts.get(pair) ?? 0) + 1);
+      if (createdAt === void 0 || createdAt < windowStart || fulfilledAt < createdAt) continue;
+      const previousPairFill = firstFillByPair.get(pair);
+      if (previousPairFill === void 0 || fulfilledAt < previousPairFill) {
+        firstFillByPair.set(pair, fulfilledAt);
+      }
+      const previousCurrencyFill = firstFillByCurrency.get(currency);
+      if (previousCurrencyFill === void 0 || fulfilledAt < previousCurrencyFill) {
+        firstFillByCurrency.set(currency, fulfilledAt);
+      }
+    }
+    if (createdAt === void 0) continue;
+    for (const [pair, firstFill] of firstFillByPair) {
+      const latencies = latenciesByPair.get(pair) ?? [];
+      latencies.push(firstFill - createdAt);
+      latenciesByPair.set(pair, latencies);
+    }
+    for (const [currency, firstFill] of firstFillByCurrency) {
+      const latencies = latenciesByCurrency.get(currency) ?? [];
+      latencies.push(firstFill - createdAt);
+      latenciesByCurrency.set(currency, latencies);
+    }
+  }
+  const stats = {};
+  for (const [pair, fills] of fillCounts) {
+    const medianFillSeconds = median(latenciesByPair.get(pair) ?? []);
+    stats[pair] = {
+      fills,
+      ...medianFillSeconds !== void 0 ? { medianFillSeconds } : {}
+    };
+  }
+  const medianFillSecondsByCurrency = /* @__PURE__ */ new Map();
+  for (const [currency, latencies] of latenciesByCurrency) {
+    const value = median(latencies);
+    if (value !== void 0) medianFillSecondsByCurrency.set(currency, value);
+  }
+  return { stats, medianFillSecondsByCurrency };
 }
-async function readFillEta(client, input) {
+async function readFillStatsSample(client, environment) {
   const now = Math.floor(Date.now() / 1e3);
-  const windowStart = now - ETA_WINDOW_SECONDS;
+  const windowStart = now - FILL_STATS_WINDOW_SECONDS;
   const deposits = [];
-  for (let offset = 0; offset < ETA_MAX_DEPOSIT_SCAN; offset += ETA_PAGE_LIMIT) {
+  for (let offset = 0; ; offset += FILL_STATS_PAGE_LIMIT) {
     const page = await client.indexer.getDepositsWithRelations(
       { chainId: BASE_CHAIN_ID },
-      { limit: ETA_PAGE_LIMIT, offset, orderBy: "timestamp", orderDirection: "desc" },
+      {
+        limit: FILL_STATS_PAGE_LIMIT,
+        offset,
+        orderBy: "updatedAt",
+        orderDirection: "desc"
+      },
       { includeIntents: true, intentStatuses: ["FULFILLED", "MANUALLY_RELEASED"] }
     );
     deposits.push(...page);
-    if (page.length < ETA_PAGE_LIMIT) break;
-    const oldestCreatedAt = Math.min(
-      ...page.map((deposit) => toUnixSeconds2(deposit.createdAt ?? deposit.timestamp) ?? Infinity)
+    if (page.length < FILL_STATS_PAGE_LIMIT) break;
+    const oldestUpdatedAt = Math.min(
+      ...page.map((deposit) => toUnixSeconds2(deposit.updatedAt) ?? Infinity)
     );
-    if (oldestCreatedAt < windowStart) break;
+    if (oldestUpdatedAt < windowStart) break;
   }
-  const firstFillLatencies = [];
-  for (const deposit of deposits) {
-    const createdAt = toUnixSeconds2(deposit.createdAt ?? deposit.timestamp);
-    if (createdAt === void 0 || createdAt < windowStart) continue;
-    if (!matchesPayout(deposit, input.environment, input.platform, input.currency)) continue;
-    const fulfilled = (deposit.intents ?? []).filter((intent) => intent.status != null && FULFILLED.has(intent.status)).map((intent) => ({
-      fulfilledAt: toUnixSeconds2(intent.fulfillTimestamp)
-    })).filter(
-      (intent) => intent.fulfilledAt !== void 0 && intent.fulfilledAt >= createdAt
-    ).sort((a, b) => a.fulfilledAt - b.fulfilledAt);
-    if (fulfilled.length === 0) continue;
-    firstFillLatencies.push(fulfilled[0].fulfilledAt - createdAt);
-  }
-  const seconds = median(firstFillLatencies);
+  return computeFillStatsSample(deposits, now, environment);
+}
+async function readFillStats(client, environment) {
+  return (await readFillStatsSample(client, environment)).stats;
+}
+async function readFillEta(client, input) {
+  const sample = await readFillStatsSample(client, input.environment);
+  const currency = input.currency.toUpperCase();
+  const seconds = input.platform ? sample.stats[`${basePlatformForMethod(input.platform)}:${currency}`]?.medianFillSeconds : sample.medianFillSecondsByCurrency.get(currency);
   return {
     ...seconds !== void 0 ? { seconds } : {},
     label: etaLabel(seconds)
@@ -1048,6 +1138,14 @@ async function assertRelayExecutionIdentity(quote, wallet, expectedRecipient) {
     throw new Error("Relay quote recipient does not match the expected Base recipient");
   }
 }
+function assertRelayNonceManagement(quote, wallet) {
+  const account = wallet.account;
+  if (!account || account.type !== "local" || account.nonceManager !== void 0) return;
+  const transactionCount = quote.steps.flatMap(
+    (step) => step.items.filter((item) => asString(asRecord(item.data).to) !== void 0)
+  ).length;
+  if (transactionCount > 1) throw errors.sourceNonceManagerRequired(transactionCount);
+}
 function isRelaySecretKey(key) {
   const normalized = key.toLowerCase();
   return normalized === "headers" || normalized === "apikey";
@@ -1249,6 +1347,7 @@ async function executeRelayQuote(quote, wallet, options = {}) {
     observedRequestId = quoteRequestId(rawQuote);
     assertCanonicalRelayDestination(rawQuote);
     await assertRelayExecutionIdentity(rawQuote, wallet, options.recipient);
+    assertRelayNonceManagement(rawQuote, wallet);
     const client = relayClient(options.relay);
     const sourceChainId = quoteSourceChainId(rawQuote);
     if (sourceChainId !== void 0 && !(client.chains ?? []).some((chain) => chain.id === sourceChainId)) {
@@ -1534,6 +1633,7 @@ function createCashClient(options) {
   }
   function validatePayout(input) {
     const { receive } = input;
+    const catalog = sdk.getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
     const platform = buildCapabilities(environment).platforms.find(
       (capability) => capability.platform === receive.platform
     );
@@ -1544,14 +1644,13 @@ function createCashClient(options) {
     if (!platform.currencies.includes(receive.currency)) {
       throw errors.unsupportedPlatformCurrency(receive.platform, receive.currency);
     }
+    const paymentMethods = paymentMethodsForPlatform(receive.platform, catalog);
     return {
-      payouts: [
-        {
-          processorName: receive.platform,
-          currency: receive.currency,
-          payeeData: receive.payee
-        }
-      ]
+      payouts: paymentMethods.map((processorName) => ({
+        processorName,
+        currency: receive.currency,
+        payeeData: receive.payee
+      }))
     };
   }
   function validateDepositInput(amount, input, payoutInput = validatePayout(input)) {
@@ -1829,6 +1928,13 @@ function createCashClient(options) {
         ...options.relay ? { relay: options.relay } : {}
       });
     },
+    async fillStats() {
+      try {
+        return await readFillStats(readClient, environment);
+      } catch (err) {
+        throw errors.indexerUnavailable("fill stats", err);
+      }
+    },
     async cashout(input, opts) {
       const client = await signingClient("cashout", opts);
       const owner = opts.signer.account.address;
@@ -2428,6 +2534,11 @@ var cashEstimateJsonSchema = zod.z.object({
     label: zod.z.string()
   }).optional()
 });
+var cashPairFillStatsJsonSchema = zod.z.object({
+  fills: zod.z.number().int().nonnegative(),
+  medianFillSeconds: zod.z.number().int().nonnegative().optional()
+}).strict();
+var cashFillStatsJsonSchema = zod.z.record(zod.z.string(), cashPairFillStatsJsonSchema);
 var preparedTransactionJsonSchema = zod.z.object({
   to: zod.z.string(),
   data: zod.z.string(),
@@ -2559,6 +2670,7 @@ var CASH_ERROR_CODES = defineCashErrorCodes([
   "SOURCE_RECIPIENT_MISMATCH",
   "SOURCE_CAPABILITIES_FAILED",
   "SOURCE_QUOTE_FAILED",
+  "SOURCE_NONCE_MANAGER_REQUIRED",
   "SOURCE_EXECUTION_FAILED",
   "SOURCE_STATUS_FAILED",
   "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED",
@@ -2731,6 +2843,21 @@ function estimateFromJson(json) {
     } : void 0
   });
 }
+function fillStatsToJson(stats) {
+  return cashFillStatsJsonSchema.parse(stats);
+}
+function fillStatsFromJson(json) {
+  const parsed = cashFillStatsJsonSchema.parse(json);
+  return Object.fromEntries(
+    Object.entries(parsed).map(([pair, stats]) => [
+      pair,
+      {
+        fills: stats.fills,
+        ...stats.medianFillSeconds !== void 0 ? { medianFillSeconds: stats.medianFillSeconds } : {}
+      }
+    ])
+  );
+}
 function cashAssetFromJson(asset) {
   return {
     chainId: asset.chainId,
@@ -3039,9 +3166,11 @@ exports.cashErrorRecoveryJsonSchema = cashErrorRecoveryJsonSchema;
 exports.cashErrorToJson = cashErrorToJson;
 exports.cashEstimateJsonSchema = cashEstimateJsonSchema;
 exports.cashFillJsonSchema = cashFillJsonSchema;
+exports.cashFillStatsJsonSchema = cashFillStatsJsonSchema;
 exports.cashNextActionSchema = cashNextActionSchema;
 exports.cashOrderJsonSchema = cashOrderJsonSchema;
 exports.cashOrderStateSchema = cashOrderStateSchema;
+exports.cashPairFillStatsJsonSchema = cashPairFillStatsJsonSchema;
 exports.cashPayoutInfoJsonSchema = cashPayoutInfoJsonSchema;
 exports.cashPayoutPricingJsonSchema = cashPayoutPricingJsonSchema;
 exports.cashPreparedStepJsonSchema = cashPreparedStepJsonSchema;
@@ -3061,6 +3190,8 @@ exports.explainOrder = explainOrder;
 exports.fiatFromUsdc = fiatFromUsdc;
 exports.fiatToNumber = fiatToNumber;
 exports.fillFromJson = fillFromJson;
+exports.fillStatsFromJson = fillStatsFromJson;
+exports.fillStatsToJson = fillStatsToJson;
 exports.fillToJson = fillToJson;
 exports.formatUsdc = formatUsdc;
 exports.intentStatusSchema = intentStatusSchema;