@circle-fin/bridge-kit 1.5.0 → 1.6.1

package/chains.cjs

@@ -95,6 +95,122 @@ var Blockchain;
     Blockchain["ZKSync_Era"] = "ZKSync_Era";
     Blockchain["ZKSync_Sepolia"] = "ZKSync_Sepolia";
 })(Blockchain || (Blockchain = {}));
+/**
+ * Enum representing the subset of {@link Blockchain} that supports swap operations.
+ *
+ * This enum provides compile-time type safety for swap chain selection,
+ * ensuring only supported chains are available in IDE autocomplete
+ * when building swap parameters.
+ *
+ * @remarks
+ * Unlike the full {@link Blockchain} enum, SwapChain only includes networks
+ * where the swap functionality is actively supported by the library.
+ * Using this enum prevents runtime errors from attempting unsupported
+ * cross-chain swaps.
+ *
+ * Currently supports:
+ * - Ethereum mainnet
+ * - Base mainnet
+ * - Polygon mainnet
+ * - Solana mainnet
+ *
+ * @example
+ * ```typescript
+ * import { SwapChain, swap, createSwapKitContext } from '@circle-fin/swap-kit'
+ * import { createViemAdapterFromPrivateKey } from '@circle-fin/adapter-viem-v2'
+ *
+ * const context = createSwapKitContext()
+ * const adapter = createViemAdapterFromPrivateKey({
+ *   privateKey: process.env.PRIVATE_KEY
+ * })
+ *
+ * // ✅ Autocomplete shows only swap-supported chains
+ * const result = await swap(context, {
+ *   from: {
+ *     adapter,
+ *     chain: SwapChain.Ethereum // Autocomplete: Ethereum, Base, Polygon, Solana
+ *   },
+ *   tokenIn: 'USDC',
+ *   tokenOut: 'USDT',
+ *   amount: '100.0'
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // String literals also work (constrained to SwapChain values)
+ * const result = await swap(context, {
+ *   from: {
+ *     adapter,
+ *     chain: 'Ethereum' // ✅ Only SwapChain strings allowed
+ *   },
+ *   tokenIn: 'USDC',
+ *   tokenOut: 'NATIVE',
+ *   amount: '50.0'
+ * })
+ *
+ * // ❌ TypeScript error - Sui not in SwapChain enum
+ * const invalidResult = await swap(context, {
+ *   from: {
+ *     adapter,
+ *     chain: 'Sui' // Compile-time error!
+ *   },
+ *   tokenIn: 'USDC',
+ *   tokenOut: 'USDT',
+ *   amount: '100.0'
+ * })
+ * ```
+ */
+/**
+ * Enum representing chains that support same-chain swaps through the Swap Kit.
+ *
+ * Unlike the full {@link Blockchain} enum, SwapChain includes only mainnet
+ * networks where adapter contracts are deployed (CCTPv2 support).
+ *
+ * Dynamic validation via {@link isSwapSupportedChain} ensures chains
+ * automatically work when adapter contracts and supported tokens are deployed.
+ *
+ * @example
+ * ```typescript
+ * import { SwapChain } from '@core/chains'
+ * import { swap } from '@circle-fin/swap-kit'
+ *
+ * const result = await swap(context, {
+ *   from: {
+ *     adapter,
+ *     chain: SwapChain.Arbitrum  // Now supported!
+ *   },
+ *   tokenIn: 'USDC',
+ *   tokenOut: 'WETH',
+ *   amount: '100.0'
+ * })
+ * ```
+ *
+ * @see {@link isSwapSupportedChain} for runtime validation
+ * @see {@link getSwapSupportedChains} for all supported chains
+ */
+var SwapChain;
+(function (SwapChain) {
+    // Original 4 chains
+    SwapChain["Ethereum"] = "Ethereum";
+    SwapChain["Base"] = "Base";
+    SwapChain["Polygon"] = "Polygon";
+    SwapChain["Solana"] = "Solana";
+    // Additional supported chains
+    SwapChain["Arbitrum"] = "Arbitrum";
+    SwapChain["Optimism"] = "Optimism";
+    SwapChain["Avalanche"] = "Avalanche";
+    SwapChain["Linea"] = "Linea";
+    SwapChain["Ink"] = "Ink";
+    SwapChain["World_Chain"] = "World_Chain";
+    SwapChain["Unichain"] = "Unichain";
+    SwapChain["Plume"] = "Plume";
+    SwapChain["Sei"] = "Sei";
+    SwapChain["Sonic"] = "Sonic";
+    SwapChain["XDC"] = "XDC";
+    SwapChain["HyperEVM"] = "HyperEVM";
+    SwapChain["Monad"] = "Monad";
+})(SwapChain || (SwapChain = {}));
 // -----------------------------------------------------------------------------
 // Bridge Chain Enum (CCTPv2 Supported Chains)
 // -----------------------------------------------------------------------------
