@zkp2p/cash 0.1.9 → 0.2.1

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-TR6JVYYF.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 } from './chunk-TR6JVYYF.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-5VBP3IWK.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-5VBP3IWK.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';
@@ -7,6 +7,12 @@ import { createClient, MAINNET_RELAY_API } from '@relayprotocol/relay-sdk';
 import { fetchChainConfigs, configureDynamicChains } from '@relayprotocol/relay-sdk/chain-utils';
 import { z } from 'zod';
 
+function payoutCurrencies(payout) {
+  if (payout.currency === void 0 === (payout.currencies === void 0)) {
+    throw new Error("Pass exactly one of payout currency or currencies");
+  }
+  return payout.currencies ?? [payout.currency];
+}
 function isMarketRateSupported(currency, adapters) {
   return getSpreadOracleConfig(currency, adapters) != null;
 }
@@ -38,14 +44,32 @@ async function prepareCashDepositParams(client, input, adapters) {
   const runtimeEnv = client.runtimeEnv;
   const catalog = getPaymentMethodsCatalog(chainId, runtimeEnv);
   const intentGatingService = getGatingServiceAddress(chainId, runtimeEnv);
+  const processorNames = payouts.map((p) => p.processorName);
+  const paymentMethodsOverride = processorNames.map(
+    (name) => resolvePaymentMethodHashFromCatalog(name, catalog)
+  );
   for (const payout of payouts) {
-    if (!isMarketRateSupported(payout.currency, adapters)) {
-      throw new Error(
-        `${payout.currency} has no live market-rate oracle feed; Peer Cash supports market-rate currencies only.`
-      );
+    const currencies = payoutCurrencies(payout);
+    if (currencies.length === 0 || new Set(currencies).size !== currencies.length) {
+      throw new Error("Payout currencies must be non-empty and unique");
+    }
+    const supportedCurrencyHashes = new Set(
+      (catalog[payout.processorName.toLowerCase()]?.currencies ?? []).map(
+        (hash) => hash.toLowerCase()
+      )
+    );
+    for (const currency of currencies) {
+      if (!isMarketRateSupported(currency, adapters)) {
+        throw new Error(
+          `${currency} has no live market-rate oracle feed; Peer Cash supports market-rate currencies only.`
+        );
+      }
+      const currencyHash = currencyInfo[currency]?.currencyCodeHash;
+      if (!currencyHash || !supportedCurrencyHashes.has(currencyHash.toLowerCase())) {
+        throw new Error(`${payout.processorName} does not support ${currency}`);
+      }
     }
   }
-  const processorNames = payouts.map((p) => p.processorName);
   const { hashedOnchainIds } = await client.registerPayeeDetails({
     processorNames,
     payeeData: payouts.map((p) => p.payeeData)
@@ -53,22 +77,24 @@ async function prepareCashDepositParams(client, input, adapters) {
   if (hashedOnchainIds.length !== payouts.length) {
     throw new Error("Payee registration returned an unexpected number of hashes");
   }
-  const paymentMethodsOverride = processorNames.map(
-    (name) => resolvePaymentMethodHashFromCatalog(name, catalog)
-  );
   const paymentMethodDataOverride = hashedOnchainIds.map((hid) => ({
     intentGatingService,
     payeeDetails: hid,
     data: "0x"
   }));
-  const currenciesOverride = payouts.map((p) => {
-    const tuple = buildMarketRateCurrencyOverride(p.currency, adapters);
-    if (!tuple) throw new Error(`Failed to build market-rate config for ${p.currency}`);
-    return [tuple];
-  });
-  const conversionRates = payouts.map((p) => [
-    { currency: p.currency, conversionRate: ORACLE_MIN_CONVERSION_RATE_SENTINEL.toString() }
-  ]);
+  const currenciesOverride = payouts.map(
+    (payout) => payoutCurrencies(payout).map((currency) => {
+      const tuple = buildMarketRateCurrencyOverride(currency, adapters);
+      if (!tuple) throw new Error(`Failed to build market-rate config for ${currency}`);
+      return tuple;
+    })
+  );
+  const conversionRates = payouts.map(
+    (payout) => payoutCurrencies(payout).map((currency) => ({
+      currency,
+      conversionRate: ORACLE_MIN_CONVERSION_RATE_SENTINEL.toString()
+    }))
+  );
   const intentAmountRange = input.intentAmountRange ?? buildIntentAmountRange(input.amount);
   return {
     token: input.token ?? BASE_USDC_ADDRESS,
@@ -287,35 +313,41 @@ function toPricing(tuple) {
   };
 }
 function derivePayouts(paymentMethods, currencies, catalog) {
-  return paymentMethods.flatMap((method) => {
+  const payouts = [];
+  for (const method of paymentMethods) {
     const platformHash = method.paymentMethodHash ?? "";
     if (!platformHash) return [];
     let platform;
     try {
       platform = resolvePaymentMethodNameFromHash(platformHash, catalog);
     } catch {
-      platform = void 0;
+      return [];
     }
+    if (!platform) return [];
     const tuples = currencies.filter(
       (c) => (c.paymentMethodHash ?? "").toLowerCase() === platformHash.toLowerCase()
     );
     const base2 = {
-      ...platform !== void 0 ? { platform } : {},
+      platform,
       platformHash,
       payeeHash: method.payeeDetailsHash ?? "",
       active: method.active ?? true
     };
-    if (tuples.length === 0) return [{ ...base2, pricing: toPricing(void 0) }];
-    return tuples.map((tuple) => {
+    if (tuples.length === 0) {
+      payouts.push({ ...base2, pricing: toPricing(void 0) });
+      continue;
+    }
+    for (const tuple of tuples) {
       const currency = tuple.currencyCode != null ? getCurrencyCodeFromHash(tuple.currencyCode) : void 0;
-      return {
+      payouts.push({
         ...base2,
         ...currency !== void 0 ? { currency } : {},
         ...tuple.currencyCode != null ? { currencyHash: tuple.currencyCode } : {},
         pricing: toPricing(tuple)
-      };
-    });
-  });
+      });
+    }
+  }
+  return payouts;
 }
 
 // src/engine/buyerProfile.ts
@@ -359,21 +391,33 @@ function resolveCashDepositId(params) {
     events = parseEventLogs({
       abi: params.abi,
       eventName: "DepositReceived",
-      logs: params.logs
+      logs: [...params.logs]
     });
   } catch {
     return null;
   }
-  const event = events[0];
-  if (!event) return null;
+  const matchingEvents = events.filter((event2) => {
+    if (params.expectedEscrowAddress !== void 0 && event2.address.toLowerCase() !== params.expectedEscrowAddress.toLowerCase()) {
+      return false;
+    }
+    if (params.expectedToken !== void 0 && String(event2.args.token ?? "").toLowerCase() !== params.expectedToken.toLowerCase()) {
+      return false;
+    }
+    return true;
+  });
+  if (matchingEvents.length !== 1) return null;
+  const event = matchingEvents[0];
   const rawId = event.args.depositId;
   if (rawId === void 0 || rawId === null) return null;
   const onchainDepositId = BigInt(rawId);
+  const rawAmount = event.args.amount;
+  const amount = rawAmount === void 0 || rawAmount === null ? void 0 : BigInt(rawAmount);
   const escrowAddress = event.address.toLowerCase();
   return {
     onchainDepositId,
     escrowAddress,
-    compositeId: createCompositeDepositId(escrowAddress, onchainDepositId)
+    compositeId: createCompositeDepositId(escrowAddress, onchainDepositId),
+    ...amount === void 0 ? {} : { amount }
   };
 }
 function parseCompositeDepositId(compositeId) {
@@ -387,26 +431,6 @@ function parseCompositeDepositId(compositeId) {
   const onchainDepositId = BigInt(rawDepositId);
   return { escrowAddress: canonicalEscrowAddress, onchainDepositId };
 }
-
-// src/client/platformGroups.ts
-var PLATFORM_METHOD_GROUPS = {
-  zelle: ["zelle", "zelle-chase", "zelle-bofa", "zelle-citi"]
-};
-var METHOD_TO_BASE_PLATFORM = new Map(
-  Object.entries(PLATFORM_METHOD_GROUPS).flatMap(
-    ([platform, methods]) => methods.map((method) => [method, platform])
-  )
-);
-function basePlatformForMethod(method) {
-  return METHOD_TO_BASE_PLATFORM.get(method) ?? method;
-}
-function paymentMethodsForPlatform(platform, catalog) {
-  const configured = PLATFORM_METHOD_GROUPS[platform];
-  const methods = configured ?? [platform];
-  return methods.filter((method) => catalog[method] !== void 0);
-}
-
-// src/client/capabilities.ts
 var MIN_CASHOUT_AMOUNT = 10000n;
 var RECOMMENDED_MIN_CASHOUT_AMOUNT = 1000000n;
 var PAYEE_HINTS = {
@@ -425,20 +449,13 @@ var PAYEE_HINTS = {
 var IDENTITY_ATTESTATION_PLATFORMS = /* @__PURE__ */ new Set(["wise", "paypal"]);
 function buildCapabilities(environment) {
   const catalog = getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
-  const currenciesByPlatform = /* @__PURE__ */ new Map();
-  for (const [method, entry] of Object.entries(catalog)) {
-    const platform = basePlatformForMethod(method);
+  const platforms = Object.entries(catalog).map(([platform, entry]) => {
     const currencies2 = (entry.currencies ?? []).map((hash) => getCurrencyCodeFromHash(hash)).filter(
       (code) => code != null && isMarketRateSupported(code)
     );
-    const aggregate = currenciesByPlatform.get(platform) ?? /* @__PURE__ */ new Set();
-    for (const currency of currencies2) aggregate.add(currency);
-    currenciesByPlatform.set(platform, aggregate);
-  }
-  const platforms = [...currenciesByPlatform.entries()].map(([platform, currencies2]) => {
     return {
       platform,
-      currencies: [...currencies2].sort(),
+      currencies: [...new Set(currencies2)].sort(),
       payeeHint: PAYEE_HINTS[platform] ?? "Your payment handle for this platform",
       requiresIdentityAttestation: IDENTITY_ATTESTATION_PLATFORMS.has(platform)
     };
@@ -517,7 +534,7 @@ function computeFillStatsSample(deposits, nowSeconds, environment) {
       }
       const currency = normalizeCurrencyCode(intent.fiatCurrency);
       if (!method || !currency) continue;
-      const pair = `${basePlatformForMethod(method)}:${currency}`;
+      const pair = `${method}:${currency}`;
       fillCounts.set(pair, (fillCounts.get(pair) ?? 0) + 1);
       if (createdAt === void 0 || createdAt < windowStart || fulfilledAt < createdAt) continue;
       const previousPairFill = firstFillByPair.get(pair);
@@ -582,7 +599,7 @@ async function readFillStatsSample(client, environment) {
 }
 function fillEtaFromSample(sample, input) {
   const currency = input.currency.toUpperCase();
-  const seconds = input.platform ? sample.stats[`${basePlatformForMethod(input.platform)}:${currency}`]?.medianFillSeconds : sample.medianFillSecondsByCurrency.get(currency);
+  const seconds = input.platform ? sample.stats[`${input.platform}:${currency}`]?.medianFillSeconds : sample.medianFillSecondsByCurrency.get(currency);
   return {
     ...seconds !== void 0 ? { seconds } : {},
     label: etaLabel(seconds)
@@ -1145,6 +1162,36 @@ async function readEstimate(publicClient, input, context = {}) {
   return estimate;
 }
 
+// src/client/payee.ts
+function normalizePaypalHandle(value) {
+  const withoutProtocol = value.replace(/^https?:\/\//i, "").replace(/^www\./i, "");
+  if (/^paypal\.me(?:[?#].*)?$/i.test(withoutProtocol)) return "";
+  const withoutDomain = withoutProtocol.replace(/^paypal\.me\//i, "");
+  const [pathWithoutQuery = ""] = withoutDomain.split(/[?#]/, 1);
+  const [username = ""] = pathWithoutQuery.replace(/^\/+/, "").split("/", 1);
+  return username.replace(/^@+/, "").trim().toLowerCase();
+}
+function normalizeCashPayee(platform, payee) {
+  if (typeof payee !== "string") return payee;
+  const trimmed = payee.trim();
+  switch (platform) {
+    case "venmo":
+      return { offchainId: trimmed.replace(/^@+/, "") };
+    case "cashapp":
+      return { offchainId: trimmed.replace(/^\$+/, "") };
+    case "chime":
+      return { offchainId: trimmed.toLowerCase() };
+    case "n26":
+      return { offchainId: trimmed.replace(/\s/g, "") };
+    case "paypal":
+      return { offchainId: normalizePaypalHandle(trimmed) };
+    case "zelle":
+      return { offchainId: trimmed.toLowerCase() };
+    default:
+      return { offchainId: trimmed };
+  }
+}
+
 // src/client/createCashClient.ts
 var DEFAULT_RPC_URL = "https://mainnet.base.org";
 var FILL_STATS_CACHE_MS = 15 * 60 * 1e3;
@@ -1186,7 +1233,7 @@ async function submitAndConfirm(client, verb, send) {
     hash = await send();
   } catch (err) {
     const mapped = mapChainError(verb, err);
-    if (isKnownPreBroadcastFailure(err, mapped)) throw mapped;
+    if (isKnownPreBroadcastFailure(mapped)) throw mapped;
     throw errors.transactionSubmissionUnknown(verb, err, {
       kind: "inspect-base-operation-submission",
       operation: verb
@@ -1201,12 +1248,8 @@ async function submitAndConfirm(client, verb, send) {
   if (receipt.status === "reverted") throw errors.transactionFailed(hash);
   return hash;
 }
-function isKnownPreBroadcastFailure(err, mapped) {
-  if (mapped.code === "INSUFFICIENT_TOKEN_BALANCE" || mapped.code === "ALLOWANCE_NOT_VISIBLE" || mapped.code === "ESCROW_PAUSED") {
-    return true;
-  }
-  const message = err instanceof Error ? err.message : String(err);
-  return /user rejected|user denied|rejected request|action_rejected/i.test(message);
+function isKnownPreBroadcastFailure(mapped) {
+  return mapped.code === "TRANSACTION_REJECTED" || mapped.code === "INSUFFICIENT_TOKEN_BALANCE" || mapped.code === "ALLOWANCE_NOT_VISIBLE" || mapped.code === "ESCROW_PAUSED";
 }
 function depositOrderOptions(deposit) {
   const remaining = toBigIntOrUndefined(deposit.remainingDeposits);
@@ -1279,24 +1322,39 @@ function createCashClient(options) {
   }
   function validatePayout(input) {
     const { receive } = input;
-    const catalog = getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
     const platform = buildCapabilities(environment).platforms.find(
       (capability) => capability.platform === receive.platform
     );
     if (!platform) throw errors.unsupportedPlatform(receive.platform);
-    if (!isMarketRateSupported(receive.currency)) {
-      throw errors.oracleUnsupportedCurrency(receive.currency);
+    if (receive.currency === void 0 === (receive.currencies === void 0)) {
+      throw errors.invalidPayoutCurrencies(
+        receive.platform,
+        "pass exactly one of currency or currencies"
+      );
     }
-    if (!platform.currencies.includes(receive.currency)) {
-      throw errors.unsupportedPlatformCurrency(receive.platform, receive.currency);
+    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);
+      }
+      if (!platform.currencies.includes(currency)) {
+        throw errors.unsupportedPlatformCurrency(receive.platform, currency);
+      }
     }
-    const paymentMethods = paymentMethodsForPlatform(receive.platform, catalog);
     return {
-      payouts: paymentMethods.map((processorName) => ({
-        processorName,
-        currency: receive.currency,
-        payeeData: receive.payee
-      }))
+      payouts: [
+        {
+          processorName: receive.platform,
+          ...currencies.length === 1 ? { currency: currencies[0] } : { currencies },
+          payeeData: normalizeCashPayee(receive.platform, receive.payee)
+        }
+      ]
     };
   }
   function validateDepositInput(amount, input, payoutInput = validatePayout(input)) {
@@ -1313,6 +1371,14 @@ function createCashClient(options) {
       ...range ? { intentAmountRange: range } : {}
     };
   }
+  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
+      )
+    );
+  }
   async function buildDepositParams(client, depositInput) {
     try {
       return await prepareCashDepositParams(client, depositInput);
@@ -1367,9 +1433,10 @@ function createCashClient(options) {
       deposit.currencies ?? [],
       getPaymentMethodsCatalog(BASE_CHAIN_ID, environment)
     );
+    if (!isCashPayoutSet(payouts)) throw errors.orderNotFound(compositeId);
     return deriveCashOrder(compositeId, deposit.intents ?? [], {
       ...depositOrderOptions(deposit),
-      ...payouts.length > 0 ? { payouts } : {}
+      payouts
     });
   }
   function escrowContext(depositId) {
@@ -1583,9 +1650,9 @@ function createCashClient(options) {
       }
     },
     async cashout(input, opts) {
+      const payoutInput = validatePayout(input);
       const client = await signingClient("cashout", opts);
       const owner = opts.signer.account.address;
-      const payoutInput = validatePayout(input);
       let sourceResult;
       let cashoutAmount = input.amount;
       if (input.source) {
@@ -1661,7 +1728,7 @@ function createCashClient(options) {
           const mapped = mapChainError("createDeposit", err, {
             requiredAmount: depositInput2.amount
           });
-          if (isKnownPreBroadcastFailure(err, mapped)) {
+          if (isKnownPreBroadcastFailure(mapped)) {
             throw errors.sourceRouteCompletedCashoutFailed(routedSource, mapped);
           }
           throw errors.sourceCashoutSubmissionUnknown(routedSource, owner, mapped);
@@ -1717,7 +1784,7 @@ function createCashClient(options) {
         const mapped = mapChainError("createDeposit", err, {
           requiredAmount: depositInput.amount
         });
-        if (isKnownPreBroadcastFailure(err, mapped)) throw mapped;
+        if (isKnownPreBroadcastFailure(mapped)) throw mapped;
         throw errors.transactionSubmissionUnknown("cashout", err, {
           kind: "inspect-base-cashout-submission",
           amount: depositInput.amount.toString(),
@@ -1785,6 +1852,32 @@ function createCashClient(options) {
         register: { hashedOnchainIds }
       };
     },
+    finalizePreparedCashout(receipt) {
+      if (receipt.status === "reverted") {
+        throw errors.transactionFailed(receipt.transactionHash);
+      }
+      const abi = readClient.escrowV2Abi ?? readClient.escrowAbi;
+      const expectedEscrowAddress = readClient.escrowV2Address ?? readClient.escrowAddress;
+      const resolved = resolveCashDepositId({
+        logs: receipt.logs,
+        abi,
+        expectedEscrowAddress,
+        expectedToken: BASE_USDC_ADDRESS
+      });
+      if (!resolved || resolved.amount === void 0) {
+        throw errors.depositResolutionFailed(receipt.transactionHash);
+      }
+      return {
+        depositId: resolved.compositeId,
+        txHash: receipt.transactionHash,
+        escrowAddress: resolved.escrowAddress,
+        onchainDepositId: resolved.onchainDepositId,
+        order: deriveCashOrder(resolved.compositeId, [], {
+          remainingAmount: resolved.amount,
+          status: "ACTIVE"
+        })
+      };
+    },
     async order(depositId) {
       return fetchOrder(depositId);
     },
@@ -1816,7 +1909,7 @@ function createCashClient(options) {
           deposit.currencies ?? [],
           catalog
         );
-        if (payouts.length !== 1 || !payouts.every((payout) => payout.pricing.marketRate && payout.pricing.spreadBps === 0)) {
+        if (!isCashPayoutSet(payouts)) {
           return [];
         }
         return [
@@ -2085,7 +2178,7 @@ var cashPayoutPricingJsonSchema = z.object({
   marketRate: z.boolean()
 });
 var cashPayoutInfoJsonSchema = z.object({
-  platform: z.string().optional(),
+  platform: z.string(),
   platformHash: z.string(),
   currency: z.string().optional(),
   currencyHash: z.string().optional(),
@@ -2301,6 +2394,7 @@ var CASH_ERROR_CODES = defineCashErrorCodes([
   "UNSUPPORTED_PLATFORM_CURRENCY",
   "AMOUNT_BELOW_MINIMUM",
   "INVALID_INTENT_AMOUNT_RANGE",
+  "INVALID_PAYOUT_CURRENCIES",
   "ACTIVE_INTENT_BLOCKS_WITHDRAWAL",
   "NOTHING_TO_WITHDRAW",
   "INSUFFICIENT_AVAILABLE_FUNDS",
@@ -2329,6 +2423,7 @@ var CASH_ERROR_CODES = defineCashErrorCodes([
   "SIGNER_CHAIN_MISMATCH",
   "SIGNER_CHAIN_UNAVAILABLE",
   "WATCH_TIMEOUT",
+  "TRANSACTION_REJECTED",
   "TRANSACTION_FAILED",
   "TRANSACTION_SUBMISSION_UNKNOWN",
   "TRANSACTION_STATUS_UNKNOWN"
@@ -2782,4 +2877,4 @@ function cashErrorFromJson(json) {
   });
 }
 
-export { CASH_ATTRIBUTION_CODE, MIN_CASHOUT_AMOUNT, RATE_PRECISION, RECOMMENDED_MIN_CASHOUT_AMOUNT, bigintString, buildCapabilities, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, createCashClient, deriveBuyerProfile, deriveCashOrder, derivePayouts, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isFillLive, isMarketRateSupported, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };
+export { CASH_ATTRIBUTION_CODE, MIN_CASHOUT_AMOUNT, RATE_PRECISION, RECOMMENDED_MIN_CASHOUT_AMOUNT, bigintString, buildCapabilities, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, createCashClient, deriveBuyerProfile, deriveCashOrder, derivePayouts, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isFillLive, isMarketRateSupported, nonNegativeBigintString, normalizeCashPayee, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import { CurrencyType } from '@zkp2p/sdk';
-import { r as CashClient, G as EstimateInput, i as CashEstimate, E as CashoutOptions, h as CashoutResult, D as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-BhOytyHE.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-Clg5Fa1H.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, G as EstimateInput, i as CashEstimate, E as CashoutOptions, h as CashoutResult, D as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-BhOytyHE.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-Clg5Fa1H.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-TR6JVYYF.js';
+import { isCashError, CASH_ORDER_POLL_INTERVAL_MS } from './chunk-5VBP3IWK.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.1.9"};
+  version: "0.2.1"};
 
 // src/tools/index.ts
 var bigintString = {
@@ -137,20 +137,36 @@ var builtInCashTools = [
               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: {
-              type: "object",
-              description: "Payee handle for the platform",
-              properties: {
-                offchainId: {
+              description: "Raw payee handle or structured curator payee data",
+              oneOf: [
+                {
                   type: "string",
-                  description: 'The handle, e.g. "@andrew" for Venmo - see payeeHint in cash_capabilities'
+                  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: ["offchainId"],
-              additionalProperties: true
+              ]
             }
           },
-          required: ["platform", "currency", "payee"],
+          required: ["platform", "payee"],
+          oneOf: [{ required: ["currency"] }, { required: ["currencies"] }],
           additionalProperties: false
         }
       },

package/dist/tools.d.cts

@@ -166,20 +166,39 @@ declare const builtInCashTools: readonly [{
                         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: "Fiat currency choices for one payment method, e.g. [\"EUR\", \"GBP\"]";
+                    };
                     readonly payee: {
-                        readonly type: "object";
-                        readonly description: "Payee handle for the platform";
-                        readonly properties: {
-                            readonly offchainId: {
-                                readonly type: "string";
-                                readonly description: "The handle, e.g. \"@andrew\" for Venmo - see payeeHint in cash_capabilities";
+                        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", "currency", "payee"];
+                readonly required: readonly ["platform", "payee"];
+                readonly oneOf: readonly [{
+                    readonly required: readonly ["currency"];
+                }, {
+                    readonly required: readonly ["currencies"];
+                }];
                 readonly additionalProperties: false;
             };
         };