@zkp2p/cash 0.4.0-rc.2 → 0.4.0-rc.3

package/AGENTS.md

@@ -87,6 +87,19 @@ const multiCurrency = await cash.cashout(
   { signer },
 );
 
+// Widest reach: several platforms on one order (each platform at most once);
+// the buyer picks the leg they can pay, every leg at the live oracle rate.
+const multiPlatform = await cash.cashout(
+  {
+    amount: usdc(500),
+    receive: [
+      { platform: 'venmo', currency: 'USD', payee: '@handle' },
+      { platform: 'revolut', currencies: ['EUR', 'GBP'], payee: { offchainId: 'revtag' } },
+    ],
+  },
+  { signer },
+);
+
 // 4. Persist depositId ↔ your user. That row is the entire integration state.
 
 // 5. Drive the lifecycle from nextActions - no heuristics.

package/README.md

@@ -65,6 +65,19 @@ const fastFill = await cash.cashout(
   { signer },
 );
 
+// One order can also offer several platforms (each at most once). The buyer
+// picks the leg they can pay; every leg fills at the live oracle market rate.
+const widestReach = await cash.cashout(
+  {
+    amount: usdc(1000),
+    receive: [
+      { platform: 'venmo', currency: 'USD', payee: '@you' },
+      { platform: 'revolut', currencies: ['EUR', 'GBP'], payee: { offchainId: 'revtag' } },
+    ],
+  },
+  { signer },
+);
+
 for await (const order of cash.watch(depositId)) {
   console.log(order.state, order.explain());
   if (order.state === 'delivered') break;

package/dist/{chunk-QCRY4XPA.js → chunk-EIEGWWNX.js}

@@ -87,6 +87,12 @@ var errors = {
     retryable: false,
     remediation: `Pass one or more unique currencies listed for ${platform} by capabilities().`
   }),
