@zkp2p/cash 0.1.3 → 0.1.4

package/dist/index.js

@@ -1,6 +1,6 @@
-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 } from './chunk-FKVPZVFH.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-FKVPZVFH.js';
-import { parseAbi, parseEventLogs, http, createWalletClient, encodeFunctionData } from 'viem';
+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-P3KYZ2FX.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-P3KYZ2FX.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';
 import { createClient, MAINNET_RELAY_API } from '@relayprotocol/relay-sdk';
@@ -221,10 +221,12 @@ function deriveCashOrder(depositId, intents, options = {}) {
   const total = options.totalAmount ?? remaining + outstanding + taken + withdrawn;
   const status = options.status;
   const isTerminal = status === "CLOSED" || status === "WITHDRAWN";
-  const hasLiveFunds = remaining > DUST_THRESHOLD || outstanding > 0n;
+  const hasLiveFunds = remaining >= DUST_THRESHOLD || outstanding > 0n;
   let state;
   if (outstanding > 0n) {
     state = taken > 0n ? "delivering" : "matched";
+  } else if (!hasLiveFunds && withdrawn > 0n) {
+    state = "returned";
   } else if (taken > 0n && !hasLiveFunds) {
     state = "delivered";
   } else if (taken > 0n && hasLiveFunds) {
@@ -266,7 +268,7 @@ function deriveCashOrder(depositId, intents, options = {}) {
     ...options.payouts !== void 0 ? { payouts: options.payouts } : {},
     ...options.successRateBps !== void 0 ? { successRateBps: options.successRateBps } : {},
     isInFlight,
-    withdrawn: isTerminal
+    withdrawn: state === "returned" && withdrawn > 0n
   });
 }
 var ORACLE_KINDS = /* @__PURE__ */ new Set(["oracle_chainlink", "oracle_pyth"]);
@@ -376,12 +378,14 @@ function resolveCashDepositId(params) {
 }
 function parseCompositeDepositId(compositeId) {
   const idx = compositeId.lastIndexOf("_");
-  if (idx === -1) {
-    return { escrowAddress: "", onchainDepositId: BigInt(compositeId) };
-  }
   const escrowAddress = compositeId.slice(0, idx);
-  const onchainDepositId = BigInt(compositeId.slice(idx + 1) || "0");
-  return { escrowAddress, onchainDepositId };
+  const rawDepositId = compositeId.slice(idx + 1);
+  if (idx <= 0 || compositeId.indexOf("_") !== idx || !isAddress(escrowAddress, { strict: false }) || !/^\d+$/.test(rawDepositId)) {
+    throw new Error(`Invalid deposit id: '${compositeId}'`);
+  }
+  const canonicalEscrowAddress = escrowAddress.toLowerCase();
+  const onchainDepositId = BigInt(rawDepositId);
+  return { escrowAddress: canonicalEscrowAddress, onchainDepositId };
 }
 var MIN_CASHOUT_AMOUNT = 10000n;
 var RECOMMENDED_MIN_CASHOUT_AMOUNT = 1000000n;
