@zkp2p/cash 0.2.0 → 0.3.0-rc.0

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-CTEXn9FF.js';
-export { o as CASH_ATTRIBUTION_CODE, p as CashAsset, q as CashChain, r as CashClient, s as CashClientOptions, t as CashFillEta, u as CashLeg, v as CashNextAction, w as CashOrderState, x as CashPairFillStats, y as CashPayout, z as CashPayoutPricing, A as CashPlatformCapability, B as CashPreparedStepKind, D as CashoutInput, E as CashoutOptions, F as CuratorPayeeDataInput, G as EstimateInput, H as EstimateOptions, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, J as RECOMMENDED_MIN_CASHOUT_AMOUNT, K as RelayOptions, L as RelayQuoteInput, N as RelaySourceInput, Q as RelayTransaction, S as SignerOptions, U as WatchOptions, V as WithdrawOptions, X as buildCapabilities, Y as createCashClient } from './createCashClient-CTEXn9FF.js';
+import { I as IntentStatus, C as CashPayoutInfo, a as IntentEntity, b as CashBuyerProfile, c as CashDepositInput, d as CreateDepositParamsArg, e as CashOrder, f as CashFill, g as CashCapabilities, h as CashoutResult, i as CashEstimate, j as CashFillStats, P as PrepareResult, k as CashPreparedStep, R as RelayExecutionResult, l as RelayQuote, m as RelayStatus, n as CashSourceCapabilities, T as TopUpResult, W as WithdrawResult } from './createCashClient-DGMd8Swr.js';
+export { o as CASH_ATTRIBUTION_CODE, p as CashAsset, q as CashChain, r as CashClient, s as CashClientOptions, t as CashFillEta, u as CashLeg, v as CashMultiCurrencyLeg, w as CashNextAction, x as CashOrderState, y as CashPairFillStats, z as CashPayeeInput, A as CashPayout, B as CashPayoutPricing, D as CashPlatformCapability, E as CashPreparedStepKind, F as CashoutInput, G as CashoutOptions, H as CuratorPayeeDataInput, J as EstimateInput, K as EstimateOptions, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, L as PreparedCashoutReceipt, N as RECOMMENDED_MIN_CASHOUT_AMOUNT, Q as RelayOptions, S as RelayQuoteInput, U as RelaySourceInput, V as RelayTransaction, X as SignerOptions, Y as WatchOptions, Z as WithdrawOptions, _ as buildCapabilities, $ as createCashClient, a0 as normalizeCashPayee } from './createCashClient-DGMd8Swr.js';
 import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
 export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
 import { Log, Abi } from 'viem';
@@ -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' | '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_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' | '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;
@@ -77,6 +77,7 @@ declare const errors: {
     unsupportedPlatformCurrency: (platform: string, currency: string) => CashError;
     amountBelowMinimum: (amount: bigint, min: bigint) => CashError;
     invalidIntentAmountRange: (amount: bigint, min: bigint, max: bigint) => CashError;
+    invalidPayoutCurrencies: (platform: string, reason: string) => CashError;
     activeIntentBlocksWithdrawal: (depositId: string) => CashError;
     insufficientAvailableFunds: (depositId: string, requested: bigint, available: bigint) => CashError;
     insufficientTokenBalance: (requiredAmount?: bigint) => CashError;
@@ -124,12 +125,15 @@ declare const errors: {
     signerChainUnavailable: (verb: string, expectedChainId: number, cause?: unknown) => CashError;
     watchTimeout: (depositId: string, timeoutMs: number) => CashError;
     transactionFailed: (txHash: string, cause?: unknown) => CashError;
+    transactionRejected: (verb: string, cause?: unknown) => CashError;
     transactionSubmissionUnknown: (operation: string, cause?: unknown, recovery?: CashErrorRecovery) => CashError;
     transactionStatusUnknown: (txHash: string, cause?: unknown, operation?: string) => CashError;
     escrowPaused: () => CashError;
     /** Generic fallback for an on-chain call that failed for an unrecognized reason. */
     chainCallFailed: (verb: string, cause?: unknown) => CashError;
 };
+/** Detect EIP-1193 and viem wallet cancellations, including nested provider causes. */
+declare function isUserRejectedError(value: unknown): boolean;
 
 /**
  * Convert a human USDC amount to base units (6 decimals).
@@ -325,10 +329,14 @@ interface ResolvedCashDeposit {
     onchainDepositId: bigint;
     escrowAddress: string;
     compositeId: string;
+    /** Base-unit amount emitted by the canonical DepositReceived event. */
+    amount?: bigint;
 }
 declare function resolveCashDepositId(params: {
-    logs: Log[];
+    logs: readonly Log[];
     abi: Abi;
+    expectedEscrowAddress?: string;
+    expectedToken?: string;
 }): ResolvedCashDeposit | null;
 /** Split a composite deposit id (`escrow_onchainId`) back into its parts. */
 declare function parseCompositeDepositId(compositeId: string): {
@@ -2710,8 +2718,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];
@@ -2781,8 +2789,8 @@ declare const cashCapabilitiesJsonSchema: z.ZodObject<{
             decimals: number;
         };
     };
