@zkp2p/cash 0.1.7 → 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,9 +104,9 @@ 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

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,
@@ -172,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/{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)
     };
@@ -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,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)
@@ -1549,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
     );
@@ -1559,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)) {
@@ -1844,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;
@@ -2443,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(),
@@ -2747,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,
@@ -3055,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;
@@ -3077,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;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { I as IntentStatus, C as CashPayoutInfo, a as IntentEntity, b as CashBuyerProfile, c as CashDepositInput, d as CreateDepositParamsArg, e as CashOrder, f as CashFill, g as CashCapabilities, h as CashoutResult, i as CashEstimate, P as PrepareResult, j as CashPreparedStep, R as RelayExecutionResult, k as RelayQuote, l as RelayStatus, m as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-jUA_GNdh.cjs';
-export { n as CASH_ATTRIBUTION_CODE, o as CashAsset, p as CashChain, q as CashClient, r as CashClientOptions, s as CashFillEta, t as CashLeg, u as CashNextAction, v as CashOrderState, w as CashPayout, x as CashPayoutPricing, y as CashPlatformCapability, z as CashPreparedStepKind, A as CashoutInput, B as CashoutOptions, D as CuratorPayeeDataInput, E as EstimateInput, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, F as RECOMMENDED_MIN_CASHOUT_AMOUNT, G as RelayOptions, H as RelayQuoteInput, J as RelaySourceInput, K as RelayTransaction, S as SignerOptions, L as WatchOptions, N as WithdrawOptions, Q as buildCapabilities, U as createCashClient } from './createCashClient-jUA_GNdh.cjs';
+import { I as IntentStatus, C as CashPayoutInfo, a as IntentEntity, b as CashBuyerProfile, c as CashDepositInput, d as CreateDepositParamsArg, e as CashOrder, f as CashFill, g as CashCapabilities, h as CashoutResult, i as CashEstimate, j as CashFillStats, P as PrepareResult, k as CashPreparedStep, R as RelayExecutionResult, l as RelayQuote, m as RelayStatus, n as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-BIzOLHjF.cjs';
+export { o as CASH_ATTRIBUTION_CODE, p as CashAsset, q as CashChain, r as CashClient, s as CashClientOptions, t as CashFillEta, u as CashLeg, v as CashNextAction, w as CashOrderState, x as CashPairFillStats, y as CashPayout, z as CashPayoutPricing, A as CashPlatformCapability, B as CashPreparedStepKind, D as CashoutInput, E as CashoutOptions, F as CuratorPayeeDataInput, G as EstimateInput, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, H as RECOMMENDED_MIN_CASHOUT_AMOUNT, J as RelayOptions, K as RelayQuoteInput, L as RelaySourceInput, N as RelayTransaction, S as SignerOptions, Q as WatchOptions, U as WithdrawOptions, V as buildCapabilities, X as createCashClient } from './createCashClient-BIzOLHjF.cjs';
 import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
 export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
 import { Log, Abi } from 'viem';
@@ -1432,6 +1432,26 @@ declare const cashEstimateJsonSchema: z.ZodObject<{
         seconds?: number | undefined;
     } | undefined;
 }>;
+declare const cashPairFillStatsJsonSchema: z.ZodObject<{
+    fills: z.ZodNumber;
+    medianFillSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    fills: number;
+    medianFillSeconds?: number | undefined;
+}, {
+    fills: number;
+    medianFillSeconds?: number | undefined;
+}>;
+declare const cashFillStatsJsonSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    fills: z.ZodNumber;
+    medianFillSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    fills: number;
+    medianFillSeconds?: number | undefined;
+}, {
+    fills: number;
+    medianFillSeconds?: number | undefined;
+}>>;
 declare const preparedTransactionJsonSchema: z.ZodObject<{
     to: z.ZodString;
     data: z.ZodString;
@@ -2688,8 +2708,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];
@@ -2759,8 +2779,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];
@@ -3707,6 +3727,7 @@ declare const cashErrorJsonSchema: z.ZodObject<{
 type CashOrderJson = z.infer<typeof cashOrderJsonSchema>;
 type CashFillJson = z.infer<typeof cashFillJsonSchema>;
 type CashEstimateJson = z.infer<typeof cashEstimateJsonSchema>;
+type CashFillStatsJson = z.infer<typeof cashFillStatsJsonSchema>;
 type PreparedTransactionJson = z.infer<typeof preparedTransactionJsonSchema>;
 type CashoutResultJson = z.infer<typeof cashoutResultJsonSchema>;
 type PrepareResultJson = z.infer<typeof prepareResultJsonSchema>;
@@ -3739,6 +3760,8 @@ declare function orderToJson(order: CashOrder): CashOrderJson;
 declare function orderFromJson(json: unknown): CashOrder;
 declare function estimateToJson(estimate: CashEstimate): CashEstimateJson;
 declare function estimateFromJson(json: unknown): CashEstimate;
+declare function fillStatsToJson(stats: CashFillStats): CashFillStatsJson;
+declare function fillStatsFromJson(json: unknown): CashFillStats;
 declare function relayQuoteToJson(quote: RelayQuote): RelayQuoteJson;
 declare function relayQuoteFromJson(json: unknown): RelayQuote;
 declare function sourceCapabilitiesToJson(capabilities: CashSourceCapabilities): CashSourceCapabilitiesJson;
@@ -3766,4 +3789,4 @@ declare function capabilitiesFromJson(json: unknown): CashCapabilities;
 declare function cashErrorToJson(error: CashErrorShape): CashErrorJson;
 declare function cashErrorFromJson(json: unknown): CashError;
 
-export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type DeriveCashOrderOptions, MARKET_SPREAD_BPS, type MethodCurrencyLike, ORACLE_MIN_CONVERSION_RATE_SENTINEL, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, USDC_DECIMALS, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillToJson, formatUsdc, intentStatusSchema, isCashError, isFillLive, isMarketRateSupported, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };
+export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashFillStats, type CashFillStatsJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type DeriveCashOrderOptions, MARKET_SPREAD_BPS, type MethodCurrencyLike, ORACLE_MIN_CONVERSION_RATE_SENTINEL, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, USDC_DECIMALS, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashError, isFillLive, isMarketRateSupported, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { I as IntentStatus, C as CashPayoutInfo, a as IntentEntity, b as CashBuyerProfile, c as CashDepositInput, d as CreateDepositParamsArg, e as CashOrder, f as CashFill, g as CashCapabilities, h as CashoutResult, i as CashEstimate, P as PrepareResult, j as CashPreparedStep, R as RelayExecutionResult, k as RelayQuote, l as RelayStatus, m as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-jUA_GNdh.js';
-export { n as CASH_ATTRIBUTION_CODE, o as CashAsset, p as CashChain, q as CashClient, r as CashClientOptions, s as CashFillEta, t as CashLeg, u as CashNextAction, v as CashOrderState, w as CashPayout, x as CashPayoutPricing, y as CashPlatformCapability, z as CashPreparedStepKind, A as CashoutInput, B as CashoutOptions, D as CuratorPayeeDataInput, E as EstimateInput, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, F as RECOMMENDED_MIN_CASHOUT_AMOUNT, G as RelayOptions, H as RelayQuoteInput, J as RelaySourceInput, K as RelayTransaction, S as SignerOptions, L as WatchOptions, N as WithdrawOptions, Q as buildCapabilities, U as createCashClient } from './createCashClient-jUA_GNdh.js';
+import { I as IntentStatus, C as CashPayoutInfo, a as IntentEntity, b as CashBuyerProfile, c as CashDepositInput, d as CreateDepositParamsArg, e as CashOrder, f as CashFill, g as CashCapabilities, h as CashoutResult, i as CashEstimate, j as CashFillStats, P as PrepareResult, k as CashPreparedStep, R as RelayExecutionResult, l as RelayQuote, m as RelayStatus, n as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-BIzOLHjF.js';
+export { o as CASH_ATTRIBUTION_CODE, p as CashAsset, q as CashChain, r as CashClient, s as CashClientOptions, t as CashFillEta, u as CashLeg, v as CashNextAction, w as CashOrderState, x as CashPairFillStats, y as CashPayout, z as CashPayoutPricing, A as CashPlatformCapability, B as CashPreparedStepKind, D as CashoutInput, E as CashoutOptions, F as CuratorPayeeDataInput, G as EstimateInput, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, H as RECOMMENDED_MIN_CASHOUT_AMOUNT, J as RelayOptions, K as RelayQuoteInput, L as RelaySourceInput, N as RelayTransaction, S as SignerOptions, Q as WatchOptions, U as WithdrawOptions, V as buildCapabilities, X as createCashClient } from './createCashClient-BIzOLHjF.js';
 import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
 export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
 import { Log, Abi } from 'viem';
@@ -1432,6 +1432,26 @@ declare const cashEstimateJsonSchema: z.ZodObject<{
         seconds?: number | undefined;
     } | undefined;
 }>;
+declare const cashPairFillStatsJsonSchema: z.ZodObject<{
+    fills: z.ZodNumber;
+    medianFillSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    fills: number;
+    medianFillSeconds?: number | undefined;
+}, {
+    fills: number;
+    medianFillSeconds?: number | undefined;
+}>;
+declare const cashFillStatsJsonSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    fills: z.ZodNumber;
+    medianFillSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    fills: number;
+    medianFillSeconds?: number | undefined;
+}, {
+    fills: number;
+    medianFillSeconds?: number | undefined;
+}>>;
 declare const preparedTransactionJsonSchema: z.ZodObject<{
     to: z.ZodString;
     data: z.ZodString;
@@ -2688,8 +2708,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];
@@ -2759,8 +2779,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];
@@ -3707,6 +3727,7 @@ declare const cashErrorJsonSchema: z.ZodObject<{
 type CashOrderJson = z.infer<typeof cashOrderJsonSchema>;
 type CashFillJson = z.infer<typeof cashFillJsonSchema>;
 type CashEstimateJson = z.infer<typeof cashEstimateJsonSchema>;
+type CashFillStatsJson = z.infer<typeof cashFillStatsJsonSchema>;
 type PreparedTransactionJson = z.infer<typeof preparedTransactionJsonSchema>;
 type CashoutResultJson = z.infer<typeof cashoutResultJsonSchema>;
 type PrepareResultJson = z.infer<typeof prepareResultJsonSchema>;
@@ -3739,6 +3760,8 @@ declare function orderToJson(order: CashOrder): CashOrderJson;
 declare function orderFromJson(json: unknown): CashOrder;
 declare function estimateToJson(estimate: CashEstimate): CashEstimateJson;
 declare function estimateFromJson(json: unknown): CashEstimate;
+declare function fillStatsToJson(stats: CashFillStats): CashFillStatsJson;
+declare function fillStatsFromJson(json: unknown): CashFillStats;
 declare function relayQuoteToJson(quote: RelayQuote): RelayQuoteJson;
 declare function relayQuoteFromJson(json: unknown): RelayQuote;
 declare function sourceCapabilitiesToJson(capabilities: CashSourceCapabilities): CashSourceCapabilitiesJson;
@@ -3766,4 +3789,4 @@ declare function capabilitiesFromJson(json: unknown): CashCapabilities;
 declare function cashErrorToJson(error: CashErrorShape): CashErrorJson;
 declare function cashErrorFromJson(json: unknown): CashError;
 
-export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type DeriveCashOrderOptions, MARKET_SPREAD_BPS, type MethodCurrencyLike, ORACLE_MIN_CONVERSION_RATE_SENTINEL, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, USDC_DECIMALS, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillToJson, formatUsdc, intentStatusSchema, isCashError, isFillLive, isMarketRateSupported, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };
+export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashFillStats, type CashFillStatsJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type DeriveCashOrderOptions, MARKET_SPREAD_BPS, type MethodCurrencyLike, ORACLE_MIN_CONVERSION_RATE_SENTINEL, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, USDC_DECIMALS, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashError, isFillLive, isMarketRateSupported, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };

package/dist/index.js

@@ -387,6 +387,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 = {
@@ -405,13 +425,20 @@ var PAYEE_HINTS = {
 var IDENTITY_ATTESTATION_PLATFORMS = /* @__PURE__ */ new Set(["wise", "paypal"]);
 function buildCapabilities(environment) {
   const catalog = 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) => 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)
     };
@@ -430,11 +457,8 @@ function buildCapabilities(environment) {
     pricing: { kind: "oracle-market-rate", spreadBps: 0 }
   };
 }
-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) {
@@ -445,12 +469,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 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);
 }
@@ -462,47 +496,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 ?? [],
-    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 = 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 ? 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)
@@ -1170,6 +1254,7 @@ function createCashClient(options) {
   }
   function validatePayout(input) {
     const { receive } = input;
+    const catalog = getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
     const platform = buildCapabilities(environment).platforms.find(
       (capability) => capability.platform === receive.platform
     );
@@ -1180,14 +1265,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)) {
@@ -1465,6 +1549,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;
@@ -2064,6 +2155,11 @@ var cashEstimateJsonSchema = z.object({
     label: z.string()
   }).optional()
 });
+var cashPairFillStatsJsonSchema = z.object({
+  fills: z.number().int().nonnegative(),
+  medianFillSeconds: z.number().int().nonnegative().optional()
+}).strict();
+var cashFillStatsJsonSchema = z.record(z.string(), cashPairFillStatsJsonSchema);
 var preparedTransactionJsonSchema = z.object({
   to: z.string(),
   data: z.string(),
@@ -2368,6 +2464,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,
@@ -2645,4 +2756,4 @@ function cashErrorFromJson(json) {
   });
 }
 
