@zkp2p/cash 0.1.7 → 0.1.9

package/AGENTS.md

@@ -54,6 +54,12 @@ 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' });
 
+// Progressive UI: do not let indexer-backed history hold up the oracle rate.
+const rateOnly = await cash.estimate({ amount: usdc(500), currency: 'EUR' }, { includeEta: false });
+
+// Optional: raw demand + speed evidence per offered platform:currency pair.
+const stats = await cash.fillStats();
+
 // 3. Execute.
 const { depositId } = await cash.cashout(
   {
@@ -101,9 +107,11 @@ 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. For progressive UIs, call `estimate(..., { includeEta: false })`
+  and load `fillStats()["platform:CURRENCY"]` separately. The SDK caches the
+  raw snapshot for 15 minutes, but never substitutes another pair's data.
 - **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

package/README.md

@@ -34,6 +34,13 @@ const est = await cash.estimate({ amount: usdc(1000), currency: 'USD' });
 // { rate: 1, receiveAmount: 1000, kind: 'oracle-estimate', eta: { seconds, label } }
 // "≈", never a locked quote. Base USDC remains the default source.
 
+// Progressive UI: render rate/receive first, then resolve the exact pair ETA.
+const rateOnly = await cash.estimate(
+  { amount: usdc(1000), currency: 'USD' },
+  { includeEta: false },
+);
+const pairStats = (await cash.fillStats())['venmo:USD'];
+
 const { depositId } = await cash.cashout(
   {
     amount: usdc(1000),
@@ -76,9 +83,10 @@ 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()`                                                  | Cached 30-day fill counts and median first-fill time per exact `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                                                                           |
+| `estimate({ amount, currency }, { includeEta? })`              | Base USDC oracle estimate; optionally skip the historical ETA for progressive rendering                                         |
 | `cashout(input, { signer })`                                   | Registers your payee, creates the protocol-held order, returns the `depositId`                                                  |
 | `order(depositId)` / `orders(owner)`                           | Resume any order from its id alone; list all orders for a wallet                                                                |
 | `watch(depositId)`                                             | Async iterator: yields on every state change until terminal, abort, or timeout                                                  |
@@ -97,6 +105,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,
@@ -172,9 +185,15 @@ 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.
+  The raw snapshot is cached for 15 minutes per client and each ETA is still
+  resolved from its exact normalized `platform:currency` key. Use
+  `{ includeEta: false }` when rate and receive amount should render first.
+- **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/{createCashClient-jUA_GNdh.d.cts → createCashClient-BhOytyHE.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;
@@ -393,6 +401,13 @@ interface EstimateInput {
         tradeType?: 'EXACT_INPUT' | 'EXACT_OUTPUT' | 'EXPECTED_OUTPUT';
     };
 }
+interface EstimateOptions {
+    /**
+     * Include the historical indexer-backed ETA. Disable for progressive UIs
+     * that render the oracle rate first and load pair fill stats separately.
+     */
+    includeEta?: boolean;
+}
 interface CashEstimate {
     /** Always `'oracle-estimate'` - there is no committed quote in Peer Cash. */
     kind: 'oracle-estimate';
@@ -581,6 +596,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. */
@@ -597,7 +619,7 @@ interface CashClient {
     /** Track Relay execution status by quote/request id. */
     relayStatus(requestId: string): Promise<RelayStatus>;
     /** 1 - Estimate: currency + amount only. No payee, no side effects, no expiry. */
-    estimate(input: EstimateInput): Promise<CashEstimate>;
+    estimate(input: EstimateInput, options?: EstimateOptions): Promise<CashEstimate>;
     /** 2 - Cash out: payee registration + deposit params + submission happen here. */
     cashout(input: CashoutInput, opts: CashoutOptions): Promise<CashoutResult>;
     /** 2b - Unsigned path: `txs[]` for agent wallets, AA, server keys, policy layers. */
@@ -640,4 +662,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, type EstimateOptions as H, type IntentStatus as I, RECOMMENDED_MIN_CASHOUT_AMOUNT as J, type RelayOptions as K, type RelayQuoteInput as L, MIN_CASHOUT_AMOUNT as M, type RelaySourceInput as N, type OrdersOptions as O, type PrepareResult as P, type RelayTransaction as Q, type RelayExecutionResult as R, type SignerOptions as S, type TopUpResult as T, type WatchOptions as U, type WithdrawOptions as V, type WithdrawResult as W, buildCapabilities as X, createCashClient as Y, 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-BhOytyHE.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;
@@ -393,6 +401,13 @@ interface EstimateInput {
         tradeType?: 'EXACT_INPUT' | 'EXACT_OUTPUT' | 'EXPECTED_OUTPUT';
     };
 }
+interface EstimateOptions {
+    /**
+     * Include the historical indexer-backed ETA. Disable for progressive UIs
+     * that render the oracle rate first and load pair fill stats separately.
+     */
+    includeEta?: boolean;
+}
 interface CashEstimate {
     /** Always `'oracle-estimate'` - there is no committed quote in Peer Cash. */
     kind: 'oracle-estimate';
@@ -581,6 +596,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. */
@@ -597,7 +619,7 @@ interface CashClient {
     /** Track Relay execution status by quote/request id. */
     relayStatus(requestId: string): Promise<RelayStatus>;
     /** 1 - Estimate: currency + amount only. No payee, no side effects, no expiry. */
-    estimate(input: EstimateInput): Promise<CashEstimate>;
+    estimate(input: EstimateInput, options?: EstimateOptions): Promise<CashEstimate>;
     /** 2 - Cash out: payee registration + deposit params + submission happen here. */
     cashout(input: CashoutInput, opts: CashoutOptions): Promise<CashoutResult>;
     /** 2b - Unsigned path: `txs[]` for agent wallets, AA, server keys, policy layers. */
@@ -640,4 +662,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, type EstimateOptions as H, type IntentStatus as I, RECOMMENDED_MIN_CASHOUT_AMOUNT as J, type RelayOptions as K, type RelayQuoteInput as L, MIN_CASHOUT_AMOUNT as M, type RelaySourceInput as N, type OrdersOptions as O, type PrepareResult as P, type RelayTransaction as Q, type RelayExecutionResult as R, type SignerOptions as S, type TopUpResult as T, type WatchOptions as U, type WithdrawOptions as V, type WithdrawResult as W, buildCapabilities as X, createCashClient as Y, 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)
     };
@@ -809,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) {
@@ -824,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);
 }
@@ -841,52 +875,102 @@ 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);
+}
+function fillEtaFromSample(sample, input) {
+  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)
   };
 }
+async function readFillEta(client, input) {
+  const sample = await readFillStatsSample(client, input.environment);
+  return fillEtaFromSample(sample, input);
+}
 var RELAY_API_URL = relaySdk.MAINNET_RELAY_API;
 var NATIVE_TOKEN_ADDRESS = "0x0000000000000000000000000000000000000000";
 var BASE_USDC_ASSET = {
@@ -1422,13 +1506,18 @@ async function readEstimate(publicClient, input, context = {}) {
       }
     } : {}
   };
-  if (context.indexerClient && context.environment) {
+  if (context.includeEta !== false && context.environment) {
     try {
-      estimate.eta = await readFillEta(context.indexerClient, {
+      const etaInput = {
         environment: context.environment,
         currency,
         ...input.platform ? { platform: input.platform } : {}
-      });
+      };
+      if (context.etaReader) {
+        estimate.eta = await context.etaReader(etaInput);
+      } else if (context.indexerClient) {
+        estimate.eta = await readFillEta(context.indexerClient, etaInput);
+      }
     } catch {
     }
   }
@@ -1437,6 +1526,7 @@ async function readEstimate(publicClient, input, context = {}) {
 
 // src/client/createCashClient.ts
 var DEFAULT_RPC_URL = "https://mainnet.base.org";
+var FILL_STATS_CACHE_MS = 15 * 60 * 1e3;
 var CASH_ATTRIBUTION_CODE = "peer-cash";
 var DEFAULT_CURATOR_URLS = {
   preproduction: "https://api-preprod.zkp2p.xyz",
@@ -1535,6 +1625,25 @@ function createCashClient(options) {
     });
   }
   const readClient = buildSdkClient(viem.createWalletClient({ chain: chains.base, transport }));
+  let fillStatsCache = null;
+  let fillStatsRequest = null;
+  async function getFillStatsSample() {
+    if (fillStatsCache && fillStatsCache.expiresAt > Date.now()) {
+      return fillStatsCache.sample;
+    }
+    if (fillStatsRequest) return fillStatsRequest;
+    fillStatsRequest = readFillStatsSample(readClient, environment);
+    try {
+      const sample = await fillStatsRequest;
+      fillStatsCache = {
+        sample,
+        expiresAt: Date.now() + FILL_STATS_CACHE_MS
+      };
+      return sample;
+    } finally {
+      fillStatsRequest = null;
+    }
+  }
   const signingClients = /* @__PURE__ */ new WeakMap();
   async function signingClient(verb, opts) {
     const signer = opts?.signer;
@@ -1549,6 +1658,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
     );
@@ -1559,14 +1669,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)) {
@@ -1837,13 +1946,21 @@ function createCashClient(options) {
     async relayStatus(requestId) {
       return readRelayStatus(requestId, options.relay);
     },
-    async estimate(input) {
+    async estimate(input, estimateOptions) {
       return readEstimate(readClient.publicClient, input, {
-        indexerClient: readClient,
         environment,
+        ...estimateOptions?.includeEta !== void 0 ? { includeEta: estimateOptions.includeEta } : {},
+        etaReader: async (etaInput) => fillEtaFromSample(await getFillStatsSample(), etaInput),
         ...options.relay ? { relay: options.relay } : {}
       });
     },
+    async fillStats() {
+      try {
+        return (await getFillStatsSample()).stats;
+      } catch (err) {
+        throw errors.indexerUnavailable("fill stats", err);
+      }
+    },
     async cashout(input, opts) {
       const client = await signingClient("cashout", opts);
       const owner = opts.signer.account.address;
@@ -2443,6 +2560,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(),
@@ -2747,6 +2869,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,
@@ -3055,9 +3192,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;
@@ -3077,6 +3216,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;