@@ -246,6 +362,7 @@ defineChain({
     rpcEndpoints: ['https://mainnet-api.algonode.cloud'],
     eurcAddress: null,
     usdcAddress: '31566704',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -269,6 +386,7 @@ defineChain({
     rpcEndpoints: ['https://testnet-api.algonode.cloud'],
     eurcAddress: null,
     usdcAddress: '10458941',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -292,6 +410,7 @@ defineChain({
     rpcEndpoints: ['https://fullnode.mainnet.aptoslabs.com/v1'],
     eurcAddress: null,
     usdcAddress: '0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b',
+    usdtAddress: '0x357b0b74bc833e95a115ad22604854d6b0fca151cecd94111770e5d6ffc9dc2b',
     cctp: {
         domain: 9,
         contracts: {
@@ -302,6 +421,10 @@ defineChain({
                 confirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
     },
 });
 
@@ -325,6 +448,7 @@ defineChain({
     rpcEndpoints: ['https://fullnode.testnet.aptoslabs.com/v1'],
     eurcAddress: null,
     usdcAddress: '0x69091fbab5f7d635ee7ac5098cf0c1efbe31d68fec0f2cd565e8d168daf52832',
+    usdtAddress: null,
     cctp: {
         domain: 9,
         contracts: {
@@ -335,9 +459,128 @@ defineChain({
                 confirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
     },
 });
 
+/**
+ * Complete swap token registry - single source of truth for all swap-supported tokens.
+ *
+ * @remarks
+ * All packages should import from this registry for swap operations.
+ * Adding a new swap token requires updating only this registry.
+ *
+ * The NATIVE token is handled separately as it resolves dynamically based on chain.
+ *
+ * @example
+ * ```typescript
+ * import { SWAP_TOKEN_REGISTRY } from '@core/chains'
+ *
+ * // Get token decimals
+ * const decimals = SWAP_TOKEN_REGISTRY.USDC.decimals  // 6
+ *
+ * // Check if token is stablecoin
+ * const isStable = SWAP_TOKEN_REGISTRY.DAI.category === 'stablecoin'  // true
+ * ```
+ */
+const SWAP_TOKEN_REGISTRY = {
+    // ============================================================================
+    // Stablecoins (6 decimals)
+    // ============================================================================
+    USDC: {
+        symbol: 'USDC',
+        decimals: 6,
+        category: 'stablecoin',
+        description: 'USD Coin',
+    },
+    EURC: {
+        symbol: 'EURC',
+        decimals: 6,
+        category: 'stablecoin',
+        description: 'Euro Coin',
+    },
+    USDT: {
+        symbol: 'USDT',
+        decimals: 6,
+        category: 'stablecoin',
+        description: 'Tether USD',
+    },
+    PYUSD: {
+        symbol: 'PYUSD',
+        decimals: 6,
+        category: 'stablecoin',
+        description: 'PayPal USD',
+    },
+    // ============================================================================
+    // Stablecoins (18 decimals)
+    // ============================================================================
+    DAI: {
+        symbol: 'DAI',
+        decimals: 18,
+        category: 'stablecoin',
+        description: 'MakerDAO stablecoin',
+    },
+    USDE: {
+        symbol: 'USDE',
+        decimals: 18,
+        category: 'stablecoin',
+        description: 'Ethena USD (synthetic dollar)',
+    },
+    // ============================================================================
+    // Wrapped Tokens
+    // ============================================================================
+    WBTC: {
+        symbol: 'WBTC',
+        decimals: 8,
+        category: 'wrapped',
+        description: 'Wrapped Bitcoin',
+    },
+    WETH: {
+        symbol: 'WETH',
+        decimals: 18,
+        category: 'wrapped',
+        description: 'Wrapped Ethereum',
+    },
+    WSOL: {
+        symbol: 'WSOL',
+        decimals: 9,
+        category: 'wrapped',
+        description: 'Wrapped Solana',
+    },
+    WAVAX: {
+        symbol: 'WAVAX',
+        decimals: 18,
+        category: 'wrapped',
+        description: 'Wrapped Avalanche',
+    },
+    WPOL: {
+        symbol: 'WPOL',
+        decimals: 18,
+        category: 'wrapped',
+        description: 'Wrapped Polygon',
+    },
+};
+/**
+ * Special NATIVE token constant for swap operations.
+ *
+ * @remarks
+ * NATIVE is handled separately from SWAP_TOKEN_REGISTRY because it resolves
+ * dynamically based on the chain (ETH on Ethereum, SOL on Solana, etc.).
+ * Its decimals are chain-specific.
+ */
+const NATIVE_TOKEN = 'NATIVE';
+/**
+ * Array of all supported swap token symbols including NATIVE.
+ * Useful for iteration, validation, and filtering.
+ */
+[
+    ...Object.keys(SWAP_TOKEN_REGISTRY),
+    NATIVE_TOKEN,
+];
+
 /**
  * The bridge contract address for EVM testnet networks.
  *
@@ -354,6 +597,13 @@ const BRIDGE_CONTRACT_EVM_TESTNET = '0xC5567a5E3370d4DBfB0540025078e283e36A363d'
  * USDC transfers on live networks.
  */
 const BRIDGE_CONTRACT_EVM_MAINNET = '0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0';
+/**
+ * The adapter contract address for EVM mainnet networks.
+ *
+ * This contract serves as an adapter for integrating with various protocols
+ * on EVM-compatible chains. Use this address for mainnet adapter integrations.
+ */
+const ADAPTER_CONTRACT_EVM_MAINNET = '0x7FB8c7260b63934d8da38aF902f87ae6e284a845';
 
 /**
  * Arc Testnet chain definition
@@ -383,6 +633,7 @@ const ArcTestnet = defineChain({
     rpcEndpoints: ['https://rpc.testnet.arc.network/'],
     eurcAddress: '0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a',
     usdcAddress: '0x3600000000000000000000000000000000000000',
+    usdtAddress: null,
     cctp: {
         domain: 26,
         contracts: {
@@ -394,6 +645,10 @@ const ArcTestnet = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -421,6 +676,7 @@ const Arbitrum = defineChain({
     rpcEndpoints: ['https://arb1.arbitrum.io/rpc'],
     eurcAddress: null,
     usdcAddress: '0xaf88d065e77c8cc2239327c5edb3a432268e5831',
+    usdtAddress: null,
     cctp: {
         domain: 3,
         contracts: {
@@ -438,9 +694,14 @@ const Arbitrum = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -465,6 +726,7 @@ const ArbitrumSepolia = defineChain({
     rpcEndpoints: ['https://sepolia-rollup.arbitrum.io/rpc'],
     eurcAddress: null,
     usdcAddress: '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d',
+    usdtAddress: null,
     cctp: {
         domain: 3,
         contracts: {
@@ -482,6 +744,10 @@ const ArbitrumSepolia = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -509,6 +775,7 @@ const Avalanche = defineChain({
     rpcEndpoints: ['https://api.avax.network/ext/bc/C/rpc'],
     eurcAddress: '0xc891eb4cbdeff6e073e859e987815ed1505c2acd',
     usdcAddress: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',
+    usdtAddress: '0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7',
     cctp: {
         domain: 1,
         contracts: {
@@ -526,9 +793,14 @@ const Avalanche = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -552,6 +824,7 @@ const AvalancheFuji = defineChain({
     explorerUrl: 'https://subnets-test.avax.network/c-chain/tx/{hash}',
     eurcAddress: '0x5e44db7996c682e92a960b65ac713a54ad815c6b',
     usdcAddress: '0x5425890298aed601595a70ab815c96711a31bc65',
+    usdtAddress: null,
     cctp: {
         domain: 1,
         contracts: {
@@ -569,6 +842,10 @@ const AvalancheFuji = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     rpcEndpoints: ['https://api.avax-test.network/ext/bc/C/rpc'],
     kitContracts: {
@@ -597,6 +874,7 @@ const Base = defineChain({
     rpcEndpoints: ['https://mainnet.base.org', 'https://base.publicnode.com'],
     eurcAddress: '0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42',
     usdcAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    usdtAddress: null,
     cctp: {
         domain: 6,
         contracts: {
@@ -614,9 +892,14 @@ const Base = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -641,6 +924,7 @@ const BaseSepolia = defineChain({
     rpcEndpoints: ['https://sepolia.base.org'],
     eurcAddress: '0x808456652fdb597867f38412077A9182bf77359F',
     usdcAddress: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+    usdtAddress: null,
     cctp: {
         domain: 6,
         contracts: {
@@ -658,6 +942,10 @@ const BaseSepolia = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -685,6 +973,7 @@ defineChain({
     rpcEndpoints: ['https://forno.celo.org'],
     eurcAddress: null,
     usdcAddress: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
+    usdtAddress: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
     cctp: null,
 });
 
@@ -709,6 +998,7 @@ defineChain({
     rpcEndpoints: ['https://alfajores-forno.celo-testnet.org'],
     eurcAddress: null,
     usdcAddress: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -733,6 +1023,7 @@ const Codex = defineChain({
     rpcEndpoints: ['https://rpc.codex.xyz'],
     eurcAddress: null,
     usdcAddress: '0xd996633a415985DBd7D6D12f4A4343E31f5037cf',
+    usdtAddress: null,
     cctp: {
         domain: 12,
         contracts: {
@@ -744,6 +1035,10 @@ const Codex = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: false,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
@@ -771,6 +1066,7 @@ const CodexTestnet = defineChain({
     rpcEndpoints: ['https://rpc.codex-stg.xyz'],
     eurcAddress: null,
     usdcAddress: '0x6d7f141b6819C2c9CC2f818e6ad549E7Ca090F8f',
+    usdtAddress: null,
     cctp: {
         domain: 12,
         contracts: {
@@ -782,6 +1078,10 @@ const CodexTestnet = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: false,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -809,6 +1109,7 @@ const Ethereum = defineChain({
     rpcEndpoints: ['https://eth.merkle.io', 'https://ethereum.publicnode.com'],
     eurcAddress: '0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c',
     usdcAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+    usdtAddress: '0xdac17f958d2ee523a2206206994597c13d831ec7',
     cctp: {
         domain: 0,
         contracts: {
@@ -826,9 +1127,14 @@ const Ethereum = defineChain({
                 fastConfirmations: 2,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -853,6 +1159,7 @@ const EthereumSepolia = defineChain({
     rpcEndpoints: ['https://sepolia.drpc.org'],
     eurcAddress: '0x08210F9170F89Ab7658F0B5E3fF39b0E03C594D4',
     usdcAddress: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+    usdtAddress: null,
     cctp: {
         domain: 0,
         contracts: {
@@ -870,6 +1177,10 @@ const EthereumSepolia = defineChain({
                 fastConfirmations: 2,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -896,6 +1207,7 @@ defineChain({
     rpcEndpoints: ['https://mainnet.hashio.io/api'],
     eurcAddress: null,
     usdcAddress: '0.0.456858',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -919,6 +1231,7 @@ defineChain({
     rpcEndpoints: ['https://testnet.hashio.io/api'],
     eurcAddress: null,
     usdcAddress: '0.0.429274',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -945,6 +1258,7 @@ const HyperEVM = defineChain({
     rpcEndpoints: ['https://rpc.hyperliquid.xyz/evm'],
     eurcAddress: null,
     usdcAddress: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',
+    usdtAddress: null,
     cctp: {
         domain: 19,
         contracts: {
@@ -956,9 +1270,14 @@ const HyperEVM = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -984,6 +1303,7 @@ const HyperEVMTestnet = defineChain({
     rpcEndpoints: ['https://rpc.hyperliquid-testnet.xyz/evm'],
     eurcAddress: null,
     usdcAddress: '0x2B3370eE501B4a559b57D449569354196457D8Ab',
+    usdtAddress: null,
     cctp: {
         domain: 19,
         contracts: {
@@ -995,6 +1315,10 @@ const HyperEVMTestnet = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -1027,6 +1351,7 @@ const Ink = defineChain({
     ],
     eurcAddress: null,
     usdcAddress: '0x2D270e6886d130D724215A266106e6832161EAEd',
+    usdtAddress: null,
     cctp: {
         domain: 21,
         contracts: {
@@ -1038,9 +1363,14 @@ const Ink = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1069,6 +1399,7 @@ const InkTestnet = defineChain({
     ],
     eurcAddress: null,
     usdcAddress: '0xFabab97dCE620294D2B0b0e46C68964e326300Ac',
+    usdtAddress: null,
     cctp: {
         domain: 21,
         contracts: {
@@ -1080,6 +1411,10 @@ const InkTestnet = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -1107,6 +1442,7 @@ const Linea = defineChain({
     rpcEndpoints: ['https://rpc.linea.build'],
     eurcAddress: null,
     usdcAddress: '0x176211869ca2b568f2a7d4ee941e073a821ee1ff',
+    usdtAddress: null,
     cctp: {
         domain: 11,
         contracts: {
@@ -1118,9 +1454,14 @@ const Linea = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1145,6 +1486,7 @@ const LineaSepolia = defineChain({
     rpcEndpoints: ['https://rpc.sepolia.linea.build'],
     eurcAddress: null,
     usdcAddress: '0xfece4462d57bd51a6a552365a011b95f0e16d9b7',
+    usdtAddress: null,
     cctp: {
         domain: 11,
         contracts: {
@@ -1156,6 +1498,10 @@ const LineaSepolia = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -1185,6 +1531,7 @@ const Monad = defineChain({
     rpcEndpoints: ['https://rpc.monad.xyz'],
     eurcAddress: null,
     usdcAddress: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',
+    usdtAddress: null,
     cctp: {
         domain: 15,
         contracts: {
@@ -1196,9 +1543,14 @@ const Monad = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1225,6 +1577,7 @@ const MonadTestnet = defineChain({
     rpcEndpoints: ['https://testnet-rpc.monad.xyz'],
     eurcAddress: null,
     usdcAddress: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
+    usdtAddress: null,
     cctp: {
         domain: 15,
         contracts: {
@@ -1236,6 +1589,10 @@ const MonadTestnet = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -1262,6 +1619,7 @@ defineChain({
     rpcEndpoints: ['https://eth-rpc.mainnet.near.org'],
     eurcAddress: null,
     usdcAddress: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
+    usdtAddress: 'usdt.tether-token.near',
     cctp: null,
 });
 
@@ -1285,6 +1643,7 @@ defineChain({
     rpcEndpoints: ['https://eth-rpc.testnet.near.org'],
     eurcAddress: null,
     usdcAddress: '3e2210e1184b45b64c8a434c0a7e7b23cc04ea7eb7a6c3c32520d03d4afcb8af',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -1308,6 +1667,7 @@ defineChain({
     rpcEndpoints: ['https://noble-rpc.polkachu.com'],
     eurcAddress: null,
     usdcAddress: 'uusdc',
+    usdtAddress: null,
     cctp: {
         domain: 4,
         contracts: {
@@ -1317,6 +1677,10 @@ defineChain({
                 confirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
     },
 });
 
@@ -1340,6 +1704,7 @@ defineChain({
     rpcEndpoints: ['https://noble-testnet-rpc.polkachu.com'],
     eurcAddress: null,
     usdcAddress: 'uusdc',
+    usdtAddress: null,
     cctp: {
         domain: 4,
         contracts: {
@@ -1349,6 +1714,10 @@ defineChain({
                 confirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
     },
 });
 
@@ -1373,6 +1742,7 @@ const Optimism = defineChain({
     rpcEndpoints: ['https://mainnet.optimism.io'],
     eurcAddress: null,
     usdcAddress: '0x0b2c639c533813f4aa9d7837caf62653d097ff85',
+    usdtAddress: null,
     cctp: {
         domain: 2,
         contracts: {
@@ -1390,9 +1760,14 @@ const Optimism = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1417,6 +1792,7 @@ const OptimismSepolia = defineChain({
     rpcEndpoints: ['https://sepolia.optimism.io'],
     eurcAddress: null,
     usdcAddress: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7',
+    usdtAddress: null,
     cctp: {
         domain: 2,
         contracts: {
@@ -1434,6 +1810,10 @@ const OptimismSepolia = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -1463,6 +1843,7 @@ const Plume = defineChain({
     rpcEndpoints: ['https://rpc.plume.org'],
     eurcAddress: null,
     usdcAddress: '0x222365EF19F7947e5484218551B56bb3965Aa7aF',
+    usdtAddress: null,
     cctp: {
         domain: 22,
         contracts: {
@@ -1474,9 +1855,14 @@ const Plume = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: false,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1502,6 +1888,7 @@ const PlumeTestnet = defineChain({
     rpcEndpoints: ['https://testnet-rpc.plume.org'],
     eurcAddress: null,
     usdcAddress: '0xcB5f30e335672893c7eb944B374c196392C19D18',
+    usdtAddress: null,
     cctp: {
         domain: 22,
         contracts: {
@@ -1513,6 +1900,10 @@ const PlumeTestnet = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: false,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -1539,6 +1930,7 @@ defineChain({
     rpcEndpoints: ['https://asset-hub-polkadot-rpc.n.dwellir.com'],
     eurcAddress: null,
     usdcAddress: '1337',
+    usdtAddress: '1984',
     cctp: null,
 });
 
@@ -1562,6 +1954,7 @@ defineChain({
     rpcEndpoints: ['https://westmint-rpc.polkadot.io'],
     eurcAddress: null,
     usdcAddress: 'Asset ID 31337',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -1583,9 +1976,10 @@ const Polygon = defineChain({
     chainId: 137,
     isTestnet: false,
     explorerUrl: 'https://polygonscan.com/tx/{hash}',
-    rpcEndpoints: ['https://polygon-rpc.com', 'https://polygon.publicnode.com'],
+    rpcEndpoints: ['https://polygon.publicnode.com', 'https://polygon.drpc.org'],
     eurcAddress: null,
     usdcAddress: '0x3c499c542cef5e3811e1192ce70d8cc03d5c3359',
+    usdtAddress: null,
     cctp: {
         domain: 7,
         contracts: {
@@ -1603,9 +1997,14 @@ const Polygon = defineChain({
                 fastConfirmations: 13,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1630,6 +2029,7 @@ const PolygonAmoy = defineChain({
     rpcEndpoints: ['https://rpc-amoy.polygon.technology'],
     eurcAddress: null,
     usdcAddress: '0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582',
+    usdtAddress: null,
     cctp: {
         domain: 7,
         contracts: {
@@ -1647,6 +2047,10 @@ const PolygonAmoy = defineChain({
                 fastConfirmations: 13,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -1676,6 +2080,7 @@ const Sei = defineChain({
     rpcEndpoints: ['https://evm-rpc.sei-apis.com'],
     eurcAddress: null,
     usdcAddress: '0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392',
+    usdtAddress: null,
     cctp: {
         domain: 16,
         contracts: {
@@ -1687,9 +2092,14 @@ const Sei = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1715,6 +2125,7 @@ const SeiTestnet = defineChain({
     rpcEndpoints: ['https://evm-rpc-testnet.sei-apis.com'],
     eurcAddress: null,
     usdcAddress: '0x4fCF1784B31630811181f670Aea7A7bEF803eaED',
+    usdtAddress: null,
     cctp: {
         domain: 16,
         contracts: {
@@ -1726,6 +2137,10 @@ const SeiTestnet = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -1753,6 +2168,7 @@ const Sonic = defineChain({
     rpcEndpoints: ['https://rpc.soniclabs.com'],
     eurcAddress: null,
     usdcAddress: '0x29219dd400f2Bf60E5a23d13Be72B486D4038894',
+    usdtAddress: null,
     cctp: {
         domain: 13,
         contracts: {
@@ -1764,9 +2180,14 @@ const Sonic = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1791,6 +2212,7 @@ const SonicTestnet = defineChain({
     rpcEndpoints: ['https://rpc.testnet.soniclabs.com'],
     eurcAddress: null,
     usdcAddress: '0x0BA304580ee7c9a980CF72e55f5Ed2E9fd30Bc51',
+    usdtAddress: null,
     cctp: {
         domain: 13,
         contracts: {
@@ -1802,6 +2224,10 @@ const SonicTestnet = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -1828,6 +2254,7 @@ const Solana = defineChain({
     rpcEndpoints: ['https://api.mainnet-beta.solana.com'],
     eurcAddress: 'HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr',
     usdcAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+    usdtAddress: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
     cctp: {
         domain: 5,
         contracts: {
@@ -1845,6 +2272,10 @@ const Solana = defineChain({
                 fastConfirmations: 3,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: false,
+        },
     },
     kitContracts: {
         bridge: 'DFaauJEjmiHkPs1JG89A4p95hDWi9m9SAEERY1LQJiC3',
@@ -1870,6 +2301,7 @@ const SolanaDevnet = defineChain({
     explorerUrl: 'https://solscan.io/tx/{hash}?cluster=devnet',
     eurcAddress: 'HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr',
     usdcAddress: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
+    usdtAddress: null,
     cctp: {
         domain: 5,
         contracts: {
@@ -1887,6 +2319,10 @@ const SolanaDevnet = defineChain({
                 fastConfirmations: 3,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: false,
+        },
     },
     kitContracts: {
         bridge: 'DFaauJEjmiHkPs1JG89A4p95hDWi9m9SAEERY1LQJiC3',
@@ -1914,6 +2350,7 @@ defineChain({
     rpcEndpoints: ['https://horizon.stellar.org'],
     eurcAddress: 'EURC-GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2',
     usdcAddress: 'USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -1937,6 +2374,7 @@ defineChain({
     rpcEndpoints: ['https://horizon-testnet.stellar.org'],
     eurcAddress: 'EURC-GB3Q6QDZYTHWT7E5PVS3W7FUT5GVAFC5KSZFFLPU25GO7VTC3NM2ZTVO',
     usdcAddress: 'USDC-GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -1960,6 +2398,7 @@ defineChain({
     rpcEndpoints: ['https://fullnode.mainnet.sui.io'],
     eurcAddress: null,
     usdcAddress: '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC',
+    usdtAddress: null,
     cctp: {
         domain: 8,
         contracts: {
@@ -1970,6 +2409,10 @@ defineChain({
                 confirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
     },
 });
 
@@ -1993,6 +2436,7 @@ defineChain({
     rpcEndpoints: ['https://fullnode.testnet.sui.io'],
     eurcAddress: null,
     usdcAddress: '0xa1ec7fc00a6f40db9693ad1415d0c193ad3906494428cf252621037bd7117e29::usdc::USDC',
+    usdtAddress: null,
     cctp: {
         domain: 8,
         contracts: {
@@ -2003,6 +2447,10 @@ defineChain({
                 confirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
     },
 });
 
@@ -2024,9 +2472,10 @@ const Unichain = defineChain({
     chainId: 130,
     isTestnet: false,
     explorerUrl: 'https://unichain.blockscout.com/tx/{hash}',
-    rpcEndpoints: ['https://rpc.unichain.org', 'https://mainnet.unichain.org'],
+    rpcEndpoints: ['https://mainnet.unichain.org'],
     eurcAddress: null,
     usdcAddress: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',
+    usdtAddress: null,
     cctp: {
         domain: 10,
         contracts: {
@@ -2044,9 +2493,14 @@ const Unichain = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -2071,6 +2525,7 @@ const UnichainSepolia = defineChain({
     rpcEndpoints: ['https://sepolia.unichain.org'],
     eurcAddress: null,
     usdcAddress: '0x31d0220469e10c4E71834a79b1f276d740d3768F',
+    usdtAddress: null,
     cctp: {
         domain: 10,
         contracts: {
@@ -2088,6 +2543,10 @@ const UnichainSepolia = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -2114,7 +2573,8 @@ const WorldChain = defineChain({
     explorerUrl: 'https://worldscan.org/tx/{hash}',
     rpcEndpoints: ['https://worldchain-mainnet.g.alchemy.com/public'],
     eurcAddress: null,
-    usdcAddress: '0x79A02482A880bCe3F13E09da970dC34dB4cD24D1',
+    usdcAddress: '0x79A02482A880bCE3F13e09Da970dC34db4CD24d1',
+    usdtAddress: null,
     cctp: {
         domain: 14,
         contracts: {
@@ -2126,9 +2586,14 @@ const WorldChain = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -2156,6 +2621,7 @@ const WorldChainSepolia = defineChain({
     ],
     eurcAddress: null,
     usdcAddress: '0x66145f38cBAC35Ca6F1Dfb4914dF98F1614aeA88',
+    usdtAddress: null,
     cctp: {
         domain: 14,
         contracts: {
@@ -2167,6 +2633,10 @@ const WorldChainSepolia = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -2193,9 +2663,10 @@ const XDC = defineChain({
     chainId: 50,
     isTestnet: false,
     explorerUrl: 'https://xdcscan.io/tx/{hash}',
-    rpcEndpoints: ['https://erpc.xinfin.network'],
+    rpcEndpoints: ['https://erpc.xdcrpc.com', 'https://erpc.xinfin.network'],
     eurcAddress: null,
     usdcAddress: '0xfA2958CB79b0491CC627c1557F441eF849Ca8eb1',
+    usdtAddress: null,
     cctp: {
         domain: 18,
         contracts: {
@@ -2207,9 +2678,14 @@ const XDC = defineChain({
                 fastConfirmations: 3,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: false,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -2234,6 +2710,7 @@ const XDCApothem = defineChain({
     rpcEndpoints: ['https://erpc.apothem.network'],
     eurcAddress: null,
     usdcAddress: '0xb5AB69F7bBada22B28e79C8FFAECe55eF1c771D4',
+    usdtAddress: null,
     cctp: {
         domain: 18,
         contracts: {
@@ -2245,6 +2722,10 @@ const XDCApothem = defineChain({
                 fastConfirmations: 1,
             },
         },
+        forwarderSupported: {
+            source: true,
+            destination: false,
+        },
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
@@ -2272,6 +2753,7 @@ defineChain({
     rpcEndpoints: ['https://mainnet.era.zksync.io'],
     eurcAddress: null,
     usdcAddress: '0x1d17CBcF0D6D143135aE902365D2E5e2A16538D4',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -2296,6 +2778,7 @@ defineChain({
     rpcEndpoints: ['https://sepolia.era.zksync.dev'],
     eurcAddress: null,
     usdcAddress: '0xAe045DE5638162fa134807Cb558E15A3F5A7F853',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -2329,10 +2812,12 @@ const baseChainDefinitionSchema = zod.z.object({
     rpcEndpoints: zod.z.array(zod.z.string()),
     eurcAddress: zod.z.string().nullable(),
     usdcAddress: zod.z.string().nullable(),
+    usdtAddress: zod.z.string().nullable(),
     cctp: zod.z.any().nullable(), // We'll accept any CCTP config structure
     kitContracts: zod.z
         .object({
         bridge: zod.z.string().optional(),
+        adapter: zod.z.string().optional(),
     })
         .optional(),
 });
@@ -2447,6 +2932,29 @@ zod.z.union([
     zod.z.nativeEnum(Blockchain),
     chainDefinitionSchema,
 ]);
+/**
+ * Zod schema for validating swap-specific chain identifiers.
+ *
+ * Validates chains based on:
+ * - CCTPv2 support (adapter contract deployed)
+ * - Mainnet only (no testnets)
+ * - At least one supported token available
+ *
+ */
+zod.z.union([
+    // String blockchain identifier (accepts SwapChain enum values)
+    zod.z.string().refine((val) => val in SwapChain, (val) => ({
+        message: `"${val}" is not a supported swap chain. ` +
+            `Supported chains: ${Object.values(SwapChain).join(', ')}`,
+    })),
+    // SwapChain enum
+    zod.z.nativeEnum(SwapChain),
+    // ChainDefinition object (checks if chain.chain is in SwapChain)
+    chainDefinitionSchema.refine((chain) => chain.chain in SwapChain, (chain) => ({
+        message: `"${chain.chain}" is not a supported swap chain. ` +
+            `Supported chains: ${Object.values(SwapChain).join(', ')}`,
+    })),
+]);
 /**
  * Zod schema for validating bridge chain identifiers.
  *
@@ -2486,6 +2994,38 @@ zod.z.union([
     })),
 ]);
 
+/**
+ * @packageDocumentation
+ * @module SwapTokenSchemas
+ *
+ * Zod validation schemas for supported swap tokens.
+ */
+// Internal enum used after input normalization.
+const swapTokenEnumSchema = zod.z.enum([
+    ...Object.keys(SWAP_TOKEN_REGISTRY),
+    NATIVE_TOKEN,
+]);
+/**
+ * Zod schema for validating supported swap token symbols.
+ *
+ * Accepts any token symbol from the SWAP_TOKEN_REGISTRY plus NATIVE.
+ * Input matching is case-insensitive and normalized to uppercase.
+ *
+ * @example
+ * ```typescript
+ * import { supportedSwapTokenSchema } from '@core/chains'
+ *
+ * const result = supportedSwapTokenSchema.safeParse('USDC')
+ * if (result.success) {
+ *   console.log('Valid swap token:', result.data)
+ * }
+ * ```
+ */
+zod.z
+    .string()
+    .transform((value) => value.toUpperCase())
+    .pipe(swapTokenEnumSchema);
+
 exports.Arbitrum = Arbitrum;
 exports.ArbitrumSepolia = ArbitrumSepolia;
 exports.ArcTestnet = ArcTestnet;