@circle-fin/app-kit 1.17.0 → 1.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/app-kit",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "A one-stop Circle SDK solution for building stablecoin (e.g. USDC) applications, with bridging, swapping, and more on-chain operations",
   "keywords": [
     "circle",
@@ -36,13 +36,13 @@
   "module": "./index.mjs",
   "types": "./index.d.cts",
   "dependencies": {
-    "@circle-fin/onramp-kit": "1.0.4",
-    "@circle-fin/unified-balance-kit": "1.8.1",
-    "@circle-fin/provider-gateway-v1": "1.5.2",
-    "@circle-fin/earn-kit": "1.9.0",
-    "@circle-fin/borrow-kit": "1.1.0",
-    "@circle-fin/bridge-kit": "1.15.3",
-    "@circle-fin/swap-kit": "1.8.0",
+    "@circle-fin/onramp-kit": "1.0.5",
+    "@circle-fin/unified-balance-kit": "1.8.2",
+    "@circle-fin/provider-gateway-v1": "1.5.3",
+    "@circle-fin/earn-kit": "1.10.0",
+    "@circle-fin/borrow-kit": "1.1.1",
+    "@circle-fin/bridge-kit": "1.16.0",
+    "@circle-fin/swap-kit": "1.8.1",
     "@coral-xyz/anchor": "^0.31.1",
     "@noble/curves": "1.4.2",
     "bn.js": "^5.2.3",

package/server.cjs

@@ -1900,14 +1900,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',
@@ -8755,7 +8755,7 @@ const swapTokenEnumSchema = zod.z.enum([
     return kit;
 }
 
-var version = "1.0.4";
+var version = "1.0.5";
 var pkg = {
 	version: version};
 

package/server.mjs

@@ -1894,14 +1894,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',
@@ -8749,7 +8749,7 @@ const swapTokenEnumSchema = z.enum([
     return kit;
 }
 
-var version = "1.0.4";
+var version = "1.0.5";
 var pkg = {
 	version: version};
 

package/swap.cjs

@@ -3895,14 +3895,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',
@@ -10848,7 +10848,7 @@ const swapTokenEnumSchema = zod.z.enum([
 }
 
 var name$3 = "@circle-fin/bridge-kit";
-var version$3 = "1.15.3";
+var version$3 = "1.16.0";
 var pkg$3 = {
 	name: name$3,
 	version: version$3};
@@ -12503,7 +12503,7 @@ const validateQuoteItemSchema = zod.z.object({
 registerKit(`${pkg$3.name}/${pkg$3.version}`);
 
 var name$2 = "@circle-fin/swap-kit";
-var version$2 = "1.8.0";
+var version$2 = "1.8.1";
 var pkg$2 = {
 	name: name$2,
 	version: version$2};
@@ -23176,7 +23176,7 @@ registerKit(`${pkg$2.name}/${pkg$2.version}`);
 };
 
 var name$1 = "@circle-fin/earn-kit";
-var version$1 = "1.9.0";
+var version$1 = "1.10.0";
 var pkg$1 = {
 	name: name$1,
 	version: version$1};
@@ -24616,7 +24616,7 @@ function hasCrossChainDepositQuoteShape(params) {
 registerKit(`${pkg$1.name}/${pkg$1.version}`);
 
 var name = "@circle-fin/borrow-kit";
-var version = "1.1.0";
+var version = "1.1.1";
 var pkg = {
 	name: name,
 	version: version};

package/swap.d.cts

@@ -8568,11 +8568,11 @@ interface AppKitContext {
      */
     actions: Record<'bridge' | 'earn' | 'borrow', Record<string, ((payload: unknown) => void)[]>>;
     /**
-     * Disable success analytics for the underlying EarnKit, SwapKit,
+     * Disable success analytics for the underlying BridgeKit, EarnKit, SwapKit,
      * BorrowKit, and UnifiedBalanceKit.
      *
-     * When `true`, completed earn, swap, borrow, and unified balance operations
-     * will not POST analytics events. This does not disable error reporting; use
+     * When `true`, completed bridge, earn, swap, borrow, and unified balance
+     * operations will not POST analytics events. This does not disable error reporting; use
      * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
      *
      * @defaultValue false

package/swap.d.mts

@@ -8568,11 +8568,11 @@ interface AppKitContext {
      */
     actions: Record<'bridge' | 'earn' | 'borrow', Record<string, ((payload: unknown) => void)[]>>;
     /**
-     * Disable success analytics for the underlying EarnKit, SwapKit,
+     * Disable success analytics for the underlying BridgeKit, EarnKit, SwapKit,
      * BorrowKit, and UnifiedBalanceKit.
      *
-     * When `true`, completed earn, swap, borrow, and unified balance operations
-     * will not POST analytics events. This does not disable error reporting; use
+     * When `true`, completed bridge, earn, swap, borrow, and unified balance
+     * operations will not POST analytics events. This does not disable error reporting; use
      * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
      *
      * @defaultValue false

package/swap.d.ts

@@ -8568,11 +8568,11 @@ interface AppKitContext {
      */
     actions: Record<'bridge' | 'earn' | 'borrow', Record<string, ((payload: unknown) => void)[]>>;
     /**
-     * Disable success analytics for the underlying EarnKit, SwapKit,
+     * Disable success analytics for the underlying BridgeKit, EarnKit, SwapKit,
      * BorrowKit, and UnifiedBalanceKit.
      *
-     * When `true`, completed earn, swap, borrow, and unified balance operations
-     * will not POST analytics events. This does not disable error reporting; use
+     * When `true`, completed bridge, earn, swap, borrow, and unified balance
+     * operations will not POST analytics events. This does not disable error reporting; use
      * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
      *
      * @defaultValue false

package/swap.mjs

@@ -3888,14 +3888,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',
@@ -10841,7 +10841,7 @@ const swapTokenEnumSchema = z.enum([
 }
 
 var name$3 = "@circle-fin/bridge-kit";
-var version$3 = "1.15.3";
+var version$3 = "1.16.0";
 var pkg$3 = {
 	name: name$3,
 	version: version$3};
@@ -12496,7 +12496,7 @@ const validateQuoteItemSchema = z.object({
 registerKit(`${pkg$3.name}/${pkg$3.version}`);
 
 var name$2 = "@circle-fin/swap-kit";
-var version$2 = "1.8.0";
+var version$2 = "1.8.1";
 var pkg$2 = {
 	name: name$2,
 	version: version$2};
@@ -23169,7 +23169,7 @@ registerKit(`${pkg$2.name}/${pkg$2.version}`);
 };
 
 var name$1 = "@circle-fin/earn-kit";
-var version$1 = "1.9.0";
+var version$1 = "1.10.0";
 var pkg$1 = {
 	name: name$1,
 	version: version$1};
@@ -24609,7 +24609,7 @@ function hasCrossChainDepositQuoteShape(params) {
 registerKit(`${pkg$1.name}/${pkg$1.version}`);
 
 var name = "@circle-fin/borrow-kit";
-var version = "1.1.0";
+var version = "1.1.1";
 var pkg = {
 	name: name,
 	version: version};

package/unifiedBalance.cjs

@@ -4394,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',
@@ -11958,7 +11958,7 @@ function resolveOptions(options) {
 }
 
 var name = "@circle-fin/unified-balance-kit";
-var version$1 = "1.8.1";
+var version$1 = "1.8.2";
 var pkg$1 = {
 	name: name,
 	version: version$1};
@@ -26551,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.
@@ -26901,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.
@@ -26921,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.
@@ -26929,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
  *
@@ -26940,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({
@@ -26969,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) {
@@ -29305,7 +29334,7 @@ const mockAttestationMessage = {
     return step;
 }
 
-var version = "1.14.2";
+var version = "1.14.3";
 var pkg = {
 	version: version};
 
@@ -30224,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
@@ -30943,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
@@ -30981,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 {
@@ -30990,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
@@ -31000,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);

package/unifiedBalance.mjs

@@ -4387,14 +4387,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',
@@ -11951,7 +11951,7 @@ function resolveOptions(options) {
 }
 
 var name = "@circle-fin/unified-balance-kit";
-var version$1 = "1.8.1";
+var version$1 = "1.8.2";
 var pkg$1 = {
 	name: name,
 	version: version$1};
@@ -26544,6 +26544,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.
@@ -26894,10 +26912,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.
@@ -26914,6 +26934,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.
@@ -26922,6 +26946,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
  *
@@ -26933,8 +26959,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({
@@ -26962,7 +26991,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) {
@@ -29298,7 +29327,7 @@ const mockAttestationMessage = {
     return step;
 }
 
-var version = "1.14.2";
+var version = "1.14.3";
 var pkg = {
 	version: version};
 
@@ -30217,9 +30246,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
@@ -30936,6 +30990,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
@@ -30974,6 +31031,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 {
@@ -30983,7 +31041,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
@@ -30993,7 +31051,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);