@zkp2p/cash 0.1.0-dev.0 → 0.1.2

package/dist/index.js

@@ -1,8 +1,10 @@
-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-4DRZRWWS.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-4DRZRWWS.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 } 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 { 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';
+import { fetchChainConfigs, configureDynamicChains } from '@relayprotocol/relay-sdk/chain-utils';
 import { z } from 'zod';
 
 function isMarketRateSupported(currency, adapters) {
@@ -414,16 +416,308 @@ function buildCapabilities(environment) {
     };
   }).filter((p) => p.currencies.length > 0).sort((a, b) => a.platform.localeCompare(b.platform));
   const currencies = [...new Set(platforms.flatMap((p) => p.currencies))].sort();
+  const baseUsdc = { address: BASE_USDC_ADDRESS, symbol: "USDC", decimals: USDC_DECIMALS };
   return {
     chainId: BASE_CHAIN_ID,
-    token: { address: BASE_USDC_ADDRESS, symbol: "USDC", decimals: USDC_DECIMALS },
+    token: baseUsdc,
     environment,
+    destination: { chainId: BASE_CHAIN_ID, token: baseUsdc },
+    source: { default: { chainId: BASE_CHAIN_ID, token: baseUsdc } },
     platforms,
     currencies,
     amount: { min: MIN_CASHOUT_AMOUNT, recommendedMin: RECOMMENDED_MIN_CASHOUT_AMOUNT, max: null },
     pricing: { kind: "oracle-market-rate", spreadBps: 0 }
   };
 }
