@circle-fin/app-kit 1.14.0 → 1.15.1

package/estimateSwap.mjs

@@ -726,6 +726,38 @@ class KitError extends Error {
         name: 'INPUT_AMOUNT_OUT_OF_RANGE',
         type: 'INPUT'
     },
+    /**
+   * Protocol fee is denominated in a token that is not supported for the
+   * route (only the native gas token and the route's supported fee tokens,
+   * such as USDC, are accepted).
+   */ UNSUPPORTED_FEE_TOKEN: {
+        code: 1014,
+        name: 'INPUT_UNSUPPORTED_FEE_TOKEN',
+        type: 'INPUT'
+    },
+    /** Retry / resume is not supported by this provider for the given result */ RETRY_NOT_SUPPORTED: {
+        code: 1015,
+        name: 'INPUT_RETRY_NOT_SUPPORTED',
+        type: 'INPUT'
+    },
+    /** Bridge-step analysis for retry is not supported by this provider */ STEP_ANALYSIS_NOT_SUPPORTED: {
+        code: 1016,
+        name: 'INPUT_STEP_ANALYSIS_NOT_SUPPORTED',
+        type: 'INPUT'
+    },
+    /**
+   * A kit operation name collides with a reserved event-subscription
+   * method (`on` / `off`) at kit construction.
+   */ RESERVED_OPERATION_NAME: {
+        code: 1000,
+        name: 'INPUT_RESERVED_OPERATION_NAME',
+        type: 'INPUT'
+    },
+    /** A kit was constructed with a missing / undefined operation factory */ MISSING_OPERATION: {
+        code: 1017,
+        name: 'INPUT_MISSING_OPERATION',
+        type: 'INPUT'
+    },
     /** General validation failure for complex validation rules */ VALIDATION_FAILED: {
         code: 1098,
         name: 'INPUT_VALIDATION_FAILED',
@@ -936,8 +968,7 @@ class KitError extends Error {
         code: 8002,
         name: 'SERVICE_UNKNOWN_ERROR',
         type: 'SERVICE'
-    }
-};
+    }};
 
 /**
  * Creates error for unsupported swap route.
@@ -1164,7 +1195,7 @@ class KitError extends Error {
  * import { createValidationErrorFromZod } from '@core/errors'
  *
  * function validateBridgeParams(params: unknown): asserts params is BridgeParams {
- *   const result = bridgeParamsSchema.safeParse(params)
+ *   const result = usdcBridgeParamsSchema.safeParse(params)
  *   if (!result.success) {
  *     throw createValidationErrorFromZod(result.error, 'bridge parameters')
  *   }
@@ -2942,9 +2973,10 @@ class KitError extends Error {
     Blockchain["Algorand_Testnet"] = "Algorand_Testnet";
     Blockchain["Aptos"] = "Aptos";
     Blockchain["Aptos_Testnet"] = "Aptos_Testnet";
-    Blockchain["Arc_Testnet"] = "Arc_Testnet";
     Blockchain["Arbitrum"] = "Arbitrum";
     Blockchain["Arbitrum_Sepolia"] = "Arbitrum_Sepolia";
+    Blockchain["Arc"] = "Arc";
+    Blockchain["Arc_Testnet"] = "Arc_Testnet";
     Blockchain["Avalanche"] = "Avalanche";
     Blockchain["Avalanche_Fuji"] = "Avalanche_Fuji";
     Blockchain["Base"] = "Base";
@@ -3031,6 +3063,7 @@ var SwapChain;
     SwapChain["XDC"] = "XDC";
     SwapChain["HyperEVM"] = "HyperEVM";
     SwapChain["Monad"] = "Monad";
+    SwapChain["Arc"] = "Arc";
     // Testnet chains with swap support
     SwapChain["Arc_Testnet"] = "Arc_Testnet";
 })(SwapChain || (SwapChain = {}));
@@ -3038,6 +3071,7 @@ var BridgeChain;
 (function(BridgeChain) {
     // Mainnet chains with CCTPv2 support
     BridgeChain["Arbitrum"] = "Arbitrum";
+    BridgeChain["Arc"] = "Arc";
     BridgeChain["Avalanche"] = "Avalanche";
     BridgeChain["Base"] = "Base";
     BridgeChain["Codex"] = "Codex";
@@ -3093,6 +3127,7 @@ var BridgeChain;
 var UnifiedBalanceChain;
 (function(UnifiedBalanceChain) {
     // Mainnet chains with Gateway V1 support
+    UnifiedBalanceChain["Arc"] = "Arc";
     UnifiedBalanceChain["Arbitrum"] = "Arbitrum";
     UnifiedBalanceChain["Avalanche"] = "Avalanche";
     UnifiedBalanceChain["Base"] = "Base";
@@ -3122,6 +3157,7 @@ var UnifiedBalanceChain;
 })(UnifiedBalanceChain || (UnifiedBalanceChain = {}));
 var EarnChain;
 (function(EarnChain) {
+    EarnChain["Arc"] = "Arc";
     EarnChain["Arc_Testnet"] = "Arc_Testnet";
 })(EarnChain || (EarnChain = {}));
 /**
@@ -3138,8 +3174,11 @@ var EarnChain;
  * console.log(EARN_BRIDGE_SOURCE_BLOCKCHAINS.join(', '))
  * ```
  */ const EARN_BRIDGE_SOURCE_BLOCKCHAINS = [
+    "Arbitrum",
     "Arbitrum_Sepolia",
+    "Base",
     "Base_Sepolia",
+    "Ethereum",
     "Ethereum_Sepolia"
 ];
 /**
@@ -3153,6 +3192,7 @@ var EarnChain;
  * console.log(EARN_BRIDGE_DESTINATION_BLOCKCHAINS.join(', '))
  * ```
  */ const EARN_BRIDGE_DESTINATION_BLOCKCHAINS = [
+    "Arc",
     "Arc_Testnet"
 ];
 