-    environment: "production" | "preproduction" | "staging";
     currencies: string[];
+    environment: "production" | "preproduction" | "staging";
     platforms: {
         platform: string;
         currencies: string[];
@@ -3176,7 +3184,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", "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_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", "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;
@@ -3563,7 +3571,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" | "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_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" | "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?: {
@@ -3645,7 +3653,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" | "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_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" | "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?: {
@@ -3791,4 +3799,4 @@ declare function capabilitiesFromJson(json: unknown): CashCapabilities;
 declare function cashErrorToJson(error: CashErrorShape): CashErrorJson;
 declare function cashErrorFromJson(json: unknown): CashError;
 
-export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashFillStats, type CashFillStatsJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type DeriveCashOrderOptions, MARKET_SPREAD_BPS, type MethodCurrencyLike, ORACLE_MIN_CONVERSION_RATE_SENTINEL, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, USDC_DECIMALS, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashError, isFillLive, isMarketRateSupported, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };
+export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, type CashAssetJson, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, type CashChainJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorJson, type CashErrorRecovery, type CashErrorRecoveryJson, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashFillStats, type CashFillStatsJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashSourceCapabilities, type CashSourceCapabilitiesJson, CashoutResult, type CashoutResultJson, type DeriveCashOrderOptions, MARKET_SPREAD_BPS, type MethodCurrencyLike, ORACLE_MIN_CONVERSION_RATE_SENTINEL, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, RATE_PRECISION, RelayExecutionResult, type RelayExecutionResultJson, RelayQuote, type RelayQuoteJson, RelayStatus, type RelayStatusJson, type RelayTransactionJson, type RelayTransactionsJson, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, USDC_DECIMALS, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashFillStatsJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPairFillStatsJsonSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillStatsFromJson, fillStatsToJson, fillToJson, formatUsdc, intentStatusSchema, isCashError, isFillLive, isMarketRateSupported, isUserRejectedError, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };

package/dist/index.js

@@ -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,
@@ -365,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) {
@@ -485,6 +523,26 @@ function computeFillStatsSample(deposits, nowSeconds, environment) {
     const createdAt = toUnixSeconds2(deposit.createdAt ?? deposit.timestamp);
     const firstFillByPair = /* @__PURE__ */ new Map();
     const firstFillByCurrency = /* @__PURE__ */ new Map();
+    const offeredCurrenciesByMethod = /* @__PURE__ */ new Map();
+    for (const offered of deposit.currencies ?? []) {
+      let method;
+      try {
+        method = offered.paymentMethodHash ? resolvePaymentMethodNameFromHash(offered.paymentMethodHash, catalog) : void 0;
+      } catch {
+        method = void 0;
+      }
+      const currency = normalizeCurrencyCode(offered.currencyCode);
+      if (!method || !currency) continue;
+      const currencies = offeredCurrenciesByMethod.get(method) ?? /* @__PURE__ */ new Set();
+      currencies.add(currency);
+      offeredCurrenciesByMethod.set(method, currencies);
+    }
+    const multiCurrencyKeyByMethod = /* @__PURE__ */ new Map();
+    for (const [method, currencies] of offeredCurrenciesByMethod) {
+      if (currencies.size > 1) {
+        multiCurrencyKeyByMethod.set(method, `${method}:${[...currencies].sort().join("+")}`);
+      }
+    }
     for (const intent of deposit.intents ?? []) {
       const fulfilledAt = toUnixSeconds2(intent.fulfillTimestamp);
       if (fulfilledAt === void 0 || fulfilledAt < windowStart) continue;
@@ -498,11 +556,25 @@ function computeFillStatsSample(deposits, nowSeconds, environment) {
       if (!method || !currency) continue;
       const pair = `${method}:${currency}`;
       fillCounts.set(pair, (fillCounts.get(pair) ?? 0) + 1);
+      const multiCurrencyKey = multiCurrencyKeyByMethod.get(method);
+      const matchingMultiCurrencyKey = multiCurrencyKey && offeredCurrenciesByMethod.get(method)?.has(currency) ? multiCurrencyKey : void 0;
+      if (matchingMultiCurrencyKey) {
+        fillCounts.set(
+          matchingMultiCurrencyKey,
+          (fillCounts.get(matchingMultiCurrencyKey) ?? 0) + 1
+        );
+      }
       if (createdAt === void 0 || createdAt < windowStart || fulfilledAt < createdAt) continue;
       const previousPairFill = firstFillByPair.get(pair);
       if (previousPairFill === void 0 || fulfilledAt < previousPairFill) {
         firstFillByPair.set(pair, fulfilledAt);
       }
+      if (matchingMultiCurrencyKey) {
+        const previousMultiCurrencyFill = firstFillByPair.get(matchingMultiCurrencyKey);
+        if (previousMultiCurrencyFill === void 0 || fulfilledAt < previousMultiCurrencyFill) {
+          firstFillByPair.set(matchingMultiCurrencyKey, fulfilledAt);
+        }
+      }
       const previousCurrencyFill = firstFillByCurrency.get(currency);
       if (previousCurrencyFill === void 0 || fulfilledAt < previousCurrencyFill) {
         firstFillByCurrency.set(currency, fulfilledAt);
@@ -1124,6 +1196,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;
@@ -1165,7 +1267,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
@@ -1180,12 +1282,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);
@@ -1262,18 +1360,33 @@ function createCashClient(options) {
       (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);
+      }
     }
     return {
       payouts: [
         {
           processorName: receive.platform,
-          currency: receive.currency,
-          payeeData: receive.payee
+          ...currencies.length === 1 ? { currency: currencies[0] } : { currencies },
+          payeeData: normalizeCashPayee(receive.platform, receive.payee)
         }
       ]
     };
@@ -1293,7 +1406,12 @@ function createCashClient(options) {
     };
   }
   function isCashPayoutSet(payouts) {
-    return payouts.length === 1 && payouts.every((payout) => payout.pricing.marketRate && payout.pricing.spreadBps === 0);
+    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 {
@@ -1566,9 +1684,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) {
@@ -1644,7 +1762,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);
@@ -1700,7 +1818,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(),
@@ -1768,6 +1886,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);
     },
@@ -2284,6 +2428,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",
@@ -2312,6 +2457,7 @@ var CASH_ERROR_CODES = defineCashErrorCodes([
   "SIGNER_CHAIN_MISMATCH",
   "SIGNER_CHAIN_UNAVAILABLE",
   "WATCH_TIMEOUT",
+  "TRANSACTION_REJECTED",
   "TRANSACTION_FAILED",
   "TRANSACTION_SUBMISSION_UNKNOWN",
   "TRANSACTION_STATUS_UNKNOWN"
@@ -2765,4 +2911,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-CTEXn9FF.cjs';
+import { r as CashClient, J as EstimateInput, i as CashEstimate, G as CashoutOptions, h as CashoutResult, F as CashoutInput, T as TopUpResult, W as WithdrawResult, e as CashOrder } from './createCashClient-DGMd8Swr.cjs';
 import { WalletClient } from 'viem';
 import '@relayprotocol/relay-sdk';
 

package/dist/react.d.ts

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

package/dist/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.2.0"};
+  version: "0.3.0-rc.0"};
 
 // 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
         }
       },