+var ETA_WINDOW_DAYS = 7;
+var ETA_WINDOW_SECONDS = ETA_WINDOW_DAYS * 24 * 60 * 60;
+var ETA_SAMPLE_LIMIT = 250;
+var FULFILLED = /* @__PURE__ */ new Set(["FULFILLED", "MANUALLY_RELEASED"]);
+function toUnixSeconds2(value) {
+  if (value === null || value === void 0 || value === "") return void 0;
+  if (value instanceof Date) {
+    const seconds = Math.floor(value.getTime() / 1e3);
+    return Number.isFinite(seconds) && seconds > 0 ? seconds : void 0;
+  }
+  if (typeof value === "string" && /[TZ:-]/.test(value)) {
+    const parsed = Date.parse(value);
+    if (Number.isFinite(parsed)) return Math.floor(parsed / 1e3);
+  }
+  const n = Number(value);
+  return Number.isFinite(n) && n > 0 ? n : void 0;
+}
+function median(values) {
+  if (values.length === 0) return void 0;
+  const sorted = [...values].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  return sorted.length % 2 === 1 ? sorted[mid] : Math.round((sorted[mid - 1] + sorted[mid]) / 2);
+}
+function etaLabel(seconds) {
+  if (seconds === void 0) return "Recent fill time unavailable";
+  if (seconds < 60) return "Usually starts in under a minute";
+  const minutes = Math.max(1, Math.round(seconds / 60));
+  if (minutes < 60) return `Usually starts in about ${minutes} min`;
+  const hours = Math.max(1, Math.round(minutes / 60));
+  return `Usually starts in about ${hours} hr`;
+}
+function matchesPayout(deposit, environment, platform, currency) {
+  const payouts = derivePayouts(
+    deposit.paymentMethods ?? [],
+    deposit.currencies ?? [],
+    getPaymentMethodsCatalog(BASE_CHAIN_ID, environment)
+  );
+  if (payouts.length === 0) return true;
+  return payouts.some(
+    (payout) => (platform === void 0 || payout.platform === platform) && (currency === void 0 || payout.currency === currency)
+  );
+}
+async function readFillEta(client, input) {
+  const now = Math.floor(Date.now() / 1e3);
+  const windowStart = now - ETA_WINDOW_SECONDS;
+  const deposits = await client.indexer.getDepositsWithRelations(
+    { chainId: BASE_CHAIN_ID },
+    { limit: ETA_SAMPLE_LIMIT, orderBy: "updatedAt", orderDirection: "desc" },
+    { includeIntents: true, intentStatuses: ["FULFILLED", "MANUALLY_RELEASED"] }
+  );
+  const firstFillLatencies = [];
+  for (const deposit of deposits) {
+    const createdAt = toUnixSeconds2(deposit.createdAt ?? deposit.timestamp);
+    if (createdAt === void 0 || createdAt < windowStart) continue;
+    if (!matchesPayout(deposit, input.environment, input.platform, input.currency)) continue;
+    const fulfilled = (deposit.intents ?? []).filter((intent) => intent.status != null && FULFILLED.has(intent.status)).map((intent) => ({
+      fulfilledAt: toUnixSeconds2(intent.fulfillTimestamp)
+    })).filter(
+      (intent) => intent.fulfilledAt !== void 0 && intent.fulfilledAt >= createdAt
+    ).sort((a, b) => a.fulfilledAt - b.fulfilledAt);
+    if (fulfilled.length === 0) continue;
+    firstFillLatencies.push(fulfilled[0].fulfilledAt - createdAt);
+  }
+  const seconds = median(firstFillLatencies);
+  return {
+    ...seconds !== void 0 ? { seconds } : {},
+    label: etaLabel(seconds)
+  };
+}
+var RELAY_API_URL = MAINNET_RELAY_API;
+var NATIVE_TOKEN_ADDRESS = "0x0000000000000000000000000000000000000000";
+var BASE_USDC_ASSET = {
+  chainId: BASE_CHAIN_ID,
+  address: BASE_USDC_ADDRESS,
+  symbol: "USDC",
+  decimals: USDC_DECIMALS,
+  name: "USD Coin"
+};
+function relayClient(options = {}) {
+  if (options.client) return options.client;
+  return createClient({
+    baseApiUrl: options.apiUrl ?? RELAY_API_URL,
+    source: options.source ?? "peer-cash",
+    ...options.apiKey ? { apiKey: options.apiKey } : {},
+    ...options.chains ? { chains: options.chains } : {}
+  });
+}
+function asRecord(value) {
+  return value !== null && typeof value === "object" ? value : {};
+}
+function asString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function asNumber(value) {
+  const n = Number(value);
+  return Number.isFinite(n) ? n : void 0;
+}
+function normalizeToken(chainId, token) {
+  const row = asRecord(token);
+  const address = asString(row.address);
+  const symbol = asString(row.symbol);
+  const decimals = asNumber(row.decimals);
+  const name = asString(row.name);
+  if (!address || !symbol || decimals === void 0) return null;
+  const metadata = asRecord(row.metadata);
+  return {
+    chainId,
+    address,
+    symbol,
+    decimals,
+    ...name ? { name } : {},
+    ...metadata.isNative === true || address.toLowerCase() === NATIVE_TOKEN_ADDRESS ? { isNative: true } : {}
+  };
+}
+function normalizeTx(data, chainId) {
+  const row = asRecord(data);
+  const to = asString(row.to);
+  const calldata = asString(row.data) ?? "0x";
+  if (!to) return null;
+  return {
+    to,
+    data: calldata,
+    value: BigInt(String(row.value ?? "0")),
+    chainId: asNumber(row.chainId) ?? chainId
+  };
+}
+function normalizeChain(chain) {
+  const row = asRecord(chain);
+  const tokenRows = [
+    chain.currency,
+    ...chain.featuredTokens ?? [],
+    ...chain.erc20Currencies ?? [],
+    ...chain.solverCurrencies ?? []
+  ];
+  const tokens = /* @__PURE__ */ new Map();
+  for (const token of tokenRows) {
+    const normalizedToken = normalizeToken(chain.id, token);
+    if (normalizedToken) tokens.set(normalizedToken.address.toLowerCase(), normalizedToken);
+  }
+  return {
+    id: chain.id,
+    name: chain.name,
+    displayName: chain.displayName,
+    disabled: row.disabled === true,
+    depositEnabled: chain.depositEnabled ?? false,
+    blockProductionLagging: chain.blockProductionLagging ?? false,
+    ...chain.vmType ? { vmType: chain.vmType } : {},
+    tokens: [...tokens.values()].sort((a, b) => a.symbol.localeCompare(b.symbol))
+  };
+}
+function isSupportedEvmChain(chain) {
+  return chain.vmType === void 0 || chain.vmType === "evm";
+}
+function quoteRequestId(quote) {
+  return quote.steps.map((step) => step.requestId).find((id) => id !== void 0);
+}
+function quoteSourceChainId(quote) {
+  const details = asRecord(quote.details);
+  const currencyIn = asRecord(details.currencyIn);
+  const sourceCurrency = asRecord(currencyIn.currency);
+  return asNumber(sourceCurrency.chainId);
+}
+function sanitizeRelayQuoteRaw(quote) {
+  if (!quote.request) return quote;
+  const request = { ...quote.request };
+  delete request.headers;
+  return { ...quote, request };
+}
+async function resolveRelayChains(options, client, config = {}) {
+  const preferInjectedClientChains = config.preferInjectedClientChains ?? true;
+  const chains = options.chains ?? (preferInjectedClientChains && options.client?.chains?.length ? options.client.chains : void 0) ?? (options.client ? await fetchChainConfigs(client.baseApiUrl, client.source, client.apiKey) : await configureDynamicChains());
+  client.chains = chains;
+  return chains;
+}
+function relayQuoteFromExecute(input, quote) {
+  const details = asRecord(quote.details);
+  const currencyIn = asRecord(details.currencyIn);
+  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 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 requestId = quoteRequestId(quote);
+  const rate = asNumber(details.rate);
+  const timeEstimateSeconds = asNumber(details.timeEstimate);
+  return {
+    ...requestId ? { requestId } : {},
+    source,
+    destination,
+    inputAmount: BigInt(String(currencyIn.amount ?? input.amount.toString())),
+    outputAmount,
+    ...rate !== void 0 ? { rate } : {},
+    ...timeEstimateSeconds !== void 0 ? { timeEstimateSeconds } : {},
+    ...quote.fees !== void 0 ? { fees: quote.fees } : {},
+    txs,
+    raw: sanitizeRelayQuoteRaw(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)
+  };
+}
+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);
+}
+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
+  };
+}
+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
+  };
+}
+
+// src/client/estimate.ts
 var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 var CHAINLINK_LATEST_ROUND_ABI = [
   {
@@ -441,14 +735,25 @@ var CHAINLINK_LATEST_ROUND_ABI = [
   }
 ];
 var DEFAULT_MAX_STALENESS_SECONDS = 86400;
-async function readEstimate(publicClient, input) {
-  const { amount, currency } = input;
-  if (amount < MIN_CASHOUT_AMOUNT) {
-    throw errors.amountBelowMinimum(amount, MIN_CASHOUT_AMOUNT);
-  }
+async function readEstimate(publicClient, input, context = {}) {
+  const { currency } = input;
   if (!isMarketRateSupported(currency)) {
     throw errors.oracleUnsupportedCurrency(currency);
   }
+  const relayQuote = input.source !== void 0 ? await quoteRelayToBaseUsdc(
+    {
+      user: input.source.user,
+      amount: input.amount,
+      source: { chainId: input.source.chainId, currency: input.source.currency },
+      ...input.source.recipient ? { recipient: input.source.recipient } : {},
+      ...input.source.tradeType ? { tradeType: input.source.tradeType } : {}
+    },
+    context.relay
+  ) : void 0;
+  const amount = relayQuote?.outputAmount ?? input.amount;
+  if (amount < MIN_CASHOUT_AMOUNT) {
+    throw errors.amountBelowMinimum(amount, MIN_CASHOUT_AMOUNT);
+  }
   const feedConfig = CHAINLINK_ORACLE_FEEDS[currency];
   const asOf = Math.floor(Date.now() / 1e3);
   let rate;
@@ -471,7 +776,7 @@ async function readEstimate(publicClient, input) {
     rate = feedConfig.invert ? 1 / price : price;
   }
   const stale = oracleUpdatedAt !== void 0 && asOf - oracleUpdatedAt > DEFAULT_MAX_STALENESS_SECONDS;
-  return {
+  const estimate = {
     kind: "oracle-estimate",
     currency,
     amount,
@@ -479,8 +784,27 @@ async function readEstimate(publicClient, input) {
     receiveAmount: Number(amount) / 10 ** USDC_DECIMALS * rate,
     asOf,
     ...oracleUpdatedAt !== void 0 ? { oracleUpdatedAt } : {},
-    ...stale ? { stale: true } : {}
+    ...stale ? { stale: true } : {},
+    ...relayQuote ? {
+      source: {
+        kind: "relay",
+        asset: relayQuote.source,
+        inputAmount: relayQuote.inputAmount,
+        relayQuote
+      }
+    } : {}
   };
+  if (context.indexerClient && context.environment) {
+    try {
+      estimate.eta = await readFillEta(context.indexerClient, {
+        environment: context.environment,
+        currency,
+        ...input.platform ? { platform: input.platform } : {}
+      });
+    } catch {
+    }
+  }
+  return estimate;
 }
 
 // src/client/createCashClient.ts
@@ -576,9 +900,8 @@ function createCashClient(options) {
     }
     return client;
   }
-  function validateInput(input) {
-    const { amount, receive } = input;
-    if (amount < MIN_CASHOUT_AMOUNT) throw errors.amountBelowMinimum(amount, MIN_CASHOUT_AMOUNT);
+  function validatePayout(input) {
+    const { receive } = input;
     const catalog = getPaymentMethodsCatalog(BASE_CHAIN_ID, environment);
     if (!catalog[receive.platform]) throw errors.unsupportedPlatform(receive.platform);
     if (!isMarketRateSupported(receive.currency)) {
@@ -588,7 +911,6 @@ function createCashClient(options) {
       throw errors.payeeVerificationRequired(receive.platform);
     }
     return {
-      amount,
       payouts: [
         {
           processorName: receive.platform,
@@ -599,6 +921,12 @@ function createCashClient(options) {
       ...input.intentAmountRange ? { intentAmountRange: input.intentAmountRange } : {}
     };
   }
+  function validateInput(input) {
+    if (input.amount < MIN_CASHOUT_AMOUNT) {
+      throw errors.amountBelowMinimum(input.amount, MIN_CASHOUT_AMOUNT);
+    }
+    return { amount: input.amount, ...validatePayout(input) };
+  }
   async function buildDepositParams(client, depositInput) {
     try {
       return await prepareCashDepositParams(client, depositInput);
@@ -675,6 +1003,14 @@ function createCashClient(options) {
     if (!order.isInFlight) throw errors.orderNotActive(depositId);
     return escrowContext(depositId);
   }
+  function capabilities(capabilityOptions) {
+    const baseCapabilities = buildCapabilities(environment);
+    if (!capabilityOptions?.includeRelaySources) return baseCapabilities;
+    return readRelaySourceCapabilities(options.relay).then((relay) => ({
+      ...baseCapabilities,
+      source: { ...baseCapabilities.source, relay }
+    }));
+  }
   async function settleAllowance(client, token, owner, escrow, amount) {
     let allowance;
     try {
@@ -703,18 +1039,109 @@ function createCashClient(options) {
     throw errors.allowanceNotVisible(amount);
   }
   return {
-    capabilities() {
-      return buildCapabilities(environment);
+    capabilities,
+    async sourceCapabilities() {
+      return readRelaySourceCapabilities(options.relay);
+    },
+    async quoteSource(input) {
+      return quoteRelayToBaseUsdc(input, options.relay);
+    },
+    async executeSourceQuote(quote, opts) {
+      return executeRelayQuote(quote, opts.signer, {
+        ...options.relay ? { relay: options.relay } : {},
+        ...opts.onProgress ? { onProgress: opts.onProgress } : {},
+        ...opts.disableCapabilitiesCheck !== void 0 ? { disableCapabilitiesCheck: opts.disableCapabilitiesCheck } : {}
+      });
+    },
+    async relayStatus(requestId) {
+      return readRelayStatus(requestId, options.relay);
     },
     async estimate(input) {
-      return readEstimate(readClient.publicClient, input);
+      return readEstimate(readClient.publicClient, input, {
+        indexerClient: readClient,
+        environment,
+        ...options.relay ? { relay: options.relay } : {}
+      });
     },
     async cashout(input, opts) {
-      const depositInput = validateInput(input);
       const client = signingClient("cashout", opts);
+      const owner = opts.signer.account.address;
+      const payoutInput = validatePayout(input);
+      let sourceResult;
+      let cashoutAmount = input.amount;
+      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");
+        if (input.source.recipient !== void 0 && input.source.recipient.toLowerCase() !== owner.toLowerCase()) {
+          throw errors.sourceRecipientMismatch(input.source.recipient, owner);
+        }
+        const relayQuote = await quoteRelayToBaseUsdc(
+          {
+            user: sourceSigner.account.address,
+            amount: input.amount,
+            source: { chainId: input.source.chainId, currency: input.source.currency },
+            recipient: owner,
+            ...input.source.tradeType ? { tradeType: input.source.tradeType } : {}
+          },
+          options.relay
+        );
+        if (relayQuote.outputAmount < MIN_CASHOUT_AMOUNT) {
+          throw errors.amountBelowMinimum(relayQuote.outputAmount, MIN_CASHOUT_AMOUNT);
+        }
+        cashoutAmount = relayQuote.outputAmount;
+        const depositInput2 = { amount: cashoutAmount, ...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 } : {},
+          ...opts.onSourceProgress ? { onProgress: opts.onSourceProgress } : {},
+          ...opts.disableSourceCapabilitiesCheck !== void 0 ? { disableCapabilitiesCheck: opts.disableSourceCapabilitiesCheck } : {}
+        });
+        sourceResult = {
+          amount: cashoutAmount,
+          ...executed.requestId ? { requestId: executed.requestId } : {},
+          txHashes: executed.txHashes
+        };
+        const attributedParams2 = { ...params2, txOverrides: attribution };
+        const send2 = async () => {
+          try {
+            return (await client.createDeposit(attributedParams2)).hash;
+          } catch (err) {
+            if (err instanceof Error && /exceeds allowance/i.test(err.message)) {
+              await sleep(2e3);
+              return (await client.createDeposit(attributedParams2)).hash;
+            }
+            throw err;
+          }
+        };
+        let hash2;
+        try {
+          hash2 = await send2();
+        } catch (err) {
+          throw mapChainError("createDeposit", err);
+        }
+        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);
+        const order2 = deriveCashOrder(resolved2.compositeId, [], {
+          remainingAmount: depositInput2.amount,
+          status: "ACTIVE"
+        });
+        return {
+          depositId: resolved2.compositeId,
+          txHash: hash2,
+          escrowAddress: resolved2.escrowAddress,
+          onchainDepositId: resolved2.onchainDepositId,
+          order: order2,
+          source: sourceResult
+        };
+      }
+      const depositInput = validateInput(input);
       const params = await buildDepositParams(client, depositInput);
       const escrow = client.escrowV2Address ?? client.escrowAddress;
-      const owner = opts.signer.account.address;
       await settleAllowance(client, params.token, owner, escrow, depositInput.amount);
       const attributedParams = { ...params, txOverrides: attribution };
       const send = async () => {
@@ -748,10 +1175,12 @@ function createCashClient(options) {
         txHash: hash,
         escrowAddress: resolved.escrowAddress,
         onchainDepositId: resolved.onchainDepositId,
-        order
+        order,
+        ...sourceResult ? { source: sourceResult } : {}
       };
     },
     async prepare(input) {
+      if (input.source) throw errors.sourceRouteUnsupportedInPrepare();
       const depositInput = validateInput(input);
       const params = await buildDepositParams(readClient, depositInput);
       const { prepared } = await readClient.prepareCreateDeposit({
@@ -1065,7 +1494,56 @@ var cashEstimateJsonSchema = z.object({
   receiveAmount: z.number(),
   asOf: z.number(),
   oracleUpdatedAt: z.number().optional(),
-  stale: z.boolean().optional()
+  stale: z.boolean().optional(),
+  source: z.object({
+    kind: z.literal("relay"),
+    asset: z.object({
+      chainId: z.number(),
+      address: z.string(),
+      symbol: z.string(),
+      decimals: z.number(),
+      name: z.string().optional(),
+      isNative: z.boolean().optional()
+    }),
+    inputAmount: bigintString,
+    relayQuote: z.object({
+      requestId: z.string().optional(),
+      source: z.object({
+        chainId: z.number(),
+        address: z.string(),
+        symbol: z.string(),
+        decimals: z.number(),
+        name: z.string().optional(),
+        isNative: z.boolean().optional()
+      }),
+      destination: z.object({
+        chainId: z.number(),
+        address: z.string(),
+        symbol: z.string(),
+        decimals: z.number(),
+        name: z.string().optional(),
+        isNative: z.boolean().optional()
+      }),
+      inputAmount: bigintString,
+      outputAmount: bigintString,
+      rate: z.number().optional(),
+      timeEstimateSeconds: z.number().optional(),
+      fees: z.unknown().optional(),
+      txs: z.array(
+        z.object({
+          to: z.string(),
+          data: z.string(),
+          value: bigintString,
+          chainId: z.number()
+        })
+      ),
+      raw: z.unknown()
+    })
+  }).optional(),
+  eta: z.object({
+    seconds: z.number().optional(),
+    label: z.string()
+  }).optional()
 });
 var preparedTransactionJsonSchema = z.object({
   to: z.string(),
@@ -1089,7 +1567,12 @@ var cashoutResultJsonSchema = z.object({
   txHash: z.string(),
   escrowAddress: z.string(),
   onchainDepositId: bigintString,
-  order: cashOrderJsonSchema
+  order: cashOrderJsonSchema,
+  source: z.object({
+    amount: bigintString,
+    requestId: z.string().optional(),
+    txHashes: z.array(z.string())
+  }).optional()
 });
 var prepareResultJsonSchema = z.object({
   txs: z.array(preparedTransactionJsonSchema),
@@ -1109,6 +1592,49 @@ var cashCapabilitiesJsonSchema = z.object({
   chainId: z.number(),
   token: z.object({ address: z.string(), symbol: z.literal("USDC"), decimals: z.number() }),
   environment: z.enum(["production", "preproduction", "staging"]),
+  destination: z.object({
+    chainId: z.number(),
+    token: z.object({ address: z.string(), symbol: z.literal("USDC"), decimals: z.number() })
+  }),
+  source: z.object({
+    default: 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()
+  }),
   platforms: z.array(
     z.object({
       platform: z.string(),
@@ -1200,14 +1726,38 @@ function orderFromJson(json) {
   return withExplain(data);
 }
 function estimateToJson(estimate) {
-  return { ...estimate, amount: estimate.amount.toString() };
+  return omitUndefined({
+    ...estimate,
+    amount: estimate.amount.toString(),
+    source: estimate.source ? {
+      ...estimate.source,
+      inputAmount: estimate.source.inputAmount.toString(),
+      relayQuote: {
+        ...estimate.source.relayQuote,
+        inputAmount: estimate.source.relayQuote.inputAmount.toString(),
+        outputAmount: estimate.source.relayQuote.outputAmount.toString(),
+        txs: estimate.source.relayQuote.txs.map(preparedTxToJson),
+        raw: sanitizeRelayQuoteRaw(estimate.source.relayQuote.raw)
+      }
+    } : void 0
+  });
 }
 function estimateFromJson(json) {
   const parsed = cashEstimateJsonSchema.parse(json);
   return omitUndefined({
     ...parsed,
     currency: parsed.currency,
-    amount: BigInt(parsed.amount)
+    amount: BigInt(parsed.amount),
+    source: parsed.source ? {
+      ...parsed.source,
+      inputAmount: BigInt(parsed.source.inputAmount),
+      relayQuote: {
+        ...parsed.source.relayQuote,
+        inputAmount: BigInt(parsed.source.relayQuote.inputAmount),
+        outputAmount: BigInt(parsed.source.relayQuote.outputAmount),
+        txs: parsed.source.relayQuote.txs.map(preparedTxFromJson)
+      }
+    } : void 0
   });
 }
 function preparedTxToJson(tx) {
@@ -1229,23 +1779,31 @@ function preparedStepFromJson(json) {
   return cashPreparedStepJsonSchema.parse(json);
 }
 function cashoutResultToJson(result) {
-  return {
+  return omitUndefined({
     depositId: result.depositId,
     txHash: result.txHash,
     escrowAddress: result.escrowAddress,
     onchainDepositId: result.onchainDepositId.toString(),
-    order: orderToJson(result.order)
-  };
+    order: orderToJson(result.order),
+    source: result.source ? {
+      ...result.source,
+      amount: result.source.amount.toString()
+    } : void 0
+  });
 }
 function cashoutResultFromJson(json) {
   const parsed = cashoutResultJsonSchema.parse(json);
-  return {
+  return omitUndefined({
     depositId: parsed.depositId,
     txHash: parsed.txHash,
     escrowAddress: parsed.escrowAddress,
     onchainDepositId: BigInt(parsed.onchainDepositId),
-    order: orderFromJson(parsed.order)
-  };
+    order: orderFromJson(parsed.order),
+    source: parsed.source ? {
+      ...parsed.source,
+      amount: BigInt(parsed.source.amount)
+    } : void 0
+  });
 }
 function prepareResultToJson(result) {
   return {
@@ -1304,6 +1862,10 @@ function capabilitiesFromJson(json) {
   const parsed = cashCapabilitiesJsonSchema.parse(json);
   return {
     ...parsed,
+    source: {
+      default: parsed.source.default,
+      ...parsed.source.relay ? { relay: parsed.source.relay } : {}
+    },
     platforms: parsed.platforms.map((p) => ({
       ...p,
       currencies: p.currencies