@@ -3469,6 +3509,25 @@ var EarnChain;
  * EVM-compatible chains. Use this address when deploying or testing
  * cross-chain USDC transfers on test networks.
  */ const BRIDGE_CONTRACT_EVM_TESTNET = '0xC5567a5E3370d4DBfB0540025078e283e36A363d';
+/**
+ * The CrossChainTokenService (CCTPx) service address for EVM testnet networks.
+ *
+ * This service coordinates CCTPx cross-chain token operations on testnet
+ * environments and is shared by every EVM test network CCTPx supports. Read the
+ * chain definitions via `isCCTPXSupported` rather than trusting a list here,
+ * which goes stale as deployments land.
+ */ const CCTPX_SERVICE_ADDRESS_EVM_TESTNET = '0x63753E722bd2C2A5DF6EE19C5106662208B81077';
+/**
+ * CrossChainTokenService (CCTS) proxy address for CCTPx on EVM **mainnet**.
+ *
+ * @remarks
+ * A distinct deployment from {@link CCTPX_SERVICE_ADDRESS_EVM_TESTNET}, shared
+ * by every EVM mainnet chain that CCTPx supports. A chain becomes
+ * CCTPx-eligible only once its definition carries this as
+ * `cctpx.serviceAddress`, and a route additionally needs both of its endpoints
+ * eligible — so adding a chain here is the deliberate, reviewable step that
+ * opens mainnet CCTPx for it.
+ */ const CCTPX_SERVICE_ADDRESS_EVM_MAINNET = '0x431871229103b780868f8C6BB820cd16ECf942BC';
 /**
  * The bridge contract address for EVM mainnet networks.
  *
@@ -3577,6 +3636,76 @@ var EarnChain;
  * Identical across all testnet EVM destination chains.
  */ const GENERIC_EXECUTOR_EVM_TESTNET = '0xEdC81040756AcCfF070c21D37b265b9D0b5Ba45e';
 