@@ -399,9 +403,6 @@ 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]) => {
@@ -591,20 +592,175 @@ function normalizeChain(chain) {
 function isSupportedEvmChain(chain) {
   return chain.vmType === void 0 || chain.vmType === "evm";
 }
+function isExecutableSourceChain(chain) {
+  return isSupportedEvmChain(chain) && !chain.disabled && chain.depositEnabled && !chain.blockProductionLagging;
+}
 function quoteRequestId(quote) {
   return quote.steps.map((step) => step.requestId).find((id) => id !== void 0);
 }
+function collectRelayTransactions(steps, sourceChainId) {
+  const origin = [];
+  const destination = [];
+  const record = (tx) => {
+    (tx.chainId === sourceChainId ? origin : destination).push(tx);
+  };
+  for (const step of steps) {
+    for (const item of step.items) {
+      for (const tx of item.internalTxHashes ?? []) {
+        record({ hash: tx.txHash, chainId: tx.chainId });
+      }
+      for (const tx of item.txHashes ?? []) {
+        record({ hash: tx.txHash, chainId: tx.chainId });
+      }
+    }
+  }
+  const dedupe = (txs) => [
+    ...new Map(txs.map((tx) => [`${tx.chainId}:${tx.hash.toLowerCase()}`, tx])).values()
+  ];
+  return { origin: dedupe(origin), destination: dedupe(destination) };
+}
+function relayTransactionHashes(transactions) {
+  return [
+    ...new Set([...transactions.origin, ...transactions.destination].map(({ hash }) => hash))
+  ];
+}
 function quoteSourceChainId(quote) {
   const details = asRecord(quote.details);
   const currencyIn = asRecord(details.currencyIn);
   const sourceCurrency = asRecord(currencyIn.currency);
   return asNumber(sourceCurrency.chainId);
 }
+function assertCanonicalRelayDestination(quote) {
+  const details = asRecord(quote.details);
+  const currencyOut = asRecord(details.currencyOut);
+  const destination = asRecord(currencyOut.currency);
+  if (asNumber(destination.chainId) !== BASE_CHAIN_ID || asString(destination.address)?.toLowerCase() !== BASE_USDC_ADDRESS.toLowerCase()) {
+    throw new Error("Relay quote destination is not canonical Base USDC");
+  }
+}
+async function assertWalletChainId(wallet, expectedChainId, operation) {
+  let actualChainId;
+  try {
+    actualChainId = await wallet.getChainId();
+  } catch (err) {
+    throw errors.signerChainUnavailable(operation, expectedChainId, err);
+  }
+  if (actualChainId !== expectedChainId) {
+    throw errors.signerChainMismatch(operation, expectedChainId, actualChainId);
+  }
+}
+async function assertRelayExecutionIdentity(quote, wallet, expectedRecipient) {
+  const signer = wallet.account?.address;
+  if (!signer) throw new Error("Relay execution requires a wallet account");
+  const sourceChainId = quoteSourceChainId(quote);
+  if (sourceChainId !== void 0) {
+    await assertWalletChainId(wallet, sourceChainId, "Relay execution");
+  }
+  const details = asRecord(quote.details);
+  const sender = asString(details.sender);
+  const recipient = asString(details.recipient);
+  if (!sender || sender.toLowerCase() !== signer.toLowerCase()) {
+    throw new Error("Relay quote sender does not match the execution signer");
+  }
+  const destinationOwner = expectedRecipient ?? signer;
+  if (!recipient || recipient.toLowerCase() !== destinationOwner.toLowerCase()) {
+    throw new Error("Relay quote recipient does not match the expected Base recipient");
+  }
+}
+function isRelaySecretKey(key) {
+  const normalized = key.toLowerCase();
+  return normalized === "headers" || normalized === "apikey";
+}
+function redactRelayValue(value, seen = /* @__PURE__ */ new WeakMap()) {
+  if (value === null || typeof value !== "object") return value;
+  if (value instanceof Date || value instanceof Error) return value;
+  const existing = seen.get(value);
+  if (existing !== void 0) return existing;
+  if (Array.isArray(value)) {
+    const output2 = [];
+    seen.set(value, output2);
+    for (const entry of value) output2.push(redactRelayValue(entry, seen));
+    return output2;
+  }
+  const output = {};
+  seen.set(value, output);
+  for (const [key, entry] of Object.entries(value)) {
+    if (!isRelaySecretKey(key)) output[key] = redactRelayValue(entry, seen);
+  }
+  return output;
+}
+var RELAY_WIRE_TYPE = "__zkp2pCashType";
+function sanitizeRelayValue(value, seen = /* @__PURE__ */ new WeakSet()) {
+  if (typeof value === "bigint") {
+    return { [RELAY_WIRE_TYPE]: "bigint", value: value.toString() };
+  }
+  if (value === null || typeof value === "string" || typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : { [RELAY_WIRE_TYPE]: "number", value: String(value) };
+  }
+  if (typeof value === "undefined") return { [RELAY_WIRE_TYPE]: "undefined" };
+  if (value instanceof Date) {
+    return { [RELAY_WIRE_TYPE]: "date", value: value.toISOString() };
+  }
+  if (value instanceof Error) {
+    return {
+      [RELAY_WIRE_TYPE]: "error",
+      name: value.name,
+      message: value.message
+    };
+  }
+  if (typeof value !== "object") return void 0;
+  if (seen.has(value)) throw new TypeError("Relay payload contains a circular reference");
+  seen.add(value);
+  if (Array.isArray(value)) {
+    const output2 = value.map((entry) => sanitizeRelayValue(entry, seen));
+    seen.delete(value);
+    return output2;
+  }
+  const output = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (isRelaySecretKey(key)) continue;
+    const sanitized = sanitizeRelayValue(entry, seen);
+    if (sanitized !== void 0) output[key] = sanitized;
+  }
+  seen.delete(value);
+  return output;
+}
+function restoreRelayValue(value) {
+  if (Array.isArray(value)) return value.map(restoreRelayValue);
+  if (value === null || typeof value !== "object") return value;
+  const row = value;
+  const wireType = row[RELAY_WIRE_TYPE];
+  const keyCount = Object.keys(row).length;
+  if (keyCount === 2 && wireType === "bigint" && typeof row.value === "string") {
+    return BigInt(row.value);
+  }
+  if (keyCount === 2 && wireType === "date" && typeof row.value === "string") {
+    return new Date(row.value);
+  }
+  if (keyCount === 2 && wireType === "number" && typeof row.value === "string") {
+    return Number(row.value);
+  }
+  if (keyCount === 1 && wireType === "undefined") return void 0;
+  if (keyCount === 3 && wireType === "error" && typeof row.message === "string") {
+    const error = new Error(row.message);
+    if (typeof row.name === "string") error.name = row.name;
+    return error;
+  }
+  return Object.fromEntries(
+    Object.entries(row).map(([key, entry]) => [key, restoreRelayValue(entry)])
+  );
+}
+function redactRelayQuoteRaw(quote) {
+  return redactRelayValue(quote);
+}
 function sanitizeRelayQuoteRaw(quote) {
-  if (!quote.request) return quote;
-  const request = { ...quote.request };
-  delete request.headers;
-  return { ...quote, request };
+  return sanitizeRelayValue(quote);
+}
+function restoreRelayQuoteRaw(value) {
+  return restoreRelayValue(value);
 }
 async function resolveRelayChains(options, client, config = {}) {
   const preferInjectedClientChains = config.preferInjectedClientChains ?? true;
@@ -618,19 +774,38 @@ function relayQuoteFromExecute(input, quote) {
   const currencyOut = asRecord(details.currencyOut);
   const sourceCurrency = asRecord(currencyIn.currency);
   const destinationCurrency = asRecord(currencyOut.currency);
-  const source = normalizeToken(input.source.chainId, sourceCurrency) ?? {
-    chainId: input.source.chainId,
-    address: input.source.currency,
-    symbol: "TOKEN",
-    decimals: 0
-  };
-  const destination = normalizeToken(BASE_CHAIN_ID, destinationCurrency) ?? BASE_USDC_ASSET;
+  const sourceChainId = asNumber(sourceCurrency.chainId);
+  const sourceAddress = asString(sourceCurrency.address);
+  const sender = asString(details.sender);
+  const recipient = asString(details.recipient);
+  const expectedRecipient = input.recipient ?? input.user;
+  const destinationChainId = asNumber(destinationCurrency.chainId);
+  const destinationAddress = asString(destinationCurrency.address);
+  if (sourceChainId !== input.source.chainId || sourceAddress?.toLowerCase() !== input.source.currency.toLowerCase()) {
+    throw new Error("Relay quote source does not match the requested asset");
+  }
+  if (!sender || sender.toLowerCase() !== input.user.toLowerCase()) {
+    throw new Error("Relay quote sender does not match the requested wallet");
+  }
+  if (!recipient || recipient.toLowerCase() !== expectedRecipient.toLowerCase()) {
+    throw new Error("Relay quote recipient does not match the requested Base recipient");
+  }
+  if (destinationChainId !== BASE_CHAIN_ID || destinationAddress?.toLowerCase() !== BASE_USDC_ADDRESS.toLowerCase()) {
+    throw new Error("Relay quote destination is not canonical Base USDC");
+  }
+  const source = normalizeToken(input.source.chainId, sourceCurrency);
+  if (!source) throw new Error("Relay quote source metadata is malformed");
+  const destination = normalizeToken(destinationChainId, destinationCurrency);
+  if (!destination) throw new Error("Relay quote destination metadata is malformed");
   const txs = quote.steps.flatMap(
     (step) => step.items.map((item) => normalizeTx(item.data, input.source.chainId)).filter((tx) => tx !== null)
   );
-  const outputAmount = BigInt(
-    String(currencyOut.minimumAmount ?? currencyOut.amount ?? input.amount.toString())
-  );
+  const rawOutputAmount = currencyOut.minimumAmount ?? currencyOut.amount;
+  if (rawOutputAmount === void 0 || rawOutputAmount === null) {
+    throw new Error("Relay quote is missing an output amount");
+  }
+  const outputAmount = BigInt(String(rawOutputAmount));
+  if (outputAmount <= 0n) throw new Error("Relay quote output amount must be positive");
   const requestId = quoteRequestId(quote);
   const rate = asNumber(details.rate);
   const timeEstimateSeconds = asNumber(details.timeEstimate);
@@ -638,92 +813,135 @@ function relayQuoteFromExecute(input, quote) {
     ...requestId ? { requestId } : {},
     source,
     destination,
-    inputAmount: BigInt(String(currencyIn.amount ?? input.amount.toString())),
+    inputAmount: BigInt(String(currencyIn.amount)),
     outputAmount,
     ...rate !== void 0 ? { rate } : {},
     ...timeEstimateSeconds !== void 0 ? { timeEstimateSeconds } : {},
     ...quote.fees !== void 0 ? { fees: quote.fees } : {},
     txs,
-    raw: sanitizeRelayQuoteRaw(quote)
+    raw: redactRelayQuoteRaw(quote)
   };
 }
 async function readRelaySourceCapabilities(options = {}) {
-  const client = relayClient(options);
-  const chains = await resolveRelayChains(options, client);
-  return {
-    destination: BASE_USDC_ASSET,
-    chains: chains.map(normalizeChain).filter((chain) => chain.tokens.length > 0 && isSupportedEvmChain(chain)).sort((a, b) => a.displayName.localeCompare(b.displayName)),
-    source: "relay-sdk",
-    asOf: Math.floor(Date.now() / 1e3)
-  };
+  try {
+    const client = relayClient(options);
+    const chains = await resolveRelayChains(options, client);
+    return {
+      destination: BASE_USDC_ASSET,
+      chains: chains.map(normalizeChain).filter((chain) => chain.tokens.length > 0 && isExecutableSourceChain(chain)).sort((a, b) => a.displayName.localeCompare(b.displayName)),
+      source: "relay-sdk",
+      asOf: Math.floor(Date.now() / 1e3)
+    };
+  } catch (err) {
+    if (isCashError(err)) throw err;
+    throw errors.sourceCapabilitiesFailed(err);
+  }
 }
 async function quoteRelayToBaseUsdc(input, options = {}) {
-  const client = relayClient(options);
-  const quote = await client.actions.getQuote(
-    {
-      chainId: input.source.chainId,
-      currency: input.source.currency,
-      toChainId: BASE_CHAIN_ID,
-      toCurrency: BASE_USDC_ADDRESS,
-      user: input.user,
-      recipient: input.recipient ?? input.user,
-      amount: input.amount.toString(),
-      tradeType: input.tradeType ?? "EXACT_INPUT"
-    },
-    false
-  );
-  return relayQuoteFromExecute(input, quote);
+  try {
+    if (input.amount <= 0n) throw new Error("Relay quote amount must be positive");
+    const client = relayClient(options);
+    const quote = await client.actions.getQuote(
+      {
+        chainId: input.source.chainId,
+        currency: input.source.currency,
+        toChainId: BASE_CHAIN_ID,
+        toCurrency: BASE_USDC_ADDRESS,
+        user: input.user,
+        recipient: input.recipient ?? input.user,
+        amount: input.amount.toString(),
+        tradeType: input.tradeType ?? "EXACT_INPUT"
+      },
+      false
+    );
+    return relayQuoteFromExecute(input, quote);
+  } catch (err) {
+    if (isCashError(err)) throw err;
+    throw errors.sourceQuoteFailed(err);
+  }
 }
 async function executeRelayQuote(quote, wallet, options = {}) {
-  const client = relayClient(options.relay);
-  const sourceChainId = quoteSourceChainId(quote);
-  if (sourceChainId !== void 0 && !(client.chains ?? []).some((chain) => chain.id === sourceChainId)) {
-    await resolveRelayChains(options.relay ?? {}, client, { preferInjectedClientChains: false });
-  }
-  const { data } = await client.actions.execute({
-    quote,
-    wallet,
-    ...options.onProgress ? { onProgress: options.onProgress } : {},
-    ...options.disableCapabilitiesCheck !== void 0 ? { disableCapabilitiesCheck: options.disableCapabilitiesCheck } : {}
-  });
-  const requestId = quoteRequestId(data);
-  return {
-    ...requestId ? { requestId } : {},
-    txHashes: data.steps.flatMap(
-      (step) => step.items.flatMap((item) => (item.txHashes ?? []).map((tx) => tx.txHash))
-    ),
-    quote: data
-  };
+  let observedRequestId;
+  let observedTransactions = { origin: [], destination: [] };
+  try {
+    const rawQuote = "raw" in quote ? quote.raw : quote;
+    observedRequestId = quoteRequestId(rawQuote);
+    assertCanonicalRelayDestination(rawQuote);
+    await assertRelayExecutionIdentity(rawQuote, wallet, options.recipient);
+    const client = relayClient(options.relay);
+    const sourceChainId = quoteSourceChainId(rawQuote);
+    if (sourceChainId !== void 0 && !(client.chains ?? []).some((chain) => chain.id === sourceChainId)) {
+      await resolveRelayChains(options.relay ?? {}, client, { preferInjectedClientChains: false });
+    }
+    const onProgress = (data2) => {
+      const progressSteps = Array.isArray(data2.steps) ? data2.steps : [];
+      observedRequestId = progressSteps.map((step) => step.requestId).find((id) => id !== void 0) ?? observedRequestId;
+      observedTransactions = collectRelayTransactions(progressSteps, sourceChainId);
+      if (options.onProgress) {
+        try {
+          options.onProgress(data2);
+        } catch {
+        }
+      }
+    };
+    const { data } = await client.actions.execute({
+      quote: rawQuote,
+      wallet,
+      onProgress,
+      ...options.disableCapabilitiesCheck !== void 0 ? { disableCapabilitiesCheck: options.disableCapabilitiesCheck } : {}
+    });
+    const requestId = quoteRequestId(data) ?? observedRequestId;
+    const transactions = collectRelayTransactions(data.steps, sourceChainId);
+    return {
+      ...requestId ? { requestId } : {},
+      txHashes: relayTransactionHashes(transactions),
+      transactions,
+      quote: redactRelayQuoteRaw(data)
+    };
+  } catch (err) {
+    if (isCashError(err)) throw err;
+    const txHashes = relayTransactionHashes(observedTransactions);
+    throw errors.sourceExecutionFailed(err, {
+      ...observedRequestId ? { requestId: observedRequestId } : {},
+      txHashes,
+      ...txHashes.length > 0 ? { transactions: observedTransactions } : {}
+    });
+  }
 }
 async function readRelayStatus(requestId, options = {}) {
-  const client = relayClient(options);
-  const response = await client.utils.request({
-    url: `${client.baseApiUrl}/intents/status/v3`,
-    method: "get",
-    params: { requestId }
-  });
-  const root = asRecord(response.data);
-  const status = asString(root.status);
-  if (status !== "refund" && status !== "waiting" && status !== "depositing" && status !== "failure" && status !== "pending" && status !== "submitted" && status !== "success") {
-    throw new Error(`Relay returned unknown status: ${String(root.status)}`);
-  }
-  const details = asString(root.details);
-  const updatedAt = asNumber(root.updatedAt);
-  const originChainId = asNumber(root.originChainId);
-  const destinationChainId = asNumber(root.destinationChainId);
-  const quoteCreatedAt = asNumber(root.quoteCreatedAt);
-  return {
-    requestId,
-    status,
-    ...details ? { details } : {},
-    inTxHashes: Array.isArray(root.inTxHashes) ? root.inTxHashes.map(String) : [],
-    txHashes: Array.isArray(root.txHashes) ? root.txHashes.map(String) : [],
-    ...updatedAt !== void 0 ? { updatedAt } : {},
-    ...originChainId !== void 0 ? { originChainId } : {},
-    ...destinationChainId !== void 0 ? { destinationChainId } : {},
-    ...quoteCreatedAt !== void 0 ? { quoteCreatedAt } : {},
-    raw: response.data
-  };
+  try {
+    const client = relayClient(options);
+    const response = await client.utils.request({
+      url: `${client.baseApiUrl}/intents/status/v3`,
+      method: "get",
+      params: { requestId }
+    });
+    const root = asRecord(response.data);
+    const status = asString(root.status);
+    if (status !== "refund" && status !== "waiting" && status !== "depositing" && status !== "failure" && status !== "pending" && status !== "submitted" && status !== "success") {
+      throw new Error(`Relay returned unknown status: ${String(root.status)}`);
+    }
+    const details = asString(root.details);
+    const updatedAt = asNumber(root.updatedAt);
+    const originChainId = asNumber(root.originChainId);
+    const destinationChainId = asNumber(root.destinationChainId);
+    const quoteCreatedAt = asNumber(root.quoteCreatedAt);
+    return {
+      requestId,
+      status,
+      ...details ? { details } : {},
+      inTxHashes: Array.isArray(root.inTxHashes) ? root.inTxHashes.map(String) : [],
+      txHashes: Array.isArray(root.txHashes) ? root.txHashes.map(String) : [],
+      ...updatedAt !== void 0 ? { updatedAt } : {},
+      ...originChainId !== void 0 ? { originChainId } : {},
+      ...destinationChainId !== void 0 ? { destinationChainId } : {},
+      ...quoteCreatedAt !== void 0 ? { quoteCreatedAt } : {},
+      raw: response.data
+    };
+  } catch (err) {
+    if (isCashError(err)) throw err;
+    throw errors.sourceStatusFailed(requestId, err);
+  }
 }
 
 // src/client/estimate.ts
@@ -770,11 +988,16 @@ async function readEstimate(publicClient, input, context = {}) {
   if (!feedConfig || feedConfig.feed.toLowerCase() === ZERO_ADDRESS) {
     rate = 1;
   } else {
-    const result = await publicClient.readContract({
-      address: feedConfig.feed,
-      abi: CHAINLINK_LATEST_ROUND_ABI,
-      functionName: "latestRoundData"
-    });
+    let result;
+    try {
+      result = await publicClient.readContract({
+        address: feedConfig.feed,
+        abi: CHAINLINK_LATEST_ROUND_ABI,
+        functionName: "latestRoundData"
+      });
+    } catch (err) {
+      throw errors.oracleReadFailed(currency, err);
+    }
     const answer = Number(result[1]);
     const price = answer / 10 ** feedConfig.decimals;
     if (!Number.isFinite(price) || price <= 0) {
@@ -820,6 +1043,7 @@ async function readEstimate(publicClient, input, context = {}) {
 var DEFAULT_RPC_URL = "https://mainnet.base.org";
 var CASH_ATTRIBUTION_CODE = "peer-cash";
 var DEFAULT_CURATOR_URLS = {
+  preproduction: "https://api-preprod.zkp2p.xyz",
   staging: "https://api-staging.zkp2p.xyz"
 };
 var ERC20_APPROVE_ABI = parseAbi([
@@ -854,12 +1078,29 @@ async function submitAndConfirm(client, verb, send) {
   try {
     hash = await send();
   } catch (err) {
-    throw mapChainError(verb, err);
+    const mapped = mapChainError(verb, err);
+    if (isKnownPreBroadcastFailure(err, mapped)) throw mapped;
+    throw errors.transactionSubmissionUnknown(verb, err, {
+      kind: "inspect-base-operation-submission",
+      operation: verb
+    });
+  }
+  let receipt;
+  try {
+    receipt = await client.publicClient.waitForTransactionReceipt({ hash });
+  } catch (err) {
+    throw errors.transactionStatusUnknown(hash, err, verb);
   }
-  const receipt = await client.publicClient.waitForTransactionReceipt({ hash });
   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 depositOrderOptions(deposit) {
   const remaining = toBigIntOrUndefined(deposit.remainingDeposits);
   const outstanding = toBigIntOrUndefined(deposit.outstandingIntentAmount);
@@ -899,9 +1140,10 @@ function createCashClient(options) {
   }
   const readClient = buildSdkClient(createWalletClient({ chain: base, transport }));
   const signingClients = /* @__PURE__ */ new WeakMap();
-  function signingClient(verb, opts) {
+  async function signingClient(verb, opts) {
     const signer = opts?.signer;
     if (!signer?.account) throw errors.signerRequired(verb);
+    await assertWalletChainId(signer, BASE_CHAIN_ID, verb);
     let client = signingClients.get(signer);
     if (!client) {
       client = buildSdkClient(signer);
@@ -911,13 +1153,15 @@ function createCashClient(options) {
   }
   function validatePayout(input) {
     const { receive } = input;
-    const catalog = getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
-    if (!catalog[receive.platform]) throw errors.unsupportedPlatform(receive.platform);
+    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 (platformRequiresIdentityAttestation(receive.platform) && !receive.payee.identityAttestation) {
-      throw errors.payeeVerificationRequired(receive.platform);
+    if (!platform.currencies.includes(receive.currency)) {
+      throw errors.unsupportedPlatformCurrency(receive.platform, receive.currency);
     }
     return {
       payouts: [
@@ -926,15 +1170,22 @@ function createCashClient(options) {
           currency: receive.currency,
           payeeData: receive.payee
         }
-      ],
-      ...input.intentAmountRange ? { intentAmountRange: input.intentAmountRange } : {}
+      ]
     };
   }
-  function validateInput(input) {
-    if (input.amount < MIN_CASHOUT_AMOUNT) {
-      throw errors.amountBelowMinimum(input.amount, MIN_CASHOUT_AMOUNT);
+  function validateDepositInput(amount, input, payoutInput = validatePayout(input)) {
+    if (amount < MIN_CASHOUT_AMOUNT) {
+      throw errors.amountBelowMinimum(amount, MIN_CASHOUT_AMOUNT);
     }
-    return { amount: input.amount, ...validatePayout(input) };
+    const range = input.intentAmountRange;
+    if (range && (range.min <= 0n || range.max < range.min || range.max > amount)) {
+      throw errors.invalidIntentAmountRange(amount, range.min, range.max);
+    }
+    return {
+      amount,
+      ...payoutInput,
+      ...range ? { intentAmountRange: range } : {}
+    };
   }
   async function buildDepositParams(client, depositInput) {
     try {
@@ -949,32 +1200,54 @@ function createCashClient(options) {
       throw errors.payeeRegistrationFailed(err);
     }
   }
+  function parseDepositId(depositId) {
+    try {
+      const parsed = parseCompositeDepositId(depositId);
+      return {
+        ...parsed,
+        compositeId: createCompositeDepositId(parsed.escrowAddress, parsed.onchainDepositId)
+      };
+    } catch (err) {
+      throw errors.invalidDepositId(depositId, err);
+    }
+  }
   async function fetchOrder(depositId) {
-    const deposits = await readClient.indexer.getDepositsByIdsWithRelations([depositId], {
-      includeIntents: true,
-      intentStatuses: CASH_ORDER_STATUSES
-    });
+    const { compositeId } = parseDepositId(depositId);
+    let deposits;
+    try {
+      deposits = await readClient.indexer.getDepositsByIdsWithRelations([compositeId], {
+        includeIntents: true,
+        intentStatuses: CASH_ORDER_STATUSES
+      });
+    } catch (err) {
+      throw errors.indexerUnavailable("order", err);
+    }
     const deposit = deposits[0];
     if (!deposit) {
-      const intents = await readClient.indexer.getIntentsForDeposits(
-        [depositId],
-        CASH_ORDER_STATUSES
-      );
-      if (intents.length === 0) throw errors.orderNotFound(depositId);
-      return deriveCashOrder(depositId, intents);
+      let intents;
+      try {
+        intents = await readClient.indexer.getIntentsForDeposits(
+          [compositeId],
+          CASH_ORDER_STATUSES
+        );
+      } catch (err) {
+        throw errors.indexerUnavailable("order intents", err);
+      }
+      if (intents.length === 0) throw errors.orderNotFound(compositeId);
+      return deriveCashOrder(compositeId, intents);
     }
     const payouts = derivePayouts(
       deposit.paymentMethods ?? [],
       deposit.currencies ?? [],
       getPaymentMethodsCatalog(BASE_CHAIN_ID, environment)
     );
-    return deriveCashOrder(depositId, deposit.intents ?? [], {
+    return deriveCashOrder(compositeId, deposit.intents ?? [], {
       ...depositOrderOptions(deposit),
       ...payouts.length > 0 ? { payouts } : {}
     });
   }
   function escrowContext(depositId) {
-    const { escrowAddress, onchainDepositId } = parseCompositeDepositId(depositId);
+    const { escrowAddress, onchainDepositId } = parseDepositId(depositId);
     return {
       onchainDepositId,
       escrowArg: escrowAddress ? { escrowAddress } : {}
@@ -989,7 +1262,7 @@ function createCashClient(options) {
     const signaled = order.fills.filter((f) => f.status === "SIGNALED");
     const liveIntent = signaled.some((f) => isFillLive(f, nowSeconds));
     const expiredIntent = signaled.length > 0 && !liveIntent;
-    if (order.pendingAmount > 0n && liveIntent) {
+    if (liveIntent || order.pendingAmount > 0n && signaled.length === 0) {
       throw errors.activeIntentBlocksWithdrawal(depositId);
     }
     if (availableAmount(order) <= 0n && order.pendingAmount === 0n) {
@@ -1030,22 +1303,32 @@ function createCashClient(options) {
         txOverrides: attribution
       });
     } catch (err) {
-      throw mapChainError("approve", err);
+      throw mapChainError("approve", err, { requiredAmount: amount });
     }
     if (allowance.hadAllowance || !allowance.hash) return;
-    const receipt = await client.publicClient.waitForTransactionReceipt({ hash: allowance.hash });
+    let receipt;
+    try {
+      receipt = await client.publicClient.waitForTransactionReceipt({ hash: allowance.hash });
+    } catch (err) {
+      throw errors.transactionStatusUnknown(allowance.hash, err, "approve");
+    }
     if (receipt.status === "reverted") throw errors.transactionFailed(allowance.hash);
+    let lastReadError;
     for (let attempt = 0; attempt < 15; attempt++) {
-      const visible = await client.publicClient.readContract({
-        address: token,
-        abi: ERC20_ALLOWANCE_ABI,
-        functionName: "allowance",
-        args: [owner, escrow]
-      });
-      if (visible >= amount) return;
+      try {
+        const visible = await client.publicClient.readContract({
+          address: token,
+          abi: ERC20_ALLOWANCE_ABI,
+          functionName: "allowance",
+          args: [owner, escrow]
+        });
+        if (visible >= amount) return;
+      } catch (err) {
+        lastReadError = err;
+      }
       await sleep(1e3);
     }
-    throw errors.allowanceNotVisible(amount);
+    throw errors.allowanceNotVisible(amount, lastReadError);
   }
   return {
     capabilities,
@@ -1056,8 +1339,10 @@ function createCashClient(options) {
       return quoteRelayToBaseUsdc(input, options.relay);
     },
     async executeSourceQuote(quote, opts) {
+      if (!opts.signer.account) throw errors.signerRequired("executeSourceQuote");
       return executeRelayQuote(quote, opts.signer, {
         ...options.relay ? { relay: options.relay } : {},
+        ...opts.recipient ? { recipient: opts.recipient } : {},
         ...opts.onProgress ? { onProgress: opts.onProgress } : {},
         ...opts.disableCapabilitiesCheck !== void 0 ? { disableCapabilitiesCheck: opts.disableCapabilitiesCheck } : {}
       });
@@ -1073,7 +1358,7 @@ function createCashClient(options) {
       });
     },
     async cashout(input, opts) {
-      const client = signingClient("cashout", opts);
+      const client = await signingClient("cashout", opts);
       const owner = opts.signer.account.address;
       const payoutInput = validatePayout(input);
       let sourceResult;
@@ -1081,6 +1366,7 @@ function createCashClient(options) {
       if (input.source) {
         const sourceSigner = opts.sourceSigner ?? (input.source.chainId === BASE_CHAIN_ID ? opts.signer : void 0);
         if (!sourceSigner?.account) throw errors.signerRequired("source cashout");
+        await assertWalletChainId(sourceSigner, input.source.chainId, "source cashout");
         if (input.source.recipient !== void 0 && input.source.recipient.toLowerCase() !== owner.toLowerCase()) {
           throw errors.sourceRecipientMismatch(input.source.recipient, owner);
         }
@@ -1098,20 +1384,23 @@ function createCashClient(options) {
           throw errors.amountBelowMinimum(relayQuote.outputAmount, MIN_CASHOUT_AMOUNT);
         }
         cashoutAmount = relayQuote.outputAmount;
-        const depositInput2 = { amount: cashoutAmount, ...payoutInput };
+        const depositInput2 = validateDepositInput(cashoutAmount, input, payoutInput);
         const params2 = await buildDepositParams(client, depositInput2);
         const escrow2 = client.escrowV2Address ?? client.escrowAddress;
         await settleAllowance(client, params2.token, owner, escrow2, depositInput2.amount);
         const executed = await executeRelayQuote(relayQuote.raw, sourceSigner, {
           ...options.relay ? { relay: options.relay } : {},
+          recipient: owner,
           ...opts.onSourceProgress ? { onProgress: opts.onSourceProgress } : {},
           ...opts.disableSourceCapabilitiesCheck !== void 0 ? { disableCapabilitiesCheck: opts.disableSourceCapabilitiesCheck } : {}
         });
-        sourceResult = {
+        const routedSource = {
           amount: cashoutAmount,
           ...executed.requestId ? { requestId: executed.requestId } : {},
-          txHashes: executed.txHashes
+          txHashes: executed.txHashes,
+          ...executed.transactions ? { transactions: executed.transactions } : {}
         };
+        sourceResult = routedSource;
         const attributedParams2 = { ...params2, txOverrides: attribution };
         const send2 = async () => {
           try {
@@ -1128,10 +1417,26 @@ function createCashClient(options) {
         try {
           hash2 = await send2();
         } catch (err) {
-          throw mapChainError("createDeposit", err);
+          const mapped = mapChainError("createDeposit", err, {
+            requiredAmount: depositInput2.amount
+          });
+          if (isKnownPreBroadcastFailure(err, mapped)) {
+            throw errors.sourceRouteCompletedCashoutFailed(routedSource, mapped);
+          }
+          throw errors.sourceCashoutSubmissionUnknown(routedSource, owner, mapped);
+        }
+        let receipt2;
+        try {
+          receipt2 = await client.publicClient.waitForTransactionReceipt({ hash: hash2 });
+        } catch (err) {
+          throw errors.sourceCashoutStatusUnknown(routedSource, hash2, err);
+        }
+        if (receipt2.status === "reverted") {
+          throw errors.sourceRouteCompletedCashoutFailed(
+            routedSource,
+            errors.transactionFailed(hash2)
+          );
         }
-        const receipt2 = await client.publicClient.waitForTransactionReceipt({ hash: hash2 });
-        if (receipt2.status === "reverted") throw errors.transactionFailed(hash2);
         const abi2 = client.escrowV2Abi ?? client.escrowAbi;
         const resolved2 = resolveCashDepositId({ logs: receipt2.logs, abi: abi2 });
         if (!resolved2) throw errors.depositResolutionFailed(hash2);
@@ -1145,10 +1450,10 @@ function createCashClient(options) {
           escrowAddress: resolved2.escrowAddress,
           onchainDepositId: resolved2.onchainDepositId,
           order: order2,
-          source: sourceResult
+          source: routedSource
         };
       }
-      const depositInput = validateInput(input);
+      const depositInput = validateDepositInput(input.amount, input, payoutInput);
       const params = await buildDepositParams(client, depositInput);
       const escrow = client.escrowV2Address ?? client.escrowAddress;
       await settleAllowance(client, params.token, owner, escrow, depositInput.amount);
@@ -1168,9 +1473,23 @@ function createCashClient(options) {
       try {
         hash = await send();
       } catch (err) {
-        throw mapChainError("createDeposit", err);
+        const mapped = mapChainError("createDeposit", err, {
+          requiredAmount: depositInput.amount
+        });
+        if (isKnownPreBroadcastFailure(err, mapped)) throw mapped;
+        throw errors.transactionSubmissionUnknown("cashout", err, {
+          kind: "inspect-base-cashout-submission",
+          amount: depositInput.amount.toString(),
+          depositor: owner,
+          txHashes: []
+        });
+      }
+      let receipt;
+      try {
+        receipt = await client.publicClient.waitForTransactionReceipt({ hash });
+      } catch (err) {
+        throw errors.transactionStatusUnknown(hash, err, "cashout");
       }
-      const receipt = await client.publicClient.waitForTransactionReceipt({ hash });
       if (receipt.status === "reverted") throw errors.transactionFailed(hash);
       const abi = client.escrowV2Abi ?? client.escrowAbi;
       const resolved = resolveCashDepositId({ logs: receipt.logs, abi });
@@ -1190,7 +1509,7 @@ function createCashClient(options) {
     },
     async prepare(input) {
       if (input.source) throw errors.sourceRouteUnsupportedInPrepare();
-      const depositInput = validateInput(input);
+      const depositInput = validateDepositInput(input.amount, input);
       const params = await buildDepositParams(readClient, depositInput);
       const { prepared } = await readClient.prepareCreateDeposit({
         ...params,
@@ -1229,13 +1548,46 @@ function createCashClient(options) {
       return fetchOrder(depositId);
     },
     async buyer(address) {
-      const intents = await readClient.indexer.getOwnerIntents(address, CASH_ORDER_STATUSES);
+      let intents;
+      try {
+        intents = await readClient.indexer.getOwnerIntents(address, CASH_ORDER_STATUSES);
+      } catch (err) {
+        throw errors.indexerUnavailable("buyer profile", err);
+      }
       return deriveBuyerProfile(address, intents);
     },
     async orders(owner, opts = {}) {
       const { inFlight = false, limit = 100 } = opts;
-      const deposits = await readClient.indexer.getDeposits({ depositor: owner }, { limit });
-      const derived = deposits.map((d) => deriveCashOrder(d.id, [], { ...depositOrderOptions(d), fillsIncluded: false })).filter((o) => o.totalAmount > 10000n).sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0));
+      let deposits;
+      try {
+        deposits = await readClient.indexer.getDepositsWithRelations(
+          { depositor: owner },
+          { limit }
+        );
+      } catch (err) {
+        throw errors.indexerUnavailable("orders", err);
+      }
+      const catalog = getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
+      const derived = deposits.flatMap((deposit) => {
+        if (deposit.token.toLowerCase() !== BASE_USDC_ADDRESS.toLowerCase()) return [];
+        const payouts = derivePayouts(
+          deposit.paymentMethods ?? [],
+          deposit.currencies ?? [],
+          catalog
+        );
+        if (payouts.length !== 1 || !payouts.every((payout) => payout.pricing.marketRate && payout.pricing.spreadBps === 0)) {
+          return [];
+        }
+        return [
+          deriveCashOrder(deposit.id, [], {
+            ...depositOrderOptions(deposit),
+            payouts,
+            // List rows carry no intent detail - a positive outstanding
+            // amount is treated conservatively as a live lock.
+            fillsIncluded: false
+          })
+        ];
+      }).filter((o) => o.totalAmount >= MIN_CASHOUT_AMOUNT).sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0));
       return inFlight ? derived.filter((o) => o.isInFlight) : derived;
     },
     async *watch(depositId, opts = {}) {
@@ -1265,7 +1617,7 @@ function createCashClient(options) {
       }
     },
     async withdraw(depositId, opts) {
-      const client = signingClient("withdraw", opts);
+      const client = await signingClient("withdraw", opts);
       if (opts.amount !== void 0) {
         const { onchainDepositId: onchainDepositId2, escrowArg: escrowArg2 } = await partialWithdrawContext(
           depositId,
@@ -1363,7 +1715,7 @@ function createCashClient(options) {
       return { txs, steps };
     },
     async topUp(depositId, amount, opts) {
-      const client = signingClient("topUp", opts);
+      const client = await signingClient("topUp", opts);
       const { onchainDepositId, escrowArg } = await topUpContext(depositId, amount);
       const owner = opts.signer.account.address;
       const escrow = escrowArg.escrowAddress ?? client.escrowV2Address ?? client.escrowAddress;
@@ -1418,6 +1770,39 @@ function createCashClient(options) {
   };
 }
 var bigintString = z.string().regex(/^-?\d+$/, "expected a decimal bigint string");
+var nonNegativeBigintString = z.string().regex(/^\d+$/, "expected a non-negative decimal bigint string");
+var relayTransactionJsonSchema = z.object({
+  hash: z.string(),
+  chainId: z.number()
+});
+var relayTransactionsJsonSchema = z.object({
+  origin: z.array(relayTransactionJsonSchema),
+  destination: z.array(relayTransactionJsonSchema)
+}).strict();
+var cashAssetJsonSchema = z.object({
+  chainId: z.number(),
+  address: z.string(),
+  symbol: z.string(),
+  decimals: z.number(),
+  name: z.string().optional(),
+  isNative: z.boolean().optional()
+});
+var cashChainJsonSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  displayName: z.string(),
+  disabled: z.boolean(),
+  depositEnabled: z.boolean(),
+  blockProductionLagging: z.boolean(),
+  vmType: z.string().optional(),
+  tokens: z.array(cashAssetJsonSchema)
+});
+var cashSourceCapabilitiesJsonSchema = z.object({
+  destination: cashAssetJsonSchema,
+  chains: z.array(cashChainJsonSchema),
+  source: z.literal("relay-sdk"),
+  asOf: z.number()
+});
 var cashOrderStateSchema = z.enum([
   "awaiting-buyer",
   "matched",
@@ -1430,18 +1815,18 @@ var intentStatusSchema = z.enum(["SIGNALED", "FULFILLED", "PRUNED", "MANUALLY_RE
 var cashFillJsonSchema = z.object({
   intentHash: z.string(),
   status: intentStatusSchema,
-  amount: bigintString,
+  amount: nonNegativeBigintString,
   buyer: z.string(),
   currency: z.string().optional(),
   currencyHash: z.string().optional(),
   rate: z.number().optional(),
-  conversionRate: bigintString.optional(),
+  conversionRate: nonNegativeBigintString.optional(),
   fiatOwed: z.number().optional(),
   fiatPaid: z.number().optional(),
   paidCurrency: z.string().optional(),
   paymentId: z.string().optional(),
   paidAt: z.number().optional(),
-  releasedAmount: bigintString.optional(),
+  releasedAmount: nonNegativeBigintString.optional(),
   fillLatencySeconds: z.number().optional(),
   isExpired: z.boolean().optional(),
   signaledAt: z.number().optional(),
@@ -1480,10 +1865,10 @@ var cashOrderJsonSchema = z.object({
   depositId: z.string(),
   state: cashOrderStateSchema,
   fills: z.array(cashFillJsonSchema),
-  totalAmount: bigintString,
-  filledAmount: bigintString,
-  pendingAmount: bigintString,
-  returnedAmount: bigintString,
+  totalAmount: nonNegativeBigintString,
+  filledAmount: nonNegativeBigintString,
+  pendingAmount: nonNegativeBigintString,
+  returnedAmount: nonNegativeBigintString,
   nextActions: z.array(cashNextActionSchema),
   primaryIntentHash: z.string().optional(),
   matchedAt: z.number().optional(),
@@ -1498,7 +1883,7 @@ var cashOrderJsonSchema = z.object({
 var cashEstimateJsonSchema = z.object({
   kind: z.literal("oracle-estimate"),
   currency: z.string(),
-  amount: bigintString,
+  amount: nonNegativeBigintString,
   rate: z.number(),
   receiveAmount: z.number(),
   asOf: z.number(),
@@ -1514,7 +1899,7 @@ var cashEstimateJsonSchema = z.object({
       name: z.string().optional(),
       isNative: z.boolean().optional()
     }),
-    inputAmount: bigintString,
+    inputAmount: nonNegativeBigintString,
     relayQuote: z.object({
       requestId: z.string().optional(),
       source: z.object({
@@ -1533,8 +1918,8 @@ var cashEstimateJsonSchema = z.object({
         name: z.string().optional(),
         isNative: z.boolean().optional()
       }),
-      inputAmount: bigintString,
-      outputAmount: bigintString,
+      inputAmount: nonNegativeBigintString,
+      outputAmount: nonNegativeBigintString,
       rate: z.number().optional(),
       timeEstimateSeconds: z.number().optional(),
       fees: z.unknown().optional(),
@@ -1542,7 +1927,7 @@ var cashEstimateJsonSchema = z.object({
         z.object({
           to: z.string(),
           data: z.string(),
-          value: bigintString,
+          value: nonNegativeBigintString,
           chainId: z.number()
         })
       ),
@@ -1557,9 +1942,39 @@ var cashEstimateJsonSchema = z.object({
 var preparedTransactionJsonSchema = z.object({
   to: z.string(),
   data: z.string(),
-  value: bigintString,
+  value: nonNegativeBigintString,
   chainId: z.number()
 });
+var relayQuoteJsonSchema = z.object({
+  requestId: z.string().optional(),
+  source: cashAssetJsonSchema,
+  destination: cashAssetJsonSchema,
+  inputAmount: nonNegativeBigintString,
+  outputAmount: nonNegativeBigintString,
+  rate: z.number().optional(),
+  timeEstimateSeconds: z.number().optional(),
+  fees: z.unknown().optional(),
+  txs: z.array(preparedTransactionJsonSchema),
+  raw: z.unknown()
+});
+var relayStatusJsonSchema = z.object({
+  requestId: z.string(),
+  status: z.enum(["refund", "waiting", "depositing", "failure", "pending", "submitted", "success"]),
+  details: z.string().optional(),
+  inTxHashes: z.array(z.string()),
+  txHashes: z.array(z.string()),
+  updatedAt: z.number().optional(),
+  originChainId: z.number().optional(),
+  destinationChainId: z.number().optional(),
+  quoteCreatedAt: z.number().optional(),
+  raw: z.unknown()
+});
+var relayExecutionResultJsonSchema = z.object({
+  requestId: z.string().optional(),
+  txHashes: z.array(z.string()),
+  transactions: relayTransactionsJsonSchema.optional(),
+  quote: z.unknown()
+});
 var cashPreparedStepJsonSchema = z.object({
   kind: z.enum([
     "approve",
@@ -1575,12 +1990,13 @@ var cashoutResultJsonSchema = z.object({
   depositId: z.string(),
   txHash: z.string(),
   escrowAddress: z.string(),
-  onchainDepositId: bigintString,
+  onchainDepositId: nonNegativeBigintString,
   order: cashOrderJsonSchema,
   source: z.object({
-    amount: bigintString,
+    amount: nonNegativeBigintString,
     requestId: z.string().optional(),
-    txHashes: z.array(z.string())
+    txHashes: z.array(z.string()),
+    transactions: relayTransactionsJsonSchema.optional()
   }).optional()
 });
 var prepareResultJsonSchema = z.object({
@@ -1610,39 +2026,7 @@ var cashCapabilitiesJsonSchema = z.object({
       chainId: z.number(),
       token: z.object({ address: z.string(), symbol: z.literal("USDC"), decimals: z.number() })
     }),
-    relay: z.object({
-      destination: z.object({
-        chainId: z.number(),
-        address: z.string(),
-        symbol: z.string(),
-        decimals: z.number(),
-        name: z.string().optional(),
-        isNative: z.boolean().optional()
-      }),
-      chains: z.array(
-        z.object({
-          id: z.number(),
-          name: z.string(),
-          displayName: z.string(),
-          disabled: z.boolean(),
-          depositEnabled: z.boolean(),
-          blockProductionLagging: z.boolean(),
-          vmType: z.string().optional(),
-          tokens: z.array(
-            z.object({
-              chainId: z.number(),
-              address: z.string(),
-              symbol: z.string(),
-              decimals: z.number(),
-              name: z.string().optional(),
-              isNative: z.boolean().optional()
-            })
-          )
-        })
-      ),
-      source: z.literal("relay-sdk"),
-      asOf: z.number()
-    }).optional()
+    relay: cashSourceCapabilitiesJsonSchema.optional()
   }),
   platforms: z.array(
     z.object({
@@ -1653,15 +2037,98 @@ var cashCapabilitiesJsonSchema = z.object({
     })
   ),
   currencies: z.array(z.string()),
-  amount: z.object({ min: bigintString, recommendedMin: bigintString, max: z.null() }),
+  amount: z.object({
+    min: nonNegativeBigintString,
+    recommendedMin: nonNegativeBigintString,
+    max: z.null()
+  }),
   pricing: z.object({ kind: z.literal("oracle-market-rate"), spreadBps: z.literal(0) })
 });
+function defineCashErrorCodes(codes) {
+  return codes;
+}
+var CASH_ERROR_CODES = defineCashErrorCodes([
+  "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_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"
+]);
+var cashSourceRecoveryJsonShape = {
+  amount: nonNegativeBigintString,
+  requestId: z.string().optional(),
+  txHashes: z.array(z.string()),
+  transactions: relayTransactionsJsonSchema.optional()
+};
+var cashErrorRecoveryJsonSchema = z.discriminatedUnion("kind", [
+  z.object({
+    ...cashSourceRecoveryJsonShape,
+    kind: z.literal("retry-base-usdc-cashout")
+  }).strict(),
+  z.object({
+    ...cashSourceRecoveryJsonShape,
+    kind: z.literal("inspect-base-cashout-transaction"),
+    depositTxHash: z.string()
+  }).strict(),
+  z.object({
+    ...cashSourceRecoveryJsonShape,
+    kind: z.literal("inspect-base-cashout-submission"),
+    depositor: z.string()
+  }).strict(),
+  z.object({
+    kind: z.literal("inspect-relay-route"),
+    requestId: z.string().optional(),
+    txHashes: z.array(z.string()),
+    transactions: relayTransactionsJsonSchema.optional()
+  }).strict(),
+  z.object({
+    kind: z.literal("inspect-base-operation-submission"),
+    operation: z.string()
+  }).strict(),
+  z.object({
+    kind: z.literal("inspect-base-transaction"),
+    transactionHash: z.string(),
+    operation: z.string()
+  }).strict()
+]);
 var cashErrorJsonSchema = z.object({
-  code: z.string(),
+  code: z.enum(CASH_ERROR_CODES),
   message: z.string(),
   retryable: z.boolean(),
-  remediation: z.string()
-});
+  remediation: z.string(),
+  recovery: cashErrorRecoveryJsonSchema.optional()
+}).strict();
 
 // src/codecs/json.ts
 function omitUndefined(obj) {
@@ -1692,35 +2159,38 @@ function fillToJson(fill) {
   });
 }
 function fillFromJson(json) {
+  const parsed = cashFillJsonSchema.parse(json);
   return omitUndefined({
-    ...json,
-    amount: BigInt(json.amount),
-    conversionRate: json.conversionRate !== void 0 ? BigInt(json.conversionRate) : void 0,
-    releasedAmount: json.releasedAmount !== void 0 ? BigInt(json.releasedAmount) : void 0
+    ...parsed,
+    amount: BigInt(parsed.amount),
+    conversionRate: parsed.conversionRate !== void 0 ? BigInt(parsed.conversionRate) : void 0,
+    releasedAmount: parsed.releasedAmount !== void 0 ? BigInt(parsed.releasedAmount) : void 0
   });
 }
 function orderToJson(order) {
-  return omitUndefined({
-    depositId: order.depositId,
-    state: order.state,
-    fills: order.fills.map(fillToJson),
-    totalAmount: order.totalAmount.toString(),
-    filledAmount: order.filledAmount.toString(),
-    pendingAmount: order.pendingAmount.toString(),
-    returnedAmount: order.returnedAmount.toString(),
-    nextActions: order.nextActions,
-    primaryIntentHash: order.primaryIntentHash,
-    matchedAt: order.matchedAt,
-    deliveredAt: order.deliveredAt,
-    updatedAt: order.updatedAt,
-    intentCount: order.intentCount,
-    payouts: order.payouts?.map(
-      (p) => omitUndefined({ ...p, pricing: omitUndefined({ ...p.pricing }) })
-    ),
-    successRateBps: order.successRateBps,
-    isInFlight: order.isInFlight,
-    withdrawn: order.withdrawn
-  });
+  return cashOrderJsonSchema.parse(
+    omitUndefined({
+      depositId: order.depositId,
+      state: order.state,
+      fills: order.fills.map(fillToJson),
+      totalAmount: order.totalAmount.toString(),
+      filledAmount: order.filledAmount.toString(),
+      pendingAmount: order.pendingAmount.toString(),
+      returnedAmount: order.returnedAmount.toString(),
+      nextActions: order.nextActions,
+      primaryIntentHash: order.primaryIntentHash,
+      matchedAt: order.matchedAt,
+      deliveredAt: order.deliveredAt,
+      updatedAt: order.updatedAt,
+      intentCount: order.intentCount,
+      payouts: order.payouts?.map(
+        (p) => omitUndefined({ ...p, pricing: omitUndefined({ ...p.pricing }) })
+      ),
+      successRateBps: order.successRateBps,
+      isInFlight: order.isInFlight,
+      withdrawn: order.withdrawn
+    })
+  );
 }
 function orderFromJson(json) {
   const parsed = cashOrderJsonSchema.parse(json);
@@ -1746,6 +2216,7 @@ function estimateToJson(estimate) {
         inputAmount: estimate.source.relayQuote.inputAmount.toString(),
         outputAmount: estimate.source.relayQuote.outputAmount.toString(),
         txs: estimate.source.relayQuote.txs.map(preparedTxToJson),
+        ...estimate.source.relayQuote.fees !== void 0 ? { fees: sanitizeRelayValue(estimate.source.relayQuote.fees) } : {},
         raw: sanitizeRelayQuoteRaw(estimate.source.relayQuote.raw)
       }
     } : void 0
@@ -1764,11 +2235,108 @@ function estimateFromJson(json) {
         ...parsed.source.relayQuote,
         inputAmount: BigInt(parsed.source.relayQuote.inputAmount),
         outputAmount: BigInt(parsed.source.relayQuote.outputAmount),
-        txs: parsed.source.relayQuote.txs.map(preparedTxFromJson)
+        txs: parsed.source.relayQuote.txs.map(preparedTxFromJson),
+        ...parsed.source.relayQuote.fees !== void 0 ? { fees: restoreRelayValue(parsed.source.relayQuote.fees) } : {},
+        raw: restoreRelayQuoteRaw(parsed.source.relayQuote.raw)
       }
     } : void 0
   });
 }
+function cashAssetFromJson(asset) {
+  return {
+    chainId: asset.chainId,
+    address: asset.address,
+    symbol: asset.symbol,
+    decimals: asset.decimals,
+    ...asset.name !== void 0 ? { name: asset.name } : {},
+    ...asset.isNative !== void 0 ? { isNative: asset.isNative } : {}
+  };
+}
+function relayQuoteToJson(quote) {
+  return relayQuoteJsonSchema.parse({
+    ...quote.requestId !== void 0 ? { requestId: quote.requestId } : {},
+    source: quote.source,
+    destination: quote.destination,
+    inputAmount: quote.inputAmount.toString(),
+    outputAmount: quote.outputAmount.toString(),
+    ...quote.rate !== void 0 ? { rate: quote.rate } : {},
+    ...quote.timeEstimateSeconds !== void 0 ? { timeEstimateSeconds: quote.timeEstimateSeconds } : {},
+    ...quote.fees !== void 0 ? { fees: sanitizeRelayValue(quote.fees) } : {},
+    txs: quote.txs.map(preparedTxToJson),
+    raw: sanitizeRelayQuoteRaw(quote.raw)
+  });
+}
+function relayQuoteFromJson(json) {
+  const parsed = relayQuoteJsonSchema.parse(json);
+  return {
+    ...parsed.requestId !== void 0 ? { requestId: parsed.requestId } : {},
+    source: cashAssetFromJson(parsed.source),
+    destination: cashAssetFromJson(parsed.destination),
+    inputAmount: BigInt(parsed.inputAmount),
+    outputAmount: BigInt(parsed.outputAmount),
+    ...parsed.rate !== void 0 ? { rate: parsed.rate } : {},
+    ...parsed.timeEstimateSeconds !== void 0 ? { timeEstimateSeconds: parsed.timeEstimateSeconds } : {},
+    ...parsed.fees !== void 0 ? { fees: restoreRelayValue(parsed.fees) } : {},
+    txs: parsed.txs.map(preparedTxFromJson),
+    raw: restoreRelayQuoteRaw(parsed.raw)
+  };
+}
+function sourceCapabilitiesToJson(capabilities) {
+  return cashSourceCapabilitiesJsonSchema.parse(capabilities);
+}
+function sourceCapabilitiesFromJson(json) {
+  const parsed = cashSourceCapabilitiesJsonSchema.parse(json);
+  return {
+    destination: cashAssetFromJson(parsed.destination),
+    chains: parsed.chains.map((chain) => ({
+      id: chain.id,
+      name: chain.name,
+      displayName: chain.displayName,
+      disabled: chain.disabled,
+      depositEnabled: chain.depositEnabled,
+      blockProductionLagging: chain.blockProductionLagging,
+      ...chain.vmType !== void 0 ? { vmType: chain.vmType } : {},
+      tokens: chain.tokens.map(cashAssetFromJson)
+    })),
+    source: parsed.source,
+    asOf: parsed.asOf
+  };
+}
+function relayStatusToJson(status) {
+  return relayStatusJsonSchema.parse({ ...status, raw: sanitizeRelayValue(status.raw) });
+}
+function relayStatusFromJson(json) {
+  const parsed = relayStatusJsonSchema.parse(json);
+  return {
+    requestId: parsed.requestId,
+    status: parsed.status,
+    ...parsed.details !== void 0 ? { details: parsed.details } : {},
+    inTxHashes: parsed.inTxHashes,
+    txHashes: parsed.txHashes,
+    ...parsed.updatedAt !== void 0 ? { updatedAt: parsed.updatedAt } : {},
+    ...parsed.originChainId !== void 0 ? { originChainId: parsed.originChainId } : {},
+    ...parsed.destinationChainId !== void 0 ? { destinationChainId: parsed.destinationChainId } : {},
+    ...parsed.quoteCreatedAt !== void 0 ? { quoteCreatedAt: parsed.quoteCreatedAt } : {},
+    raw: restoreRelayValue(parsed.raw)
+  };
+}
+function relayExecutionResultToJson(result) {
+  return relayExecutionResultJsonSchema.parse({
+    ...result.requestId !== void 0 ? { requestId: result.requestId } : {},
+    txHashes: result.txHashes,
+    ...result.transactions !== void 0 ? { transactions: result.transactions } : {},
+    quote: sanitizeRelayQuoteRaw(result.quote)
+  });
+}
+function relayExecutionResultFromJson(json) {
+  const parsed = relayExecutionResultJsonSchema.parse(json);
+  return {
+    ...parsed.requestId !== void 0 ? { requestId: parsed.requestId } : {},
+    txHashes: parsed.txHashes,
+    ...parsed.transactions !== void 0 ? { transactions: parsed.transactions } : {},
+    quote: restoreRelayQuoteRaw(parsed.quote)
+  };
+}
 function preparedTxToJson(tx) {
   return { to: tx.to, data: tx.data, value: tx.value.toString(), chainId: tx.chainId };
 }
@@ -1887,7 +2455,68 @@ function capabilitiesFromJson(json) {
     }
   };
 }
+function cashErrorToJson(error) {
+  return cashErrorJsonSchema.parse({
+    code: error.code,
+    message: error.message,
+    retryable: error.retryable,
+    remediation: error.remediation,
+    ...error.recovery ? { recovery: error.recovery } : {}
+  });
+}
+function cashErrorFromJson(json) {
+  const parsed = cashErrorJsonSchema.parse(json);
+  let recovery;
+  if (parsed.recovery) {
+    if (parsed.recovery.kind === "inspect-base-transaction") {
+      recovery = {
+        kind: parsed.recovery.kind,
+        transactionHash: parsed.recovery.transactionHash,
+        operation: parsed.recovery.operation
+      };
+    } else if (parsed.recovery.kind === "inspect-base-operation-submission") {
+      recovery = {
+        kind: parsed.recovery.kind,
+        operation: parsed.recovery.operation
+      };
+    } else if (parsed.recovery.kind === "inspect-relay-route") {
+      recovery = {
+        kind: parsed.recovery.kind,
+        txHashes: parsed.recovery.txHashes,
+        ...parsed.recovery.requestId !== void 0 ? { requestId: parsed.recovery.requestId } : {},
+        ...parsed.recovery.transactions !== void 0 ? { transactions: parsed.recovery.transactions } : {}
+      };
+    } else {
+      const common = {
+        amount: parsed.recovery.amount,
+        txHashes: parsed.recovery.txHashes,
+        ...parsed.recovery.requestId !== void 0 ? { requestId: parsed.recovery.requestId } : {},
+        ...parsed.recovery.transactions !== void 0 ? { transactions: parsed.recovery.transactions } : {}
+      };
+      if (parsed.recovery.kind === "retry-base-usdc-cashout") {
+        recovery = { ...common, kind: parsed.recovery.kind };
+      } else if (parsed.recovery.kind === "inspect-base-cashout-submission") {
+        recovery = {
+          ...common,
+          kind: parsed.recovery.kind,
+          depositor: parsed.recovery.depositor
+        };
+      } else {
+        recovery = {
+          ...common,
+          kind: parsed.recovery.kind,
+          depositTxHash: parsed.recovery.depositTxHash
+        };
+      }
+    }
+  }
+  return new CashError({
+    code: parsed.code,
+    message: parsed.message,
+    retryable: parsed.retryable,
+    remediation: parsed.remediation,
+    ...recovery ? { recovery } : {}
+  });
+}
 
-export { CASH_ATTRIBUTION_CODE, MIN_CASHOUT_AMOUNT, RATE_PRECISION, RECOMMENDED_MIN_CASHOUT_AMOUNT, bigintString, buildCapabilities, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashErrorJsonSchema, cashEstimateJsonSchema, cashFillJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, createCashClient, deriveBuyerProfile, deriveCashOrder, derivePayouts, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillToJson, formatUsdc, intentStatusSchema, isFillLive, isMarketRateSupported, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, resolveCashDepositId, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+export { CASH_ATTRIBUTION_CODE, MIN_CASHOUT_AMOUNT, RATE_PRECISION, RECOMMENDED_MIN_CASHOUT_AMOUNT, bigintString, buildCapabilities, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashAssetJsonSchema, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashChainJsonSchema, cashErrorFromJson, cashErrorJsonSchema, cashErrorRecoveryJsonSchema, cashErrorToJson, cashEstimateJsonSchema, cashFillJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashSourceCapabilitiesJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, createCashClient, deriveBuyerProfile, deriveCashOrder, derivePayouts, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillToJson, formatUsdc, intentStatusSchema, isFillLive, isMarketRateSupported, nonNegativeBigintString, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, relayExecutionResultFromJson, relayExecutionResultJsonSchema, relayExecutionResultToJson, relayQuoteFromJson, relayQuoteJsonSchema, relayQuoteToJson, relayStatusFromJson, relayStatusJsonSchema, relayStatusToJson, relayTransactionJsonSchema, relayTransactionsJsonSchema, resolveCashDepositId, sourceCapabilitiesFromJson, sourceCapabilitiesToJson, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };