@circle-fin/app-kit 1.16.0 → 1.18.0

package/unifiedBalance.cjs

@@ -2411,22 +2411,73 @@ let activeRedactor = defaultMessageRedactor;
     '0x9147d463': 'Final balance is less than the initial balance',
     '0xf4b3b1bc': 'Native token transfer to the beneficiary failed'
 };
+/**
+ * Matches revert data: a 4-byte selector followed by whole ABI-encoded bytes.
+ */ const REVERT_DATA_PATTERN = /^0x[0-9a-f]{8}(?:[0-9a-f]{2})*$/i;
+/**
+ * Returns the revert data held by one error in a `cause` chain.
+ *
+ * Browser wallets (EIP-1193) wrap the node's error, so the revert data sits
+ * one level down as `data.data`. viem's `getContractError` reads it the same
+ * way, then keeps it on `ContractFunctionRevertedError.raw` and drops the
+ * node's error from the chain.
+ *
+ * @param link - One error in the `cause` chain
+ * @returns The `raw` or `data` string, or undefined if there is none
+ */ function getRevertData(link) {
+    if ('raw' in link && typeof link.raw === 'string' && REVERT_DATA_PATTERN.test(link.raw)) {
+        return link.raw;
+    }
+    if (!('data' in link)) {
+        return undefined;
+    }
+    const { data } = link;
+    if (typeof data === 'string') {
+        return data;
+    }
+    if (data !== null && typeof data === 'object' && 'data' in data && typeof data.data === 'string') {
+        return data.data;
+    }
+    return undefined;
+}
+/**
+ * Finds the first revert data on the error or in its `cause` chain that
+ * `accept` takes.
+ *
+ * viem keeps the node's revert data on an inner `RpcRequestError`, not on
+ * the error it throws. The `seen` set stops a self-referencing `cause` chain.
+ *
+ * @param error - The error object
+ * @param accept - Returns true for the data shape the caller wants
+ * @returns The data as written on the error, or undefined if not found
+ */ function findRevertData(error, accept) {
+    const seen = new Set();
+    let current = error;
+    while(current !== null && typeof current === 'object' && !seen.has(current)){
+        seen.add(current);
+        const data = getRevertData(current);
+        if (data !== undefined && accept(data)) {
+            return data;
+        }
+        current = 'cause' in current ? current.cause : undefined;
+    }
+    return undefined;
+}
 /**
  * Attempts to extract an error selector from an error object or message.
  *
  * Checks multiple sources in priority order:
- * 1. `error.data` field
+ * 1. `raw` or `data` field (or nested `data.data`) on the error or anywhere
+ *    in its `cause` chain
  * 2. Message pattern: "custom error 0x8baa579f"
  *
  * @param msg - The error message
  * @param error - The error object (optional)
  * @returns The 4 bytes selector , or undefined if not found
  */ function extractErrorSelector(msg, error) {
-    // Check error.data field
-    if (error !== null && typeof error === 'object' && 'data' in error) {
-        if (typeof error.data === 'string' && /^0x[0-9a-f]{8}$/i.test(error.data)) {
-            return error.data.toLowerCase();
-        }
+    const data = findRevertData(error, (value)=>/^0x[0-9a-f]{8}$/i.test(value));
+    if (data !== undefined) {
+        return data.toLowerCase();
     }
     // Check for "custom error 0x8baa579f" in the message
     const match = /custom error (0x[0-9a-f]{8})\b/i.exec(msg);
@@ -3651,6 +3702,8 @@ var SwapChain;
     SwapChain["HyperEVM"] = "HyperEVM";
     SwapChain["Monad"] = "Monad";
     SwapChain["Arc"] = "Arc";
+    SwapChain["Cronos"] = "Cronos";
+    SwapChain["Morph"] = "Morph";
     // Testnet chains with swap support
     SwapChain["Arc_Testnet"] = "Arc_Testnet";
 })(SwapChain || (SwapChain = {}));
@@ -4341,14 +4394,14 @@ var BorrowChain;
         symbol: 'USDC',
         // Arc uses native USDC with 18 decimals for gas payments (EVM standard).
         // Note: The ERC-20 USDC contract at usdcAddress uses 6 decimals.
-        // See: https://docs.arc.network/arc/references/contract-addresses
+        // See: https://docs.arc.io/arc/references/contract-addresses
         decimals: 18
     },
     chainId: 5042002,
     isTestnet: true,
     explorerUrl: 'https://testnet.arcscan.app/tx/{hash}',
     rpcEndpoints: [
-        'https://rpc.testnet.arc.network/'
+        'https://rpc.testnet.arc.io'
     ],
     eurcAddress: '0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a',
     usdcAddress: '0x3600000000000000000000000000000000000000',