+/**
+ * Arc Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Arc blockchain,
+ * Circle's EVM-compatible Layer-1 designed for stablecoin finance
+ * and asset tokenization. Arc uses USDC as the native gas token and
+ * features the Malachite Byzantine Fault Tolerant (BFT) consensus
+ * engine for sub-second finality.
+ */ const Arc = defineChain({
+    type: 'evm',
+    chain: Blockchain.Arc,
+    name: 'Arc',
+    title: 'Arc Mainnet',
+    nativeCurrency: {
+        name: 'USDC',
+        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
+        decimals: 18
+    },
+    chainId: 5042,
+    isTestnet: false,
+    explorerUrl: 'https://explorer.arc.io/tx/{hash}',
+    rpcEndpoints: [
+        'https://rpc.mainnet.arc.io/'
+    ],
+    eurcAddress: '0xbEf5f6d51CB62b58e6A8f77868681825C6fe21c1',
+    usdcAddress: '0x3600000000000000000000000000000000000000',
+    usdtAddress: null,
+    cctp: {
+        domain: 26,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 1,
+                fastConfirmations: 1
+            }
+        },
+        forwarderSupported: {
+            source: false,
+            destination: true
+        }
+    },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET
+    },
+    gateway: {
+        domain: 26,
+        contracts: {
+            v1: {
+                wallet: GATEWAY_WALLET_EVM_MAINNET,
+                minter: GATEWAY_MINTER_EVM_MAINNET,
+                depositForHandler: DEPOSIT_FOR_HANDLER_EVM_MAINNET,
+                genericExecutor: GENERIC_EXECUTOR_EVM_MAINNET
+            }
+        },
+        forwarderSupported: {
+            source: true,
+            destination: true
+        }
+    }
+});
+
 /**
  * Arc Testnet chain definition
  * @remarks
@@ -3624,6 +3753,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -3691,6 +3823,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -3756,6 +3891,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -3821,6 +3959,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -3888,6 +4029,9 @@ var EarnChain;
     rpcEndpoints: [
         'https://api.avax-test.network/ext/bc/C/rpc'
     ],
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET
     },
@@ -3955,6 +4099,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -4020,6 +4167,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -4412,6 +4562,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -4477,6 +4630,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -5308,6 +5464,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -5373,6 +5532,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET
     },
@@ -5768,6 +5930,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -5836,6 +6001,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET
     },
@@ -6844,6 +7012,7 @@ var Chains = /*#__PURE__*/Object.freeze({
   AptosTestnet: AptosTestnet,
   Arbitrum: Arbitrum,
   ArbitrumSepolia: ArbitrumSepolia,
+  Arc: Arc,
   ArcTestnet: ArcTestnet,
   Avalanche: Avalanche,
   AvalancheFuji: AvalancheFuji,
@@ -7101,6 +7270,7 @@ var Chains = /*#__PURE__*/Object.freeze({
     usdcAddress: z.string().nullable(),
     usdtAddress: z.string().nullable(),
     cctp: z.any().nullable(),
+    cctpx: z.any().optional(),
     kitContracts: z.object({
         bridge: z.string().optional(),
         adapter: z.string().optional()
@@ -7306,14 +7476,15 @@ const EARN_BRIDGE_DESTINATION_CHAIN_VALUES = EARN_BRIDGE_DESTINATION_BLOCKCHAINS
  * Zod schema for validating the source chain of a cross-chain Earn deposit.
  *
  * Accept a supported source Blockchain value, a matching string literal, or a
- * ChainDefinition for a supported source chain. Source chains are Ethereum
- * Sepolia, Arbitrum Sepolia, and Base Sepolia.
+ * ChainDefinition for a supported source chain. Source chains are Ethereum,
+ * Arbitrum, and Base (mainnet and testnet).
  *
  * @example
  * ```typescript
  * import { earnBridgeSourceChainIdentifierSchema } from '@core/chains'
  *
  * // Valid
+ * earnBridgeSourceChainIdentifierSchema.parse('Ethereum')
  * earnBridgeSourceChainIdentifierSchema.parse('Ethereum_Sepolia')
  *
  * // Invalid (throws ZodError)
@@ -7332,14 +7503,15 @@ const EARN_BRIDGE_DESTINATION_CHAIN_VALUES = EARN_BRIDGE_DESTINATION_BLOCKCHAINS
  * deposit.
  *
  * Accept a supported destination Blockchain value, a matching string literal,
- * or a ChainDefinition for a supported destination chain. Currently only Arc
- * Testnet is supported.
+ * or a ChainDefinition for a supported destination chain. Arc (mainnet) and
+ * Arc Testnet are supported.
  *
  * @example
  * ```typescript
  * import { earnBridgeDestinationChainIdentifierSchema } from '@core/chains'
  *
  * // Valid
+ * earnBridgeDestinationChainIdentifierSchema.parse('Arc')
  * earnBridgeDestinationChainIdentifierSchema.parse('Arc_Testnet')
  *
  * // Invalid (throws ZodError)
@@ -7517,7 +7689,10 @@ const swapTokenEnumSchema = z.enum([
  * Get decimal places for a supported swap token.
  *
  * @param token - Swap token symbol
- * @returns Number of decimals, or null for NATIVE (chain-specific)
+ * @returns Number of decimals; `null` for NATIVE (chain-specific) or when the
+ *   symbol is not in the swap registry. Callers must not read `null` as
+ *   "use the chain's native decimals" — for a CCTPx token that would scale
+ *   an 8-decimal amount as 18.
  *
  * @example
  * ```typescript
@@ -7529,6 +7704,15 @@ const swapTokenEnumSchema = z.enum([
  * ```
  */ function getSwapTokenDecimals(token) {
     if (token === NATIVE_TOKEN) return null;
+    // Membership is checked rather than assumed: callers reach this through
+    // `formatAmount`/`parseAmount` with a plain `string` token, so a value
+    // outside the registry (a provider's own symbol, or a bytes32 id) is
+    // reachable at runtime despite what the parameter type says. A bare index
+    // would throw a raw TypeError from inside the formatter; `null` lets the
+    // caller raise its own "could not determine decimals" error instead.
+    if (!Object.hasOwn(SWAP_TOKEN_REGISTRY, token)) {
+        return null;
+    }
     return SWAP_TOKEN_REGISTRY[token].decimals;
 }
 /**
@@ -8970,6 +9154,7 @@ const swapTokenEnumSchema = z.enum([
         // Mainnets (alphabetically sorted)
         // =========================================================================
         [Blockchain.Arbitrum]: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+        [Blockchain.Arc]: '0x3600000000000000000000000000000000000000',
         [Blockchain.Avalanche]: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',
         [Blockchain.Base]: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
         [Blockchain.Celo]: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
@@ -9084,6 +9269,7 @@ const swapTokenEnumSchema = z.enum([
         // =========================================================================
         // Mainnets
         // =========================================================================
+        [Blockchain.Arc]: '0xbEf5f6d51CB62b58e6A8f77868681825C6fe21c1',
         [Blockchain.Avalanche]: '0xc891EB4cbdEFf6e073e859e987815Ed1505c2ACD',
         [Blockchain.Base]: '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42',
         [Blockchain.Cronos]: '0xA6dE01a2d62C6B5f3525d768f34d276652C554c8',
@@ -9327,6 +9513,7 @@ const swapTokenEnumSchema = z.enum([
         // =========================================================================
         // Mainnets
         // =========================================================================
+        [Blockchain.Arc]: '0x171A4217b86A807A64eB94757Db6849fb4bDbAA0',
         [Blockchain.Ethereum]: '0x72DFB2E44f59C5AD2bAFE84314E5b99a7cd5075E',
         // =========================================================================
         // Testnets
@@ -9419,13 +9606,28 @@ const swapTokenEnumSchema = z.enum([
 }
 
 /**
- * Check if a selector is a raw token selector (object form).
+ * Type guard: narrows a {@link TokenSelector} to a {@link RawTokenSelector}.
  *
  * @param selector - The token selector to check.
- * @returns True if the selector is a raw token selector.
+ * @returns `true` if `selector` is a raw token selector (object with `locator`).
+ *
+ * @example
+ * ```typescript
+ * if (isRawSelector(selector)) {
+ *   console.log(selector.locator)
+ * }
+ * ```
  */ function isRawSelector(selector) {
-    return typeof selector === 'object' && 'locator' in selector;
+    // `typeof null === 'object'` (a JS quirk) and `'locator' in null`
+    // throws, so the explicit `null` check is required at this exported
+    // guard for JS consumers passing nullish values. The lint rule sees
+    // the parameter typed as `TokenSelector` (no null) and flags the
+    // check as unnecessary — disabled because the check IS necessary at
+    // runtime even though TypeScript can prove it dead statically.
+    return typeof selector === 'object' && // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    selector !== null && 'locator' in selector;
 }
+
 /**
  * Normalize a symbol to uppercase for case-insensitive lookup.
  *
@@ -9613,7 +9815,7 @@ const swapTokenEnumSchema = z.enum([
             if (typeof selector === 'string') {
                 return resolveSymbol(selector, chainId);
             }
-            throw createTokenResolutionError(`Invalid selector type: ${typeof selector}. Expected string or object with locator.`, selector, chainId);
+            throw createTokenResolutionError(`Invalid selector type: ${typeof selector}. Expected a token symbol or a raw selector (with locator).`, selector, chainId);
         },
         resolveByAddress (address, chainId) {
             if (!address || typeof address !== 'string') {
@@ -9735,9 +9937,17 @@ const swapTokenEnumSchema = z.enum([
  *
  * // Native token (chain-derived decimals)
  * formatAmount({ value: '3141592000000000000', token: 'NATIVE', chain: Ethereum }) // "3.141592"
+ *
+ * // Explicit decimals (skips all registry lookups)
+ * formatAmount({ value: '100000000', token: 'USDC', decimals: 8 }) // "1"
  * ```
  */ const formatAmount = (params)=>{
     const { value, token, tokens } = params;
+    // Explicit decimals win — used when the caller resolved decimals itself
+    // (e.g. through a provider) for a token outside the built-in registries.
+    if (params.decimals !== undefined) {
+        return formatUnits(value, params.decimals);
+    }
     // Handle NATIVE token first (chain-specific decimals)
     if (token === 'NATIVE') {
         if (params.chain === undefined) {
@@ -10347,7 +10557,7 @@ const swapTokenEnumSchema = z.enum([
 }
 
 var name$2 = "@circle-fin/bridge-kit";
-var version$2 = "1.14.1";
+var version$2 = "1.15.0";
 var pkg$2 = {
 	name: name$2,
 	version: version$2};
@@ -11046,7 +11256,72 @@ var TransferSpeed;
      */ recipientAddress: z.string().trim().min(1, 'Fee recipient must be a non-empty string').optional()
 }).strict();
 /**
- * Schema for validating bridge parameters.
+ * Factory for the bridge-params Zod schema, parameterized by the token
+ * validator. The base schema enforces all non-token fields (amount,
+ * source, destination, config); callers supply the Zod schema for the
+ * `token` field, allowing each provider to validate the token type it
+ * accepts.
+ *
+ * @param tokenSchema - Zod schema applied to the `token` field. Pass
+ *   `z.literal('USDC')` for USDC-only validation, or any
+ *   provider-specific schema (e.g. a `0x`-prefixed hex regex) for
+ *   providers that accept a different token type.
+ * @param config - Required. `maxDecimals` caps the decimal precision
+ *   permitted in `amount` and `config.maxFee`. Pass the widest value
+ *   any of the provider's tokens require — `6` for USDC-only, `18`
+ *   for an ERC-20 family that includes wETH, etc. The schema is a
+ *   coarse syntactic gate; narrower per-token precision is enforced
+ *   by the provider downstream.
+ * @returns A Zod object schema whose `token` field is validated by
+ *   `tokenSchema` and whose other fields (`amount`, `source`,
+ *   `destination`, `config`) are validated against the shared bridge
+ *   contract. Use `.safeParse` / `.parse` directly, or feed the schema
+ *   to {@link parseOrThrow} from `@core/utils` to surface validation
+ *   failures as `KitError` with the canonical
+ *   `INPUT_VALIDATION_FAILED` code.
+ *
+ * @example
+ * ```typescript
+ * import { createBridgeParamsSchema, z } from '@core/provider'
+ *
+ * const usdcSchema = createBridgeParamsSchema(z.literal('USDC'), { maxDecimals: 6 })
+ * const hexSchema = createBridgeParamsSchema(
+ *   z.string().regex(/^0x[0-9a-fA-F]{64}$/),
+ *   { maxDecimals: 18 },
+ * )
+ * ```
+ */ // The full inferred return type of `z.object({...})` here is
+// effectively impossible to spell out by hand without re-stating every
+// field's schema. TypeScript infers it from the body — callers receive
+// a precise Zod schema type via inference, and the explicit-return
+// rules are disabled for that reason.
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+function createBridgeParamsSchema(tokenSchema, config) {
+    const { maxDecimals } = config;
+    return z.object({
+        amount: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
+            allowZero: false,
+            regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
+            attributeName: 'amount',
+            maxDecimals
+        })(z.string())),
+        source: walletContextSchema,
+        destination: bridgeDestinationSchema$1,
+        token: tokenSchema,
+        config: z.object({
+            transferSpeed: z.nativeEnum(TransferSpeed).optional(),
+            maxFee: z.string().pipe(createDecimalStringValidator({
+                allowZero: true,
+                regexMessage: MAX_FEE_FORMAT_ERROR_MESSAGE,
+                attributeName: 'maxFee',
+                maxDecimals
+            })(z.string())).optional(),
+            customFee: customFeeSchema.optional()
+        })
+    });
+}
+/**
+ * Schema for validating bridge parameters with USDC as the token.
  * This ensures all required fields are present and properly typed.
  * A bridge must include:
  * - A valid amount (non-empty numeric string \> 0)
@@ -11054,11 +11329,15 @@ var TransferSpeed;
  * - USDC as the token
  * - Optional config with transfer speed and max fee settings
  *
+ * Providers that accept a non-USDC token type should call
+ * {@link createBridgeParamsSchema} with their own token schema rather
+ * than reusing this constant.
+ *
  * @throws KitError if validation fails
  *
  * @example
  * ```typescript
- * import { bridgeParamsSchema } from '@core/provider'
+ * import { usdcBridgeParamsSchema } from '@core/provider'
  *
  * const validBridge = {
  *   amount: '100.50',
@@ -11083,175 +11362,43 @@ var TransferSpeed;
  *   }
  * }
  *
- * const result = bridgeParamsSchema.safeParse(validBridge)
+ * const result = usdcBridgeParamsSchema.safeParse(validBridge)
  * console.log(result.success) // true
  * ```
- */ z.object({
-    amount: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
-        allowZero: false,
-        regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
-        attributeName: 'amount',
-        maxDecimals: 6
-    })(z.string())),
-    source: walletContextSchema,
-    destination: bridgeDestinationSchema$1,
-    token: z.literal('USDC'),
-    config: z.object({
-        transferSpeed: z.nativeEnum(TransferSpeed).optional(),
-        maxFee: z.string().pipe(createDecimalStringValidator({
-            allowZero: true,
-            regexMessage: MAX_FEE_FORMAT_ERROR_MESSAGE,
-            attributeName: 'maxFee',
-            maxDecimals: 6
-        })(z.string())).optional(),
-        customFee: customFeeSchema.optional()
-    })
+ */ createBridgeParamsSchema(z.literal('USDC'), {
+    maxDecimals: 6
 });
 
-/**
- * Creates a Zod superRefine validator for recipient address format validation.
- * Validates that the address format matches the expected format for the chain type.
- *
- * @returns A superRefine function that validates recipientAddress against chain type
- */ function createRecipientAddressValidator() {
-    return (data, ctx)=>{
-        const chain = data.chain;
-        if (chain === null) {
-            return;
-        }
-        if (!isValidAddressForChain(data.recipientAddress, chain)) {
-            const chainInfo = extractChainInfo(chain);
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: [
-                    'recipientAddress'
-                ],
-                message: `Invalid address format for ${String(chainInfo.name)}. Expected ${chainInfo.expectedAddressFormat}, but received: ${data.recipientAddress}`
-            });
-        }
-    };
-}
-/**
- * Schema for validating AdapterContext for bridge operations.
- * Must always contain both adapter and chain explicitly.
- *
- * Optionally includes address for developer-controlled adapters.
- */ const adapterContextSchema$3 = z.object({
-    adapter: adapterSchema,
-    chain: bridgeChainIdentifierSchema,
-    address: z.string().optional()
-});
-/**
- * Schema for validating BridgeDestinationWithAddress objects.
- * Contains an explicit recipientAddress along with adapter and chain.
- * The address format is validated based on the chain type (EVM or Solana).
- */ const bridgeDestinationWithAddressSchema = adapterContextSchema$3.extend({
-    recipientAddress: z.string().min(1, 'Recipient address is required'),
-    useForwarder: z.boolean().optional()
-}).superRefine(createRecipientAddressValidator());
-/**
- * Schema for validating AdapterContext with optional useForwarder.
- * Extends adapterContextSchema with the useForwarder flag.
- */ const adapterContextWithForwarderSchema = adapterContextSchema$3.extend({
-    useForwarder: z.boolean().optional()
-});
-/**
- * Schema for validating ForwarderDestination objects.
- * Used when useForwarder is true and no adapter is provided.
- * Requires chain, recipientAddress, and useForwarder: true.
- *
- * When using this destination type:
- * - The mint step completes when the IRIS API confirms forwardState === 'CONFIRMED'
- * - No on-chain transaction confirmation is performed (no adapter available)
- * - The mint step's data field will be undefined (no transaction receipt)
- */ const forwarderDestinationSchema = z.object({
-    chain: bridgeChainIdentifierSchema,
-    recipientAddress: z.string().min(1, 'Recipient address is required'),
-    useForwarder: z.literal(true)
-}).strict().superRefine(createRecipientAddressValidator());
-/**
- * Schema for validating BridgeDestination union type.
- * Supports three destination configurations:
- * - BridgeDestinationWithAddress (adapter with explicit recipient)
- * - ForwarderDestination (no adapter, requires useForwarder: true and recipientAddress)
- * - AdapterContext with optional useForwarder (adapter for default recipient)
- *
- * When using ForwarderDestination (no adapter):
- * - The mint step completes when the IRIS API confirms forwardState === 'CONFIRMED'
- * - No on-chain transaction confirmation is performed
- *
- * The order matters: we check the more specific schemas first.
- * This ensures that objects with specific fields are matched correctly.
- */ const bridgeDestinationSchema = z.union([
-    bridgeDestinationWithAddressSchema,
-    forwarderDestinationSchema,
-    adapterContextWithForwarderSchema.strict()
-]);
-/**
- * Schema for validating bridge parameters with chain identifiers.
- * This extends the core provider's schema but adapts it for the bridge kit's
- * more flexible interface that accepts chain identifiers.
- *
- * The schema validates:
- * - From adapter context (must always include both adapter and chain)
- * - To bridge destination (AdapterContext or BridgeDestinationWithAddress)
- * - Amount is a non-empty numeric string \> 0
- * - Token is optional and defaults to 'USDC'
- * - Optional config parameters (transfer speed, max fee)
- *
- * @example
- * ```typescript
- * import { bridgeParamsWithChainIdentifierSchema } from '@circle-fin/bridge-kit'
- *
- * const params = {
- *   from: {
- *     adapter: sourceAdapter,
- *     chain: 'Ethereum'
- *   },
- *   to: {
- *     adapter: destAdapter,
- *     chain: 'Base'
- *   },
- *   amount: '100.50',
- *   token: 'USDC',
- *   config: {
- *     transferSpeed: 'FAST'
- *   }
- * }
- *
- * const result = bridgeParamsWithChainIdentifierSchema.safeParse(params)
- * if (result.success) {
- *   console.log('Parameters are valid')
- * } else {
- *   console.error('Validation failed:', result.error)
- * }
- * ```
- */ z.object({
-    from: adapterContextSchema$3.strict(),
-    to: bridgeDestinationSchema,
-    amount: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
-        allowZero: false,
-        regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
-        attributeName: 'amount',
-        maxDecimals: 6
-    })(z.string())),
-    token: z.literal('USDC').optional(),
-    config: z.object({
-        transferSpeed: z.nativeEnum(TransferSpeed).optional(),
-        feePayment: z.enum([
-            'source',
-            'destination'
-        ]).optional(),
-        maxFee: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
-            allowZero: true,
-            regexMessage: MAX_FEE_FORMAT_ERROR_MESSAGE,
-            attributeName: 'maxFee',
-            maxDecimals: 6
-        })(z.string())).optional(),
-        customFee: customFeeSchema.optional()
-    }).optional(),
-    quote: z.string().regex(/^0x([a-fA-F0-9]{2})+$/, 'must be non-empty 0x hex').optional()
-});
+// ----------------------------------------------------------------------------
+// IRIS API base URLs
+// ----------------------------------------------------------------------------
+// ----------------------------------------------------------------------------
+// Known token symbols (DX convenience)
+// ----------------------------------------------------------------------------
+//
+// These constants back symbol -> id resolution as a convenience: a caller may
+// pass a known symbol instead of a raw bytes32 id. They do NOT gate
+// routability.
+/**
+ * Display symbols the provider recognizes as a convenience for callers.
+ *
+ * A consumer may pass one of these symbols instead of a raw bytes32 token
+ * id; the provider resolves it to the symbol's canonical bytes32 id via
+ * {@link KNOWN_TOKEN_IDS_BY_NETWORK} (a symbol can map to more than one
+ * bridge, so the map pins the canonical one). This list does NOT gate
+ * routability: any token the IRIS registry lists with deployments on both
+ * endpoints routes when passed by its bytes32 id, whether listed here or
+ * not.
+ *
+ * @example
+ * ```typescript
+ * for (const symbol of KNOWN_TOKEN_SYMBOLS) console.log(symbol)
+ * ```
+ */ const KNOWN_TOKEN_SYMBOLS = [
+    'cirBTC',
+    'wETH',
+    'EURC'
+];
 
 /**
  * Define a schema for runtime logger interfaces.
@@ -11626,6 +11773,186 @@ var TransferSpeed;
     clock: z.any().optional()
 }).passthrough();
 
+/**
+ * Creates a Zod superRefine validator for recipient address format validation.
+ * Validates that the address format matches the expected format for the chain type.
+ *
+ * @returns A superRefine function that validates recipientAddress against chain type
+ */ function createRecipientAddressValidator() {
+    return (data, ctx)=>{
+        const chain = data.chain;
+        if (chain === null) {
+            return;
+        }
+        if (!isValidAddressForChain(data.recipientAddress, chain)) {
+            const chainInfo = extractChainInfo(chain);
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [
+                    'recipientAddress'
+                ],
+                message: `Invalid address format for ${String(chainInfo.name)}. Expected ${chainInfo.expectedAddressFormat}, but received: ${data.recipientAddress}`
+            });
+        }
+    };
+}
+/**
+ * Schema for `BridgeParams.token`.
+ *
+ * Accept `'USDC'`, a symbol from {@link KNOWN_TOKEN_SYMBOLS}, or a bytes32 id
+ * (`0x` plus exactly 64 hex characters). Reject unknown symbols, malformed ids,
+ * and `{ provider, id }` objects. A custom extra provider cannot introduce a
+ * new symbol through this field — only a bytes32 id.
+ *
+ * Omit the field to default to `'USDC'`.
+ */ const bridgeTokenSchema = z.union([
+    z.enum([
+        'USDC',
+        ...KNOWN_TOKEN_SYMBOLS
+    ]),
+    z.string().regex(/^0x[0-9a-fA-F]{64}$/, 'Token id must be a bytes32 (0x-prefixed, 64 hex chars)')
+]);
+/**
+ * Schema for validating AdapterContext for bridge operations.
+ * Must always contain both adapter and chain explicitly.
+ *
+ * Optionally includes address for developer-controlled adapters.
+ */ const adapterContextSchema$3 = z.object({
+    adapter: adapterSchema,
+    chain: bridgeChainIdentifierSchema,
+    address: z.string().optional()
+});
+/**
+ * Schema for validating BridgeDestinationWithAddress objects.
+ * Contains an explicit recipientAddress along with adapter and chain.
+ * The address format is validated based on the chain type (EVM or Solana).
+ */ const bridgeDestinationWithAddressSchema = adapterContextSchema$3.extend({
+    recipientAddress: z.string().min(1, 'Recipient address is required'),
+    useForwarder: z.boolean().optional()
+}).superRefine(createRecipientAddressValidator());
+/**
+ * Schema for validating AdapterContext with optional useForwarder.
+ * Extends adapterContextSchema with the useForwarder flag.
+ */ const adapterContextWithForwarderSchema = adapterContextSchema$3.extend({
+    useForwarder: z.boolean().optional()
+});
+/**
+ * Schema for validating ForwarderDestination objects.
+ * Used when useForwarder is true and no adapter is provided.
+ * Requires chain, recipientAddress, and useForwarder: true.
+ *
+ * When using this destination type:
+ * - The mint step completes when the IRIS API confirms forwardState === 'CONFIRMED'
+ * - No on-chain transaction confirmation is performed (no adapter available)
+ * - The mint step's data field will be undefined (no transaction receipt)
+ */ const forwarderDestinationSchema = z.object({
+    chain: bridgeChainIdentifierSchema,
+    recipientAddress: z.string().min(1, 'Recipient address is required'),
+    useForwarder: z.literal(true)
+}).strict().superRefine(createRecipientAddressValidator());
+/**
+ * Schema for validating BridgeDestination union type.
+ * Supports three destination configurations:
+ * - BridgeDestinationWithAddress (adapter with explicit recipient)
+ * - ForwarderDestination (no adapter, requires useForwarder: true and recipientAddress)
+ * - AdapterContext with optional useForwarder (adapter for default recipient)
+ *
+ * When using ForwarderDestination (no adapter):
+ * - The mint step completes when the IRIS API confirms forwardState === 'CONFIRMED'
+ * - No on-chain transaction confirmation is performed
+ *
+ * The order matters: we check the more specific schemas first.
+ * This ensures that objects with specific fields are matched correctly.
+ */ const bridgeDestinationSchema = z.union([
+    bridgeDestinationWithAddressSchema,
+    forwarderDestinationSchema,
+    adapterContextWithForwarderSchema.strict()
+]);
+/**
+ * Schema for validating bridge parameters with chain identifiers.
+ * This extends the core provider's schema but adapts it for the bridge kit's
+ * more flexible interface that accepts chain identifiers.
+ *
+ * The schema validates:
+ * - From adapter context (must always include both adapter and chain)
+ * - To bridge destination (AdapterContext or BridgeDestinationWithAddress)
+ * - Amount is a non-empty numeric string \> 0
+ * - Token is optional and defaults to 'USDC'
+ * - Optional config parameters (transfer speed, max fee)
+ *
+ * @example
+ * ```typescript
+ * import { bridgeParamsWithChainIdentifierSchema } from '@circle-fin/bridge-kit'
+ *
+ * const params = {
+ *   from: {
+ *     adapter: sourceAdapter,
+ *     chain: 'Ethereum'
+ *   },
+ *   to: {
+ *     adapter: destAdapter,
+ *     chain: 'Base'
+ *   },
+ *   amount: '100.50',
+ *   token: 'USDC',
+ *   config: {
+ *     transferSpeed: 'FAST'
+ *   }
+ * }
+ *
+ * const result = bridgeParamsWithChainIdentifierSchema.safeParse(params)
+ * if (result.success) {
+ *   console.log('Parameters are valid')
+ * } else {
+ *   console.error('Validation failed:', result.error)
+ * }
+ * ```
+ */ z.object({
+    from: adapterContextSchema$3.strict(),
+    to: bridgeDestinationSchema,
+    amount: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
+        allowZero: false,
+        regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
+        attributeName: 'amount',
+        // Widest precision any routable token needs (wETH = 18). This gate is
+        // token-agnostic and runs before the route provider is known, so it
+        // can only cap coarsely; the token's exact precision is enforced later
+        // at the scaling boundary (`BridgeKit.scaleResolvedAmount`). USDC (6)
+        // and every narrower token stay valid.
+        maxDecimals: 18
+    })(z.string())),
+    token: bridgeTokenSchema.optional(),
+    config: z.object({
+        transferSpeed: z.nativeEnum(TransferSpeed).optional(),
+        feePayment: z.enum([
+            'source',
+            'destination'
+        ]).optional(),
+        maxFee: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
+            allowZero: true,
+            regexMessage: MAX_FEE_FORMAT_ERROR_MESSAGE,
+            attributeName: 'maxFee',
+            // See `amount` above: widest routable precision (18); the exact
+            // per-token precision is enforced at the scaling boundary.
+            maxDecimals: 18
+        })(z.string())).optional(),
+        customFee: customFeeSchema.optional()
+    }).optional(),
+    // Top-level (not nested under `config`) to mirror `BridgeParams.quote`.
+    //
+    // `z.unknown()` rather than a shape: the quote belongs to whichever provider
+    // issued it, and a route is matched to a provider only after these
+    // parameters are validated, so there is no one shape to check here.
+    //
+    // It also keeps the value intact. This object strips unknown keys, so a
+    // nested `z.object()` would clone the quote and drop every key not listed —
+    // losing a field the issuing provider added, between `estimate` and
+    // `bridge`. Shape is checked where the quote is consumed instead: CCTPx
+    // against its own envelope schema, and the receive-exact path in
+    // `sourceFees.ts` before it calls the Fee Service.
+    quote: z.unknown().optional()
+});
+
 /**
  * The ASCII "cctp-forward" magic, hex-encoded (no `0x`), that a forward-friendly
  * hookData must start with.
@@ -11865,7 +12192,7 @@ const validateQuoteItemSchema = z.object({
 registerKit(`${pkg$2.name}/${pkg$2.version}`);
 
 var name$1 = "@circle-fin/swap-kit";
-var version$1 = "1.6.1";
+var version$1 = "1.7.0";
 var pkg$1 = {
 	name: name$1,
 	version: version$1};
@@ -15126,6 +15453,11 @@ function resolveFeePayoutChain(tokenIn, tokenOut, sourceChain, destinationChain)
         name: 'USDC',
         version: '2'
     },
+    Arc: {
+        chainId: Arc.chainId,
+        name: 'USDC',
+        version: '2'
+    },
     Arc_Testnet: {
         chainId: ArcTestnet.chainId,
         name: 'USDC',
@@ -22237,7 +22569,7 @@ registerKit(`${pkg$1.name}/${pkg$1.version}`);
 };
 
 var name = "@circle-fin/earn-kit";
-var version = "1.6.1";
+var version = "1.7.0";
 var pkg = {
 	name: name,
 	version: version};
@@ -22252,18 +22584,22 @@ var pkg = {
  *
  * @internal
  */ const CHAIN_TO_API = {
+    [Blockchain.Arc]: 'ARC',
     [Blockchain.Arc_Testnet]: 'ARC-TESTNET'
 };
 /**
  * Map SDK source chain identifiers to bridge source-chain strings.
  *
- * Cross-chain Earn deposits currently support Ethereum Sepolia, Arbitrum
- * Sepolia, and Base Sepolia as source chains.
+ * Cross-chain Earn deposits support Ethereum, Arbitrum, and Base (mainnet
+ * and testnet) as source chains.
  *
  * @internal
  */ ({
+    [Blockchain.Arbitrum]: 'ARB',
     [Blockchain.Arbitrum_Sepolia]: 'ARB-SEPOLIA',
+    [Blockchain.Base]: 'BASE',
     [Blockchain.Base_Sepolia]: 'BASE-SEPOLIA',
+    [Blockchain.Ethereum]: 'ETH',
     [Blockchain.Ethereum_Sepolia]: 'ETH-SEPOLIA'
 });
 /**
@@ -22274,13 +22610,20 @@ var pkg = {
  *
  * @internal
  */ ({
+    [Blockchain.Arc]: CHAIN_TO_API[Blockchain.Arc],
     [Blockchain.Arc_Testnet]: CHAIN_TO_API[Blockchain.Arc_Testnet]
 });
 ({
+    [Blockchain.Arbitrum]: {
+        },
     [Blockchain.Arbitrum_Sepolia]: {
         },
+    [Blockchain.Base]: {
+        },
     [Blockchain.Base_Sepolia]: {
         },
+    [Blockchain.Ethereum]: {
+        },
     [Blockchain.Ethereum_Sepolia]: {
         }
 });