@circle-fin/provider-cctp-v2 1.4.1 → 1.6.0

package/index.mjs

@@ -66,6 +66,8 @@ var Blockchain;
     Blockchain["Celo_Alfajores_Testnet"] = "Celo_Alfajores_Testnet";
     Blockchain["Codex"] = "Codex";
     Blockchain["Codex_Testnet"] = "Codex_Testnet";
+    Blockchain["Edge"] = "Edge";
+    Blockchain["Edge_Testnet"] = "Edge_Testnet";
     Blockchain["Ethereum"] = "Ethereum";
     Blockchain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
     Blockchain["Hedera"] = "Hedera";
@@ -78,6 +80,8 @@ var Blockchain;
     Blockchain["Linea_Sepolia"] = "Linea_Sepolia";
     Blockchain["Monad"] = "Monad";
     Blockchain["Monad_Testnet"] = "Monad_Testnet";
+    Blockchain["Morph"] = "Morph";
+    Blockchain["Morph_Testnet"] = "Morph_Testnet";
     Blockchain["NEAR"] = "NEAR";
     Blockchain["NEAR_Testnet"] = "NEAR_Testnet";
     Blockchain["Noble"] = "Noble";
@@ -281,11 +285,13 @@ var BridgeChain;
     BridgeChain["Avalanche"] = "Avalanche";
     BridgeChain["Base"] = "Base";
     BridgeChain["Codex"] = "Codex";
+    BridgeChain["Edge"] = "Edge";
     BridgeChain["Ethereum"] = "Ethereum";
     BridgeChain["HyperEVM"] = "HyperEVM";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
     BridgeChain["Monad"] = "Monad";
+    BridgeChain["Morph"] = "Morph";
     BridgeChain["Optimism"] = "Optimism";
     BridgeChain["Plume"] = "Plume";
     BridgeChain["Polygon"] = "Polygon";
@@ -301,11 +307,13 @@ var BridgeChain;
     BridgeChain["Avalanche_Fuji"] = "Avalanche_Fuji";
     BridgeChain["Base_Sepolia"] = "Base_Sepolia";
     BridgeChain["Codex_Testnet"] = "Codex_Testnet";
+    BridgeChain["Edge_Testnet"] = "Edge_Testnet";
     BridgeChain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
     BridgeChain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
     BridgeChain["Ink_Testnet"] = "Ink_Testnet";
     BridgeChain["Linea_Sepolia"] = "Linea_Sepolia";
     BridgeChain["Monad_Testnet"] = "Monad_Testnet";
+    BridgeChain["Morph_Testnet"] = "Morph_Testnet";
     BridgeChain["Optimism_Sepolia"] = "Optimism_Sepolia";
     BridgeChain["Plume_Testnet"] = "Plume_Testnet";
     BridgeChain["Polygon_Amoy_Testnet"] = "Polygon_Amoy_Testnet";