@@ -4993,7 +5046,8 @@ var BorrowChain;
         }
     },
     kitContracts: {
-        bridge: BRIDGE_CONTRACT_EVM_MAINNET
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET
     }
 });
 
@@ -5862,7 +5916,8 @@ var BorrowChain;
         }
     },
     kitContracts: {
-        bridge: BRIDGE_CONTRACT_EVM_MAINNET
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET
     }
 });
 
@@ -8165,8 +8220,8 @@ var Chains = {
  * Zod schema for validating swap-specific chain identifiers.
  *
  * Validates chains based on:
- * - CCTPv2 support (adapter contract deployed)
- * - Mainnet only (no testnets)
+ * - Membership in the SwapChain enum
+ * - Mainnet or explicitly allowlisted testnet
  * - At least one supported token available
  *
  */ zod.z.union([
@@ -10063,11 +10118,13 @@ function parseOrThrow(value, schema, context) {
         [Blockchain.Arbitrum]: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9',
         [Blockchain.Avalanche]: '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7',
         [Blockchain.Celo]: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
+        [Blockchain.Cronos]: '0x66e428c3f67a68878562e79A0234c1F83c208770',
         [Blockchain.Ethereum]: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
         [Blockchain.HyperEVM]: '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb',
         [Blockchain.Ink]: '0x0200C29006150606B650577BBE7B6248F58470c1',
         [Blockchain.Linea]: '0xA219439258ca9da29E9Cc4cE5596924745e12B93',
         [Blockchain.Monad]: '0xe7cd86e13AC4309349F30B3435a9d337750fC82D',
+        [Blockchain.Morph]: '0xe7cd86e13AC4309349F30B3435a9d337750fC82D',
         [Blockchain.NEAR]: 'usdt.tether-token.near',
         [Blockchain.Optimism]: '0x94b008aA00579c1307B0EF2c499aD98a8ce58e58',
         [Blockchain.Polkadot_Asset_Hub]: '1984',
@@ -10126,6 +10183,7 @@ function parseOrThrow(value, schema, context) {
         [Blockchain.Arbitrum]: '0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1',
         [Blockchain.Avalanche]: '0xd586E7F844cEa2F87f50152665BCbc2C279D8d70',
         [Blockchain.Base]: '0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb',
+        [Blockchain.Cronos]: '0xF2001B145b43032AAF5Ee2884e456CCd805F677D',
         [Blockchain.Ethereum]: '0x6B175474E89094C44Da98b954EedeAC495271d0F',
         [Blockchain.Linea]: '0x4AF15ec2A0BD43Db75dd04E62FAA3B8EF36b00d5',
         [Blockchain.Optimism]: '0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1',
@@ -10188,7 +10246,9 @@ function parseOrThrow(value, schema, context) {
         [Blockchain.Arbitrum]: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
         [Blockchain.Avalanche]: '0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB',
         [Blockchain.Base]: '0x4200000000000000000000000000000000000006',
+        [Blockchain.Cronos]: '0xe44Fd7fCb2b1581822D0c862B68222998a0c299a',
         [Blockchain.Ethereum]: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+        [Blockchain.Morph]: '0x5300000000000000000000000000000000000011',
         [Blockchain.Optimism]: '0x4200000000000000000000000000000000000006',
         [Blockchain.Polygon]: '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619',
         [Blockchain.Solana]: '7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs'
@@ -10207,6 +10267,7 @@ function parseOrThrow(value, schema, context) {
     locators: {
         [Blockchain.Ethereum]: '0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599',
         [Blockchain.Arbitrum]: '0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f',
+        [Blockchain.Cronos]: '0x062E66477Faf219F25D27dCED647BF57C3107d52',
         [Blockchain.Avalanche]: '0x50b7545627a5162F82A992c33b87aDc75187B218'
     }
 };
@@ -11897,7 +11958,7 @@ function resolveOptions(options) {
 }
 
 var name = "@circle-fin/unified-balance-kit";
-var version$1 = "1.8.0";
+var version$1 = "1.8.2";
 var pkg$1 = {
 	name: name,
 	version: version$1};
@@ -26490,6 +26551,24 @@ const FAST_TIER_FINALITY_THRESHOLD = 1000;
     }
 };
 
+/**
+ * Check whether a forwarded burn to the given destination asks Circle's
+ * Forwarding Service to set up the recipient's token account before minting.
+ *
+ * Must return `true` exactly for the destinations where
+ * {@link getForwarderHookData} emits the `createAta` frame, so the forwarding
+ * fee quote includes the setup rent whenever the burn requests it.
+ *
+ * @internal
+ * @param chainType - The destination blockchain type.
+ * @returns `true` for Solana destinations, `false` otherwise.
+ *
+ * @example
+ * ```typescript
+ * requiresRecipientSetup('solana') // true
+ * requiresRecipientSetup('evm') // false
+ * ```
+ */ const requiresRecipientSetup = (chainType)=>chainType === 'solana';
 /**
  * Build the forwarding `hookData` for a forwarded (Orbit-relayed) CCTP v2 burn,
  * tailored to the destination chain.
@@ -26840,10 +26919,12 @@ const FAST_TIER_FINALITY_THRESHOLD = 1000;
  * @param sourceDomain - The source domain
  * @param destinationDomain - The destination domain
  * @param isTestnet - Whether the request is for a testnet chain
+ * @param includeRecipientSetup - Whether the quote includes recipient account setup rent
  * @returns The complete API URL with forward=true query parameter
- */ function buildForwardingFeeUrl(sourceDomain, destinationDomain, isTestnet) {
+ */ function buildForwardingFeeUrl(sourceDomain, destinationDomain, isTestnet, includeRecipientSetup) {
     const baseUrl = isTestnet ? IRIS_API_SANDBOX_BASE_URL : IRIS_API_BASE_URL;
-    return `${baseUrl}/v2/burn/USDC/fees/${sourceDomain.toString()}/${destinationDomain.toString()}?forward=true`;
+    const recipientSetupQuery = includeRecipientSetup ? '&includeRecipientSetup=true' : '';
+    return `${baseUrl}/v2/burn/USDC/fees/${sourceDomain.toString()}/${destinationDomain.toString()}?forward=true${recipientSetupQuery}`;
 }
 /**
  * Fetches the forwarding fee for a USDC transfer operation with retry and timeout handling.
@@ -26860,6 +26941,10 @@ const FAST_TIER_FINALITY_THRESHOLD = 1000;
  *
  * The high fee tier is always used to provide buffer for destination gas fluctuations.
  *
+ * Pass `includeRecipientSetup: true` when the burn asks the Forwarding Service to create
+ * the recipient's token account (Solana destinations). The quote then includes the
+ * account rent, which the quote without this flag leaves out.
+ *
  * Implements timeout and retry logic to handle network issues and temporary API failures.
  * Each HTTP request is given a maximum of 2 seconds before it is aborted.
  * We retry up to 10 times, waiting 200ms between attempts.
@@ -26868,6 +26953,8 @@ const FAST_TIER_FINALITY_THRESHOLD = 1000;
  * @param destinationDomain - The destination domain
  * @param isTestnet - Whether the request is for a testnet chain
  * @param finalityThreshold - The finality threshold to select the fee tier (1000 for FAST, 2000 for SLOW)
+ * @param includeRecipientSetup - Whether to include recipient account setup rent in the
+ *   quote. Defaults to `false`.
  * @returns The high-tier forwarding fee in USDC minor units (6 decimals)
  * @throws Error if the input domains are invalid, the API request fails, returns invalid data, or network errors occur
  *
@@ -26879,8 +26966,11 @@ const FAST_TIER_FINALITY_THRESHOLD = 1000;
  *
  * // SLOW transfer - use 2000ms finality threshold
  * const slowForwardingFee = await fetchForwardingFee(0, 6, false, 2000)
+ *
+ * // Ethereum -> Solana: include the recipient token account rent
+ * const solanaForwardingFee = await fetchForwardingFee(0, 5, false, 1000, true)
  * ```
- */ async function fetchForwardingFee(sourceDomain, destinationDomain, isTestnet, finalityThreshold) {
+ */ async function fetchForwardingFee(sourceDomain, destinationDomain, isTestnet, finalityThreshold, includeRecipientSetup = false) {
     // Validate source domain
     if (!Number.isInteger(sourceDomain) || sourceDomain < 0) {
         throw new KitError({
@@ -26908,7 +26998,7 @@ const FAST_TIER_FINALITY_THRESHOLD = 1000;
         });
     }
     // Fetch the fee tiers from the API with forward=true
-    const url = buildForwardingFeeUrl(sourceDomain, destinationDomain, isTestnet);
+    const url = buildForwardingFeeUrl(sourceDomain, destinationDomain, isTestnet, includeRecipientSetup);
     const response = await pollApiGet(url, isForwardingFeeResponse, DEFAULT_CONFIG$1);
     // Validate that we have at least one fee tier
     if (response.length === 0) {
@@ -29244,7 +29334,7 @@ const mockAttestationMessage = {
     return step;
 }
 
-var version = "1.14.1";
+var version = "1.14.3";
 var pkg = {
 	version: version};
 
@@ -30163,9 +30253,34 @@ function assertCCTPV2Config(config) {
             tokenAddress: source.chain.usdcAddress,
             operationContext: sourceOperationContext
         });
+        await this.assertAmountCoversRecipientSetupFee(params);
         return bridge(params, this);
     }
     /**
+   * Reject a forwarded transfer to Solana whose amount does not exceed the fee.
+   *
+   * CCTP v2 reverts a burn whose `maxFee` is not less than its amount, and the Solana
+   * forwarding fee includes the recipient token account rent. Checking before the
+   * approval avoids sending a transaction that can never be followed by a burn.
+   * Skipped when the caller provides `config.maxFee`.
+   *
+   * @param params - The validated CCTP v2 bridge parameters.
+   * @returns A promise that resolves when the amount covers the fee.
+   * @throws {KitError} INPUT_INVALID_AMOUNT (FATAL) when the fee is greater than or equal
+   *   to the amount.
+   */ async assertAmountCoversRecipientSetupFee(params) {
+        const { destination, amount, config } = params;
+        if (destination.useForwarder !== true || config.maxFee !== undefined || !requiresRecipientSetup(destination.chain.type)) {
+            return;
+        }
+        const { providerFee, forwarderFee } = await this.getMaxFee(params);
+        const maxFee = providerFee + forwarderFee;
+        if (maxFee >= BigInt(amount)) {
+            // Amounts and fees are in USDC minor units (6 decimals)
+            throw createInvalidAmountError(formatUnits(amount, 6), `Amount must be greater than the ${formatUnits(String(maxFee), 6)} USDC fee for forwarded transfers to ${destination.chain.name}, which includes creating the recipient's token account`);
+        }
+    }
+    /**
    * Retry a failed or incomplete CCTP v2 bridge operation.
    *
    * Analyzes the bridge result to determine where to continue and executes
@@ -30882,6 +30997,9 @@ function assertCCTPV2Config(config) {
    * | FAST           | true         | No              | maxFee = calculatedBurnFee + forwardingFee |
    * | FAST           | true         | Yes             | maxFee = config.maxFee |
    *
+   * For forwarded burns to Solana, the forwarding fee includes the rent for creating the
+   * recipient's token account. A caller-provided `maxFee` must cover it too.
+   *
    * @param params - The bridge parameters object containing:
    *   - `source`: The source wallet context with chain definition and adapter
    *   - `destination`: The destination wallet context with chain definition and adapter
@@ -30920,6 +31038,7 @@ function assertCCTPV2Config(config) {
         }
         // Get the min finality threshold based on the transfer speed
         const minFinalityThreshold = CCTPv2MinFinalityThreshold[transferSpeed];
+        const includeRecipientSetup = requiresRecipientSetup(destination.chain.type);
         // SLOW transfer without forwarder: no fee
         if (transferSpeed === TransferSpeed.SLOW && !useForwarder) {
             return {
@@ -30929,7 +31048,7 @@ function assertCCTPV2Config(config) {
         }
         // SLOW transfer with forwarder: only forwarding fee
         if (transferSpeed === TransferSpeed.SLOW && useForwarder) {
-            const forwarderFee = await fetchForwardingFee(source.chain.cctp.domain, destination.chain.cctp.domain, source.chain.isTestnet, minFinalityThreshold);
+            const forwarderFee = await fetchForwardingFee(source.chain.cctp.domain, destination.chain.cctp.domain, source.chain.isTestnet, minFinalityThreshold, includeRecipientSetup);
             return {
                 providerFee: 0n,
                 forwarderFee
@@ -30939,7 +31058,7 @@ function assertCCTPV2Config(config) {
         // Fetch fees in parallel when forwarder is enabled
         const [scaledBps, forwarderFee] = await Promise.all([
             fetchUsdcFastBurnFee(source.chain.cctp.domain, destination.chain.cctp.domain, source.chain.isTestnet),
-            useForwarder ? fetchForwardingFee(source.chain.cctp.domain, destination.chain.cctp.domain, source.chain.isTestnet, minFinalityThreshold) : Promise.resolve(0n)
+            useForwarder ? fetchForwardingFee(source.chain.cctp.domain, destination.chain.cctp.domain, source.chain.isTestnet, minFinalityThreshold, includeRecipientSetup) : Promise.resolve(0n)
         ]);
         // Calculate fee proportional to the transfer amount
         const amountInMinorUnits = BigInt(amount);