@circle-fin/app-kit 1.16.0 → 1.17.0

package/bridge.cjs

@@ -2522,22 +2522,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);
@@ -3810,6 +3861,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 = {}));
@@ -5142,7 +5195,8 @@ var BorrowChain;
         }
     },
     kitContracts: {
-        bridge: BRIDGE_CONTRACT_EVM_MAINNET
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET
     }
 });
 
@@ -6011,7 +6065,8 @@ var BorrowChain;
         }
     },
     kitContracts: {
-        bridge: BRIDGE_CONTRACT_EVM_MAINNET
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET
     }
 });
 
@@ -8309,8 +8364,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
  *
  */ const swapChainIdentifierSchema = zod.z.union([
@@ -8789,7 +8844,7 @@ const swapTokenEnumSchema = zod.z.enum([
  *
  * A chain supports swaps if ALL conditions are met:
  * 1. Is a member of the {@link SwapChain} enum
- * 2. Has CCTPv2 support (adapter contract deployed)
+ * 2. Has an Adapter contract configured directly or through CCTP v2
  *
  * Testnets are allowed only when explicitly listed in the
  * {@link SwapChain} enum (e.g., Arc_Testnet).
@@ -8810,14 +8865,14 @@ const swapTokenEnumSchema = zod.z.enum([
  * @remarks
  * Chains automatically become swap-enabled when:
  * - Added to the {@link SwapChain} enum
- * - Adapter contract is deployed (CCTPv2)
+ * - An Adapter contract is deployed and configured
  *
  * No code changes needed when new chains are added!
  */ function isSwapSupportedChain(chain) {
     if (!(chain.chain in SwapChain)) {
         return false;
     }
-    if (!isCCTPV2Supported(chain)) {
+    if (!isCCTPV2Supported(chain) && !hasCustomContractSupport(chain, 'adapter')) {
         return false;
     }
     return true;
@@ -8828,7 +8883,7 @@ const swapTokenEnumSchema = zod.z.enum([
  *
  * Dynamically filter chain definitions to include only those that:
  * - Are members of the {@link SwapChain} enum
- * - Have CCTPv2 support
+ * - Have an Adapter contract configured directly or through CCTP v2
  *
  * This function is pure and accepts chains as parameter to avoid
  * circular dependencies.
@@ -10262,11 +10317,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',
@@ -10325,6 +10382,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',
@@ -10387,7 +10445,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'
@@ -10406,6 +10466,7 @@ function parseOrThrow(value, schema, context) {
     locators: {
         [Blockchain.Ethereum]: '0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599',
         [Blockchain.Arbitrum]: '0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f',
+        [Blockchain.Cronos]: '0x062E66477Faf219F25D27dCED647BF57C3107d52',
         [Blockchain.Avalanche]: '0x50b7545627a5162F82A992c33b87aDc75187B218'
     }
 };
@@ -12236,7 +12297,7 @@ function resolveOptions(options) {
 }
 
 var name$3 = "@circle-fin/bridge-kit";
-var version$4 = "1.15.2";
+var version$4 = "1.15.3";
 var pkg$4 = {
 	name: name$3,
 	version: version$4};
@@ -14801,7 +14862,11 @@ function createNoopLogger() {
     tokenId: bytes32Hex,
     domainId: nonNegativeInteger,
     tokenAddress: zod.z.string(),
-    tokenManagerAddress: zod.z.string()
+    tokenManagerAddress: zod.z.string(),
+    // Operator-controlled per-chain kill switch (CCTPE-3979). Optional for
+    // back-compat with older IRIS versions that do not surface it. Downstream
+    // consumers in `findCCTPXDeployment` treat a missing value as `true`.
+    enabled: zod.z.boolean().optional()
 });
 /**
  * Schema for one token entry in the token registry response.
@@ -15285,17 +15350,23 @@ function createNoopLogger() {
 /**
  * Find a token's deployment on the given CCTP domain.
  *
+ * A deployment row with `enabled === false` is treated as missing: an IRIS
+ * operator has flipped the per-chain kill switch (CCTPE-3979), so the SDK must
+ * not route through it even though the row still exists in the registry. A
+ * missing or `true` `enabled` value remains routable — the field is optional on
+ * older IRIS versions and absence is read as "allowed".
+ *
  * @param token - The registry token whose deployments are searched.
  * @param domain - The CCTP domain id to match.
  * @returns The matching {@link CCTPXTokenDeployment}, or `undefined` when the
- *   token has no deployment on that domain.
+ *   token has no deployment on that domain or the deployment is disabled.
  *
  * @example
  * ```typescript
  * const deployment = findCCTPXDeployment(token, 0)
  * ```
  */ function findCCTPXDeployment(token, domain) {
-    return token.deployments.find((deployment)=>deployment.domainId === domain);
+    return token.deployments.find((deployment)=>deployment.domainId === domain && deployment.enabled !== false);
 }
 
 /**
@@ -15397,6 +15468,24 @@ function createNoopLogger() {
                     }
                 }
             })
+    ],
+    // The token is not deployed on one of the route chains, or an operator has
+    // flipped the per-chain `enabled` kill switch on the IRIS deployment row.
+    // Either way the route is permanently unavailable until the operator intervenes;
+    // a retry at the same source/destination will keep returning this error.
+    [
+        'TOKEN_NOT_SUPPORTED_ON_ROUTE',
+        ({ sourceDomain, destinationDomain })=>new KitError({
+                ...InputError.UNSUPPORTED_ROUTE,
+                recoverability: 'FATAL',
+                message: 'CCTPx fee quote rejected the route: the token is not supported on ' + 'the source or destination chain (missing deployment or operator-disabled).',
+                cause: {
+                    trace: {
+                        sourceDomain,
+                        destinationDomain
+                    }
+                }
+            })
     ]
 ]);
 /**
@@ -23407,7 +23496,7 @@ const mockAttestationMessage = {
     return step;
 }
 
-var version$3 = "1.14.1";
+var version$3 = "1.14.2";
 var pkg$3 = {
 	version: version$3};
 
@@ -27658,7 +27747,7 @@ registerKit(`${pkg$4.name}/${pkg$4.version}`);
 };
 
 var name$2 = "@circle-fin/swap-kit";
-var version$2 = "1.7.1";
+var version$2 = "1.8.0";
 var pkg$2 = {
 	name: name$2,
 	version: version$2};
@@ -28000,6 +28089,64 @@ const optionalChainIdentifierField = chainIdentifierField.optional();
 }, {
     message: 'fee amount must be non-negative (>= 0)'
 });
+/**
+ * Parses a display-only field leniently: a value `schema` rejects is replaced
+ * with `fallback` instead of failing the response that carries it.
+ * Implemented with `preprocess` rather than Zod's `.catch()` because static
+ * analysis misreads `.catch` on the schema chain as an unhandled Promise
+ * (S7785).
+ */ const withFallback = (schema, fallback)=>zod.z.preprocess((value)=>schema.safeParse(value).success ? value : fallback, schema);
+const swapRouteTokenSchema = zod.z.object({
+    symbol: zod.z.string(),
+    address: zod.z.string(),
+    decimals: zod.z.number()
+});
+const swapRouteMetadataSchema = zod.z.record(zod.z.unknown()).optional();
+const swapRouteStepSchema = zod.z.object({
+    type: zod.z.string(),
+    tool: zod.z.string(),
+    toolName: zod.z.string(),
+    fromToken: swapRouteTokenSchema,
+    toToken: swapRouteTokenSchema,
+    estimate: zod.z.object({
+        fromAmount: zod.z.string(),
+        toAmount: zod.z.string(),
+        gasCostUSD: zod.z.string().optional()
+    }),
+    metadata: swapRouteMetadataSchema
+});
+/**
+ * Strict schema for a `SwapRoute`. Module-private: service responses
+ * parse routes leniently through {@link responseSwapRouteSchema}.
+ */ const swapRouteSchema = zod.z.object({
+    provider: zod.z.string().min(1, 'provider must be a non-empty string'),
+    steps: zod.z.array(swapRouteStepSchema),
+    metadata: swapRouteMetadataSchema
+});
+/**
+ * Route details are display-only, so service responses parse them leniently:
+ * steps or metadata in a shape the SDK does not know are dropped rather than
+ * failing the quote or swap they describe. Steps are all-or-nothing: if any
+ * step is malformed, `steps` is empty, so a route never silently loses a hop.
+ */ const responseSwapRouteSchema = swapRouteSchema.extend({
+    steps: withFallback(swapRouteSchema.shape.steps, []),
+    metadata: withFallback(swapRouteMetadataSchema, undefined)
+});
+const createSwapFeeItemSchema = zod.z.object({
+    token: zod.z.string({
+        required_error: 'fee token is required',
+        invalid_type_error: 'fee token must be a string'
+    }).min(1, 'fee token must be a non-empty string'),
+    amount: feeAmountSchema,
+    decimals: zod.z.number().int('fee token decimals must be an integer').nonnegative('fee token decimals must be a non-negative integer').optional(),
+    symbol: zod.z.string({
+        invalid_type_error: 'fee token symbol must be a string'
+    }).min(1, 'fee token symbol must be a non-empty string').optional(),
+    // Descriptive metadata: a value the SDK cannot use is dropped rather than
+    // failing the response that carries the fee.
+    type: withFallback(zod.z.string().min(1).optional(), undefined),
+    chain: withFallback(zod.z.string().min(1).optional(), undefined)
+});
 /**
  * Zod schema for validating API keys.
  *
@@ -28085,10 +28232,7 @@ const optionalChainIdentifierField = chainIdentifierField.optional();
     /** Quote information with estimated amounts and route */ quote: zod.z.object({
         /** Estimated output amount (base units) */ estimatedAmount: zod.z.string().min(1, 'estimatedAmount must be a non-empty string').regex(/^\d+$/, 'estimatedAmount must be a numeric string'),
         /** Guaranteed minimum output amount (base units) */ minAmount: zod.z.string().min(1, 'minAmount must be a non-empty string').regex(/^\d+$/, 'minAmount must be a numeric string'),
-        /** Route information from DEX aggregator */ route: zod.z.object({
-            provider: zod.z.string().min(1, 'provider must be a non-empty string'),
-            steps: zod.z.array(zod.z.unknown())
-        })
+        /** Route information from DEX aggregator */ route: responseSwapRouteSchema
     }),
     /** Fee context indicating where fees should be collected */ feeContext: quoteFeeContextSchema
 });
@@ -28304,19 +28448,6 @@ getQuoteRequestBaseSchema.superRefine(requireCrossChainQuoteToAddress);
     }).min(1, 'toChain must be a non-empty string if provided').optional(),
     apiKey: apiKeySchema.optional()
 });
-/**
- * Zod schema for validating CreateSwapResponse payloads.
- */ const createSwapFeeItemSchema = zod.z.object({
-    token: zod.z.string({
-        required_error: 'fee token is required',
-        invalid_type_error: 'fee token must be a string'
-    }).min(1, 'fee token must be a non-empty string'),
-    amount: feeAmountSchema,
-    decimals: zod.z.number().int('fee token decimals must be an integer').nonnegative('fee token decimals must be a non-negative integer').optional(),
-    symbol: zod.z.string({
-        invalid_type_error: 'fee token symbol must be a string'
-    }).min(1, 'fee token symbol must be a non-empty string').optional()
-});
 /**
  * Developer fee item schema with basis field.
  */ const createSwapDeveloperFeeItemSchema = createSwapFeeItemSchema.extend({
@@ -28454,6 +28585,8 @@ getQuoteRequestBaseSchema.superRefine(requireCrossChainQuoteToAddress);
     correlationId: zod.z.preprocess((value)=>zod.z.string().uuid().safeParse(value).success ? value : undefined, zod.z.string().optional()),
     config: createSwapRequestBaseSchema.shape.config.optional(),
     fees: createSwapFeesSchema.optional(),
+    // A route the SDK cannot parse is dropped instead of failing the swap.
+    route: withFallback(responseSwapRouteSchema.optional(), undefined),
     transaction: createSwapTransactionSchema
 });
 
@@ -29581,6 +29714,16 @@ createTokenRegistry();
         name: 'USDC',
         version: '2'
     },
+    Cronos: {
+        chainId: Cronos.chainId,
+        name: 'USDC',
+        version: '2'
+    },
+    Morph: {
+        chainId: Morph.chainId,
+        name: 'USDC',
+        version: '2'
+    },
     Arc_Testnet: {
         chainId: ArcTestnet.chainId,
         name: 'USDC',
@@ -29669,6 +29812,7 @@ const optionalSwapChainIdentifierField = swapChainIdentifierField.optional();
  * - customFee: Optional fee configuration
  * - apiKey: Optional credential string
  * - kitKey: Optional credential string (deprecated alias for apiKey)
+ * - batchTransactions: Optional boolean to opt out of atomic batching
  */ const swapConfigSchema = zod.z.object({
     allowanceStrategy: allowanceStrategySchema.optional(),
     slippageBps: zod.z.number().int().min(0).optional(),
@@ -29679,7 +29823,10 @@ const optionalSwapChainIdentifierField = swapChainIdentifierField.optional();
     })(zod.z.string())).optional(),
     customFee: swapCustomFeeSchema.optional(),
     apiKey: zod.z.string().optional(),
-    kitKey: zod.z.string().optional()
+    kitKey: zod.z.string().optional(),
+    batchTransactions: zod.z.boolean({
+        invalid_type_error: 'batchTransactions must be a boolean'
+    }).optional()
 });
 const swapDestinationSchema = zod.z.object({
     chain: optionalSwapChainIdentifierField,
@@ -29872,7 +30019,7 @@ new Set(Object.values(Blockchain));
 registerKit(`${pkg$2.name}/${pkg$2.version}`);
 
 var name$1 = "@circle-fin/earn-kit";
-var version$1 = "1.8.1";
+var version$1 = "1.9.0";
 var pkg$1 = {
 	name: name$1,
 	version: version$1};
@@ -31376,7 +31523,7 @@ registerKit(`${pkg$1.name}/${pkg$1.version}`);
 };
 
 var name = "@circle-fin/borrow-kit";
-var version = "1.0.0";
+var version = "1.1.0";
 var pkg = {
 	name: name,
 	version: version};

package/bridge.d.cts

@@ -899,10 +899,10 @@ declare enum Blockchain {
  *
  * Unlike the full {@link Blockchain} enum, SwapChain includes mainnet
  * networks and explicitly whitelisted testnets (e.g., {@link Arc_Testnet})
- * where adapter contracts are deployed (CCTPv2 support).
+ * where Adapter contracts are deployed.
  *
  * Dynamic validation via {@link isSwapSupportedChain} ensures chains
- * automatically work when adapter contracts and supported tokens are deployed.
+ * automatically work when Adapter contracts and supported tokens are deployed.
  *
  * @example
  * ```typescript
@@ -942,20 +942,22 @@ declare enum SwapChain {
     HyperEVM = "HyperEVM",
     Monad = "Monad",
     Arc = "Arc",
+    Cronos = "Cronos",
+    Morph = "Morph",
     Arc_Testnet = "Arc_Testnet"
 }
 /**
  * Chain definition that supports swap operations.
  *
  * @remarks
- * Expanded from 4 to ~18 supported chains based on:
- * - CCTPv2 support (adapter contract deployed)
+ * Expanded from 4 to supported mainnets and whitelisted testnets based on:
+ * - A deployed Adapter contract, configured directly or through CCTP v2
  * - Mainnet chains plus whitelisted testnets (e.g., Arc Testnet)
  *
  * Use `isSwapSupportedChain()` for runtime validation.
  */
 type SwapChainDefinition = ChainDefinition & {
-    chain: Blockchain.Ethereum | Blockchain.Base | Blockchain.Polygon | Blockchain.Solana | Blockchain.Arbitrum | Blockchain.Optimism | Blockchain.Avalanche | Blockchain.Linea | Blockchain.Ink | Blockchain.World_Chain | Blockchain.Unichain | Blockchain.Plume | Blockchain.Sei | Blockchain.Sonic | Blockchain.XDC | Blockchain.HyperEVM | Blockchain.Monad | Blockchain.Arc | Blockchain.Arc_Testnet;
+    chain: Blockchain.Ethereum | Blockchain.Base | Blockchain.Polygon | Blockchain.Solana | Blockchain.Arbitrum | Blockchain.Optimism | Blockchain.Avalanche | Blockchain.Linea | Blockchain.Ink | Blockchain.World_Chain | Blockchain.Unichain | Blockchain.Plume | Blockchain.Sei | Blockchain.Sonic | Blockchain.XDC | Blockchain.HyperEVM | Blockchain.Monad | Blockchain.Arc | Blockchain.Cronos | Blockchain.Morph | Blockchain.Arc_Testnet;
 };
 /**
  * Chain identifier accepted by swap operations.
@@ -6975,7 +6977,7 @@ interface ServiceSwapConfig {
      *
      * @defaultValue true
      */
-    batchTransactions?: boolean;
+    batchTransactions?: boolean | undefined;
 }
 /**
  * Parameters for initiating a swap operation through the Stablecoin Service.
@@ -7439,6 +7441,33 @@ interface SwapConfig {
      * `apiKey` is omitted, and `apiKey` takes precedence when both are set.
      */
     kitKey?: string;
+    /**
+     * Enable or disable atomic batched execution of the approval and swap.
+     *
+     * When `true` (or omitted), an EVM swap that needs an on-chain ERC-20
+     * approval submits the approval and the swap as one atomic batch if the
+     * connected wallet supports it (EIP-5792, or a signing strategy that
+     * declares atomic batching). Set to `false` to force the sequential
+     * approve-then-swap flow.
+     *
+     * @remarks
+     * Has no effect on the gasless permit path, native-token swaps, or Solana,
+     * which already execute as a single transaction. USDT input always uses the
+     * sequential path because its allowance must be reset to zero first. The
+     * batched path relies on the wallet's own gas estimation for the swap call;
+     * set `false` if your wallet under-estimates gas for complex routes or
+     * rejects batched calls.
+     *
+     * @defaultValue `undefined` (batching attempted when the wallet supports it)
+     *
+     * @example
+     * ```typescript
+     * const config: SwapConfig = {
+     *   batchTransactions: false, // force sequential approve → swap
+     * }
+     * ```
+     */
+    batchTransactions?: boolean | undefined;
 }
 /**
  * Resolved parameters for swap operations after validation and normalization.

package/bridge.d.mts

@@ -899,10 +899,10 @@ declare enum Blockchain {
  *
  * Unlike the full {@link Blockchain} enum, SwapChain includes mainnet
  * networks and explicitly whitelisted testnets (e.g., {@link Arc_Testnet})
- * where adapter contracts are deployed (CCTPv2 support).
+ * where Adapter contracts are deployed.
  *
  * Dynamic validation via {@link isSwapSupportedChain} ensures chains
- * automatically work when adapter contracts and supported tokens are deployed.
+ * automatically work when Adapter contracts and supported tokens are deployed.
  *
  * @example
  * ```typescript
@@ -942,20 +942,22 @@ declare enum SwapChain {
     HyperEVM = "HyperEVM",
     Monad = "Monad",
     Arc = "Arc",
+    Cronos = "Cronos",
+    Morph = "Morph",
     Arc_Testnet = "Arc_Testnet"
 }
 /**
  * Chain definition that supports swap operations.
  *
  * @remarks
- * Expanded from 4 to ~18 supported chains based on:
- * - CCTPv2 support (adapter contract deployed)
+ * Expanded from 4 to supported mainnets and whitelisted testnets based on:
+ * - A deployed Adapter contract, configured directly or through CCTP v2
  * - Mainnet chains plus whitelisted testnets (e.g., Arc Testnet)
  *
  * Use `isSwapSupportedChain()` for runtime validation.
  */
 type SwapChainDefinition = ChainDefinition & {
-    chain: Blockchain.Ethereum | Blockchain.Base | Blockchain.Polygon | Blockchain.Solana | Blockchain.Arbitrum | Blockchain.Optimism | Blockchain.Avalanche | Blockchain.Linea | Blockchain.Ink | Blockchain.World_Chain | Blockchain.Unichain | Blockchain.Plume | Blockchain.Sei | Blockchain.Sonic | Blockchain.XDC | Blockchain.HyperEVM | Blockchain.Monad | Blockchain.Arc | Blockchain.Arc_Testnet;
+    chain: Blockchain.Ethereum | Blockchain.Base | Blockchain.Polygon | Blockchain.Solana | Blockchain.Arbitrum | Blockchain.Optimism | Blockchain.Avalanche | Blockchain.Linea | Blockchain.Ink | Blockchain.World_Chain | Blockchain.Unichain | Blockchain.Plume | Blockchain.Sei | Blockchain.Sonic | Blockchain.XDC | Blockchain.HyperEVM | Blockchain.Monad | Blockchain.Arc | Blockchain.Cronos | Blockchain.Morph | Blockchain.Arc_Testnet;
 };
 /**
  * Chain identifier accepted by swap operations.
@@ -6975,7 +6977,7 @@ interface ServiceSwapConfig {
      *
      * @defaultValue true
      */
-    batchTransactions?: boolean;
+    batchTransactions?: boolean | undefined;
 }
 /**
  * Parameters for initiating a swap operation through the Stablecoin Service.
@@ -7439,6 +7441,33 @@ interface SwapConfig {
      * `apiKey` is omitted, and `apiKey` takes precedence when both are set.
      */
     kitKey?: string;
+    /**
+     * Enable or disable atomic batched execution of the approval and swap.
+     *
+     * When `true` (or omitted), an EVM swap that needs an on-chain ERC-20
+     * approval submits the approval and the swap as one atomic batch if the
+     * connected wallet supports it (EIP-5792, or a signing strategy that
+     * declares atomic batching). Set to `false` to force the sequential
+     * approve-then-swap flow.
+     *
+     * @remarks
+     * Has no effect on the gasless permit path, native-token swaps, or Solana,
+     * which already execute as a single transaction. USDT input always uses the
+     * sequential path because its allowance must be reset to zero first. The
+     * batched path relies on the wallet's own gas estimation for the swap call;
+     * set `false` if your wallet under-estimates gas for complex routes or
+     * rejects batched calls.
+     *
+     * @defaultValue `undefined` (batching attempted when the wallet supports it)
+     *
+     * @example
+     * ```typescript
+     * const config: SwapConfig = {
+     *   batchTransactions: false, // force sequential approve → swap
+     * }
+     * ```
+     */
+    batchTransactions?: boolean | undefined;
 }
 /**
  * Resolved parameters for swap operations after validation and normalization.