+  invalidPayoutPlatforms: (reason) => new CashError({
+    code: "INVALID_PAYOUT_PLATFORMS",
+    message: `The payout platform set is invalid: ${reason}.`,
+    retryable: false,
+    remediation: `Pass one payout leg, or an array of legs using each platform from capabilities() at most once.`
+  }),
   invalidReferralCode: () => new CashError({
     code: "INVALID_REFERRAL_CODE",
     message: `The Peer referral code must be exactly six letters or numbers.`,

package/dist/{createCashClient-D8gw-Hhv.d.cts → createCashClient-CYSM84-K.d.cts}

@@ -515,6 +515,8 @@ interface CashMultiCurrencyLeg {
     payee: CashPayeeInput;
     currency?: never;
 }
+/** One payout leg of a cash-out - single-currency or multi-currency. */
+type CashReceiveLeg = CashLeg | CashMultiCurrencyLeg;
 interface CashoutInput {
     /**
      * Amount to cash out. Without `source`, this is Base USDC base units. With
@@ -529,8 +531,12 @@ interface CashoutInput {
         /** Relay amount mode. Omit for the recommended exact source-input flow. */
         tradeType?: 'EXACT_INPUT' | 'EXACT_OUTPUT' | 'EXPECTED_OUTPUT';
     };
-    /** Where the fiat should arrive. One method may offer multiple currencies. */
-    receive: CashLeg | CashMultiCurrencyLeg;
+    /**
+     * Where the fiat should arrive. One leg, or an array of legs to offer the
+     * buyer several payout platforms (each platform at most once). One method
+     * may offer multiple currencies; every leg fills at the live oracle rate.
+     */
+    receive: CashReceiveLeg | readonly [CashReceiveLeg, ...CashReceiveLeg[]];
     /** Per-order min/max override (USDC base units). */
     intentAmountRange?: {
         min: bigint;
@@ -702,4 +708,4 @@ interface CashClient {
 }
 declare function createCashClient(options: CashClientOptions): CashClient;
 
-export { buildCapabilities as $, type CashPayeeInput as A, type CashPayout as B, type CashPayoutInfo as C, type CashPayoutPricing as D, type CashPlatformCapability as E, type CashPreparedStepKind as F, type CashoutInput as G, type CashoutOptions as H, type IntentStatus as I, type CuratorPayeeDataInput as J, type EstimateInput as K, type EstimateOptions as L, MIN_CASHOUT_AMOUNT as M, type PreparedCashoutReceipt as N, type OrdersOptions as O, type PrepareResult as P, RECOMMENDED_MIN_CASHOUT_AMOUNT as Q, type RelayExecutionResult as R, type RelayOptions as S, type TopUpResult as T, type RelayQuoteInput as U, type RelaySourceInput as V, type WithdrawResult as W, type RelayTransaction as X, type SignerOptions as Y, type WatchOptions as Z, type WithdrawOptions as _, type IntentEntity as a, createCashClient as a0, normalizeCashPayee as a1, toCashReferralAttributionCode as a2, 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, CASH_REFERRAL_ATTRIBUTION_PREFIX as p, type CashAsset as q, type CashChain as r, type CashClient as s, type CashClientOptions as t, type CashFillEta as u, type CashLeg as v, type CashMultiCurrencyLeg as w, type CashNextAction as x, type CashOrderState as y, type CashPairFillStats as z };
+export { type WithdrawOptions as $, type CashPayeeInput as A, type CashPayout as B, type CashPayoutInfo as C, type CashPayoutPricing as D, type CashPlatformCapability as E, type CashPreparedStepKind as F, type CashReceiveLeg as G, type CashoutInput as H, type IntentStatus as I, type CashoutOptions as J, type CuratorPayeeDataInput as K, type EstimateInput as L, type EstimateOptions as M, MIN_CASHOUT_AMOUNT as N, type OrdersOptions as O, type PrepareResult as P, type PreparedCashoutReceipt as Q, type RelayExecutionResult as R, RECOMMENDED_MIN_CASHOUT_AMOUNT as S, type TopUpResult as T, type RelayOptions as U, type RelayQuoteInput as V, type WithdrawResult as W, type RelaySourceInput as X, type RelayTransaction as Y, type SignerOptions as Z, type WatchOptions as _, type IntentEntity as a, buildCapabilities as a0, createCashClient as a1, normalizeCashPayee as a2, toCashReferralAttributionCode as a3, 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, CASH_REFERRAL_ATTRIBUTION_PREFIX as p, type CashAsset as q, type CashChain as r, type CashClient as s, type CashClientOptions as t, type CashFillEta as u, type CashLeg as v, type CashMultiCurrencyLeg as w, type CashNextAction as x, type CashOrderState as y, type CashPairFillStats as z };

package/dist/{createCashClient-D8gw-Hhv.d.ts → createCashClient-CYSM84-K.d.ts}

@@ -515,6 +515,8 @@ interface CashMultiCurrencyLeg {
     payee: CashPayeeInput;
     currency?: never;
 }
+/** One payout leg of a cash-out - single-currency or multi-currency. */
+type CashReceiveLeg = CashLeg | CashMultiCurrencyLeg;
 interface CashoutInput {
     /**
      * Amount to cash out. Without `source`, this is Base USDC base units. With
@@ -529,8 +531,12 @@ interface CashoutInput {
         /** Relay amount mode. Omit for the recommended exact source-input flow. */
         tradeType?: 'EXACT_INPUT' | 'EXACT_OUTPUT' | 'EXPECTED_OUTPUT';
     };
-    /** Where the fiat should arrive. One method may offer multiple currencies. */
-    receive: CashLeg | CashMultiCurrencyLeg;
+    /**
+     * Where the fiat should arrive. One leg, or an array of legs to offer the
+     * buyer several payout platforms (each platform at most once). One method
+     * may offer multiple currencies; every leg fills at the live oracle rate.
+     */
+    receive: CashReceiveLeg | readonly [CashReceiveLeg, ...CashReceiveLeg[]];
     /** Per-order min/max override (USDC base units). */
     intentAmountRange?: {
         min: bigint;
@@ -702,4 +708,4 @@ interface CashClient {
 }
 declare function createCashClient(options: CashClientOptions): CashClient;
 
-export { buildCapabilities as $, type CashPayeeInput as A, type CashPayout as B, type CashPayoutInfo as C, type CashPayoutPricing as D, type CashPlatformCapability as E, type CashPreparedStepKind as F, type CashoutInput as G, type CashoutOptions as H, type IntentStatus as I, type CuratorPayeeDataInput as J, type EstimateInput as K, type EstimateOptions as L, MIN_CASHOUT_AMOUNT as M, type PreparedCashoutReceipt as N, type OrdersOptions as O, type PrepareResult as P, RECOMMENDED_MIN_CASHOUT_AMOUNT as Q, type RelayExecutionResult as R, type RelayOptions as S, type TopUpResult as T, type RelayQuoteInput as U, type RelaySourceInput as V, type WithdrawResult as W, type RelayTransaction as X, type SignerOptions as Y, type WatchOptions as Z, type WithdrawOptions as _, type IntentEntity as a, createCashClient as a0, normalizeCashPayee as a1, toCashReferralAttributionCode as a2, 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, CASH_REFERRAL_ATTRIBUTION_PREFIX as p, type CashAsset as q, type CashChain as r, type CashClient as s, type CashClientOptions as t, type CashFillEta as u, type CashLeg as v, type CashMultiCurrencyLeg as w, type CashNextAction as x, type CashOrderState as y, type CashPairFillStats as z };
+export { type WithdrawOptions as $, type CashPayeeInput as A, type CashPayout as B, type CashPayoutInfo as C, type CashPayoutPricing as D, type CashPlatformCapability as E, type CashPreparedStepKind as F, type CashReceiveLeg as G, type CashoutInput as H, type IntentStatus as I, type CashoutOptions as J, type CuratorPayeeDataInput as K, type EstimateInput as L, type EstimateOptions as M, MIN_CASHOUT_AMOUNT as N, type OrdersOptions as O, type PrepareResult as P, type PreparedCashoutReceipt as Q, type RelayExecutionResult as R, RECOMMENDED_MIN_CASHOUT_AMOUNT as S, type TopUpResult as T, type RelayOptions as U, type RelayQuoteInput as V, type WithdrawResult as W, type RelaySourceInput as X, type RelayTransaction as Y, type SignerOptions as Z, type WatchOptions as _, type IntentEntity as a, buildCapabilities as a0, createCashClient as a1, normalizeCashPayee as a2, toCashReferralAttributionCode as a3, 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, CASH_REFERRAL_ATTRIBUTION_PREFIX as p, type CashAsset as q, type CashChain as r, type CashClient as s, type CashClientOptions as t, type CashFillEta as u, type CashLeg as v, type CashMultiCurrencyLeg as w, type CashNextAction as x, type CashOrderState as y, type CashPairFillStats as z };

package/dist/index.cjs

@@ -463,6 +463,9 @@ var PAYEE_HINTS = {
   n26: "MoneyBeam email or phone number"
 };
 var IDENTITY_ATTESTATION_PLATFORMS = /* @__PURE__ */ new Set(["wise", "paypal"]);
+function platformRequiresIdentityAttestation(platform) {
+  return IDENTITY_ATTESTATION_PLATFORMS.has(platform);
+}
 function buildCapabilities(environment) {
   const catalog = sdk.getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
   const platforms = Object.entries(catalog).map(([platform, entry]) => {
@@ -565,6 +568,12 @@ var errors = {
     retryable: false,
     remediation: `Pass one or more unique currencies listed for ${platform} by capabilities().`
   }),
+  invalidPayoutPlatforms: (reason) => new CashError({
+    code: "INVALID_PAYOUT_PLATFORMS",
+    message: `The payout platform set is invalid: ${reason}.`,
+    retryable: false,
+    remediation: `Pass one payout leg, or an array of legs using each platform from capabilities() at most once.`
+  }),
   invalidReferralCode: () => new CashError({
     code: "INVALID_REFERRAL_CODE",
     message: `The Peer referral code must be exactly six letters or numbers.`,
@@ -1805,41 +1814,51 @@ function createCashClient(options) {
     return client;
   }
   function validatePayout(input) {
-    const { receive } = input;
-    const platform = buildCapabilities(environment).platforms.find(
-      (capability) => capability.platform === receive.platform
-    );
-    if (!platform) throw errors.unsupportedPlatform(receive.platform);
-    if (receive.currency === void 0 === (receive.currencies === void 0)) {
-      throw errors.invalidPayoutCurrencies(
-        receive.platform,
-        "pass exactly one of currency or currencies"
-      );
-    }
-    const currencies = receive.currencies !== void 0 ? [...receive.currencies] : [receive.currency];
-    if (currencies.length === 0) {
-      throw errors.invalidPayoutCurrencies(receive.platform, "at least one currency is required");
+    const legs = Array.isArray(input.receive) ? input.receive : [input.receive];
+    if (legs.length === 0) {
+      throw errors.invalidPayoutPlatforms("at least one payout leg is required");
     }
-    if (new Set(currencies).size !== currencies.length) {
-      throw errors.invalidPayoutCurrencies(receive.platform, "currencies must be unique");
-    }
-    for (const currency of currencies) {
-      if (!isMarketRateSupported(currency)) {
-        throw errors.oracleUnsupportedCurrency(currency);
+    const capabilities2 = buildCapabilities(environment);
+    const seenPlatforms = /* @__PURE__ */ new Set();
+    const payouts = legs.map((leg) => {
+      const platform = capabilities2.platforms.find(
+        (capability) => capability.platform === leg.platform
+      );
+      if (!platform) throw errors.unsupportedPlatform(leg.platform);
+      if (seenPlatforms.has(leg.platform)) {
+        throw errors.invalidPayoutPlatforms(
+          `${leg.platform} appears more than once - each platform may carry one leg`
+        );
       }
-      if (!platform.currencies.includes(currency)) {
-        throw errors.unsupportedPlatformCurrency(receive.platform, currency);
+      seenPlatforms.add(leg.platform);
+      if (leg.currency === void 0 === (leg.currencies === void 0)) {
+        throw errors.invalidPayoutCurrencies(
+          leg.platform,
+          "pass exactly one of currency or currencies"
+        );
       }
-    }
-    return {
-      payouts: [
-        {
-          processorName: receive.platform,
-          ...currencies.length === 1 ? { currency: currencies[0] } : { currencies },
-          payeeData: normalizeCashPayee(receive.platform, receive.payee)
+      const currencies = leg.currencies !== void 0 ? [...leg.currencies] : [leg.currency];
+      if (currencies.length === 0) {
+        throw errors.invalidPayoutCurrencies(leg.platform, "at least one currency is required");
+      }
+      if (new Set(currencies).size !== currencies.length) {
+        throw errors.invalidPayoutCurrencies(leg.platform, "currencies must be unique");
+      }
+      for (const currency of currencies) {
+        if (!isMarketRateSupported(currency)) {
+          throw errors.oracleUnsupportedCurrency(currency);
         }
-      ]
-    };
+        if (!platform.currencies.includes(currency)) {
+          throw errors.unsupportedPlatformCurrency(leg.platform, currency);
+        }
+      }
+      return {
+        processorName: leg.platform,
+        ...currencies.length === 1 ? { currency: currencies[0] } : { currencies },
+        payeeData: normalizeCashPayee(leg.platform, leg.payee)
+      };
+    });
+    return { payouts };
   }
   function validateDepositInput(amount, input, payoutInput = validatePayout(input)) {
     if (amount < MIN_CASHOUT_AMOUNT) {
@@ -1856,12 +1875,7 @@ function createCashClient(options) {
     };
   }
   function isCashPayoutSet(payouts) {
-    const first = payouts[0];
-    return Boolean(
-      first && payouts.every(
-        (payout) => payout.platformHash.toLowerCase() === first.platformHash.toLowerCase() && payout.payeeHash.toLowerCase() === first.payeeHash.toLowerCase() && payout.pricing.marketRate && payout.pricing.spreadBps === 0
-      )
-    );
+    return payouts.length > 0 && payouts.every((payout) => payout.pricing.marketRate && payout.pricing.spreadBps === 0);
   }
   async function buildDepositParams(client, depositInput) {
     try {
@@ -1870,7 +1884,8 @@ function createCashClient(options) {
       if (isCashError(err)) throw err;
       const message = err instanceof Error ? err.message : String(err);
       if (/identityAttestation is required|identity attestation/i.test(message)) {
-        const platform = depositInput.payouts[0]?.processorName ?? "this platform";
+        const platforms = depositInput.payouts.map((payout) => payout.processorName);
+        const platform = platforms.find(platformRequiresIdentityAttestation) ?? platforms[0] ?? "this platform";
         throw errors.payeeVerificationRequired(platform, err);
       }
       throw errors.payeeRegistrationFailed(err);
@@ -2879,6 +2894,7 @@ var CASH_ERROR_CODES = defineCashErrorCodes([
   "AMOUNT_BELOW_MINIMUM",
   "INVALID_INTENT_AMOUNT_RANGE",
   "INVALID_PAYOUT_CURRENCIES",
+  "INVALID_PAYOUT_PLATFORMS",
   "INVALID_REFERRAL_CODE",
   "ACTIVE_INTENT_BLOCKS_WITHDRAWAL",
   "NOTHING_TO_WITHDRAW",

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-D8gw-Hhv.cjs';
-export { o as CASH_ATTRIBUTION_CODE, p as CASH_REFERRAL_ATTRIBUTION_PREFIX, q as CashAsset, r as CashChain, s as CashClient, t as CashClientOptions, u as CashFillEta, v as CashLeg, w as CashMultiCurrencyLeg, x as CashNextAction, y as CashOrderState, z as CashPairFillStats, A as CashPayeeInput, B as CashPayout, D as CashPayoutPricing, E as CashPlatformCapability, F as CashPreparedStepKind, G as CashoutInput, H as CashoutOptions, J as CuratorPayeeDataInput, K as EstimateInput, L as EstimateOptions, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, N as PreparedCashoutReceipt, Q as RECOMMENDED_MIN_CASHOUT_AMOUNT, S as RelayOptions, U as RelayQuoteInput, V as RelaySourceInput, X as RelayTransaction, Y as SignerOptions, Z as WatchOptions, _ as WithdrawOptions, $ as buildCapabilities, a0 as createCashClient, a1 as normalizeCashPayee, a2 as toCashReferralAttributionCode } from './createCashClient-D8gw-Hhv.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-CYSM84-K.cjs';
+export { o as CASH_ATTRIBUTION_CODE, p as CASH_REFERRAL_ATTRIBUTION_PREFIX, q as CashAsset, r as CashChain, s as CashClient, t as CashClientOptions, u as CashFillEta, v as CashLeg, w as CashMultiCurrencyLeg, x as CashNextAction, y as CashOrderState, z as CashPairFillStats, A as CashPayeeInput, B as CashPayout, D as CashPayoutPricing, E as CashPlatformCapability, F as CashPreparedStepKind, G as CashReceiveLeg, H as CashoutInput, J as CashoutOptions, K as CuratorPayeeDataInput, L as EstimateInput, M as EstimateOptions, N as MIN_CASHOUT_AMOUNT, O as OrdersOptions, Q as PreparedCashoutReceipt, S as RECOMMENDED_MIN_CASHOUT_AMOUNT, U as RelayOptions, V as RelayQuoteInput, X as RelaySourceInput, Y as RelayTransaction, Z as SignerOptions, _ as WatchOptions, $ as WithdrawOptions, a0 as buildCapabilities, a1 as createCashClient, a2 as normalizeCashPayee, a3 as toCashReferralAttributionCode } from './createCashClient-CYSM84-K.cjs';
 import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
 export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
 import { Log, Abi } from 'viem';
@@ -10,7 +10,7 @@ import '@relayprotocol/relay-sdk';
  * Typed errors - every failure carries a `code`, whether it is `retryable`,
  * and a `remediation` sentence so agents can self-drive recovery.
  */
-type CashErrorCode = 'ORACLE_UNSUPPORTED_CURRENCY' | 'ORACLE_READ_FAILED' | 'UNSUPPORTED_PLATFORM' | 'UNSUPPORTED_PLATFORM_CURRENCY' | 'AMOUNT_BELOW_MINIMUM' | 'INVALID_INTENT_AMOUNT_RANGE' | 'INVALID_PAYOUT_CURRENCIES' | 'INVALID_REFERRAL_CODE' | 'ACTIVE_INTENT_BLOCKS_WITHDRAWAL' | 'NOTHING_TO_WITHDRAW' | 'INSUFFICIENT_AVAILABLE_FUNDS' | 'INSUFFICIENT_TOKEN_BALANCE' | 'ORDER_NOT_ACTIVE' | 'INVALID_DEPOSIT_ID' | 'ESCROW_PAUSED' | 'INDEXER_LAG' | 'INDEXER_UNAVAILABLE' | 'ORDER_NOT_FOUND' | 'PAYEE_REGISTRATION_FAILED' | 'PAYEE_VERIFICATION_REQUIRED' | 'SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE' | 'SOURCE_RECIPIENT_MISMATCH' | 'SOURCE_CAPABILITIES_FAILED' | 'SOURCE_QUOTE_FAILED' | 'SOURCE_NONCE_MANAGER_REQUIRED' | 'SOURCE_EXECUTION_FAILED' | 'SOURCE_STATUS_FAILED' | 'SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED' | 'SOURCE_CASHOUT_SUBMISSION_UNKNOWN' | 'SOURCE_CASHOUT_STATUS_UNKNOWN' | 'DEPOSIT_RESOLUTION_FAILED' | 'ALLOWANCE_NOT_VISIBLE' | 'SIGNER_REQUIRED' | 'SIGNER_CHAIN_MISMATCH' | 'SIGNER_CHAIN_UNAVAILABLE' | 'WATCH_TIMEOUT' | 'TRANSACTION_REJECTED' | 'TRANSACTION_FAILED' | 'TRANSACTION_SUBMISSION_UNKNOWN' | 'TRANSACTION_STATUS_UNKNOWN';
+type CashErrorCode = 'ORACLE_UNSUPPORTED_CURRENCY' | 'ORACLE_READ_FAILED' | 'UNSUPPORTED_PLATFORM' | 'UNSUPPORTED_PLATFORM_CURRENCY' | 'AMOUNT_BELOW_MINIMUM' | 'INVALID_INTENT_AMOUNT_RANGE' | 'INVALID_PAYOUT_CURRENCIES' | 'INVALID_PAYOUT_PLATFORMS' | 'INVALID_REFERRAL_CODE' | 'ACTIVE_INTENT_BLOCKS_WITHDRAWAL' | 'NOTHING_TO_WITHDRAW' | 'INSUFFICIENT_AVAILABLE_FUNDS' | 'INSUFFICIENT_TOKEN_BALANCE' | 'ORDER_NOT_ACTIVE' | 'INVALID_DEPOSIT_ID' | 'ESCROW_PAUSED' | 'INDEXER_LAG' | 'INDEXER_UNAVAILABLE' | 'ORDER_NOT_FOUND' | 'PAYEE_REGISTRATION_FAILED' | 'PAYEE_VERIFICATION_REQUIRED' | 'SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE' | 'SOURCE_RECIPIENT_MISMATCH' | 'SOURCE_CAPABILITIES_FAILED' | 'SOURCE_QUOTE_FAILED' | 'SOURCE_NONCE_MANAGER_REQUIRED' | 'SOURCE_EXECUTION_FAILED' | 'SOURCE_STATUS_FAILED' | 'SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED' | 'SOURCE_CASHOUT_SUBMISSION_UNKNOWN' | 'SOURCE_CASHOUT_STATUS_UNKNOWN' | 'DEPOSIT_RESOLUTION_FAILED' | 'ALLOWANCE_NOT_VISIBLE' | 'SIGNER_REQUIRED' | 'SIGNER_CHAIN_MISMATCH' | 'SIGNER_CHAIN_UNAVAILABLE' | 'WATCH_TIMEOUT' | 'TRANSACTION_REJECTED' | 'TRANSACTION_FAILED' | 'TRANSACTION_SUBMISSION_UNKNOWN' | 'TRANSACTION_STATUS_UNKNOWN';
 interface CashErrorShape {
     code: CashErrorCode;
     message: string;
@@ -78,6 +78,7 @@ declare const errors: {
     amountBelowMinimum: (amount: bigint, min: bigint) => CashError;
     invalidIntentAmountRange: (amount: bigint, min: bigint, max: bigint) => CashError;
     invalidPayoutCurrencies: (platform: string, reason: string) => CashError;
+    invalidPayoutPlatforms: (reason: string) => CashError;
     invalidReferralCode: () => CashError;
     activeIntentBlocksWithdrawal: (depositId: string) => CashError;
     insufficientAvailableFunds: (depositId: string, requested: bigint, available: bigint) => CashError;
@@ -224,9 +225,9 @@ interface MethodCurrencyLike {
 /**
  * Decode a deposit's payment methods + currency tuples into payout legs.
  * Pure - the environment arrives via the catalog. One leg per
- * (method, currency) pair; cash orders create exactly one in v1. If any
- * method is absent from the active catalog, reject the whole set instead of
- * partially reclassifying a mixed historical deposit.
+ * (method, currency) pair; a cash order carries one or several platforms. If
+ * any method is absent from the active catalog, reject the whole set instead
+ * of partially reclassifying a mixed historical deposit.
  */
 declare function derivePayouts(paymentMethods: ReadonlyArray<PaymentMethodLike>, currencies: ReadonlyArray<MethodCurrencyLike>, catalog: PaymentMethodCatalog): CashPayoutInfo[];
 
@@ -3185,7 +3186,7 @@ declare const cashErrorRecoveryJsonSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
     operation: string;
 }>]>;
 declare const cashErrorJsonSchema: z.ZodObject<{
-    code: z.ZodEnum<["ORACLE_UNSUPPORTED_CURRENCY", "ORACLE_READ_FAILED", "UNSUPPORTED_PLATFORM", "UNSUPPORTED_PLATFORM_CURRENCY", "AMOUNT_BELOW_MINIMUM", "INVALID_INTENT_AMOUNT_RANGE", "INVALID_PAYOUT_CURRENCIES", "INVALID_REFERRAL_CODE", "ACTIVE_INTENT_BLOCKS_WITHDRAWAL", "NOTHING_TO_WITHDRAW", "INSUFFICIENT_AVAILABLE_FUNDS", "INSUFFICIENT_TOKEN_BALANCE", "ORDER_NOT_ACTIVE", "INVALID_DEPOSIT_ID", "ESCROW_PAUSED", "INDEXER_LAG", "INDEXER_UNAVAILABLE", "ORDER_NOT_FOUND", "PAYEE_REGISTRATION_FAILED", "PAYEE_VERIFICATION_REQUIRED", "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE", "SOURCE_RECIPIENT_MISMATCH", "SOURCE_CAPABILITIES_FAILED", "SOURCE_QUOTE_FAILED", "SOURCE_NONCE_MANAGER_REQUIRED", "SOURCE_EXECUTION_FAILED", "SOURCE_STATUS_FAILED", "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED", "SOURCE_CASHOUT_SUBMISSION_UNKNOWN", "SOURCE_CASHOUT_STATUS_UNKNOWN", "DEPOSIT_RESOLUTION_FAILED", "ALLOWANCE_NOT_VISIBLE", "SIGNER_REQUIRED", "SIGNER_CHAIN_MISMATCH", "SIGNER_CHAIN_UNAVAILABLE", "WATCH_TIMEOUT", "TRANSACTION_REJECTED", "TRANSACTION_FAILED", "TRANSACTION_SUBMISSION_UNKNOWN", "TRANSACTION_STATUS_UNKNOWN"]>;
+    code: z.ZodEnum<["ORACLE_UNSUPPORTED_CURRENCY", "ORACLE_READ_FAILED", "UNSUPPORTED_PLATFORM", "UNSUPPORTED_PLATFORM_CURRENCY", "AMOUNT_BELOW_MINIMUM", "INVALID_INTENT_AMOUNT_RANGE", "INVALID_PAYOUT_CURRENCIES", "INVALID_PAYOUT_PLATFORMS", "INVALID_REFERRAL_CODE", "ACTIVE_INTENT_BLOCKS_WITHDRAWAL", "NOTHING_TO_WITHDRAW", "INSUFFICIENT_AVAILABLE_FUNDS", "INSUFFICIENT_TOKEN_BALANCE", "ORDER_NOT_ACTIVE", "INVALID_DEPOSIT_ID", "ESCROW_PAUSED", "INDEXER_LAG", "INDEXER_UNAVAILABLE", "ORDER_NOT_FOUND", "PAYEE_REGISTRATION_FAILED", "PAYEE_VERIFICATION_REQUIRED", "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE", "SOURCE_RECIPIENT_MISMATCH", "SOURCE_CAPABILITIES_FAILED", "SOURCE_QUOTE_FAILED", "SOURCE_NONCE_MANAGER_REQUIRED", "SOURCE_EXECUTION_FAILED", "SOURCE_STATUS_FAILED", "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED", "SOURCE_CASHOUT_SUBMISSION_UNKNOWN", "SOURCE_CASHOUT_STATUS_UNKNOWN", "DEPOSIT_RESOLUTION_FAILED", "ALLOWANCE_NOT_VISIBLE", "SIGNER_REQUIRED", "SIGNER_CHAIN_MISMATCH", "SIGNER_CHAIN_UNAVAILABLE", "WATCH_TIMEOUT", "TRANSACTION_REJECTED", "TRANSACTION_FAILED", "TRANSACTION_SUBMISSION_UNKNOWN", "TRANSACTION_STATUS_UNKNOWN"]>;
     message: z.ZodString;
     retryable: z.ZodBoolean;
     remediation: z.ZodString;
@@ -3572,7 +3573,7 @@ declare const cashErrorJsonSchema: z.ZodObject<{
     }>]>>;
 }, "strict", z.ZodTypeAny, {
     message: string;
-    code: "ORACLE_UNSUPPORTED_CURRENCY" | "ORACLE_READ_FAILED" | "UNSUPPORTED_PLATFORM" | "UNSUPPORTED_PLATFORM_CURRENCY" | "AMOUNT_BELOW_MINIMUM" | "INVALID_INTENT_AMOUNT_RANGE" | "INVALID_PAYOUT_CURRENCIES" | "INVALID_REFERRAL_CODE" | "ACTIVE_INTENT_BLOCKS_WITHDRAWAL" | "NOTHING_TO_WITHDRAW" | "INSUFFICIENT_AVAILABLE_FUNDS" | "INSUFFICIENT_TOKEN_BALANCE" | "ORDER_NOT_ACTIVE" | "INVALID_DEPOSIT_ID" | "ESCROW_PAUSED" | "INDEXER_LAG" | "INDEXER_UNAVAILABLE" | "ORDER_NOT_FOUND" | "PAYEE_REGISTRATION_FAILED" | "PAYEE_VERIFICATION_REQUIRED" | "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE" | "SOURCE_RECIPIENT_MISMATCH" | "SOURCE_CAPABILITIES_FAILED" | "SOURCE_QUOTE_FAILED" | "SOURCE_NONCE_MANAGER_REQUIRED" | "SOURCE_EXECUTION_FAILED" | "SOURCE_STATUS_FAILED" | "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED" | "SOURCE_CASHOUT_SUBMISSION_UNKNOWN" | "SOURCE_CASHOUT_STATUS_UNKNOWN" | "DEPOSIT_RESOLUTION_FAILED" | "ALLOWANCE_NOT_VISIBLE" | "SIGNER_REQUIRED" | "SIGNER_CHAIN_MISMATCH" | "SIGNER_CHAIN_UNAVAILABLE" | "WATCH_TIMEOUT" | "TRANSACTION_REJECTED" | "TRANSACTION_FAILED" | "TRANSACTION_SUBMISSION_UNKNOWN" | "TRANSACTION_STATUS_UNKNOWN";
+    code: "ORACLE_UNSUPPORTED_CURRENCY" | "ORACLE_READ_FAILED" | "UNSUPPORTED_PLATFORM" | "UNSUPPORTED_PLATFORM_CURRENCY" | "AMOUNT_BELOW_MINIMUM" | "INVALID_INTENT_AMOUNT_RANGE" | "INVALID_PAYOUT_CURRENCIES" | "INVALID_PAYOUT_PLATFORMS" | "INVALID_REFERRAL_CODE" | "ACTIVE_INTENT_BLOCKS_WITHDRAWAL" | "NOTHING_TO_WITHDRAW" | "INSUFFICIENT_AVAILABLE_FUNDS" | "INSUFFICIENT_TOKEN_BALANCE" | "ORDER_NOT_ACTIVE" | "INVALID_DEPOSIT_ID" | "ESCROW_PAUSED" | "INDEXER_LAG" | "INDEXER_UNAVAILABLE" | "ORDER_NOT_FOUND" | "PAYEE_REGISTRATION_FAILED" | "PAYEE_VERIFICATION_REQUIRED" | "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE" | "SOURCE_RECIPIENT_MISMATCH" | "SOURCE_CAPABILITIES_FAILED" | "SOURCE_QUOTE_FAILED" | "SOURCE_NONCE_MANAGER_REQUIRED" | "SOURCE_EXECUTION_FAILED" | "SOURCE_STATUS_FAILED" | "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED" | "SOURCE_CASHOUT_SUBMISSION_UNKNOWN" | "SOURCE_CASHOUT_STATUS_UNKNOWN" | "DEPOSIT_RESOLUTION_FAILED" | "ALLOWANCE_NOT_VISIBLE" | "SIGNER_REQUIRED" | "SIGNER_CHAIN_MISMATCH" | "SIGNER_CHAIN_UNAVAILABLE" | "WATCH_TIMEOUT" | "TRANSACTION_REJECTED" | "TRANSACTION_FAILED" | "TRANSACTION_SUBMISSION_UNKNOWN" | "TRANSACTION_STATUS_UNKNOWN";
     retryable: boolean;
     remediation: string;
     recovery?: {
@@ -3654,7 +3655,7 @@ declare const cashErrorJsonSchema: z.ZodObject<{
     } | undefined;
 }, {
     message: string;
-    code: "ORACLE_UNSUPPORTED_CURRENCY" | "ORACLE_READ_FAILED" | "UNSUPPORTED_PLATFORM" | "UNSUPPORTED_PLATFORM_CURRENCY" | "AMOUNT_BELOW_MINIMUM" | "INVALID_INTENT_AMOUNT_RANGE" | "INVALID_PAYOUT_CURRENCIES" | "INVALID_REFERRAL_CODE" | "ACTIVE_INTENT_BLOCKS_WITHDRAWAL" | "NOTHING_TO_WITHDRAW" | "INSUFFICIENT_AVAILABLE_FUNDS" | "INSUFFICIENT_TOKEN_BALANCE" | "ORDER_NOT_ACTIVE" | "INVALID_DEPOSIT_ID" | "ESCROW_PAUSED" | "INDEXER_LAG" | "INDEXER_UNAVAILABLE" | "ORDER_NOT_FOUND" | "PAYEE_REGISTRATION_FAILED" | "PAYEE_VERIFICATION_REQUIRED" | "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE" | "SOURCE_RECIPIENT_MISMATCH" | "SOURCE_CAPABILITIES_FAILED" | "SOURCE_QUOTE_FAILED" | "SOURCE_NONCE_MANAGER_REQUIRED" | "SOURCE_EXECUTION_FAILED" | "SOURCE_STATUS_FAILED" | "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED" | "SOURCE_CASHOUT_SUBMISSION_UNKNOWN" | "SOURCE_CASHOUT_STATUS_UNKNOWN" | "DEPOSIT_RESOLUTION_FAILED" | "ALLOWANCE_NOT_VISIBLE" | "SIGNER_REQUIRED" | "SIGNER_CHAIN_MISMATCH" | "SIGNER_CHAIN_UNAVAILABLE" | "WATCH_TIMEOUT" | "TRANSACTION_REJECTED" | "TRANSACTION_FAILED" | "TRANSACTION_SUBMISSION_UNKNOWN" | "TRANSACTION_STATUS_UNKNOWN";
+    code: "ORACLE_UNSUPPORTED_CURRENCY" | "ORACLE_READ_FAILED" | "UNSUPPORTED_PLATFORM" | "UNSUPPORTED_PLATFORM_CURRENCY" | "AMOUNT_BELOW_MINIMUM" | "INVALID_INTENT_AMOUNT_RANGE" | "INVALID_PAYOUT_CURRENCIES" | "INVALID_PAYOUT_PLATFORMS" | "INVALID_REFERRAL_CODE" | "ACTIVE_INTENT_BLOCKS_WITHDRAWAL" | "NOTHING_TO_WITHDRAW" | "INSUFFICIENT_AVAILABLE_FUNDS" | "INSUFFICIENT_TOKEN_BALANCE" | "ORDER_NOT_ACTIVE" | "INVALID_DEPOSIT_ID" | "ESCROW_PAUSED" | "INDEXER_LAG" | "INDEXER_UNAVAILABLE" | "ORDER_NOT_FOUND" | "PAYEE_REGISTRATION_FAILED" | "PAYEE_VERIFICATION_REQUIRED" | "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE" | "SOURCE_RECIPIENT_MISMATCH" | "SOURCE_CAPABILITIES_FAILED" | "SOURCE_QUOTE_FAILED" | "SOURCE_NONCE_MANAGER_REQUIRED" | "SOURCE_EXECUTION_FAILED" | "SOURCE_STATUS_FAILED" | "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED" | "SOURCE_CASHOUT_SUBMISSION_UNKNOWN" | "SOURCE_CASHOUT_STATUS_UNKNOWN" | "DEPOSIT_RESOLUTION_FAILED" | "ALLOWANCE_NOT_VISIBLE" | "SIGNER_REQUIRED" | "SIGNER_CHAIN_MISMATCH" | "SIGNER_CHAIN_UNAVAILABLE" | "WATCH_TIMEOUT" | "TRANSACTION_REJECTED" | "TRANSACTION_FAILED" | "TRANSACTION_SUBMISSION_UNKNOWN" | "TRANSACTION_STATUS_UNKNOWN";
     retryable: boolean;
     remediation: string;
     recovery?: {

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-D8gw-Hhv.js';
-export { o as CASH_ATTRIBUTION_CODE, p as CASH_REFERRAL_ATTRIBUTION_PREFIX, q as CashAsset, r as CashChain, s as CashClient, t as CashClientOptions, u as CashFillEta, v as CashLeg, w as CashMultiCurrencyLeg, x as CashNextAction, y as CashOrderState, z as CashPairFillStats, A as CashPayeeInput, B as CashPayout, D as CashPayoutPricing, E as CashPlatformCapability, F as CashPreparedStepKind, G as CashoutInput, H as CashoutOptions, J as CuratorPayeeDataInput, K as EstimateInput, L as EstimateOptions, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, N as PreparedCashoutReceipt, Q as RECOMMENDED_MIN_CASHOUT_AMOUNT, S as RelayOptions, U as RelayQuoteInput, V as RelaySourceInput, X as RelayTransaction, Y as SignerOptions, Z as WatchOptions, _ as WithdrawOptions, $ as buildCapabilities, a0 as createCashClient, a1 as normalizeCashPayee, a2 as toCashReferralAttributionCode } from './createCashClient-D8gw-Hhv.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-CYSM84-K.js';
+export { o as CASH_ATTRIBUTION_CODE, p as CASH_REFERRAL_ATTRIBUTION_PREFIX, q as CashAsset, r as CashChain, s as CashClient, t as CashClientOptions, u as CashFillEta, v as CashLeg, w as CashMultiCurrencyLeg, x as CashNextAction, y as CashOrderState, z as CashPairFillStats, A as CashPayeeInput, B as CashPayout, D as CashPayoutPricing, E as CashPlatformCapability, F as CashPreparedStepKind, G as CashReceiveLeg, H as CashoutInput, J as CashoutOptions, K as CuratorPayeeDataInput, L as EstimateInput, M as EstimateOptions, N as MIN_CASHOUT_AMOUNT, O as OrdersOptions, Q as PreparedCashoutReceipt, S as RECOMMENDED_MIN_CASHOUT_AMOUNT, U as RelayOptions, V as RelayQuoteInput, X as RelaySourceInput, Y as RelayTransaction, Z as SignerOptions, _ as WatchOptions, $ as WithdrawOptions, a0 as buildCapabilities, a1 as createCashClient, a2 as normalizeCashPayee, a3 as toCashReferralAttributionCode } from './createCashClient-CYSM84-K.js';
 import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
 export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
 import { Log, Abi } from 'viem';
@@ -10,7 +10,7 @@ import '@relayprotocol/relay-sdk';
  * Typed errors - every failure carries a `code`, whether it is `retryable`,
  * and a `remediation` sentence so agents can self-drive recovery.
  */
-type CashErrorCode = 'ORACLE_UNSUPPORTED_CURRENCY' | 'ORACLE_READ_FAILED' | 'UNSUPPORTED_PLATFORM' | 'UNSUPPORTED_PLATFORM_CURRENCY' | 'AMOUNT_BELOW_MINIMUM' | 'INVALID_INTENT_AMOUNT_RANGE' | 'INVALID_PAYOUT_CURRENCIES' | 'INVALID_REFERRAL_CODE' | 'ACTIVE_INTENT_BLOCKS_WITHDRAWAL' | 'NOTHING_TO_WITHDRAW' | 'INSUFFICIENT_AVAILABLE_FUNDS' | 'INSUFFICIENT_TOKEN_BALANCE' | 'ORDER_NOT_ACTIVE' | 'INVALID_DEPOSIT_ID' | 'ESCROW_PAUSED' | 'INDEXER_LAG' | 'INDEXER_UNAVAILABLE' | 'ORDER_NOT_FOUND' | 'PAYEE_REGISTRATION_FAILED' | 'PAYEE_VERIFICATION_REQUIRED' | 'SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE' | 'SOURCE_RECIPIENT_MISMATCH' | 'SOURCE_CAPABILITIES_FAILED' | 'SOURCE_QUOTE_FAILED' | 'SOURCE_NONCE_MANAGER_REQUIRED' | 'SOURCE_EXECUTION_FAILED' | 'SOURCE_STATUS_FAILED' | 'SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED' | 'SOURCE_CASHOUT_SUBMISSION_UNKNOWN' | 'SOURCE_CASHOUT_STATUS_UNKNOWN' | 'DEPOSIT_RESOLUTION_FAILED' | 'ALLOWANCE_NOT_VISIBLE' | 'SIGNER_REQUIRED' | 'SIGNER_CHAIN_MISMATCH' | 'SIGNER_CHAIN_UNAVAILABLE' | 'WATCH_TIMEOUT' | 'TRANSACTION_REJECTED' | 'TRANSACTION_FAILED' | 'TRANSACTION_SUBMISSION_UNKNOWN' | 'TRANSACTION_STATUS_UNKNOWN';
+type CashErrorCode = 'ORACLE_UNSUPPORTED_CURRENCY' | 'ORACLE_READ_FAILED' | 'UNSUPPORTED_PLATFORM' | 'UNSUPPORTED_PLATFORM_CURRENCY' | 'AMOUNT_BELOW_MINIMUM' | 'INVALID_INTENT_AMOUNT_RANGE' | 'INVALID_PAYOUT_CURRENCIES' | 'INVALID_PAYOUT_PLATFORMS' | 'INVALID_REFERRAL_CODE' | 'ACTIVE_INTENT_BLOCKS_WITHDRAWAL' | 'NOTHING_TO_WITHDRAW' | 'INSUFFICIENT_AVAILABLE_FUNDS' | 'INSUFFICIENT_TOKEN_BALANCE' | 'ORDER_NOT_ACTIVE' | 'INVALID_DEPOSIT_ID' | 'ESCROW_PAUSED' | 'INDEXER_LAG' | 'INDEXER_UNAVAILABLE' | 'ORDER_NOT_FOUND' | 'PAYEE_REGISTRATION_FAILED' | 'PAYEE_VERIFICATION_REQUIRED' | 'SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE' | 'SOURCE_RECIPIENT_MISMATCH' | 'SOURCE_CAPABILITIES_FAILED' | 'SOURCE_QUOTE_FAILED' | 'SOURCE_NONCE_MANAGER_REQUIRED' | 'SOURCE_EXECUTION_FAILED' | 'SOURCE_STATUS_FAILED' | 'SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED' | 'SOURCE_CASHOUT_SUBMISSION_UNKNOWN' | 'SOURCE_CASHOUT_STATUS_UNKNOWN' | 'DEPOSIT_RESOLUTION_FAILED' | 'ALLOWANCE_NOT_VISIBLE' | 'SIGNER_REQUIRED' | 'SIGNER_CHAIN_MISMATCH' | 'SIGNER_CHAIN_UNAVAILABLE' | 'WATCH_TIMEOUT' | 'TRANSACTION_REJECTED' | 'TRANSACTION_FAILED' | 'TRANSACTION_SUBMISSION_UNKNOWN' | 'TRANSACTION_STATUS_UNKNOWN';
 interface CashErrorShape {
     code: CashErrorCode;
     message: string;
@@ -78,6 +78,7 @@ declare const errors: {
     amountBelowMinimum: (amount: bigint, min: bigint) => CashError;
     invalidIntentAmountRange: (amount: bigint, min: bigint, max: bigint) => CashError;
     invalidPayoutCurrencies: (platform: string, reason: string) => CashError;
+    invalidPayoutPlatforms: (reason: string) => CashError;
     invalidReferralCode: () => CashError;
     activeIntentBlocksWithdrawal: (depositId: string) => CashError;
     insufficientAvailableFunds: (depositId: string, requested: bigint, available: bigint) => CashError;
@@ -224,9 +225,9 @@ interface MethodCurrencyLike {
 /**
  * Decode a deposit's payment methods + currency tuples into payout legs.
  * Pure - the environment arrives via the catalog. One leg per
- * (method, currency) pair; cash orders create exactly one in v1. If any
- * method is absent from the active catalog, reject the whole set instead of
- * partially reclassifying a mixed historical deposit.
+ * (method, currency) pair; a cash order carries one or several platforms. If
+ * any method is absent from the active catalog, reject the whole set instead
+ * of partially reclassifying a mixed historical deposit.
  */
 declare function derivePayouts(paymentMethods: ReadonlyArray<PaymentMethodLike>, currencies: ReadonlyArray<MethodCurrencyLike>, catalog: PaymentMethodCatalog): CashPayoutInfo[];
 
@@ -3185,7 +3186,7 @@ declare const cashErrorRecoveryJsonSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
     operation: string;
 }>]>;
 declare const cashErrorJsonSchema: z.ZodObject<{
-    code: z.ZodEnum<["ORACLE_UNSUPPORTED_CURRENCY", "ORACLE_READ_FAILED", "UNSUPPORTED_PLATFORM", "UNSUPPORTED_PLATFORM_CURRENCY", "AMOUNT_BELOW_MINIMUM", "INVALID_INTENT_AMOUNT_RANGE", "INVALID_PAYOUT_CURRENCIES", "INVALID_REFERRAL_CODE", "ACTIVE_INTENT_BLOCKS_WITHDRAWAL", "NOTHING_TO_WITHDRAW", "INSUFFICIENT_AVAILABLE_FUNDS", "INSUFFICIENT_TOKEN_BALANCE", "ORDER_NOT_ACTIVE", "INVALID_DEPOSIT_ID", "ESCROW_PAUSED", "INDEXER_LAG", "INDEXER_UNAVAILABLE", "ORDER_NOT_FOUND", "PAYEE_REGISTRATION_FAILED", "PAYEE_VERIFICATION_REQUIRED", "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE", "SOURCE_RECIPIENT_MISMATCH", "SOURCE_CAPABILITIES_FAILED", "SOURCE_QUOTE_FAILED", "SOURCE_NONCE_MANAGER_REQUIRED", "SOURCE_EXECUTION_FAILED", "SOURCE_STATUS_FAILED", "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED", "SOURCE_CASHOUT_SUBMISSION_UNKNOWN", "SOURCE_CASHOUT_STATUS_UNKNOWN", "DEPOSIT_RESOLUTION_FAILED", "ALLOWANCE_NOT_VISIBLE", "SIGNER_REQUIRED", "SIGNER_CHAIN_MISMATCH", "SIGNER_CHAIN_UNAVAILABLE", "WATCH_TIMEOUT", "TRANSACTION_REJECTED", "TRANSACTION_FAILED", "TRANSACTION_SUBMISSION_UNKNOWN", "TRANSACTION_STATUS_UNKNOWN"]>;
+    code: z.ZodEnum<["ORACLE_UNSUPPORTED_CURRENCY", "ORACLE_READ_FAILED", "UNSUPPORTED_PLATFORM", "UNSUPPORTED_PLATFORM_CURRENCY", "AMOUNT_BELOW_MINIMUM", "INVALID_INTENT_AMOUNT_RANGE", "INVALID_PAYOUT_CURRENCIES", "INVALID_PAYOUT_PLATFORMS", "INVALID_REFERRAL_CODE", "ACTIVE_INTENT_BLOCKS_WITHDRAWAL", "NOTHING_TO_WITHDRAW", "INSUFFICIENT_AVAILABLE_FUNDS", "INSUFFICIENT_TOKEN_BALANCE", "ORDER_NOT_ACTIVE", "INVALID_DEPOSIT_ID", "ESCROW_PAUSED", "INDEXER_LAG", "INDEXER_UNAVAILABLE", "ORDER_NOT_FOUND", "PAYEE_REGISTRATION_FAILED", "PAYEE_VERIFICATION_REQUIRED", "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE", "SOURCE_RECIPIENT_MISMATCH", "SOURCE_CAPABILITIES_FAILED", "SOURCE_QUOTE_FAILED", "SOURCE_NONCE_MANAGER_REQUIRED", "SOURCE_EXECUTION_FAILED", "SOURCE_STATUS_FAILED", "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED", "SOURCE_CASHOUT_SUBMISSION_UNKNOWN", "SOURCE_CASHOUT_STATUS_UNKNOWN", "DEPOSIT_RESOLUTION_FAILED", "ALLOWANCE_NOT_VISIBLE", "SIGNER_REQUIRED", "SIGNER_CHAIN_MISMATCH", "SIGNER_CHAIN_UNAVAILABLE", "WATCH_TIMEOUT", "TRANSACTION_REJECTED", "TRANSACTION_FAILED", "TRANSACTION_SUBMISSION_UNKNOWN", "TRANSACTION_STATUS_UNKNOWN"]>;
     message: z.ZodString;
     retryable: z.ZodBoolean;
     remediation: z.ZodString;
@@ -3572,7 +3573,7 @@ declare const cashErrorJsonSchema: z.ZodObject<{
     }>]>>;
 }, "strict", z.ZodTypeAny, {
     message: string;
-    code: "ORACLE_UNSUPPORTED_CURRENCY" | "ORACLE_READ_FAILED" | "UNSUPPORTED_PLATFORM" | "UNSUPPORTED_PLATFORM_CURRENCY" | "AMOUNT_BELOW_MINIMUM" | "INVALID_INTENT_AMOUNT_RANGE" | "INVALID_PAYOUT_CURRENCIES" | "INVALID_REFERRAL_CODE" | "ACTIVE_INTENT_BLOCKS_WITHDRAWAL" | "NOTHING_TO_WITHDRAW" | "INSUFFICIENT_AVAILABLE_FUNDS" | "INSUFFICIENT_TOKEN_BALANCE" | "ORDER_NOT_ACTIVE" | "INVALID_DEPOSIT_ID" | "ESCROW_PAUSED" | "INDEXER_LAG" | "INDEXER_UNAVAILABLE" | "ORDER_NOT_FOUND" | "PAYEE_REGISTRATION_FAILED" | "PAYEE_VERIFICATION_REQUIRED" | "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE" | "SOURCE_RECIPIENT_MISMATCH" | "SOURCE_CAPABILITIES_FAILED" | "SOURCE_QUOTE_FAILED" | "SOURCE_NONCE_MANAGER_REQUIRED" | "SOURCE_EXECUTION_FAILED" | "SOURCE_STATUS_FAILED" | "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED" | "SOURCE_CASHOUT_SUBMISSION_UNKNOWN" | "SOURCE_CASHOUT_STATUS_UNKNOWN" | "DEPOSIT_RESOLUTION_FAILED" | "ALLOWANCE_NOT_VISIBLE" | "SIGNER_REQUIRED" | "SIGNER_CHAIN_MISMATCH" | "SIGNER_CHAIN_UNAVAILABLE" | "WATCH_TIMEOUT" | "TRANSACTION_REJECTED" | "TRANSACTION_FAILED" | "TRANSACTION_SUBMISSION_UNKNOWN" | "TRANSACTION_STATUS_UNKNOWN";
+    code: "ORACLE_UNSUPPORTED_CURRENCY" | "ORACLE_READ_FAILED" | "UNSUPPORTED_PLATFORM" | "UNSUPPORTED_PLATFORM_CURRENCY" | "AMOUNT_BELOW_MINIMUM" | "INVALID_INTENT_AMOUNT_RANGE" | "INVALID_PAYOUT_CURRENCIES" | "INVALID_PAYOUT_PLATFORMS" | "INVALID_REFERRAL_CODE" | "ACTIVE_INTENT_BLOCKS_WITHDRAWAL" | "NOTHING_TO_WITHDRAW" | "INSUFFICIENT_AVAILABLE_FUNDS" | "INSUFFICIENT_TOKEN_BALANCE" | "ORDER_NOT_ACTIVE" | "INVALID_DEPOSIT_ID" | "ESCROW_PAUSED" | "INDEXER_LAG" | "INDEXER_UNAVAILABLE" | "ORDER_NOT_FOUND" | "PAYEE_REGISTRATION_FAILED" | "PAYEE_VERIFICATION_REQUIRED" | "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE" | "SOURCE_RECIPIENT_MISMATCH" | "SOURCE_CAPABILITIES_FAILED" | "SOURCE_QUOTE_FAILED" | "SOURCE_NONCE_MANAGER_REQUIRED" | "SOURCE_EXECUTION_FAILED" | "SOURCE_STATUS_FAILED" | "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED" | "SOURCE_CASHOUT_SUBMISSION_UNKNOWN" | "SOURCE_CASHOUT_STATUS_UNKNOWN" | "DEPOSIT_RESOLUTION_FAILED" | "ALLOWANCE_NOT_VISIBLE" | "SIGNER_REQUIRED" | "SIGNER_CHAIN_MISMATCH" | "SIGNER_CHAIN_UNAVAILABLE" | "WATCH_TIMEOUT" | "TRANSACTION_REJECTED" | "TRANSACTION_FAILED" | "TRANSACTION_SUBMISSION_UNKNOWN" | "TRANSACTION_STATUS_UNKNOWN";
     retryable: boolean;
     remediation: string;
     recovery?: {
@@ -3654,7 +3655,7 @@ declare const cashErrorJsonSchema: z.ZodObject<{
     } | undefined;
 }, {
     message: string;
-    code: "ORACLE_UNSUPPORTED_CURRENCY" | "ORACLE_READ_FAILED" | "UNSUPPORTED_PLATFORM" | "UNSUPPORTED_PLATFORM_CURRENCY" | "AMOUNT_BELOW_MINIMUM" | "INVALID_INTENT_AMOUNT_RANGE" | "INVALID_PAYOUT_CURRENCIES" | "INVALID_REFERRAL_CODE" | "ACTIVE_INTENT_BLOCKS_WITHDRAWAL" | "NOTHING_TO_WITHDRAW" | "INSUFFICIENT_AVAILABLE_FUNDS" | "INSUFFICIENT_TOKEN_BALANCE" | "ORDER_NOT_ACTIVE" | "INVALID_DEPOSIT_ID" | "ESCROW_PAUSED" | "INDEXER_LAG" | "INDEXER_UNAVAILABLE" | "ORDER_NOT_FOUND" | "PAYEE_REGISTRATION_FAILED" | "PAYEE_VERIFICATION_REQUIRED" | "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE" | "SOURCE_RECIPIENT_MISMATCH" | "SOURCE_CAPABILITIES_FAILED" | "SOURCE_QUOTE_FAILED" | "SOURCE_NONCE_MANAGER_REQUIRED" | "SOURCE_EXECUTION_FAILED" | "SOURCE_STATUS_FAILED" | "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED" | "SOURCE_CASHOUT_SUBMISSION_UNKNOWN" | "SOURCE_CASHOUT_STATUS_UNKNOWN" | "DEPOSIT_RESOLUTION_FAILED" | "ALLOWANCE_NOT_VISIBLE" | "SIGNER_REQUIRED" | "SIGNER_CHAIN_MISMATCH" | "SIGNER_CHAIN_UNAVAILABLE" | "WATCH_TIMEOUT" | "TRANSACTION_REJECTED" | "TRANSACTION_FAILED" | "TRANSACTION_SUBMISSION_UNKNOWN" | "TRANSACTION_STATUS_UNKNOWN";
+    code: "ORACLE_UNSUPPORTED_CURRENCY" | "ORACLE_READ_FAILED" | "UNSUPPORTED_PLATFORM" | "UNSUPPORTED_PLATFORM_CURRENCY" | "AMOUNT_BELOW_MINIMUM" | "INVALID_INTENT_AMOUNT_RANGE" | "INVALID_PAYOUT_CURRENCIES" | "INVALID_PAYOUT_PLATFORMS" | "INVALID_REFERRAL_CODE" | "ACTIVE_INTENT_BLOCKS_WITHDRAWAL" | "NOTHING_TO_WITHDRAW" | "INSUFFICIENT_AVAILABLE_FUNDS" | "INSUFFICIENT_TOKEN_BALANCE" | "ORDER_NOT_ACTIVE" | "INVALID_DEPOSIT_ID" | "ESCROW_PAUSED" | "INDEXER_LAG" | "INDEXER_UNAVAILABLE" | "ORDER_NOT_FOUND" | "PAYEE_REGISTRATION_FAILED" | "PAYEE_VERIFICATION_REQUIRED" | "SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE" | "SOURCE_RECIPIENT_MISMATCH" | "SOURCE_CAPABILITIES_FAILED" | "SOURCE_QUOTE_FAILED" | "SOURCE_NONCE_MANAGER_REQUIRED" | "SOURCE_EXECUTION_FAILED" | "SOURCE_STATUS_FAILED" | "SOURCE_ROUTE_COMPLETED_CASHOUT_FAILED" | "SOURCE_CASHOUT_SUBMISSION_UNKNOWN" | "SOURCE_CASHOUT_STATUS_UNKNOWN" | "DEPOSIT_RESOLUTION_FAILED" | "ALLOWANCE_NOT_VISIBLE" | "SIGNER_REQUIRED" | "SIGNER_CHAIN_MISMATCH" | "SIGNER_CHAIN_UNAVAILABLE" | "WATCH_TIMEOUT" | "TRANSACTION_REJECTED" | "TRANSACTION_FAILED" | "TRANSACTION_SUBMISSION_UNKNOWN" | "TRANSACTION_STATUS_UNKNOWN";
     retryable: boolean;
     remediation: string;
     recovery?: {

package/dist/index.js

@@ -1,5 +1,5 @@
-import { MARKET_SPREAD_BPS, ORACLE_MIN_CONVERSION_RATE_SENTINEL, CASH_RETAIN_ON_EMPTY, BASE_USDC_ADDRESS, USDC_DECIMALS, BASE_CHAIN_ID, errors, isCashError, CASH_ORDER_STATUSES, mapChainError, CashError } from './chunk-QCRY4XPA.js';
-export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, CashError, MARKET_SPREAD_BPS, ORACLE_MIN_CONVERSION_RATE_SENTINEL, USDC_DECIMALS, errors, isCashError, isUserRejectedError } from './chunk-QCRY4XPA.js';
+import { MARKET_SPREAD_BPS, ORACLE_MIN_CONVERSION_RATE_SENTINEL, CASH_RETAIN_ON_EMPTY, BASE_USDC_ADDRESS, USDC_DECIMALS, BASE_CHAIN_ID, errors, isCashError, CASH_ORDER_STATUSES, mapChainError, CashError } from './chunk-EIEGWWNX.js';
+export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, CashError, MARKET_SPREAD_BPS, ORACLE_MIN_CONVERSION_RATE_SENTINEL, USDC_DECIMALS, errors, isCashError, isUserRejectedError } from './chunk-EIEGWWNX.js';
 import { parseAbi, parseEventLogs, isAddress, http, createWalletClient, encodeFunctionData } from 'viem';
 import { base } from 'viem/chains';
 import { getSpreadOracleConfig, currencyInfo, getPaymentMethodsCatalog, getGatingServiceAddress, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, getCurrencyCodeFromHash, createCompositeDepositId, appendAttributionToCalldata, Zkp2pClient, CHAINLINK_ORACLE_FEEDS } from '@zkp2p/sdk';
@@ -447,6 +447,9 @@ var PAYEE_HINTS = {
   n26: "MoneyBeam email or phone number"
 };
 var IDENTITY_ATTESTATION_PLATFORMS = /* @__PURE__ */ new Set(["wise", "paypal"]);
+function platformRequiresIdentityAttestation(platform) {
+  return IDENTITY_ATTESTATION_PLATFORMS.has(platform);
+}
 function buildCapabilities(environment) {
   const catalog = getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
   const platforms = Object.entries(catalog).map(([platform, entry]) => {
@@ -1363,41 +1366,51 @@ function createCashClient(options) {
     return client;
   }
   function validatePayout(input) {
-    const { receive } = input;
-    const platform = buildCapabilities(environment).platforms.find(
-      (capability) => capability.platform === receive.platform
-    );
-    if (!platform) throw errors.unsupportedPlatform(receive.platform);
-    if (receive.currency === void 0 === (receive.currencies === void 0)) {
-      throw errors.invalidPayoutCurrencies(
-        receive.platform,
-        "pass exactly one of currency or currencies"
-      );
+    const legs = Array.isArray(input.receive) ? input.receive : [input.receive];
+    if (legs.length === 0) {
+      throw errors.invalidPayoutPlatforms("at least one payout leg is required");
     }
-    const currencies = receive.currencies !== void 0 ? [...receive.currencies] : [receive.currency];
-    if (currencies.length === 0) {
-      throw errors.invalidPayoutCurrencies(receive.platform, "at least one currency is required");
-    }
-    if (new Set(currencies).size !== currencies.length) {
-      throw errors.invalidPayoutCurrencies(receive.platform, "currencies must be unique");
-    }
-    for (const currency of currencies) {
-      if (!isMarketRateSupported(currency)) {
-        throw errors.oracleUnsupportedCurrency(currency);
+    const capabilities2 = buildCapabilities(environment);
+    const seenPlatforms = /* @__PURE__ */ new Set();
+    const payouts = legs.map((leg) => {
+      const platform = capabilities2.platforms.find(
+        (capability) => capability.platform === leg.platform
+      );
+      if (!platform) throw errors.unsupportedPlatform(leg.platform);
+      if (seenPlatforms.has(leg.platform)) {
+        throw errors.invalidPayoutPlatforms(
+          `${leg.platform} appears more than once - each platform may carry one leg`
+        );
       }
-      if (!platform.currencies.includes(currency)) {
-        throw errors.unsupportedPlatformCurrency(receive.platform, currency);
+      seenPlatforms.add(leg.platform);
+      if (leg.currency === void 0 === (leg.currencies === void 0)) {
+        throw errors.invalidPayoutCurrencies(
+          leg.platform,
+          "pass exactly one of currency or currencies"
+        );
       }
-    }
-    return {
-      payouts: [
-        {
-          processorName: receive.platform,
-          ...currencies.length === 1 ? { currency: currencies[0] } : { currencies },
-          payeeData: normalizeCashPayee(receive.platform, receive.payee)
+      const currencies = leg.currencies !== void 0 ? [...leg.currencies] : [leg.currency];
+      if (currencies.length === 0) {
+        throw errors.invalidPayoutCurrencies(leg.platform, "at least one currency is required");
+      }
+      if (new Set(currencies).size !== currencies.length) {
+        throw errors.invalidPayoutCurrencies(leg.platform, "currencies must be unique");
+      }
+      for (const currency of currencies) {
+        if (!isMarketRateSupported(currency)) {
+          throw errors.oracleUnsupportedCurrency(currency);
         }
-      ]
-    };
+        if (!platform.currencies.includes(currency)) {
+          throw errors.unsupportedPlatformCurrency(leg.platform, currency);
+        }
+      }
+      return {
+        processorName: leg.platform,
+        ...currencies.length === 1 ? { currency: currencies[0] } : { currencies },
+        payeeData: normalizeCashPayee(leg.platform, leg.payee)
+      };
+    });
+    return { payouts };
   }
   function validateDepositInput(amount, input, payoutInput = validatePayout(input)) {
     if (amount < MIN_CASHOUT_AMOUNT) {
@@ -1414,12 +1427,7 @@ function createCashClient(options) {
     };
   }
   function isCashPayoutSet(payouts) {
-    const first = payouts[0];
-    return Boolean(
-      first && payouts.every(
-        (payout) => payout.platformHash.toLowerCase() === first.platformHash.toLowerCase() && payout.payeeHash.toLowerCase() === first.payeeHash.toLowerCase() && payout.pricing.marketRate && payout.pricing.spreadBps === 0
-      )
-    );
+    return payouts.length > 0 && payouts.every((payout) => payout.pricing.marketRate && payout.pricing.spreadBps === 0);
   }
   async function buildDepositParams(client, depositInput) {
     try {
@@ -1428,7 +1436,8 @@ function createCashClient(options) {
       if (isCashError(err)) throw err;
       const message = err instanceof Error ? err.message : String(err);
       if (/identityAttestation is required|identity attestation/i.test(message)) {
-        const platform = depositInput.payouts[0]?.processorName ?? "this platform";
+        const platforms = depositInput.payouts.map((payout) => payout.processorName);
+        const platform = platforms.find(platformRequiresIdentityAttestation) ?? platforms[0] ?? "this platform";
         throw errors.payeeVerificationRequired(platform, err);
       }
       throw errors.payeeRegistrationFailed(err);
@@ -2437,6 +2446,7 @@ var CASH_ERROR_CODES = defineCashErrorCodes([
   "AMOUNT_BELOW_MINIMUM",
   "INVALID_INTENT_AMOUNT_RANGE",
   "INVALID_PAYOUT_CURRENCIES",
+  "INVALID_PAYOUT_PLATFORMS",
   "INVALID_REFERRAL_CODE",
   "ACTIVE_INTENT_BLOCKS_WITHDRAWAL",
   "NOTHING_TO_WITHDRAW",

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { s as CashClient, K as EstimateInput, i as CashEstimate, H as CashoutOptions, h as CashoutResult, G as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-D8gw-Hhv.cjs';
+import { s as CashClient, L as EstimateInput, i as CashEstimate, J as CashoutOptions, h as CashoutResult, H as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-CYSM84-K.cjs';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { s as CashClient, K as EstimateInput, i as CashEstimate, H as CashoutOptions, h as CashoutResult, G as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-D8gw-Hhv.js';
+import { s as CashClient, L as EstimateInput, i as CashEstimate, J as CashoutOptions, h as CashoutResult, H as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-CYSM84-K.js';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/react.js

@@ -1,4 +1,4 @@
-import { isCashError, CASH_ORDER_POLL_INTERVAL_MS } from './chunk-QCRY4XPA.js';
+import { isCashError, CASH_ORDER_POLL_INTERVAL_MS } from './chunk-EIEGWWNX.js';
 import { useState, useRef, useCallback, useEffect, useMemo } from 'react';
 
 function useEstimate({

package/dist/tools.cjs

@@ -2,7 +2,7 @@
 
 // package.json
 var package_default = {
-  version: "0.4.0-rc.2"};
+  version: "0.4.0-rc.3"};
 
 // src/tools/index.ts
 var bigintString = {
@@ -24,6 +24,47 @@ var chainId = {
   minimum: 1,
   maximum: Number.MAX_SAFE_INTEGER
 };
+var receiveLeg = {
+  type: "object",
+  description: "One payout leg: platform + currency choice + payee",
+  properties: {
+    platform: {
+      type: "string",
+      description: 'Platform id from cash_capabilities, e.g. "venmo"'
+    },
+    currency: { type: "string", description: 'Fiat currency code, e.g. "USD"' },
+    currencies: {
+      type: "array",
+      minItems: 1,
+      uniqueItems: true,
+      items: { type: "string" },
+      description: 'Fiat currency choices for one payment method, e.g. ["EUR", "GBP"]'
+    },
+    payee: {
+      description: "Raw payee handle or structured curator payee data",
+      oneOf: [
+        {
+          type: "string",
+          description: 'User-entered handle, e.g. "@andrew" for Venmo; Peer Cash normalizes it for the selected platform'
+        },
+        {
+          type: "object",
+          properties: {
+            offchainId: {
+              type: "string",
+              description: "Already-normalized handle for the platform"
+            }
+          },
+          required: ["offchainId"],
+          additionalProperties: true
+        }
+      ]
+    }
+  },
+  required: ["platform", "payee"],
+  oneOf: [{ required: ["currency"] }, { required: ["currencies"] }],
+  additionalProperties: false
+};
 var builtInCashTools = [
   {
     name: "cash_capabilities",
@@ -129,45 +170,16 @@ var builtInCashTools = [
       properties: {
         amount: bigintString,
         receive: {
-          type: "object",
-          description: "Where the fiat should arrive",
-          properties: {
-            platform: {
-              type: "string",
-              description: 'Platform id from cash_capabilities, e.g. "venmo"'
-            },
-            currency: { type: "string", description: 'Fiat currency code, e.g. "USD"' },
-            currencies: {
+          description: "Where the fiat should arrive: one payout leg, or an array of legs to offer several platforms (each platform at most once; every leg fills at the live oracle market rate)",
+          oneOf: [
+            receiveLeg,
+            {
               type: "array",
               minItems: 1,
-              uniqueItems: true,
-              items: { type: "string" },
-              description: 'Fiat currency choices for one payment method, e.g. ["EUR", "GBP"]'
-            },
-            payee: {
-              description: "Raw payee handle or structured curator payee data",
-              oneOf: [
-                {
-                  type: "string",
-                  description: 'User-entered handle, e.g. "@andrew" for Venmo; Peer Cash normalizes it for the selected platform'
-                },
-                {
-                  type: "object",
-                  properties: {
-                    offchainId: {
-                      type: "string",
-                      description: "Already-normalized handle for the platform"
-                    }
-                  },
-                  required: ["offchainId"],
-                  additionalProperties: true
-                }
-              ]
+              items: receiveLeg,
+              description: "Multiple payout legs across different platforms"
             }
-          },
-          required: ["platform", "payee"],
-          oneOf: [{ required: ["currency"] }, { required: ["currencies"] }],
-          additionalProperties: false
+          ]
         }
       },
       required: ["amount", "receive"],

package/dist/tools.d.cts

@@ -155,51 +155,105 @@ declare const builtInCashTools: readonly [{
                 readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
             };
             readonly receive: {
-                readonly type: "object";
-                readonly description: "Where the fiat should arrive";
-                readonly properties: {
-                    readonly platform: {
-                        readonly type: "string";
-                        readonly description: "Platform id from cash_capabilities, e.g. \"venmo\"";
-                    };
-                    readonly currency: {
-                        readonly type: "string";
-                        readonly description: "Fiat currency code, e.g. \"USD\"";
-                    };
-                    readonly currencies: {
-                        readonly type: "array";
-                        readonly minItems: 1;
-                        readonly uniqueItems: true;
-                        readonly items: {
+                readonly description: "Where the fiat should arrive: one payout leg, or an array of legs to offer several platforms (each platform at most once; every leg fills at the live oracle market rate)";
+                readonly oneOf: readonly [{
+                    readonly type: "object";
+                    readonly description: "One payout leg: platform + currency choice + payee";
+                    readonly properties: {
+                        readonly platform: {
                             readonly type: "string";
+                            readonly description: "Platform id from cash_capabilities, e.g. \"venmo\"";
                         };
-                        readonly description: "Fiat currency choices for one payment method, e.g. [\"EUR\", \"GBP\"]";
-                    };
-                    readonly payee: {
-                        readonly description: "Raw payee handle or structured curator payee data";
-                        readonly oneOf: readonly [{
+                        readonly currency: {
                             readonly type: "string";
-                            readonly description: "User-entered handle, e.g. \"@andrew\" for Venmo; Peer Cash normalizes it for the selected platform";
-                        }, {
-                            readonly type: "object";
-                            readonly properties: {
-                                readonly offchainId: {
+                            readonly description: "Fiat currency code, e.g. \"USD\"";
+                        };
+                        readonly currencies: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly uniqueItems: true;
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                            readonly description: "Fiat currency choices for one payment method, e.g. [\"EUR\", \"GBP\"]";
+                        };
+                        readonly payee: {
+                            readonly description: "Raw payee handle or structured curator payee data";
+                            readonly oneOf: readonly [{
+                                readonly type: "string";
+                                readonly description: "User-entered handle, e.g. \"@andrew\" for Venmo; Peer Cash normalizes it for the selected platform";
+                            }, {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly offchainId: {
+                                        readonly type: "string";
+                                        readonly description: "Already-normalized handle for the platform";
+                                    };
+                                };
+                                readonly required: readonly ["offchainId"];
+                                readonly additionalProperties: true;
+                            }];
+                        };
+                    };
+                    readonly required: readonly ["platform", "payee"];
+                    readonly oneOf: readonly [{
+                        readonly required: readonly ["currency"];
+                    }, {
+                        readonly required: readonly ["currencies"];
+                    }];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly description: "One payout leg: platform + currency choice + payee";
+                        readonly properties: {
+                            readonly platform: {
+                                readonly type: "string";
+                                readonly description: "Platform id from cash_capabilities, e.g. \"venmo\"";
+                            };
+                            readonly currency: {
+                                readonly type: "string";
+                                readonly description: "Fiat currency code, e.g. \"USD\"";
+                            };
+                            readonly currencies: {
+                                readonly type: "array";
+                                readonly minItems: 1;
+                                readonly uniqueItems: true;
+                                readonly items: {
                                     readonly type: "string";
-                                    readonly description: "Already-normalized handle for the platform";
                                 };
+                                readonly description: "Fiat currency choices for one payment method, e.g. [\"EUR\", \"GBP\"]";
+                            };
+                            readonly payee: {
+                                readonly description: "Raw payee handle or structured curator payee data";
+                                readonly oneOf: readonly [{
+                                    readonly type: "string";
+                                    readonly description: "User-entered handle, e.g. \"@andrew\" for Venmo; Peer Cash normalizes it for the selected platform";
+                                }, {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly offchainId: {
+                                            readonly type: "string";
+                                            readonly description: "Already-normalized handle for the platform";
+                                        };
+                                    };
+                                    readonly required: readonly ["offchainId"];
+                                    readonly additionalProperties: true;
+                                }];
                             };
-                            readonly required: readonly ["offchainId"];
-                            readonly additionalProperties: true;
+                        };
+                        readonly required: readonly ["platform", "payee"];
+                        readonly oneOf: readonly [{
+                            readonly required: readonly ["currency"];
+                        }, {
+                            readonly required: readonly ["currencies"];
                         }];
+                        readonly additionalProperties: false;
                     };
-                };
-                readonly required: readonly ["platform", "payee"];
-                readonly oneOf: readonly [{
-                    readonly required: readonly ["currency"];
-                }, {
-                    readonly required: readonly ["currencies"];
+                    readonly description: "Multiple payout legs across different platforms";
                 }];
-                readonly additionalProperties: false;
             };
         };
         readonly required: readonly ["amount", "receive"];

package/dist/tools.d.ts

@@ -155,51 +155,105 @@ declare const builtInCashTools: readonly [{
                 readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
             };
             readonly receive: {
-                readonly type: "object";
-                readonly description: "Where the fiat should arrive";
-                readonly properties: {
-                    readonly platform: {
-                        readonly type: "string";
-                        readonly description: "Platform id from cash_capabilities, e.g. \"venmo\"";
-                    };
-                    readonly currency: {
-                        readonly type: "string";
-                        readonly description: "Fiat currency code, e.g. \"USD\"";
-                    };
-                    readonly currencies: {
-                        readonly type: "array";
-                        readonly minItems: 1;
-                        readonly uniqueItems: true;
-                        readonly items: {
+                readonly description: "Where the fiat should arrive: one payout leg, or an array of legs to offer several platforms (each platform at most once; every leg fills at the live oracle market rate)";
+                readonly oneOf: readonly [{
+                    readonly type: "object";
+                    readonly description: "One payout leg: platform + currency choice + payee";
+                    readonly properties: {
+                        readonly platform: {
                             readonly type: "string";
+                            readonly description: "Platform id from cash_capabilities, e.g. \"venmo\"";
                         };
-                        readonly description: "Fiat currency choices for one payment method, e.g. [\"EUR\", \"GBP\"]";
-                    };
-                    readonly payee: {
-                        readonly description: "Raw payee handle or structured curator payee data";
-                        readonly oneOf: readonly [{
+                        readonly currency: {
                             readonly type: "string";
-                            readonly description: "User-entered handle, e.g. \"@andrew\" for Venmo; Peer Cash normalizes it for the selected platform";
-                        }, {
-                            readonly type: "object";
-                            readonly properties: {
-                                readonly offchainId: {
+                            readonly description: "Fiat currency code, e.g. \"USD\"";
+                        };
+                        readonly currencies: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly uniqueItems: true;
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                            readonly description: "Fiat currency choices for one payment method, e.g. [\"EUR\", \"GBP\"]";
+                        };
+                        readonly payee: {
+                            readonly description: "Raw payee handle or structured curator payee data";
+                            readonly oneOf: readonly [{
+                                readonly type: "string";
+                                readonly description: "User-entered handle, e.g. \"@andrew\" for Venmo; Peer Cash normalizes it for the selected platform";
+                            }, {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly offchainId: {
+                                        readonly type: "string";
+                                        readonly description: "Already-normalized handle for the platform";
+                                    };
+                                };
+                                readonly required: readonly ["offchainId"];
+                                readonly additionalProperties: true;
+                            }];
+                        };
+                    };
+                    readonly required: readonly ["platform", "payee"];
+                    readonly oneOf: readonly [{
+                        readonly required: readonly ["currency"];
+                    }, {
+                        readonly required: readonly ["currencies"];
+                    }];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly description: "One payout leg: platform + currency choice + payee";
+                        readonly properties: {
+                            readonly platform: {
+                                readonly type: "string";
+                                readonly description: "Platform id from cash_capabilities, e.g. \"venmo\"";
+                            };
+                            readonly currency: {
+                                readonly type: "string";
+                                readonly description: "Fiat currency code, e.g. \"USD\"";
+                            };
+                            readonly currencies: {
+                                readonly type: "array";
+                                readonly minItems: 1;
+                                readonly uniqueItems: true;
+                                readonly items: {
                                     readonly type: "string";
-                                    readonly description: "Already-normalized handle for the platform";
                                 };
+                                readonly description: "Fiat currency choices for one payment method, e.g. [\"EUR\", \"GBP\"]";
+                            };
+                            readonly payee: {
+                                readonly description: "Raw payee handle or structured curator payee data";
+                                readonly oneOf: readonly [{
+                                    readonly type: "string";
+                                    readonly description: "User-entered handle, e.g. \"@andrew\" for Venmo; Peer Cash normalizes it for the selected platform";
+                                }, {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly offchainId: {
+                                            readonly type: "string";
+                                            readonly description: "Already-normalized handle for the platform";
+                                        };
+                                    };
+                                    readonly required: readonly ["offchainId"];
+                                    readonly additionalProperties: true;
+                                }];
                             };
-                            readonly required: readonly ["offchainId"];
-                            readonly additionalProperties: true;
+                        };
+                        readonly required: readonly ["platform", "payee"];
+                        readonly oneOf: readonly [{
+                            readonly required: readonly ["currency"];
+                        }, {
+                            readonly required: readonly ["currencies"];
                         }];
+                        readonly additionalProperties: false;
                     };
-                };
-                readonly required: readonly ["platform", "payee"];
-                readonly oneOf: readonly [{
-                    readonly required: readonly ["currency"];
-                }, {
-                    readonly required: readonly ["currencies"];
+                    readonly description: "Multiple payout legs across different platforms";
                 }];
-                readonly additionalProperties: false;
             };
         };
         readonly required: readonly ["amount", "receive"];

package/dist/tools.js

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "0.4.0-rc.2"};
+  version: "0.4.0-rc.3"};
 
 // src/tools/index.ts
 var bigintString = {
@@ -22,6 +22,47 @@ var chainId = {
   minimum: 1,
   maximum: Number.MAX_SAFE_INTEGER
 };
+var receiveLeg = {
+  type: "object",
+  description: "One payout leg: platform + currency choice + payee",
+  properties: {
+    platform: {
+      type: "string",
+      description: 'Platform id from cash_capabilities, e.g. "venmo"'
+    },
+    currency: { type: "string", description: 'Fiat currency code, e.g. "USD"' },
+    currencies: {
+      type: "array",
+      minItems: 1,
+      uniqueItems: true,
+      items: { type: "string" },
+      description: 'Fiat currency choices for one payment method, e.g. ["EUR", "GBP"]'
+    },
+    payee: {
+      description: "Raw payee handle or structured curator payee data",
+      oneOf: [
+        {
+          type: "string",
+          description: 'User-entered handle, e.g. "@andrew" for Venmo; Peer Cash normalizes it for the selected platform'
+        },
+        {
+          type: "object",
+          properties: {
+            offchainId: {
+              type: "string",
+              description: "Already-normalized handle for the platform"
+            }
+          },
+          required: ["offchainId"],
+          additionalProperties: true
+        }
+      ]
+    }
+  },
+  required: ["platform", "payee"],
+  oneOf: [{ required: ["currency"] }, { required: ["currencies"] }],
+  additionalProperties: false
+};
 var builtInCashTools = [
   {
     name: "cash_capabilities",
@@ -127,45 +168,16 @@ var builtInCashTools = [
       properties: {
         amount: bigintString,
         receive: {
-          type: "object",
-          description: "Where the fiat should arrive",
-          properties: {
-            platform: {
-              type: "string",
-              description: 'Platform id from cash_capabilities, e.g. "venmo"'
-            },
-            currency: { type: "string", description: 'Fiat currency code, e.g. "USD"' },
-            currencies: {
+          description: "Where the fiat should arrive: one payout leg, or an array of legs to offer several platforms (each platform at most once; every leg fills at the live oracle market rate)",
+          oneOf: [
+            receiveLeg,
+            {
               type: "array",
               minItems: 1,
-              uniqueItems: true,
-              items: { type: "string" },
-              description: 'Fiat currency choices for one payment method, e.g. ["EUR", "GBP"]'
-            },
-            payee: {
-              description: "Raw payee handle or structured curator payee data",
-              oneOf: [
-                {
-                  type: "string",
-                  description: 'User-entered handle, e.g. "@andrew" for Venmo; Peer Cash normalizes it for the selected platform'
-                },
-                {
-                  type: "object",
-                  properties: {
-                    offchainId: {
-                      type: "string",
-                      description: "Already-normalized handle for the platform"
-                    }
-                  },
-                  required: ["offchainId"],
-                  additionalProperties: true
-                }
-              ]
+              items: receiveLeg,
+              description: "Multiple payout legs across different platforms"
             }
-          },
-          required: ["platform", "payee"],
-          oneOf: [{ required: ["currency"] }, { required: ["currencies"] }],
-          additionalProperties: false
+          ]
         }
       },
       required: ["amount", "receive"],

package/llms.txt

@@ -55,6 +55,9 @@ Key facts:
   their on-chain hashes, plain-number rates from 1e18 precision.
 - Fills are receipts: locked rate + fiat owed at signal; verified fiat paid,
   payment id, released USDC, and fill latency after the proof.
+- `receive` takes one payout leg or an array of legs across different
+  platforms (each platform at most once); every leg fills at the live oracle
+  market rate.
 - Orders carry their payout legs (platform, currency, payee hash) plus a
   verifiable pricing proof (spreadBps: 0, oracle kind) from indexed data.
 - Order reads fail closed when any deposit method is absent from the active

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkp2p/cash",
-  "version": "0.4.0-rc.2",
+  "version": "0.4.0-rc.3",
   "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)",

package/skills/peer-cash-integration/SKILL.md

@@ -61,6 +61,8 @@ const res = await cash.cashout(
   {
     // 2 execute
     amount: usdc(100),
+    // or an array of legs to offer several platforms on one order:
+    // receive: [{ platform: 'venmo', ... }, { platform: 'revolut', ... }]
     receive: { platform: 'venmo', currency: 'USD', payee: { offchainId: '@handle' } },
   },
   { signer },