-export { CASH_ATTRIBUTION_CODE, MIN_CASHOUT_AMOUNT, RATE_PRECISION, RECOMMENDED_MIN_CASHOUT_AMOUNT, bigintString, buildCapabilities, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, createCashClient, deriveBuyerProfile, deriveCashOrder, derivePayouts, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillToJson, formatUsdc, intentStatusSchema, isFillLive, isMarketRateSupported, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };
+export { CASH_ATTRIBUTION_CODE, MIN_CASHOUT_AMOUNT, RATE_PRECISION, RECOMMENDED_MIN_CASHOUT_AMOUNT, bigintString, buildCapabilities, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, createCashClient, deriveBuyerProfile, deriveCashOrder, derivePayouts, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isFillLive, isMarketRateSupported, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { q as CashClient, E as EstimateInput, i as CashEstimate, B as CashoutOptions, h as CashoutResult, A as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-jUA_GNdh.cjs';
+import { r as CashClient, G as EstimateInput, i as CashEstimate, E as CashoutOptions, h as CashoutResult, D as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-BIzOLHjF.cjs';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { q as CashClient, E as EstimateInput, i as CashEstimate, B as CashoutOptions, h as CashoutResult, A as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-jUA_GNdh.js';
+import { r as CashClient, G as EstimateInput, i as CashEstimate, E as CashoutOptions, h as CashoutResult, D as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-BIzOLHjF.js';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/tools.cjs

@@ -2,7 +2,7 @@
 
 // package.json
 var package_default = {
-  version: "0.1.7"};
+  version: "0.1.8"};
 
 // src/tools/index.ts
 var bigintString = {
@@ -112,6 +112,15 @@ var builtInCashTools = [
       additionalProperties: false
     }
   },
+  {
+    name: "cash_fill_stats",
+    description: "Read raw 30-day demand and first-fill speed evidence for every observed platform:currency pair. Consumers should apply their own threshold and fail open to cash_capabilities when stats are unavailable or filtering would empty the catalog.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
   {
     name: "cash_cashout",
     description: "Start a Base-USDC cash-out using the custody-separated prepare path. Returns UNSIGNED transactions plus same-index steps [approve, createDeposit]; signing and ordered submission stay host-side. For another source asset, complete cash_source_quote and cash_source_status first, then pass the guaranteed Base USDC output amount here.",

package/dist/tools.d.cts

@@ -135,6 +135,14 @@ declare const builtInCashTools: readonly [{
         readonly required: readonly ["amount", "currency"];
         readonly additionalProperties: false;
     };
+}, {
+    readonly name: "cash_fill_stats";
+    readonly description: "Read raw 30-day demand and first-fill speed evidence for every observed platform:currency pair. Consumers should apply their own threshold and fail open to cash_capabilities when stats are unavailable or filtering would empty the catalog.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+        readonly additionalProperties: false;
+    };
 }, {
     readonly name: "cash_cashout";
     readonly description: "Start a Base-USDC cash-out using the custody-separated prepare path. Returns UNSIGNED transactions plus same-index steps [approve, createDeposit]; signing and ordered submission stay host-side. For another source asset, complete cash_source_quote and cash_source_status first, then pass the guaranteed Base USDC output amount here.";

package/dist/tools.d.ts

@@ -135,6 +135,14 @@ declare const builtInCashTools: readonly [{
         readonly required: readonly ["amount", "currency"];
         readonly additionalProperties: false;
     };
+}, {
+    readonly name: "cash_fill_stats";
+    readonly description: "Read raw 30-day demand and first-fill speed evidence for every observed platform:currency pair. Consumers should apply their own threshold and fail open to cash_capabilities when stats are unavailable or filtering would empty the catalog.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+        readonly additionalProperties: false;
+    };
 }, {
     readonly name: "cash_cashout";
     readonly description: "Start a Base-USDC cash-out using the custody-separated prepare path. Returns UNSIGNED transactions plus same-index steps [approve, createDeposit]; signing and ordered submission stay host-side. For another source asset, complete cash_source_quote and cash_source_status first, then pass the guaranteed Base USDC output amount here.";

package/dist/tools.js

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "0.1.7"};
+  version: "0.1.8"};
 
 // src/tools/index.ts
 var bigintString = {
@@ -110,6 +110,15 @@ var builtInCashTools = [
       additionalProperties: false
     }
   },
+  {
+    name: "cash_fill_stats",
+    description: "Read raw 30-day demand and first-fill speed evidence for every observed platform:currency pair. Consumers should apply their own threshold and fail open to cash_capabilities when stats are unavailable or filtering would empty the catalog.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
   {
     name: "cash_cashout",
     description: "Start a Base-USDC cash-out using the custody-separated prepare path. Returns UNSIGNED transactions plus same-index steps [approve, createDeposit]; signing and ordered submission stay host-side. For another source asset, complete cash_source_quote and cash_source_status first, then pass the guaranteed Base USDC output amount here.",

package/docs/lifecycle-and-recovery.md

@@ -124,10 +124,17 @@ passes through `delivering` until the last one completes. `filledAmount`,
 ## The ETA principle
 
 `estimate().eta` is historical, not a promise. It uses rolling 30-day indexer
-data from deposit/order creation to the first fulfilled fill. It deliberately
-does **not** measure buyer signal to fulfillment; that would miss the
-buyer-arrival wait that users actually care about. The public shape is small:
-`{ seconds, label }`.
+data from deposit/order creation to the first fulfilled fill through the
+intent's actual platform and currency pair. It deliberately does **not**
+measure buyer signal to fulfillment; that would miss the buyer-arrival wait
+that users actually care about. The public shape is small: `{ seconds, label }`.
+
+`fillStats()` exposes the sampler's raw evidence for catalog filtering as
+`Record<"platform:currency", { fills, medianFillSeconds? }>`. Bank-scoped Zelle
+methods aggregate to `zelle:USD`. Consumers own thresholding; the recommended
+gate is `fills >= 10 && medianFillSeconds <= 48h`, with a fail-open fallback to
+the full capability catalog when the read fails or filtering would empty it.
+Medians are per-deposit first-fill latencies, never means or censored cohorts.
 
 - **Buyer arrival time is market-driven.** A deposit at market rate should
   fill fast, but the ETA is only a recent historical sample.

package/llms.txt

@@ -19,9 +19,13 @@ Key facts:
   source.amount is Relay's guaranteed minimum Base USDC output and the exact
   order deposit amount, not the route's actual output.
 - There is NO locked fiat quote. estimate() reads the oracle; the binding rate
-  resolves at fill time. ETA is `{ seconds, label }` from rolling 30-day,
-  zero-spread market-rate deposits in the same payout corridor, not a
-  guarantee.
+  resolves at fill time. ETA is `{ seconds, label }` from the same rolling
+  30-day, intent-attributed pair sampler as fillStats(), not a guarantee.
+- fillStats() returns raw `{ fills, medianFillSeconds? }` evidence keyed by
+  `platform:currency`. Recommended consumer gate: fills >= 10 and median <=
+  48h; fail open to capabilities() if unavailable or filtering empties it.
+- capabilities() exposes one Zelle platform. A zelle cashout internally attaches
+  the generic method plus Chase, Bank of America, and Citi buyer routes.
 - Resume any order from its depositId alone (composite escrow_onchainId).
 - One unwind verb: withdraw(depositId) - prunes expired intents automatically;
   pass amount for a partial withdrawal of the unlocked balance.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkp2p/cash",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Peer Cash - offramp-only SDK for routing crypto to Base USDC, then cashing out to fiat at the live oracle market rate.",
   "license": "MIT",
   "author": "Peer (https://peer.xyz)",
@@ -92,13 +92,15 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src test examples",
+    "lint": "eslint src test examples scripts",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "vitest run",
     "test:watch": "vitest",
     "audit": "bun audit --production",
     "pack:check": "bun scripts/check-packed-package.ts",
+    "verify:production-crosschain-relay": "bun scripts/verify-production-crosschain-relay.ts",
+    "verify:production-maker": "bun scripts/verify-production-maker.ts",
     "prepack": "bun run build",
     "ci": "bun run typecheck && bun run lint && bun run format:check && bun run test && bun run audit && bun run build && bun run pack:check"
   },