@zkp2p/cash 0.2.1 → 0.3.0-rc.0

package/AGENTS.md

@@ -59,8 +59,9 @@ 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.
+// Optional: raw demand + speed evidence per offered pair or sorted currency set.
 const stats = await cash.fillStats();
+console.log(stats['revolut:EUR+GBP+USD']);
 
 // 3. Execute.
 const { depositId } = await cash.cashout(

package/README.md

@@ -39,7 +39,9 @@ const rateOnly = await cash.estimate(
   { amount: usdc(1000), currency: 'USD' },
   { includeEta: false },
 );
-const pairStats = (await cash.fillStats())['venmo:USD'];
+const fillStats = await cash.fillStats();
+const pairStats = fillStats['venmo:USD'];
+const multiCurrencyStats = fillStats['revolut:EUR+GBP+USD'];
 
 const { depositId } = await cash.cashout(
   {
@@ -97,7 +99,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()`                                                  | Cached 30-day fill counts and median first-fill time per exact `platform:currency` pair                                         |
+| `fillStats()`                                                  | Cached 30-day fill counts and median first-fill time per exact `platform:currency` pair or sorted multi-currency set            |
 | `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 }, { includeEta? })`              | Base USDC oracle estimate; optionally skip the historical ETA for progressive rendering                                         |
@@ -235,7 +237,9 @@ awaiting-buyer ──────────► matched ───────
   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
+  resolved from its exact normalized `platform:currency` key. Multi-currency
+  deposits also produce sorted keys such as `revolut:EUR+GBP+USD`, measured to
+  the first fill in any offered currency. 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`.

package/dist/{createCashClient-Clg5Fa1H.d.cts → createCashClient-DGMd8Swr.d.cts}

@@ -363,12 +363,15 @@ interface CashCapabilities {
 declare function buildCapabilities(environment: RuntimeEnv): CashCapabilities;
 
 interface CashPairFillStats {
-    /** Fulfilled intents through this pair inside the rolling 30-day window. */
+    /** Fulfilled intents through this pair or currency set inside the rolling 30-day window. */
     fills: number;
-    /** Median deposit-to-first-fill seconds, sampled once per deposit for this pair. */
+    /** Median deposit-to-first-fill seconds, sampled once per deposit for this pair or set. */
     medianFillSeconds?: number;
 }
-/** Raw demand and speed evidence keyed by `basePlatform:currencyCode`. */
+/**
+ * Raw demand and speed evidence keyed by `basePlatform:currencyCode` or a
+ * sorted multi-currency set such as `revolut:EUR+GBP+USD`.
+ */
 type CashFillStats = Record<string, CashPairFillStats>;
 interface CashFillEta {
     /** Simple headline ETA from recent deposits. Undefined when no recent sample exists. */
@@ -622,10 +625,11 @@ interface CashClient {
         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.
+     * 0c - Raw 30-day demand and first-fill speed evidence keyed by an exact
+     * `platform:currency` pair or sorted multi-currency set. 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. */

package/dist/{createCashClient-Clg5Fa1H.d.ts → createCashClient-DGMd8Swr.d.ts}

@@ -363,12 +363,15 @@ interface CashCapabilities {
 declare function buildCapabilities(environment: RuntimeEnv): CashCapabilities;
 
 interface CashPairFillStats {
-    /** Fulfilled intents through this pair inside the rolling 30-day window. */
+    /** Fulfilled intents through this pair or currency set inside the rolling 30-day window. */
     fills: number;
-    /** Median deposit-to-first-fill seconds, sampled once per deposit for this pair. */
+    /** Median deposit-to-first-fill seconds, sampled once per deposit for this pair or set. */
     medianFillSeconds?: number;
 }
-/** Raw demand and speed evidence keyed by `basePlatform:currencyCode`. */
+/**
+ * Raw demand and speed evidence keyed by `basePlatform:currencyCode` or a
+ * sorted multi-currency set such as `revolut:EUR+GBP+USD`.
+ */
 type CashFillStats = Record<string, CashPairFillStats>;
 interface CashFillEta {
     /** Simple headline ETA from recent deposits. Undefined when no recent sample exists. */
@@ -622,10 +625,11 @@ interface CashClient {
         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.
+     * 0c - Raw 30-day demand and first-fill speed evidence keyed by an exact
+     * `platform:currency` pair or sorted multi-currency set. 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. */

package/dist/index.cjs

@@ -959,6 +959,26 @@ function computeFillStatsSample(deposits, nowSeconds, environment) {
     const createdAt = toUnixSeconds2(deposit.createdAt ?? deposit.timestamp);
     const firstFillByPair = /* @__PURE__ */ new Map();
     const firstFillByCurrency = /* @__PURE__ */ new Map();
+    const offeredCurrenciesByMethod = /* @__PURE__ */ new Map();
+    for (const offered of deposit.currencies ?? []) {
+      let method;
+      try {
+        method = offered.paymentMethodHash ? sdk.resolvePaymentMethodNameFromHash(offered.paymentMethodHash, catalog) : void 0;
+      } catch {
+        method = void 0;
+      }
+      const currency = normalizeCurrencyCode(offered.currencyCode);
+      if (!method || !currency) continue;
+      const currencies = offeredCurrenciesByMethod.get(method) ?? /* @__PURE__ */ new Set();
+      currencies.add(currency);
+      offeredCurrenciesByMethod.set(method, currencies);
+    }
+    const multiCurrencyKeyByMethod = /* @__PURE__ */ new Map();
+    for (const [method, currencies] of offeredCurrenciesByMethod) {
+      if (currencies.size > 1) {
+        multiCurrencyKeyByMethod.set(method, `${method}:${[...currencies].sort().join("+")}`);
+      }
+    }
     for (const intent of deposit.intents ?? []) {
       const fulfilledAt = toUnixSeconds2(intent.fulfillTimestamp);
       if (fulfilledAt === void 0 || fulfilledAt < windowStart) continue;
@@ -972,11 +992,25 @@ function computeFillStatsSample(deposits, nowSeconds, environment) {
       if (!method || !currency) continue;
       const pair = `${method}:${currency}`;
       fillCounts.set(pair, (fillCounts.get(pair) ?? 0) + 1);
+      const multiCurrencyKey = multiCurrencyKeyByMethod.get(method);
+      const matchingMultiCurrencyKey = multiCurrencyKey && offeredCurrenciesByMethod.get(method)?.has(currency) ? multiCurrencyKey : void 0;
+      if (matchingMultiCurrencyKey) {
+        fillCounts.set(
+          matchingMultiCurrencyKey,
+          (fillCounts.get(matchingMultiCurrencyKey) ?? 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);
       }
+      if (matchingMultiCurrencyKey) {
+        const previousMultiCurrencyFill = firstFillByPair.get(matchingMultiCurrencyKey);
+        if (previousMultiCurrencyFill === void 0 || fulfilledAt < previousMultiCurrencyFill) {
+          firstFillByPair.set(matchingMultiCurrencyKey, fulfilledAt);
+        }
+      }
       const previousCurrencyFill = firstFillByCurrency.get(currency);
       if (previousCurrencyFill === void 0 || fulfilledAt < previousCurrencyFill) {
         firstFillByCurrency.set(currency, fulfilledAt);

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, 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-Clg5Fa1H.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 CashMultiCurrencyLeg, w as CashNextAction, x as CashOrderState, y as CashPairFillStats, z as CashPayeeInput, A as CashPayout, B as CashPayoutPricing, D as CashPlatformCapability, E as CashPreparedStepKind, F as CashoutInput, G as CashoutOptions, H as CuratorPayeeDataInput, J as EstimateInput, K as EstimateOptions, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, L as PreparedCashoutReceipt, N as RECOMMENDED_MIN_CASHOUT_AMOUNT, Q as RelayOptions, S as RelayQuoteInput, U as RelaySourceInput, V as RelayTransaction, X as SignerOptions, Y as WatchOptions, Z as WithdrawOptions, _ as buildCapabilities, $ as createCashClient, a0 as normalizeCashPayee } from './createCashClient-Clg5Fa1H.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-DGMd8Swr.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 CashMultiCurrencyLeg, w as CashNextAction, x as CashOrderState, y as CashPairFillStats, z as CashPayeeInput, A as CashPayout, B as CashPayoutPricing, D as CashPlatformCapability, E as CashPreparedStepKind, F as CashoutInput, G as CashoutOptions, H as CuratorPayeeDataInput, J as EstimateInput, K as EstimateOptions, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, L as PreparedCashoutReceipt, N as RECOMMENDED_MIN_CASHOUT_AMOUNT, Q as RelayOptions, S as RelayQuoteInput, U as RelaySourceInput, V as RelayTransaction, X as SignerOptions, Y as WatchOptions, Z as WithdrawOptions, _ as buildCapabilities, $ as createCashClient, a0 as normalizeCashPayee } from './createCashClient-DGMd8Swr.cjs';
 import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
 export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
 import { Log, Abi } from 'viem';
@@ -2718,8 +2718,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];
@@ -2789,8 +2789,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];

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, 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-Clg5Fa1H.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 CashMultiCurrencyLeg, w as CashNextAction, x as CashOrderState, y as CashPairFillStats, z as CashPayeeInput, A as CashPayout, B as CashPayoutPricing, D as CashPlatformCapability, E as CashPreparedStepKind, F as CashoutInput, G as CashoutOptions, H as CuratorPayeeDataInput, J as EstimateInput, K as EstimateOptions, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, L as PreparedCashoutReceipt, N as RECOMMENDED_MIN_CASHOUT_AMOUNT, Q as RelayOptions, S as RelayQuoteInput, U as RelaySourceInput, V as RelayTransaction, X as SignerOptions, Y as WatchOptions, Z as WithdrawOptions, _ as buildCapabilities, $ as createCashClient, a0 as normalizeCashPayee } from './createCashClient-Clg5Fa1H.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-DGMd8Swr.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 CashMultiCurrencyLeg, w as CashNextAction, x as CashOrderState, y as CashPairFillStats, z as CashPayeeInput, A as CashPayout, B as CashPayoutPricing, D as CashPlatformCapability, E as CashPreparedStepKind, F as CashoutInput, G as CashoutOptions, H as CuratorPayeeDataInput, J as EstimateInput, K as EstimateOptions, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, L as PreparedCashoutReceipt, N as RECOMMENDED_MIN_CASHOUT_AMOUNT, Q as RelayOptions, S as RelayQuoteInput, U as RelaySourceInput, V as RelayTransaction, X as SignerOptions, Y as WatchOptions, Z as WithdrawOptions, _ as buildCapabilities, $ as createCashClient, a0 as normalizeCashPayee } from './createCashClient-DGMd8Swr.js';
 import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
 export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
 import { Log, Abi } from 'viem';
@@ -2718,8 +2718,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];
@@ -2789,8 +2789,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];

package/dist/index.js

@@ -523,6 +523,26 @@ function computeFillStatsSample(deposits, nowSeconds, environment) {
     const createdAt = toUnixSeconds2(deposit.createdAt ?? deposit.timestamp);
     const firstFillByPair = /* @__PURE__ */ new Map();
     const firstFillByCurrency = /* @__PURE__ */ new Map();
+    const offeredCurrenciesByMethod = /* @__PURE__ */ new Map();
+    for (const offered of deposit.currencies ?? []) {
+      let method;
+      try {
+        method = offered.paymentMethodHash ? resolvePaymentMethodNameFromHash(offered.paymentMethodHash, catalog) : void 0;
+      } catch {
+        method = void 0;
+      }
+      const currency = normalizeCurrencyCode(offered.currencyCode);
+      if (!method || !currency) continue;
+      const currencies = offeredCurrenciesByMethod.get(method) ?? /* @__PURE__ */ new Set();
+      currencies.add(currency);
+      offeredCurrenciesByMethod.set(method, currencies);
+    }
+    const multiCurrencyKeyByMethod = /* @__PURE__ */ new Map();
+    for (const [method, currencies] of offeredCurrenciesByMethod) {
+      if (currencies.size > 1) {
+        multiCurrencyKeyByMethod.set(method, `${method}:${[...currencies].sort().join("+")}`);
+      }
+    }
     for (const intent of deposit.intents ?? []) {
       const fulfilledAt = toUnixSeconds2(intent.fulfillTimestamp);
       if (fulfilledAt === void 0 || fulfilledAt < windowStart) continue;
@@ -536,11 +556,25 @@ function computeFillStatsSample(deposits, nowSeconds, environment) {
       if (!method || !currency) continue;
       const pair = `${method}:${currency}`;
       fillCounts.set(pair, (fillCounts.get(pair) ?? 0) + 1);
+      const multiCurrencyKey = multiCurrencyKeyByMethod.get(method);
+      const matchingMultiCurrencyKey = multiCurrencyKey && offeredCurrenciesByMethod.get(method)?.has(currency) ? multiCurrencyKey : void 0;
+      if (matchingMultiCurrencyKey) {
+        fillCounts.set(
+          matchingMultiCurrencyKey,
+          (fillCounts.get(matchingMultiCurrencyKey) ?? 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);
       }
+      if (matchingMultiCurrencyKey) {
+        const previousMultiCurrencyFill = firstFillByPair.get(matchingMultiCurrencyKey);
+        if (previousMultiCurrencyFill === void 0 || fulfilledAt < previousMultiCurrencyFill) {
+          firstFillByPair.set(matchingMultiCurrencyKey, fulfilledAt);
+        }
+      }
       const previousCurrencyFill = firstFillByCurrency.get(currency);
       if (previousCurrencyFill === void 0 || fulfilledAt < previousCurrencyFill) {
         firstFillByCurrency.set(currency, fulfilledAt);

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { r as CashClient, J as EstimateInput, i as CashEstimate, G as CashoutOptions, h as CashoutResult, F as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-Clg5Fa1H.cjs';
+import { r as CashClient, J as EstimateInput, i as CashEstimate, G as CashoutOptions, h as CashoutResult, F as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-DGMd8Swr.cjs';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { r as CashClient, J as EstimateInput, i as CashEstimate, G as CashoutOptions, h as CashoutResult, F as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-Clg5Fa1H.js';
+import { r as CashClient, J as EstimateInput, i as CashEstimate, G as CashoutOptions, h as CashoutResult, F as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-DGMd8Swr.js';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/tools.cjs

@@ -2,7 +2,7 @@
 
 // package.json
 var package_default = {
-  version: "0.2.1"};
+  version: "0.3.0-rc.0"};
 
 // src/tools/index.ts
 var bigintString = {

package/dist/tools.js

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "0.2.1"};
+  version: "0.3.0-rc.0"};
 
 // src/tools/index.ts
 var bigintString = {

package/docs/lifecycle-and-recovery.md

@@ -132,7 +132,9 @@ 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? }>`. Generic Zelle
+`Record<string, { fills, medianFillSeconds? }>`. Keys are exact
+`platform:currency` pairs or sorted sets such as `revolut:EUR+GBP+USD`; set
+medians measure time to the first fill in any offered currency. Generic Zelle
 fills are reported as `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.

package/llms.txt

@@ -22,10 +22,11 @@ Key facts:
   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.
-  Its raw environment snapshot is cached for 15 minutes, while lookups remain
-  exact to the normalized platform:currency pair.
+  `platform:currency` or a sorted set such as `revolut:EUR+GBP+USD`. Set
+  medians measure time to the first fill in any offered currency. Recommended
+  consumer gate: fills >= 10 and median <= 48h; fail open to capabilities() if
+  unavailable or filtering empties it. Its raw environment snapshot is cached
+  for 15 minutes.
 - Progressive UIs can call estimate(input, { includeEta: false }) so the
   oracle rate is not blocked by indexer history, then load the exact pair from
   fillStats() separately.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkp2p/cash",
-  "version": "0.2.1",
+  "version": "0.3.0-rc.0",
   "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)",
@@ -106,7 +106,7 @@
   },
   "dependencies": {
     "@relayprotocol/relay-sdk": "^6.1.3",
-    "@zkp2p/sdk": "^0.9.0",
+    "@zkp2p/sdk": "0.10.0-rc.7",
     "zod": "^3.25.76"
   },
   "peerDependencies": {