@@ -1051,7 +1059,7 @@ const Codex = defineChain({
         },
         forwarderSupported: {
             source: true,
-            destination: false,
+            destination: true,
         },
     },
     kitContracts: {
@@ -1094,7 +1102,95 @@ const CodexTestnet = defineChain({
         },
         forwarderSupported: {
             source: true,
-            destination: false,
+            destination: true,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
+/**
+ * Edge Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Edge blockchain.
+ * Edge is an EVM-compatible blockchain.
+ */
+const Edge = defineChain({
+    type: 'evm',
+    chain: Blockchain.Edge,
+    name: 'Edge',
+    title: 'Edge Mainnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 3343,
+    isTestnet: false,
+    explorerUrl: 'https://pro.edgex.exchange/en-US/explorer/tx/{hash}',
+    rpcEndpoints: ['https://edge-mainnet.g.alchemy.com/public'],
+    eurcAddress: null,
+    usdcAddress: '0x98d2919b9A214E6Fa5384AC81E6864bA686Ad74c',
+    usdtAddress: null,
+    cctp: {
+        domain: 28,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x98706A006bc632Df31CAdFCBD43F38887ce2ca5c',
+                messageTransmitter: '0x5b61381Fc9e58E70EfC13a4A97516997019198ee',
+                confirmations: 65,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
+    },
+    kitContracts: {
+        bridge: '0x6D1AaE1c34Aeb582022916a67f2A655C6f4eDFF2', //Unique bridge address as CCTP address for Edge is also unique
+    },
+});
+
+/**
+ * Edge Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Edge blockchain.
+ * Edge is an EVM-compatible blockchain.
+ */
+const EdgeTestnet = defineChain({
+    type: 'evm',
+    chain: Blockchain.Edge_Testnet,
+    name: 'Edge Testnet',
+    title: 'Edge Testnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 33431,
+    isTestnet: true,
+    explorerUrl: 'https://edge-testnet.explorer.alchemy.com/tx/{hash}',
+    rpcEndpoints: ['https://edge-testnet.g.alchemy.com/public'],
+    eurcAddress: null,
+    usdcAddress: '0x2d9F7CAD728051AA35Ecdc472a14cf8cDF5CFD6B',
+    usdtAddress: null,
+    cctp: {
+        domain: 28,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 65,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: true,
+            destination: true,
         },
     },
     kitContracts: {
@@ -1268,7 +1364,7 @@ const HyperEVM = defineChain({
     },
     chainId: 999,
     isTestnet: false,
-    explorerUrl: 'https://hyperevmscan.io/tx/{hash}',
+    explorerUrl: 'https://app.hyperliquid.xyz/explorer/tx/{hash}',
     rpcEndpoints: ['https://rpc.hyperliquid.xyz/evm'],
     eurcAddress: null,
     usdcAddress: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',
@@ -1313,7 +1409,7 @@ const HyperEVMTestnet = defineChain({
     },
     chainId: 998,
     isTestnet: true,
-    explorerUrl: 'https://testnet.hyperliquid.xyz/explorer/tx/{hash}',
+    explorerUrl: 'https://app.hyperliquid-testnet.xyz/explorer/tx/{hash}',
     rpcEndpoints: ['https://rpc.hyperliquid-testnet.xyz/evm'],
     eurcAddress: null,
     usdcAddress: '0x2B3370eE501B4a559b57D449569354196457D8Ab',
@@ -1613,6 +1709,94 @@ const MonadTestnet = defineChain({
     },
 });
 
+/**
+ * Morph Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Morph blockchain.
+ * Morph is an EVM-compatible Layer-2 blockchain built on the OP Stack.
+ */
+const Morph = defineChain({
+    type: 'evm',
+    chain: Blockchain.Morph,
+    name: 'Morph',
+    title: 'Morph Mainnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 2818,
+    isTestnet: false,
+    explorerUrl: 'https://explorer.morph.network/tx/{hash}',
+    rpcEndpoints: ['https://rpc.morphl2.io'],
+    eurcAddress: null,
+    usdcAddress: '0xCfb1186F4e93D60E60a8bDd997427D1F33bc372B',
+    usdtAddress: null,
+    cctp: {
+        domain: 30,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 64,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+    },
+});
+
+/**
+ * Morph Hoodi Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Morph blockchain.
+ * Morph is an EVM-compatible Layer-2 blockchain built on the OP Stack.
+ */
+const MorphTestnet = defineChain({
+    type: 'evm',
+    chain: Blockchain.Morph_Testnet,
+    name: 'Morph Hoodi',
+    title: 'Morph Hoodi Testnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 2910,
+    isTestnet: true,
+    explorerUrl: 'https://explorer-hoodi.morphl2.io/tx/{hash}',
+    rpcEndpoints: ['https://rpc-hoodi.morphl2.io'],
+    eurcAddress: null,
+    usdcAddress: '0x7433b41C6c5e1d58D4Da99483609520255ab661B',
+    usdtAddress: null,
+    cctp: {
+        domain: 30,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 64,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * NEAR Protocol Mainnet chain definition
  * @remarks
@@ -1871,7 +2055,7 @@ const Plume = defineChain({
         },
         forwarderSupported: {
             source: true,
-            destination: false,
+            destination: true,
         },
     },
     kitContracts: {
@@ -1916,7 +2100,7 @@ const PlumeTestnet = defineChain({
         },
         forwarderSupported: {
             source: true,
-            destination: false,
+            destination: true,
         },
     },
     kitContracts: {
@@ -2694,7 +2878,7 @@ const XDC = defineChain({
         },
         forwarderSupported: {
             source: true,
-            destination: false,
+            destination: true,
         },
     },
     kitContracts: {
@@ -2738,7 +2922,7 @@ const XDCApothem = defineChain({
         },
         forwarderSupported: {
             source: true,
-            destination: false,
+            destination: true,
         },
     },
     kitContracts: {
@@ -2813,6 +2997,8 @@ var Chains = /*#__PURE__*/Object.freeze({
     CeloAlfajoresTestnet: CeloAlfajoresTestnet,
     Codex: Codex,
     CodexTestnet: CodexTestnet,
+    Edge: Edge,
+    EdgeTestnet: EdgeTestnet,
     Ethereum: Ethereum,
     EthereumSepolia: EthereumSepolia,
     Hedera: Hedera,
@@ -2825,6 +3011,8 @@ var Chains = /*#__PURE__*/Object.freeze({
     LineaSepolia: LineaSepolia,
     Monad: Monad,
     MonadTestnet: MonadTestnet,
+    Morph: Morph,
+    MorphTestnet: MorphTestnet,
     NEAR: NEAR,
     NEARTestnet: NEARTestnet,
     Noble: Noble,
@@ -5416,12 +5604,14 @@ const USDC = {
         [Blockchain.Base]: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
         [Blockchain.Celo]: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
         [Blockchain.Codex]: '0xd996633a415985DBd7D6D12f4A4343E31f5037cf',
+        [Blockchain.Edge]: '0x98d2919b9A214E6Fa5384AC81E6864bA686Ad74c',
         [Blockchain.Ethereum]: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
         [Blockchain.Hedera]: '0.0.456858',
         [Blockchain.HyperEVM]: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',
         [Blockchain.Ink]: '0x2D270e6886d130D724215A266106e6832161EAEd',
         [Blockchain.Linea]: '0x176211869ca2b568f2a7d4ee941e073a821ee1ff',
         [Blockchain.Monad]: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',
+        [Blockchain.Morph]: '0xCfb1186F4e93D60E60a8bDd997427D1F33bc372B',
         [Blockchain.NEAR]: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
         [Blockchain.Noble]: 'uusdc',
         [Blockchain.Optimism]: '0x0b2c639c533813f4aa9d7837caf62653d097ff85',
@@ -5444,12 +5634,14 @@ const USDC = {
         [Blockchain.Avalanche_Fuji]: '0x5425890298aed601595a70AB815c96711a31Bc65',
         [Blockchain.Base_Sepolia]: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
         [Blockchain.Codex_Testnet]: '0x6d7f141b6819C2c9CC2f818e6ad549E7Ca090F8f',
+        [Blockchain.Edge_Testnet]: '0x2d9F7CAD728051AA35Ecdc472a14cf8cDF5CFD6B',
         [Blockchain.Ethereum_Sepolia]: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
         [Blockchain.Hedera_Testnet]: '0.0.429274',
         [Blockchain.HyperEVM_Testnet]: '0x2B3370eE501B4a559b57D449569354196457D8Ab',
         [Blockchain.Ink_Testnet]: '0xFabab97dCE620294D2B0b0e46C68964e326300Ac',
         [Blockchain.Linea_Sepolia]: '0xfece4462d57bd51a6a552365a011b95f0e16d9b7',
         [Blockchain.Monad_Testnet]: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
+        [Blockchain.Morph_Testnet]: '0x7433b41C6c5e1d58D4Da99483609520255ab661B',
         [Blockchain.NEAR_Testnet]: '3e2210e1184b45b64c8a434c0a7e7b23cc04ea7eb7a6c3c32520d03d4afcb8af',
         [Blockchain.Noble_Testnet]: 'uusdc',
         [Blockchain.Optimism_Sepolia]: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7',
@@ -9310,7 +9502,184 @@ z
 })
     .passthrough();
 
-var version = "1.4.1";
+/**
+ * Check whether the source adapter supports EIP-5792 atomic batching and
+ * the consumer has not explicitly opted out via `config.batchTransactions`.
+ *
+ * @param params - Bridge parameters (used for adapter and config access).
+ * @returns `true` when batched execution should be attempted.
+ *
+ * @example
+ * ```typescript
+ * const useBatched = await shouldUseBatchedExecution(params)
+ * if (useBatched) {
+ *   // take the batched approve + burn path
+ * }
+ * ```
+ */
+async function shouldUseBatchedExecution(params) {
+    if (params.config?.batchTransactions === false) {
+        return false;
+    }
+    const { chain } = params.source;
+    if (chain.type !== 'evm') {
+        return false;
+    }
+    const adapter = params.source
+        .adapter;
+    if (typeof adapter.supportsAtomicBatch !== 'function' ||
+        typeof adapter.batchExecute !== 'function') {
+        return false;
+    }
+    try {
+        return await adapter.supportsAtomicBatch(chain);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Execute the approve and burn steps as a single EIP-5792 batched call.
+ *
+ * Prepare both `PreparedChainRequest` objects upfront, extract their raw
+ * call data via `getCallData()`, submit both via `adapter.batchExecute()`,
+ * then map the individual receipts back to standard {@link BridgeStep}
+ * objects so downstream consumers (event callbacks, result tracking) are
+ * unaffected.
+ *
+ * @param params - The CCTP v2 bridge parameters.
+ * @param provider - The CCTP v2 bridging provider.
+ * @returns Approve and burn steps with a shared context containing the burn tx hash.
+ * @throws {@link KitError} when the source chain is not EVM.
+ * @throws {@link KitError} when calldata extraction (`getCallData`) is not supported
+ *   by the prepared requests.
+ * @remarks
+ * Errors that occur after the batch has been submitted to the wallet
+ * (e.g. polling timeout, insufficient receipts) are **not thrown** — they
+ * are captured as `state: 'error'` on the returned steps to prevent
+ * accidental double-spend on retry.
+ *
+ * @example
+ * ```typescript
+ * const { approveStep, burnStep, context } = await executeBatchedApproveAndBurn(
+ *   params,
+ *   provider,
+ * )
+ * result.steps.push(approveStep, burnStep)
+ * ```
+ */
+async function executeBatchedApproveAndBurn(params, provider) {
+    // Double-unknown cast: Adapter<TFrom> has no structural overlap with
+    // BatchCapableAdapter (a duck-typed interface for EIP-5792 methods).
+    // A direct cast fails because TS cannot prove the intersection; the
+    // runtime capability check below guards against unsupported adapters.
+    const adapter = params.source.adapter;
+    const sourceChain = params.source.chain;
+    if (sourceChain.type !== 'evm') {
+        throw new KitError({
+            ...InputError.INVALID_CHAIN,
+            recoverability: 'FATAL',
+            message: 'Batched execution is only supported on EVM chains.',
+        });
+    }
+    const chain = sourceChain;
+    // customFee.value is in base units (integer string) at this point.
+    const customFee = BigInt(params.config?.customFee?.value ?? '0');
+    const amountBigInt = BigInt(params.amount);
+    const approvalAmount = (amountBigInt + customFee).toString();
+    const [approveRequest, burnRequest] = await Promise.all([
+        provider.approve(params.source, approvalAmount),
+        provider.burn(params),
+    ]);
+    if (approveRequest.type !== 'evm' ||
+        burnRequest.type !== 'evm' ||
+        !approveRequest.getCallData ||
+        !burnRequest.getCallData) {
+        throw new KitError({
+            ...InputError.UNSUPPORTED_ACTION,
+            recoverability: 'FATAL',
+            message: 'Batched execution requires EVM prepared requests with getCallData() support.',
+        });
+    }
+    const approveCallData = approveRequest.getCallData();
+    const burnCallData = burnRequest.getCallData();
+    // batchExecute may throw before submission (wallet declined) but never
+    // after — post-submission errors are returned as empty receipts.
+    const batchResult = await adapter.batchExecute([approveCallData, burnCallData], chain);
+    const approveReceipt = batchResult.receipts[0];
+    const burnReceipt = batchResult.receipts[1];
+    const approveStep = await buildBatchedStep('approve', approveReceipt, batchResult.batchId, adapter, chain);
+    const burnStep = await buildBatchedStep('burn', burnReceipt, batchResult.batchId, adapter, chain);
+    if (burnStep.state !== 'error' && !burnStep.txHash) {
+        burnStep.state = 'error';
+        burnStep.errorMessage =
+            'Batched burn step completed but no transaction hash was returned.';
+    }
+    const context = { burnTxHash: burnStep.txHash ?? '' };
+    return { approveStep, burnStep, context };
+}
+/**
+ * Build a {@link BridgeStep} from a single receipt within a batch.
+ *
+ * Map the raw receipt from `batchExecute` into a standard `BridgeStep`,
+ * waiting for on-chain confirmation via `adapter.waitForTransaction`.
+ * All errors are captured on the step (never thrown) so the caller
+ * can inspect each step independently.
+ *
+ * @param name - Human-readable step name (e.g. `'approve'`, `'burn'`).
+ * @param receipt - Per-call receipt from `batchExecute`, or `undefined`
+ *   when the wallet returned fewer receipts than submitted calls.
+ * @param batchId - Wallet-assigned batch identifier.
+ * @param adapter - The batch-capable adapter (used for confirmation).
+ * @param chain - The EVM chain the batch was executed on.
+ * @returns A fully-populated bridge step with state, tx hash and explorer URL.
+ *
+ * @internal
+ */
+async function buildBatchedStep(name, receipt, batchId, adapter, chain) {
+    const step = {
+        name,
+        state: 'pending',
+        batched: true,
+        batchId,
+    };
+    if (!receipt) {
+        step.state = 'error';
+        step.errorMessage = `No receipt returned for ${name} in batch ${batchId}.`;
+        return step;
+    }
+    step.txHash = receipt.txHash;
+    if (receipt.txHash) {
+        step.explorerUrl = buildExplorerUrl(chain, receipt.txHash);
+    }
+    if (receipt.status !== 'success') {
+        step.state = 'error';
+        step.errorMessage = `${name} call failed within batch ${batchId}.`;
+        return step;
+    }
+    if (!receipt.txHash) {
+        step.state = 'error';
+        step.errorMessage = `${name} succeeded in batch but returned an empty transaction hash.`;
+        return step;
+    }
+    try {
+        const transaction = await adapter.waitForTransaction(receipt.txHash, { confirmations: 1 }, chain);
+        step.state = transaction.blockNumber === undefined ? 'error' : 'success';
+        step.data = transaction;
+        if (transaction.blockNumber === undefined) {
+            step.errorMessage = 'Transaction was not confirmed on-chain.';
+        }
+    }
+    catch (err) {
+        step.state = 'error';
+        step.error = err;
+        step.errorMessage =
+            err instanceof Error ? err.message : 'Unknown error during confirmation.';
+    }
+    return step;
+}
+
+var version = "1.6.0";
 var pkg = {
 	version: version};
 
@@ -9339,6 +9708,67 @@ function resolveBridgeInvocation(invocationMeta) {
     };
     return extendInvocationContext(resolveInvocationContext(invocationMeta, defaults), BRIDGE_CALLER);
 }
+/**
+ * Execute the batched approve + burn path via EIP-5792.
+ *
+ * Mutate `result` with step data and error state as needed. Return the
+ * batch context on success, or `undefined` when the batch failed (in
+ * which case `result.state` is set to `'error'`).
+ *
+ * @internal
+ * @param params - Bridge parameters (read-only).
+ * @param provider - The CCTP v2 bridging provider (read-only).
+ * @param result - Bridge result object — **mutated in place** with step
+ *   data and, on failure, `state: 'error'` plus an `error` payload.
+ * @param invocation - Invocation context for telemetry (read-only).
+ * @returns The step context on success, or `undefined` when the batch failed.
+ */
+async function executeBatchedPath(params, provider, result, invocation) {
+    // IMPORTANT: once executeBatchedApproveAndBurn is called, we NEVER
+    // fall back to sequential. The wallet may have already signed &
+    // submitted the batch; retrying as individual txs would double-spend.
+    try {
+        const { approveStep, burnStep, context: batchContext, } = await executeBatchedApproveAndBurn(params, provider);
+        for (const step of [approveStep, burnStep]) {
+            const stepName = step.name;
+            if (step.state === 'error') {
+                ensureStepErrorMessage(step.name, step);
+                result.steps.push(step);
+                result.state = 'error';
+                dispatchStepEvent(stepName, step, provider, invocation);
+                return undefined;
+            }
+            dispatchStepEvent(stepName, step, provider, invocation);
+            result.steps.push(step);
+        }
+        return batchContext;
+    }
+    catch (error_) {
+        // Only handles pre-submission failures (prepare rejected, wallet
+        // declined, etc.). batchExecute never throws after sendCalls succeeds.
+        result.state = 'error';
+        result.steps.push({
+            name: 'batch',
+            state: 'error',
+            batched: true,
+            error: error_,
+            errorMessage: error_ instanceof Error
+                ? error_.message
+                : 'Batched approve + burn failed.',
+        });
+        return undefined;
+    }
+}
+/**
+ * Ensure `step.errorMessage` is populated when an error object exists.
+ *
+ * @internal
+ */
+function ensureStepErrorMessage(name, step) {
+    if (!step.errorMessage && step.error) {
+        step.errorMessage = `${name} step failed: ${getErrorMessage(step.error)}`;
+    }
+}
 /**
  * Execute a cross-chain USDC bridge using the CCTP v2 protocol.
  *
@@ -9372,9 +9802,7 @@ function resolveBridgeInvocation(invocationMeta) {
  * ```
  */
 async function bridge(params, provider) {
-    // Check if forwarder is enabled (on destination)
     const useForwarder = params.destination.useForwarder === true;
-    // Resolve invocation metadata to full context for event dispatching
     const invocation = resolveBridgeInvocation(params.invocationMeta);
     const result = {
         state: 'pending',
@@ -9387,11 +9815,9 @@ async function bridge(params, provider) {
         destination: {
             address: params.destination.address,
             chain: params.destination.chain,
-            // Preserve recipientAddress
             ...(params.destination.recipientAddress && {
                 recipientAddress: params.destination.recipientAddress,
             }),
-            // Preserve useForwarder
             ...(useForwarder && {
                 useForwarder: true,
             }),
@@ -9400,29 +9826,38 @@ async function bridge(params, provider) {
         config: params.config,
         provider: provider.name,
     };
-    // Context shared between steps
     let context = undefined;
-    // Create step executors based on useForwarder config
+    let useBatched = false;
+    try {
+        useBatched = await shouldUseBatchedExecution(params);
+    }
+    catch {
+        // Silently fall back to sequential
+    }
     const executors = createStepExecutors(useForwarder);
-    // Execute each step in sequence
-    for (const { name, executor, updateContext } of executors) {
+    if (useBatched) {
+        const batchContext = await executeBatchedPath(params, provider, result, invocation);
+        if (result.state === 'error') {
+            return result;
+        }
+        context = batchContext;
+    }
+    const stepsToRun = useBatched
+        ? executors.filter(({ name }) => name !== 'approve' && name !== 'burn')
+        : executors;
+    for (const { name, executor, updateContext } of stepsToRun) {
         try {
             const step = await executor(params, provider, context);
             if (step.state === 'error') {
-                // Ensure errorMessage is set with proper formatting if not already present
-                if (!step.errorMessage && step.error) {
-                    step.errorMessage = `${name} step failed: ${getErrorMessage(step.error)}`;
-                }
+                ensureStepErrorMessage(name, step);
                 result.steps.push(step);
                 result.state = 'error';
-                // Dispatch event even for error steps
                 dispatchStepEvent(name, step, provider, invocation);
                 return result;
             }
-            // Merge new context with existing context to preserve data from previous steps
             const newContext = updateContext?.(step);
             if (newContext) {
-                context = { ...(context ?? {}), ...newContext };
+                context = { ...context, ...newContext };
             }
             dispatchStepEvent(name, step, provider, invocation);
             result.steps.push(step);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/provider-cctp-v2",
-  "version": "1.4.1",
+  "version": "1.6.0",
   "description": "Circle's official Cross-Chain Transfer Protocol v2 provider for native USDC bridging",
   "keywords": [
     "circle",