@circle-fin/bridge-kit 1.6.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: {
@@ -329,6 +448,7 @@ defineChain({
     rpcEndpoints: ['https://fullnode.testnet.aptoslabs.com/v1'],
     eurcAddress: null,
     usdcAddress: '0x69091fbab5f7d635ee7ac5098cf0c1efbe31d68fec0f2cd565e8d168daf52832',
+    usdtAddress: null,
     cctp: {
         domain: 9,
         contracts: {
@@ -346,6 +466,121 @@ defineChain({
     },
 });
 
+/**
+ * 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.
  *
@@ -362,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
@@ -391,6 +633,7 @@ const ArcTestnet = defineChain({
     rpcEndpoints: ['https://rpc.testnet.arc.network/'],
     eurcAddress: '0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a',
     usdcAddress: '0x3600000000000000000000000000000000000000',
+    usdtAddress: null,
     cctp: {
         domain: 26,
         contracts: {
@@ -433,6 +676,7 @@ const Arbitrum = defineChain({
     rpcEndpoints: ['https://arb1.arbitrum.io/rpc'],
     eurcAddress: null,
     usdcAddress: '0xaf88d065e77c8cc2239327c5edb3a432268e5831',
+    usdtAddress: null,
     cctp: {
         domain: 3,
         contracts: {
@@ -457,6 +701,7 @@ const Arbitrum = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -481,6 +726,7 @@ const ArbitrumSepolia = defineChain({
     rpcEndpoints: ['https://sepolia-rollup.arbitrum.io/rpc'],
     eurcAddress: null,
     usdcAddress: '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d',
+    usdtAddress: null,
     cctp: {
         domain: 3,
         contracts: {
@@ -529,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: {
@@ -553,6 +800,7 @@ const Avalanche = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -576,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: {
@@ -625,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: {
@@ -649,6 +899,7 @@ const Base = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -673,6 +924,7 @@ const BaseSepolia = defineChain({
     rpcEndpoints: ['https://sepolia.base.org'],
     eurcAddress: '0x808456652fdb597867f38412077A9182bf77359F',
     usdcAddress: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+    usdtAddress: null,
     cctp: {
         domain: 6,
         contracts: {
@@ -721,6 +973,7 @@ defineChain({
     rpcEndpoints: ['https://forno.celo.org'],
     eurcAddress: null,
     usdcAddress: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
+    usdtAddress: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
     cctp: null,
 });
 
@@ -745,6 +998,7 @@ defineChain({
     rpcEndpoints: ['https://alfajores-forno.celo-testnet.org'],
     eurcAddress: null,
     usdcAddress: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -769,6 +1023,7 @@ const Codex = defineChain({
     rpcEndpoints: ['https://rpc.codex.xyz'],
     eurcAddress: null,
     usdcAddress: '0xd996633a415985DBd7D6D12f4A4343E31f5037cf',
+    usdtAddress: null,
     cctp: {
         domain: 12,
         contracts: {
@@ -811,6 +1066,7 @@ const CodexTestnet = defineChain({
     rpcEndpoints: ['https://rpc.codex-stg.xyz'],
     eurcAddress: null,
     usdcAddress: '0x6d7f141b6819C2c9CC2f818e6ad549E7Ca090F8f',
+    usdtAddress: null,
     cctp: {
         domain: 12,
         contracts: {
@@ -853,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: {
@@ -877,6 +1134,7 @@ const Ethereum = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -901,6 +1159,7 @@ const EthereumSepolia = defineChain({
     rpcEndpoints: ['https://sepolia.drpc.org'],
     eurcAddress: '0x08210F9170F89Ab7658F0B5E3fF39b0E03C594D4',
     usdcAddress: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+    usdtAddress: null,
     cctp: {
         domain: 0,
         contracts: {
@@ -948,6 +1207,7 @@ defineChain({
     rpcEndpoints: ['https://mainnet.hashio.io/api'],
     eurcAddress: null,
     usdcAddress: '0.0.456858',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -971,6 +1231,7 @@ defineChain({
     rpcEndpoints: ['https://testnet.hashio.io/api'],
     eurcAddress: null,
     usdcAddress: '0.0.429274',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -997,6 +1258,7 @@ const HyperEVM = defineChain({
     rpcEndpoints: ['https://rpc.hyperliquid.xyz/evm'],
     eurcAddress: null,
     usdcAddress: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',
+    usdtAddress: null,
     cctp: {
         domain: 19,
         contracts: {
@@ -1015,6 +1277,7 @@ const HyperEVM = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1040,6 +1303,7 @@ const HyperEVMTestnet = defineChain({
     rpcEndpoints: ['https://rpc.hyperliquid-testnet.xyz/evm'],
     eurcAddress: null,
     usdcAddress: '0x2B3370eE501B4a559b57D449569354196457D8Ab',
+    usdtAddress: null,
     cctp: {
         domain: 19,
         contracts: {
@@ -1087,6 +1351,7 @@ const Ink = defineChain({
     ],
     eurcAddress: null,
     usdcAddress: '0x2D270e6886d130D724215A266106e6832161EAEd',
+    usdtAddress: null,
     cctp: {
         domain: 21,
         contracts: {
@@ -1105,6 +1370,7 @@ const Ink = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1133,6 +1399,7 @@ const InkTestnet = defineChain({
     ],
     eurcAddress: null,
     usdcAddress: '0xFabab97dCE620294D2B0b0e46C68964e326300Ac',
+    usdtAddress: null,
     cctp: {
         domain: 21,
         contracts: {
@@ -1175,6 +1442,7 @@ const Linea = defineChain({
     rpcEndpoints: ['https://rpc.linea.build'],
     eurcAddress: null,
     usdcAddress: '0x176211869ca2b568f2a7d4ee941e073a821ee1ff',
+    usdtAddress: null,
     cctp: {
         domain: 11,
         contracts: {
@@ -1193,6 +1461,7 @@ const Linea = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1217,6 +1486,7 @@ const LineaSepolia = defineChain({
     rpcEndpoints: ['https://rpc.sepolia.linea.build'],
     eurcAddress: null,
     usdcAddress: '0xfece4462d57bd51a6a552365a011b95f0e16d9b7',
+    usdtAddress: null,
     cctp: {
         domain: 11,
         contracts: {
@@ -1261,6 +1531,7 @@ const Monad = defineChain({
     rpcEndpoints: ['https://rpc.monad.xyz'],
     eurcAddress: null,
     usdcAddress: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',
+    usdtAddress: null,
     cctp: {
         domain: 15,
         contracts: {
@@ -1279,6 +1550,7 @@ const Monad = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1305,6 +1577,7 @@ const MonadTestnet = defineChain({
     rpcEndpoints: ['https://testnet-rpc.monad.xyz'],
     eurcAddress: null,
     usdcAddress: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
+    usdtAddress: null,
     cctp: {
         domain: 15,
         contracts: {
@@ -1346,6 +1619,7 @@ defineChain({
     rpcEndpoints: ['https://eth-rpc.mainnet.near.org'],
     eurcAddress: null,
     usdcAddress: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
+    usdtAddress: 'usdt.tether-token.near',
     cctp: null,
 });
 
@@ -1369,6 +1643,7 @@ defineChain({
     rpcEndpoints: ['https://eth-rpc.testnet.near.org'],
     eurcAddress: null,
     usdcAddress: '3e2210e1184b45b64c8a434c0a7e7b23cc04ea7eb7a6c3c32520d03d4afcb8af',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -1392,6 +1667,7 @@ defineChain({
     rpcEndpoints: ['https://noble-rpc.polkachu.com'],
     eurcAddress: null,
     usdcAddress: 'uusdc',
+    usdtAddress: null,
     cctp: {
         domain: 4,
         contracts: {
@@ -1428,6 +1704,7 @@ defineChain({
     rpcEndpoints: ['https://noble-testnet-rpc.polkachu.com'],
     eurcAddress: null,
     usdcAddress: 'uusdc',
+    usdtAddress: null,
     cctp: {
         domain: 4,
         contracts: {
@@ -1465,6 +1742,7 @@ const Optimism = defineChain({
     rpcEndpoints: ['https://mainnet.optimism.io'],
     eurcAddress: null,
     usdcAddress: '0x0b2c639c533813f4aa9d7837caf62653d097ff85',
+    usdtAddress: null,
     cctp: {
         domain: 2,
         contracts: {
@@ -1489,6 +1767,7 @@ const Optimism = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1513,6 +1792,7 @@ const OptimismSepolia = defineChain({
     rpcEndpoints: ['https://sepolia.optimism.io'],
     eurcAddress: null,
     usdcAddress: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7',
+    usdtAddress: null,
     cctp: {
         domain: 2,
         contracts: {
@@ -1563,6 +1843,7 @@ const Plume = defineChain({
     rpcEndpoints: ['https://rpc.plume.org'],
     eurcAddress: null,
     usdcAddress: '0x222365EF19F7947e5484218551B56bb3965Aa7aF',
+    usdtAddress: null,
     cctp: {
         domain: 22,
         contracts: {
@@ -1581,6 +1862,7 @@ const Plume = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1606,6 +1888,7 @@ const PlumeTestnet = defineChain({
     rpcEndpoints: ['https://testnet-rpc.plume.org'],
     eurcAddress: null,
     usdcAddress: '0xcB5f30e335672893c7eb944B374c196392C19D18',
+    usdtAddress: null,
     cctp: {
         domain: 22,
         contracts: {
@@ -1647,6 +1930,7 @@ defineChain({
     rpcEndpoints: ['https://asset-hub-polkadot-rpc.n.dwellir.com'],
     eurcAddress: null,
     usdcAddress: '1337',
+    usdtAddress: '1984',
     cctp: null,
 });
 
@@ -1670,6 +1954,7 @@ defineChain({
     rpcEndpoints: ['https://westmint-rpc.polkadot.io'],
     eurcAddress: null,
     usdcAddress: 'Asset ID 31337',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -1691,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: {
@@ -1718,6 +2004,7 @@ const Polygon = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1742,6 +2029,7 @@ const PolygonAmoy = defineChain({
     rpcEndpoints: ['https://rpc-amoy.polygon.technology'],
     eurcAddress: null,
     usdcAddress: '0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582',
+    usdtAddress: null,
     cctp: {
         domain: 7,
         contracts: {
@@ -1792,6 +2080,7 @@ const Sei = defineChain({
     rpcEndpoints: ['https://evm-rpc.sei-apis.com'],
     eurcAddress: null,
     usdcAddress: '0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392',
+    usdtAddress: null,
     cctp: {
         domain: 16,
         contracts: {
@@ -1810,6 +2099,7 @@ const Sei = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1835,6 +2125,7 @@ const SeiTestnet = defineChain({
     rpcEndpoints: ['https://evm-rpc-testnet.sei-apis.com'],
     eurcAddress: null,
     usdcAddress: '0x4fCF1784B31630811181f670Aea7A7bEF803eaED',
+    usdtAddress: null,
     cctp: {
         domain: 16,
         contracts: {
@@ -1877,6 +2168,7 @@ const Sonic = defineChain({
     rpcEndpoints: ['https://rpc.soniclabs.com'],
     eurcAddress: null,
     usdcAddress: '0x29219dd400f2Bf60E5a23d13Be72B486D4038894',
+    usdtAddress: null,
     cctp: {
         domain: 13,
         contracts: {
@@ -1895,6 +2187,7 @@ const Sonic = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -1919,6 +2212,7 @@ const SonicTestnet = defineChain({
     rpcEndpoints: ['https://rpc.testnet.soniclabs.com'],
     eurcAddress: null,
     usdcAddress: '0x0BA304580ee7c9a980CF72e55f5Ed2E9fd30Bc51',
+    usdtAddress: null,
     cctp: {
         domain: 13,
         contracts: {
@@ -1960,6 +2254,7 @@ const Solana = defineChain({
     rpcEndpoints: ['https://api.mainnet-beta.solana.com'],
     eurcAddress: 'HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr',
     usdcAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+    usdtAddress: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
     cctp: {
         domain: 5,
         contracts: {
@@ -2006,6 +2301,7 @@ const SolanaDevnet = defineChain({
     explorerUrl: 'https://solscan.io/tx/{hash}?cluster=devnet',
     eurcAddress: 'HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr',
     usdcAddress: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
+    usdtAddress: null,
     cctp: {
         domain: 5,
         contracts: {
@@ -2054,6 +2350,7 @@ defineChain({
     rpcEndpoints: ['https://horizon.stellar.org'],
     eurcAddress: 'EURC-GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2',
     usdcAddress: 'USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -2077,6 +2374,7 @@ defineChain({
     rpcEndpoints: ['https://horizon-testnet.stellar.org'],
     eurcAddress: 'EURC-GB3Q6QDZYTHWT7E5PVS3W7FUT5GVAFC5KSZFFLPU25GO7VTC3NM2ZTVO',
     usdcAddress: 'USDC-GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -2100,6 +2398,7 @@ defineChain({
     rpcEndpoints: ['https://fullnode.mainnet.sui.io'],
     eurcAddress: null,
     usdcAddress: '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC',
+    usdtAddress: null,
     cctp: {
         domain: 8,
         contracts: {
@@ -2137,6 +2436,7 @@ defineChain({
     rpcEndpoints: ['https://fullnode.testnet.sui.io'],
     eurcAddress: null,
     usdcAddress: '0xa1ec7fc00a6f40db9693ad1415d0c193ad3906494428cf252621037bd7117e29::usdc::USDC',
+    usdtAddress: null,
     cctp: {
         domain: 8,
         contracts: {
@@ -2175,6 +2475,7 @@ const Unichain = defineChain({
     rpcEndpoints: ['https://mainnet.unichain.org'],
     eurcAddress: null,
     usdcAddress: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',
+    usdtAddress: null,
     cctp: {
         domain: 10,
         contracts: {
@@ -2199,6 +2500,7 @@ const Unichain = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -2223,6 +2525,7 @@ const UnichainSepolia = defineChain({
     rpcEndpoints: ['https://sepolia.unichain.org'],
     eurcAddress: null,
     usdcAddress: '0x31d0220469e10c4E71834a79b1f276d740d3768F',
+    usdtAddress: null,
     cctp: {
         domain: 10,
         contracts: {
@@ -2271,6 +2574,7 @@ const WorldChain = defineChain({
     rpcEndpoints: ['https://worldchain-mainnet.g.alchemy.com/public'],
     eurcAddress: null,
     usdcAddress: '0x79A02482A880bCE3F13e09Da970dC34db4CD24d1',
+    usdtAddress: null,
     cctp: {
         domain: 14,
         contracts: {
@@ -2289,6 +2593,7 @@ const WorldChain = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -2316,6 +2621,7 @@ const WorldChainSepolia = defineChain({
     ],
     eurcAddress: null,
     usdcAddress: '0x66145f38cBAC35Ca6F1Dfb4914dF98F1614aeA88',
+    usdtAddress: null,
     cctp: {
         domain: 14,
         contracts: {
@@ -2360,6 +2666,7 @@ const XDC = defineChain({
     rpcEndpoints: ['https://erpc.xdcrpc.com', 'https://erpc.xinfin.network'],
     eurcAddress: null,
     usdcAddress: '0xfA2958CB79b0491CC627c1557F441eF849Ca8eb1',
+    usdtAddress: null,
     cctp: {
         domain: 18,
         contracts: {
@@ -2378,6 +2685,7 @@ const XDC = defineChain({
     },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET,
     },
 });
 
@@ -2402,6 +2710,7 @@ const XDCApothem = defineChain({
     rpcEndpoints: ['https://erpc.apothem.network'],
     eurcAddress: null,
     usdcAddress: '0xb5AB69F7bBada22B28e79C8FFAECe55eF1c771D4',
+    usdtAddress: null,
     cctp: {
         domain: 18,
         contracts: {
@@ -2444,6 +2753,7 @@ defineChain({
     rpcEndpoints: ['https://mainnet.era.zksync.io'],
     eurcAddress: null,
     usdcAddress: '0x1d17CBcF0D6D143135aE902365D2E5e2A16538D4',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -2468,6 +2778,7 @@ defineChain({
     rpcEndpoints: ['https://sepolia.era.zksync.dev'],
     eurcAddress: null,
     usdcAddress: '0xAe045DE5638162fa134807Cb558E15A3F5A7F853',
+    usdtAddress: null,
     cctp: null,
 });
 
@@ -2501,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(),
 });
@@ -2619,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.
  *
@@ -2658,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;