@circle-fin/adapter-ethers-v6 0.0.2-alpha.7 → 1.0.1

package/index.cjs.js

@@ -262,12 +262,13 @@ class ActionRegistry {
  * @category Enums
  * @description Provides string identifiers for each supported blockchain.
  */
-var Blockchain;
+exports.Blockchain = void 0;
 (function (Blockchain) {
     Blockchain["Algorand"] = "Algorand";
     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["Avalanche"] = "Avalanche";
@@ -318,7 +319,7 @@ var Blockchain;
     Blockchain["XDC_Apothem"] = "XDC_Apothem";
     Blockchain["ZKSync_Era"] = "ZKSync_Era";
     Blockchain["ZKSync_Sepolia"] = "ZKSync_Sepolia";
-})(Blockchain || (Blockchain = {}));
+})(exports.Blockchain || (exports.Blockchain = {}));
 
 /**
  * Helper function to define a chain with proper TypeScript typing.
@@ -366,7 +367,7 @@ function defineChain(chain) {
  */
 const Algorand = defineChain({
     type: 'algorand',
-    chain: Blockchain.Algorand,
+    chain: exports.Blockchain.Algorand,
     name: 'Algorand',
     title: 'Algorand Mainnet',
     nativeCurrency: {
@@ -389,7 +390,7 @@ const Algorand = defineChain({
  */
 const AlgorandTestnet = defineChain({
     type: 'algorand',
-    chain: Blockchain.Algorand_Testnet,
+    chain: exports.Blockchain.Algorand_Testnet,
     name: 'Algorand Testnet',
     title: 'Algorand Test Network',
     nativeCurrency: {
@@ -412,7 +413,7 @@ const AlgorandTestnet = defineChain({
  */
 const Aptos = defineChain({
     type: 'aptos',
-    chain: Blockchain.Aptos,
+    chain: exports.Blockchain.Aptos,
     name: 'Aptos',
     title: 'Aptos Mainnet',
     nativeCurrency: {
@@ -445,7 +446,7 @@ const Aptos = defineChain({
  */
 const AptosTestnet = defineChain({
     type: 'aptos',
-    chain: Blockchain.Aptos_Testnet,
+    chain: exports.Blockchain.Aptos_Testnet,
     name: 'Aptos Testnet',
     title: 'Aptos Test Network',
     nativeCurrency: {
@@ -488,6 +489,48 @@ const BRIDGE_CONTRACT_EVM_TESTNET = '0xC5567a5E3370d4DBfB0540025078e283e36A363d'
  */
 const BRIDGE_CONTRACT_EVM_MAINNET = '0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0';
 
+/**
+ * Arc Testnet chain definition
+ * @remarks
+ * This represents the test 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 ArcTestnet = defineChain({
+    type: 'evm',
+    chain: exports.Blockchain.Arc_Testnet,
+    name: 'Arc Testnet',
+    title: 'ArcTestnet',
+    nativeCurrency: {
+        name: 'Arc',
+        symbol: 'Arc',
+        decimals: 18,
+    },
+    chainId: 5042002,
+    isTestnet: true,
+    explorerUrl: 'https://testnet.arcscan.app/tx/{hash}',
+    rpcEndpoints: ['https://rpc.testnet.arc.network/'],
+    eurcAddress: '0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a',
+    usdcAddress: '0x3600000000000000000000000000000000000000',
+    cctp: {
+        domain: 26,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 1,
+                fastConfirmations: 1,
+            },
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * Arbitrum Mainnet chain definition
  * @remarks
@@ -495,7 +538,7 @@ const BRIDGE_CONTRACT_EVM_MAINNET = '0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0'
  */
 const Arbitrum = defineChain({
     type: 'evm',
-    chain: Blockchain.Arbitrum,
+    chain: exports.Blockchain.Arbitrum,
     name: 'Arbitrum',
     title: 'Arbitrum Mainnet',
     nativeCurrency: {
@@ -539,7 +582,7 @@ const Arbitrum = defineChain({
  */
 const ArbitrumSepolia = defineChain({
     type: 'evm',
-    chain: Blockchain.Arbitrum_Sepolia,
+    chain: exports.Blockchain.Arbitrum_Sepolia,
     name: 'Arbitrum Sepolia',
     title: 'Arbitrum Sepolia Testnet',
     nativeCurrency: {
@@ -583,7 +626,7 @@ const ArbitrumSepolia = defineChain({
  */
 const Avalanche = defineChain({
     type: 'evm',
-    chain: Blockchain.Avalanche,
+    chain: exports.Blockchain.Avalanche,
     name: 'Avalanche',
     title: 'Avalanche Mainnet',
     nativeCurrency: {
@@ -627,7 +670,7 @@ const Avalanche = defineChain({
  */
 const AvalancheFuji = defineChain({
     type: 'evm',
-    chain: Blockchain.Avalanche_Fuji,
+    chain: exports.Blockchain.Avalanche_Fuji,
     name: 'Avalanche Fuji',
     title: 'Avalanche Fuji Testnet',
     nativeCurrency: {
@@ -671,7 +714,7 @@ const AvalancheFuji = defineChain({
  */
 const Base = defineChain({
     type: 'evm',
-    chain: Blockchain.Base,
+    chain: exports.Blockchain.Base,
     name: 'Base',
     title: 'Base Mainnet',
     nativeCurrency: {
@@ -715,7 +758,7 @@ const Base = defineChain({
  */
 const BaseSepolia = defineChain({
     type: 'evm',
-    chain: Blockchain.Base_Sepolia,
+    chain: exports.Blockchain.Base_Sepolia,
     name: 'Base Sepolia',
     title: 'Base Sepolia Testnet',
     nativeCurrency: {
@@ -759,7 +802,7 @@ const BaseSepolia = defineChain({
  */
 const Celo = defineChain({
     type: 'evm',
-    chain: Blockchain.Celo,
+    chain: exports.Blockchain.Celo,
     name: 'Celo',
     title: 'Celo Mainnet',
     nativeCurrency: {
@@ -783,7 +826,7 @@ const Celo = defineChain({
  */
 const CeloAlfajoresTestnet = defineChain({
     type: 'evm',
-    chain: Blockchain.Celo_Alfajores_Testnet,
+    chain: exports.Blockchain.Celo_Alfajores_Testnet,
     name: 'Celo Alfajores',
     title: 'Celo Alfajores Testnet',
     nativeCurrency: {
@@ -807,7 +850,7 @@ const CeloAlfajoresTestnet = defineChain({
  */
 const Codex = defineChain({
     type: 'evm',
-    chain: Blockchain.Codex,
+    chain: exports.Blockchain.Codex,
     name: 'Codex Mainnet',
     title: 'Codex Mainnet',
     nativeCurrency: {
@@ -845,7 +888,7 @@ const Codex = defineChain({
  */
 const CodexTestnet = defineChain({
     type: 'evm',
-    chain: Blockchain.Codex_Testnet,
+    chain: exports.Blockchain.Codex_Testnet,
     name: 'Codex Testnet',
     title: 'Codex Testnet',
     nativeCurrency: {
@@ -883,7 +926,7 @@ const CodexTestnet = defineChain({
  */
 const Ethereum = defineChain({
     type: 'evm',
-    chain: Blockchain.Ethereum,
+    chain: exports.Blockchain.Ethereum,
     name: 'Ethereum',
     title: 'Ethereum Mainnet',
     nativeCurrency: {
@@ -927,7 +970,7 @@ const Ethereum = defineChain({
  */
 const EthereumSepolia = defineChain({
     type: 'evm',
-    chain: Blockchain.Ethereum_Sepolia,
+    chain: exports.Blockchain.Ethereum_Sepolia,
     name: 'Ethereum Sepolia',
     title: 'Ethereum Sepolia Testnet',
     nativeCurrency: {
@@ -971,7 +1014,7 @@ const EthereumSepolia = defineChain({
  */
 const Hedera = defineChain({
     type: 'hedera',
-    chain: Blockchain.Hedera,
+    chain: exports.Blockchain.Hedera,
     name: 'Hedera',
     title: 'Hedera Mainnet',
     nativeCurrency: {
@@ -994,7 +1037,7 @@ const Hedera = defineChain({
  */
 const HederaTestnet = defineChain({
     type: 'hedera',
-    chain: Blockchain.Hedera_Testnet,
+    chain: exports.Blockchain.Hedera_Testnet,
     name: 'Hedera Testnet',
     title: 'Hedera Test Network',
     nativeCurrency: {
@@ -1019,7 +1062,7 @@ const HederaTestnet = defineChain({
  */
 const HyperEVM = defineChain({
     type: 'evm',
-    chain: Blockchain.HyperEVM,
+    chain: exports.Blockchain.HyperEVM,
     name: 'HyperEVM',
     title: 'HyperEVM Mainnet',
     nativeCurrency: {
@@ -1058,7 +1101,7 @@ const HyperEVM = defineChain({
  */
 const HyperEVMTestnet = defineChain({
     type: 'evm',
-    chain: Blockchain.HyperEVM_Testnet,
+    chain: exports.Blockchain.HyperEVM_Testnet,
     name: 'HyperEVM Testnet',
     title: 'HyperEVM Test Network',
     nativeCurrency: {
@@ -1098,7 +1141,7 @@ const HyperEVMTestnet = defineChain({
  */
 const Ink = defineChain({
     type: 'evm',
-    chain: Blockchain.Ink,
+    chain: exports.Blockchain.Ink,
     name: 'Ink',
     title: 'Ink Mainnet',
     nativeCurrency: {
@@ -1140,7 +1183,7 @@ const Ink = defineChain({
  */
 const InkTestnet = defineChain({
     type: 'evm',
-    chain: Blockchain.Ink_Testnet,
+    chain: exports.Blockchain.Ink_Testnet,
     name: 'Ink Sepolia',
     title: 'Ink Sepolia Testnet',
     nativeCurrency: {
@@ -1181,7 +1224,7 @@ const InkTestnet = defineChain({
  */
 const Linea = defineChain({
     type: 'evm',
-    chain: Blockchain.Linea,
+    chain: exports.Blockchain.Linea,
     name: 'Linea',
     title: 'Linea Mainnet',
     nativeCurrency: {
@@ -1219,7 +1262,7 @@ const Linea = defineChain({
  */
 const LineaSepolia = defineChain({
     type: 'evm',
-    chain: Blockchain.Linea_Sepolia,
+    chain: exports.Blockchain.Linea_Sepolia,
     name: 'Linea Sepolia',
     title: 'Linea Sepolia Testnet',
     nativeCurrency: {
@@ -1257,7 +1300,7 @@ const LineaSepolia = defineChain({
  */
 const NEAR = defineChain({
     type: 'near',
-    chain: Blockchain.NEAR,
+    chain: exports.Blockchain.NEAR,
     name: 'NEAR Protocol',
     title: 'NEAR Mainnet',
     nativeCurrency: {
@@ -1280,7 +1323,7 @@ const NEAR = defineChain({
  */
 const NEARTestnet = defineChain({
     type: 'near',
-    chain: Blockchain.NEAR_Testnet,
+    chain: exports.Blockchain.NEAR_Testnet,
     name: 'NEAR Protocol Testnet',
     title: 'NEAR Test Network',
     nativeCurrency: {
@@ -1303,7 +1346,7 @@ const NEARTestnet = defineChain({
  */
 const Noble = defineChain({
     type: 'noble',
-    chain: Blockchain.Noble,
+    chain: exports.Blockchain.Noble,
     name: 'Noble',
     title: 'Noble Mainnet',
     nativeCurrency: {
@@ -1335,7 +1378,7 @@ const Noble = defineChain({
  */
 const NobleTestnet = defineChain({
     type: 'noble',
-    chain: Blockchain.Noble_Testnet,
+    chain: exports.Blockchain.Noble_Testnet,
     name: 'Noble Testnet',
     title: 'Noble Test Network',
     nativeCurrency: {
@@ -1367,7 +1410,7 @@ const NobleTestnet = defineChain({
  */
 const Optimism = defineChain({
     type: 'evm',
-    chain: Blockchain.Optimism,
+    chain: exports.Blockchain.Optimism,
     name: 'Optimism',
     title: 'Optimism Mainnet',
     nativeCurrency: {
@@ -1411,7 +1454,7 @@ const Optimism = defineChain({
  */
 const OptimismSepolia = defineChain({
     type: 'evm',
-    chain: Blockchain.Optimism_Sepolia,
+    chain: exports.Blockchain.Optimism_Sepolia,
     name: 'Optimism Sepolia',
     title: 'Optimism Sepolia Testnet',
     nativeCurrency: {
@@ -1457,7 +1500,7 @@ const OptimismSepolia = defineChain({
  */
 const Plume = defineChain({
     type: 'evm',
-    chain: Blockchain.Plume,
+    chain: exports.Blockchain.Plume,
     name: 'Plume',
     title: 'Plume Mainnet',
     nativeCurrency: {
@@ -1496,7 +1539,7 @@ const Plume = defineChain({
  */
 const PlumeTestnet = defineChain({
     type: 'evm',
-    chain: Blockchain.Plume_Testnet,
+    chain: exports.Blockchain.Plume_Testnet,
     name: 'Plume Testnet',
     title: 'Plume Test Network',
     nativeCurrency: {
@@ -1534,7 +1577,7 @@ const PlumeTestnet = defineChain({
  */
 const PolkadotAssetHub = defineChain({
     type: 'polkadot',
-    chain: Blockchain.Polkadot_Asset_Hub,
+    chain: exports.Blockchain.Polkadot_Asset_Hub,
     name: 'Polkadot Asset Hub',
     title: 'Polkadot Asset Hub',
     nativeCurrency: {
@@ -1557,7 +1600,7 @@ const PolkadotAssetHub = defineChain({
  */
 const PolkadotWestmint = defineChain({
     type: 'polkadot',
-    chain: Blockchain.Polkadot_Westmint,
+    chain: exports.Blockchain.Polkadot_Westmint,
     name: 'Polkadot Westmint',
     title: 'Polkadot Westmint',
     nativeCurrency: {
@@ -1580,7 +1623,7 @@ const PolkadotWestmint = defineChain({
  */
 const Polygon = defineChain({
     type: 'evm',
-    chain: Blockchain.Polygon,
+    chain: exports.Blockchain.Polygon,
     name: 'Polygon',
     title: 'Polygon Mainnet',
     nativeCurrency: {
@@ -1624,7 +1667,7 @@ const Polygon = defineChain({
  */
 const PolygonAmoy = defineChain({
     type: 'evm',
-    chain: Blockchain.Polygon_Amoy_Testnet,
+    chain: exports.Blockchain.Polygon_Amoy_Testnet,
     name: 'Polygon Amoy',
     title: 'Polygon Amoy Testnet',
     nativeCurrency: {
@@ -1670,7 +1713,7 @@ const PolygonAmoy = defineChain({
  */
 const Sei = defineChain({
     type: 'evm',
-    chain: Blockchain.Sei,
+    chain: exports.Blockchain.Sei,
     name: 'Sei',
     title: 'Sei Mainnet',
     nativeCurrency: {
@@ -1709,7 +1752,7 @@ const Sei = defineChain({
  */
 const SeiTestnet = defineChain({
     type: 'evm',
-    chain: Blockchain.Sei_Testnet,
+    chain: exports.Blockchain.Sei_Testnet,
     name: 'Sei Testnet',
     title: 'Sei Test Network',
     nativeCurrency: {
@@ -1747,7 +1790,7 @@ const SeiTestnet = defineChain({
  */
 const Sonic = defineChain({
     type: 'evm',
-    chain: Blockchain.Sonic,
+    chain: exports.Blockchain.Sonic,
     name: 'Sonic',
     title: 'Sonic Mainnet',
     nativeCurrency: {
@@ -1779,26 +1822,26 @@ const Sonic = defineChain({
 });
 
 /**
- * Sonic Blaze Testnet chain definition
+ * Sonic Testnet chain definition
  * @remarks
  * This represents the official test network for the Sonic blockchain.
  */
 const SonicTestnet = defineChain({
     type: 'evm',
-    chain: Blockchain.Sonic_Testnet,
-    name: 'Sonic Blaze Testnet',
-    title: 'Sonic Blaze Testnet',
+    chain: exports.Blockchain.Sonic_Testnet,
+    name: 'Sonic Testnet',
+    title: 'Sonic Testnet',
     nativeCurrency: {
         name: 'Sonic',
         symbol: 'S',
         decimals: 18,
     },
-    chainId: 57054,
+    chainId: 14601,
     isTestnet: true,
     explorerUrl: 'https://testnet.sonicscan.org/tx/{hash}',
-    rpcEndpoints: ['https://rpc.blaze.soniclabs.com'],
+    rpcEndpoints: ['https://rpc.testnet.soniclabs.com'],
     eurcAddress: null,
-    usdcAddress: '0xA4879Fed32Ecbef99399e5cbC247E533421C4eC6',
+    usdcAddress: '0x0BA304580ee7c9a980CF72e55f5Ed2E9fd30Bc51',
     cctp: {
         domain: 13,
         contracts: {
@@ -1823,7 +1866,7 @@ const SonicTestnet = defineChain({
  */
 const Solana = defineChain({
     type: 'solana',
-    chain: Blockchain.Solana,
+    chain: exports.Blockchain.Solana,
     name: 'Solana',
     title: 'Solana Mainnet',
     nativeCurrency: {
@@ -1866,7 +1909,7 @@ const Solana = defineChain({
  */
 const SolanaDevnet = defineChain({
     type: 'solana',
-    chain: Blockchain.Solana_Devnet,
+    chain: exports.Blockchain.Solana_Devnet,
     name: 'Solana Devnet',
     title: 'Solana Development Network',
     nativeCurrency: {
@@ -1909,7 +1952,7 @@ const SolanaDevnet = defineChain({
  */
 const Stellar = defineChain({
     type: 'stellar',
-    chain: Blockchain.Stellar,
+    chain: exports.Blockchain.Stellar,
     name: 'Stellar',
     title: 'Stellar Mainnet',
     nativeCurrency: {
@@ -1932,7 +1975,7 @@ const Stellar = defineChain({
  */
 const StellarTestnet = defineChain({
     type: 'stellar',
-    chain: Blockchain.Stellar_Testnet,
+    chain: exports.Blockchain.Stellar_Testnet,
     name: 'Stellar Testnet',
     title: 'Stellar Test Network',
     nativeCurrency: {
@@ -1955,7 +1998,7 @@ const StellarTestnet = defineChain({
  */
 const Sui = defineChain({
     type: 'sui',
-    chain: Blockchain.Sui,
+    chain: exports.Blockchain.Sui,
     name: 'Sui',
     title: 'Sui Mainnet',
     nativeCurrency: {
@@ -1988,7 +2031,7 @@ const Sui = defineChain({
  */
 const SuiTestnet = defineChain({
     type: 'sui',
-    chain: Blockchain.Sui_Testnet,
+    chain: exports.Blockchain.Sui_Testnet,
     name: 'Sui Testnet',
     title: 'Sui Test Network',
     nativeCurrency: {
@@ -2021,7 +2064,7 @@ const SuiTestnet = defineChain({
  */
 const Unichain = defineChain({
     type: 'evm',
-    chain: Blockchain.Unichain,
+    chain: exports.Blockchain.Unichain,
     name: 'Unichain',
     title: 'Unichain Mainnet',
     nativeCurrency: {
@@ -2065,7 +2108,7 @@ const Unichain = defineChain({
  */
 const UnichainSepolia = defineChain({
     type: 'evm',
-    chain: Blockchain.Unichain_Sepolia,
+    chain: exports.Blockchain.Unichain_Sepolia,
     name: 'Unichain Sepolia',
     title: 'Unichain Sepolia Testnet',
     nativeCurrency: {
@@ -2109,7 +2152,7 @@ const UnichainSepolia = defineChain({
  */
 const WorldChain = defineChain({
     type: 'evm',
-    chain: Blockchain.World_Chain,
+    chain: exports.Blockchain.World_Chain,
     name: 'World Chain',
     title: 'World Chain',
     nativeCurrency: {
@@ -2147,7 +2190,7 @@ const WorldChain = defineChain({
  */
 const WorldChainSepolia = defineChain({
     type: 'evm',
-    chain: Blockchain.World_Chain_Sepolia,
+    chain: exports.Blockchain.World_Chain_Sepolia,
     name: 'World Chain Sepolia',
     title: 'World Chain Sepolia',
     nativeCurrency: {
@@ -2190,7 +2233,7 @@ const WorldChainSepolia = defineChain({
  */
 const XDC = defineChain({
     type: 'evm',
-    chain: Blockchain.XDC,
+    chain: exports.Blockchain.XDC,
     name: 'XDC',
     title: 'XDC Mainnet',
     nativeCurrency: {
@@ -2228,7 +2271,7 @@ const XDC = defineChain({
  */
 const XDCApothem = defineChain({
     type: 'evm',
-    chain: Blockchain.XDC_Apothem,
+    chain: exports.Blockchain.XDC_Apothem,
     name: 'Apothem Network',
     title: 'Apothem Network',
     nativeCurrency: {
@@ -2266,7 +2309,7 @@ const XDCApothem = defineChain({
  */
 const ZKSyncEra = defineChain({
     type: 'evm',
-    chain: Blockchain.ZKSync_Era,
+    chain: exports.Blockchain.ZKSync_Era,
     name: 'ZKSync Era',
     title: 'ZKSync Era Mainnet',
     nativeCurrency: {
@@ -2290,7 +2333,7 @@ const ZKSyncEra = defineChain({
  */
 const ZKSyncEraSepolia = defineChain({
     type: 'evm',
-    chain: Blockchain.ZKSync_Sepolia,
+    chain: exports.Blockchain.ZKSync_Sepolia,
     name: 'ZKSync Era Sepolia',
     title: 'ZKSync Era Sepolia Testnet',
     nativeCurrency: {
@@ -2315,6 +2358,7 @@ var Blockchains = {
     AptosTestnet: AptosTestnet,
     Arbitrum: Arbitrum,
     ArbitrumSepolia: ArbitrumSepolia,
+    ArcTestnet: ArcTestnet,
     Avalanche: Avalanche,
     AvalancheFuji: AvalancheFuji,
     Base: Base,
@@ -2421,7 +2465,7 @@ function hasCustomContractSupport(chain, contractType) {
  * This contains all properties shared between EVM and non-EVM chains.
  */
 const baseChainDefinitionSchema = zod.z.object({
-    chain: zod.z.nativeEnum(Blockchain, {
+    chain: zod.z.nativeEnum(exports.Blockchain, {
         required_error: 'Chain enum is required. Please provide a valid Blockchain enum value.',
         invalid_type_error: 'Chain must be a valid Blockchain enum value.',
     }),
@@ -2447,6 +2491,11 @@ const baseChainDefinitionSchema = zod.z.object({
     eurcAddress: zod.z.string().nullable(),
     usdcAddress: 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(),
+    })
+        .optional(),
 });
 /**
  * Zod schema for validating EVM chain definitions specifically.
@@ -2478,13 +2527,15 @@ const baseChainDefinitionSchema = zod.z.object({
  * }
  * ```
  */
-const evmChainDefinitionSchema = baseChainDefinitionSchema.extend({
+const evmChainDefinitionSchema = baseChainDefinitionSchema
+    .extend({
     type: zod.z.literal('evm'),
     chainId: zod.z.number({
         required_error: 'EVM chains must have a chainId. Please provide a valid EVM chain ID.',
         invalid_type_error: 'EVM chain ID must be a number.',
     }),
-});
+})
+    .strict(); //// Reject any additional properties not defined in the schema
 /**
  * Zod schema for validating non-EVM chain definitions.
  * This schema extends the base schema with non-EVM specific properties.
@@ -2504,7 +2555,7 @@ const nonEvmChainDefinitionSchema = baseChainDefinitionSchema
         'polkadot',
     ]),
 })
-    .strict(); // Reject additional properties like chainId
+    .strict(); // Reject any additional properties not defined in the schema
 /**
  * Discriminated union schema for all chain definitions.
  * This schema validates different chain types based on their 'type' field.
@@ -2553,8 +2604,8 @@ const chainDefinitionSchema$1 = zod.z.discriminatedUnion('type', [
 zod.z.union([
     zod.z
         .string()
-        .refine((val) => val in Blockchain, 'Must be a valid Blockchain enum value as string'),
-    zod.z.nativeEnum(Blockchain),
+        .refine((val) => val in exports.Blockchain, 'Must be a valid Blockchain enum value as string'),
+    zod.z.nativeEnum(exports.Blockchain),
     chainDefinitionSchema$1,
 ]);
 
@@ -2986,67 +3037,41 @@ class KitError extends Error {
 }
 
 /**
- * Standardized error codes for INPUT type errors.
+ * Minimum error code for INPUT type errors.
+ * INPUT errors represent validation failures and invalid parameters.
+ */
+/**
+ * Standardized error definitions for INPUT type errors.
+ *
+ * Each entry combines the numeric error code with its corresponding
+ * string name to ensure consistency when creating error instances.
  *
  * Error codes follow a hierarchical numbering scheme where the first digit
  * indicates the error category (1 = INPUT) and subsequent digits provide
  * specific error identification within that category.
  *
+ *
  * @example
  * ```typescript
- * import { InputErrorCode, InputErrorName } from '@core/errors'
+ * import { InputError } from '@core/errors'
  *
  * const error = new KitError({
- *   code: InputErrorCode.NETWORK_MISMATCH,
- *   name: InputErrorName.NETWORK_MISMATCH,
+ *   ...InputError.NETWORK_MISMATCH,
  *   recoverability: 'FATAL',
  *   message: 'Source and destination networks must be different'
  * })
- * ```
- */
-var InputErrorCode;
-(function (InputErrorCode) {
-    /** Network type mismatch between chains (mainnet vs testnet) */
-    InputErrorCode[InputErrorCode["NETWORK_MISMATCH"] = 1001] = "NETWORK_MISMATCH";
-    /** Invalid amount format or value (negative, zero, or malformed) */
-    InputErrorCode[InputErrorCode["INVALID_AMOUNT"] = 1002] = "INVALID_AMOUNT";
-    /** Unsupported or invalid bridge route configuration */
-    InputErrorCode[InputErrorCode["UNSUPPORTED_ROUTE"] = 1003] = "UNSUPPORTED_ROUTE";
-    /** Invalid wallet or contract address format */
-    InputErrorCode[InputErrorCode["INVALID_ADDRESS"] = 1004] = "INVALID_ADDRESS";
-    /** Invalid or unsupported chain identifier */
-    InputErrorCode[InputErrorCode["INVALID_CHAIN"] = 1005] = "INVALID_CHAIN";
-    /** General validation failure for complex validation rules */
-    InputErrorCode[InputErrorCode["VALIDATION_FAILED"] = 1098] = "VALIDATION_FAILED";
-})(InputErrorCode || (InputErrorCode = {}));
-/**
- * Standardized error names for INPUT type errors.
- *
- * These names correspond 1:1 with InputErrorCode and should always
- * be used together to ensure consistency across error instances.
  *
- * @example
- * ```typescript
- * import { InputErrorCode, InputErrorName } from '@core/errors'
- *
- * // Use matching code and name enums
- * const error = new KitError({
- *   code: InputErrorCode.NETWORK_MISMATCH,
- *   name: InputErrorName.NETWORK_MISMATCH,
- *   recoverability: 'FATAL',
- *   message: 'Network mismatch detected'
- * })
+ * // Access code and name individually if needed
+ * console.log(InputError.NETWORK_MISMATCH.code)  // 1001
+ * console.log(InputError.NETWORK_MISMATCH.name)  // 'INPUT_NETWORK_MISMATCH'
  * ```
  */
-var InputErrorName;
-(function (InputErrorName) {
-    InputErrorName["NETWORK_MISMATCH"] = "INPUT_NETWORK_MISMATCH";
-    InputErrorName["INVALID_AMOUNT"] = "INPUT_INVALID_AMOUNT";
-    InputErrorName["UNSUPPORTED_ROUTE"] = "INPUT_UNSUPPORTED_ROUTE";
-    InputErrorName["INVALID_ADDRESS"] = "INPUT_INVALID_ADDRESS";
-    InputErrorName["INVALID_CHAIN"] = "INPUT_INVALID_CHAIN";
-    InputErrorName["VALIDATION_FAILED"] = "INPUT_VALIDATION_FAILED";
-})(InputErrorName || (InputErrorName = {}));
+const InputError = {
+    /** Unsupported or invalid bridge route configuration */
+    UNSUPPORTED_ROUTE: {
+        code: 1003,
+        name: 'INPUT_UNSUPPORTED_ROUTE',
+    }};
 
 /**
  * Creates error for unsupported bridge route.
@@ -3068,8 +3093,7 @@ var InputErrorName;
  */
 function createUnsupportedRouteError(source, destination) {
     const errorDetails = {
-        code: InputErrorCode.UNSUPPORTED_ROUTE,
-        name: InputErrorName.UNSUPPORTED_ROUTE,
+        ...InputError.UNSUPPORTED_ROUTE,
         recoverability: 'FATAL',
         message: `Route from ${source} to ${destination} is not supported.`,
         cause: {
@@ -3118,26 +3142,6 @@ class Adapter {
      * ```
      */
     capabilities;
-    /**
-     * Default chain for operations when none is explicitly provided.
-     *
-     * This allows adapters to have sensible defaults for chain operations,
-     * reducing the need for explicit chain specification in every call.
-     *
-     * @remarks
-     * This is optional for backward compatibility and because some adapter types
-     * (like developer-controlled adapters) may not have meaningful defaults.
-     *
-     * @example
-     * ```typescript
-     * // User-controlled adapter with default chain
-     * defaultChain = Ethereum
-     *
-     * // Developer-controlled adapter (no default)
-     * defaultChain = undefined
-     * ```
-     */
-    defaultChain;
     /**
      * Registry of available actions for this adapter.
      *
@@ -3209,17 +3213,14 @@ class Adapter {
      * - **Browser wallet adapters**: Request chain switch via EIP-1193 or equivalent
      * - **Multi-entity adapters**: Validate chain support (operations are contextual)
      *
-     * @param chain - The target chain for operations. If not provided, uses the adapter's defaultChain.
+     * @param chain - The target chain for operations.
      * @returns A promise that resolves when the adapter is operating on the specified chain.
      * @throws When the target chain is not supported or chain switching fails.
      *
      * @remarks
-     * This method replaces the pattern of calling `getChain()` to check current chain and then
-     * manually switching. It provides a declarative "ensure this chain" interface for operations.
-     *
-     * **Backward Compatibility**: The default implementation provides basic validation but
-     * doesn't perform actual chain switching. Concrete adapter implementations should override
-     * this method to provide proper chain switching logic.
+     * This method always calls `switchToChain()` to ensure consistency across all adapter types.
+     * The underlying implementations handle idempotent switching efficiently (e.g., browser wallets
+     * gracefully handle switching to the current chain, private key adapters recreate lightweight clients).
      *
      * @example
      * ```typescript
@@ -3233,25 +3234,9 @@ class Adapter {
      * await circleWalletsAdapter.ensureChain(Ethereum)
      * ```
      */
-    async ensureChain(chain) {
-        const targetChain = chain ?? this.defaultChain;
-        if (!targetChain) {
-            return;
-        }
+    async ensureChain(targetChain) {
         this.validateChainSupport(targetChain);
-        // Check if already on the target chain (skip for developer-controlled adapters)
-        if (this.capabilities?.addressContext !== 'developer-controlled') {
-            try {
-                const currentChain = await this.getChain();
-                if (currentChain.chain === targetChain.chain) {
-                    return; // Already on the correct chain
-                }
-            }
-            catch {
-                // If getChain() fails, we'll proceed with switching anyway
-            }
-        }
-        // Delegate actual switching to the concrete implementation
+        // Always delegate to switchToChain - implementations handle idempotent switching
         try {
             await this.switchToChain(targetChain);
         }
@@ -3814,7 +3799,6 @@ base58StringSchema.refine((value) => value.length >= 86 && value.length <= 88, '
 const adapterSchema = zod.z.object({
     prepare: zod.z.function(),
     waitForTransaction: zod.z.function(),
-    getChain: zod.z.function(),
     getAddress: zod.z.function(),
 });
 
@@ -8076,6 +8060,246 @@ class EvmAdapter extends Adapter {
     }
 }
 
+// --- Signature Parsing Constants ---
+const SIGNATURE_BYTE_LENGTH = 65; // Total bytes in an Ethereum signature
+const HEX_CHARS_PER_BYTE = 2;
+const SIGNATURE_HEX_LENGTH = SIGNATURE_BYTE_LENGTH * HEX_CHARS_PER_BYTE;
+const R_HEX_LENGTH = 32 * HEX_CHARS_PER_BYTE; // 32 bytes for 'r'
+const S_HEX_LENGTH = 32 * HEX_CHARS_PER_BYTE; // 32 bytes for 's'
+// --- Recovery ID Validation Constants ---
+/**
+ * Legacy recovery IDs (pre-EIP-155 format):
+ * - 0 or 1 (older clients) or 27, 28 (Ethereum before chain-id inclusion)
+ */
+const LEGACY_V_VALUES = new Set([0, 1, 27, 28]);
+/**
+ * Minimum v value indicating an EIP-155 style signature.
+ * Calculated as 35 + (2 * chainId) + recoveryId (0 or 1).
+ */
+const MIN_EIP155_V = 35;
+/**
+ * parseSignature
+ *
+ * Parse a 65-byte ECDSA signature into its r, s, and v components, expressed in hex.
+ *
+ * Ethereum signatures are structured as:
+ *   signature = r (32 bytes) || s (32 bytes) || v (1 byte)
+ *
+ * - r, s: Big-endian hex values (32 bytes each)
+ * - v: Recovery identifier, used by secp256k1 to reconstruct the signer’s public key
+ *
+ * @param signatureHex - Signature as a hex string, optionally prefixed with "0x".
+ * @returns { r, s, v }
+ *   - r: Hex string of the R component.
+ *   - s: Hex string of the S component.
+ *   - v: Numeric recovery ID.
+ *
+ * @throws Error if:
+ *   - Input is not valid hex.
+ *   - Incorrect length (must be exactly 65 bytes / 130 hex chars).
+ *   - v is outside the supported range (Legacy or EIP-155 formula).
+ *
+ * Notes on EIP-155 overload:
+ * EIP-155 repurposes the v field so that:
+ *   v = 35 + (2 * chainId) + recoveryId(0 or 1)
+ * Any v value >= 35 indicates the chain-id is encoded, preventing cross-chain replay.
+ * r and s values remain unchanged.
+ *
+ * Example:
+ * ```typescript
+ * const rawSig = '0x6c1b...f02b'
+ * try {
+ *   const { r, s, v } = parseSignature(rawSig)
+ *   console.log('R:', r)
+ *   console.log('S:', s)
+ *   console.log('Recovery ID (v):', v)
+ * } catch (err) {
+ *   console.error('Signature parse error:', err.message)
+ * }
+ * ```
+ */
+function parseSignature(signatureHex) {
+    // 1) Remove optional '0x' prefix
+    const hex = signatureHex.startsWith('0x')
+        ? signatureHex.slice(2)
+        : signatureHex;
+    // 2) Validate hex format and length
+    const VALID_HEX_REGEX = /^[0-9a-fA-F]+$/;
+    if (!VALID_HEX_REGEX.test(hex)) {
+        throw new Error('Signature must be a valid hex string (0-9, a-f, A-F).');
+    }
+    if (hex.length !== SIGNATURE_HEX_LENGTH) {
+        throw new Error(`Invalid length: expected ${SIGNATURE_HEX_LENGTH.toString()} hex chars (65 bytes), got ${hex.length.toString()}`);
+    }
+    // 3) Extract components
+    const r = `0x${hex.slice(0, R_HEX_LENGTH)}`;
+    const s = `0x${hex.slice(R_HEX_LENGTH, R_HEX_LENGTH + S_HEX_LENGTH)}`;
+    const vValue = parseInt(hex.slice(R_HEX_LENGTH + S_HEX_LENGTH), 16);
+    // 4) Ensure v is within supported values
+    const isLegacy = LEGACY_V_VALUES.has(vValue);
+    const isEIP155 = vValue >= MIN_EIP155_V;
+    if (!isLegacy && !isEIP155) {
+        throw new Error(`Unsupported v value: ${vValue.toString()}. Must be one of [${[
+            ...LEGACY_V_VALUES,
+        ].join(', ')}] or >=${MIN_EIP155_V.toString()}`);
+    }
+    return { r: r, s: s, v: vValue };
+}
+/**
+ * buildTypedData
+ *
+ * Create an EIP-712 compliant "TypedData" object, encapsulating:
+ *  - Domain separator (application/contract identity, chain ID)
+ *  - Explicit type definitions (field names and types)
+ *  - Primary type name identifying the root object
+ *  - Message payload matching the defined schema
+ *
+ * This enforces structured, non-ambiguous signing, and guards against signature replay.
+ *
+ * @typeParam Types - Map of type names to arrays of { name, type } definitions.
+ * @typeParam Msg - Object whose shape matches the primaryType fields.
+ *
+ * @param domain - EIP712Domain, e.g. { name, version, chainId, verifyingContract }.
+ * @param types - Type definitions, e.g.:
+ *   {
+ *     Mail: [ { name: 'from', type: 'string' }, { name: 'contents', type: 'string' } ],
+ *   }
+ * @param primaryType - Root key in types, e.g. 'Mail'.
+ * @param message - The actual values, e.g. { from: 'Alice', contents: 'Hello' }.
+ *
+ * @returns TypedData object ready for use with signing libraries.
+ *
+ * Example:
+ * ```typescript
+ * const typedData = buildTypedData(
+ *   { name: 'MyDApp', version: '1', chainId: 1, verifyingContract: '0xabc...' },
+ *   { Message: [{ name: 'text', type: 'string' }] },
+ *   'Message',
+ *   { text: 'Hello, EIP-712!' }
+ * )
+ * // Pass typedData to ethers.js signer._signTypedData(domain, types, message)
+ * ```
+ */
+function buildTypedData(domain, types, primaryType, message) {
+    return { domain, types, primaryType, message };
+}
+
+/**
+ * Compute default deadline for permit signatures.
+ *
+ * Returns a timestamp 1 hour (3600 seconds) from the current time,
+ * converted to Unix timestamp format as a bigint. This is commonly
+ * used as the default expiration time for EIP-2612 permit signatures.
+ *
+ * @returns Unix timestamp (in seconds) 1 hour from now as a bigint
+ *
+ * @example
+ * ```typescript
+ * import { computeDefaultDeadline } from '@core/adapter-evm'
+ *
+ * const deadline = computeDefaultDeadline()
+ * console.log(`Permit expires at: ${deadline}`)
+ * // Output: Permit expires at: 1640998800
+ * ```
+ */
+function computeDefaultDeadline() {
+    return BigInt(Math.floor(Date.now() / 1000) + 3600);
+}
+
+/**
+ * EIP-2612 permit type definition.
+ * Defines the structure for permit signatures according to EIP-2612 specification.
+ *
+ * @see {@link https://eips.ethereum.org/EIPS/eip-2612 | EIP-2612 Specification}
+ */
+const EIP2612_TYPES = {
+    Permit: [
+        { name: 'owner', type: 'address' },
+        { name: 'spender', type: 'address' },
+        { name: 'value', type: 'uint256' },
+        { name: 'nonce', type: 'uint256' },
+        { name: 'deadline', type: 'uint256' },
+    ],
+};
+
+/**
+ * Build EIP-2612 typed data for permit signing.
+ *
+ * This function creates the complete EIP-712 typed data structure required
+ * for EIP-2612 permit signatures, including automatic nonce fetching using
+ * the adapter's built-in nonce fetching capability.
+ *
+ * **Address Formatting**: All addresses are automatically formatted with proper
+ * EIP-55 checksumming using the `convertAddress` utility, ensuring compatibility
+ * with strict validation libraries like viem.
+ *
+ * **Nonce Handling**: The nonce can be provided explicitly or will be fetched
+ * automatically using the adapter's `fetchEIP2612Nonce` method, which queries
+ * the token contract's `nonces(owner)` function.
+ *
+ * **Deadline Calculation**: If no deadline is provided, it defaults to 24 hours
+ * from the current time (computed using `computeDefaultDeadline`).
+ *
+ * @param meta - Domain metadata for the token contract
+ * @param adapter - Adapter instance with nonce-fetching capability
+ * @param opts - EIP-2612 permit options including owner, spender, value
+ * @returns Complete EIP-712 typed data ready for signing
+ *
+ * @example
+ * ```typescript
+ * import { buildEIP2612TypedData } from '@core/adapter-evm'
+ *
+ * const typedData = await buildEIP2612TypedData(
+ *   {
+ *     name: 'USD Coin',
+ *     version: '2',
+ *     chainId: 1,
+ *     verifyingContract: '0xa0b86a33e6441e4d178bb0c14ce0e9ce9c83bdd8'
+ *   },
+ *   adapter,
+ *   {
+ *     owner: '0x742d35cc6639c0532fbe9002b3a2265ca4c878f8e',
+ *     spender: '0x1234567890123456789012345678901234567890',
+ *     value: 1000000n
+ *   }
+ * )
+ *
+ * const signature = await adapter.signTypedData(typedData)
+ * ```
+ */
+async function buildEIP2612TypedData(meta, adapter, opts, ctx) {
+    // Format addresses to ensure proper EIP-55 checksumming
+    const formattedOwner = convertAddress(opts.owner, 'evm');
+    const formattedSpender = convertAddress(opts.spender, 'evm');
+    const formattedContract = convertAddress(meta.verifyingContract, 'evm');
+    // Fetch nonce if not provided - adapter handles the contract interaction
+    const nonce = opts.nonce ??
+        (await adapter.fetchEIP2612Nonce(formattedContract, formattedOwner, ctx));
+    /*
+     * Calculate deadline if not provided (24 hours from now)
+     * EIP-2612 deadline is a uint256 in the permit struct, so we use bigint for full compatibility
+     * with on-chain values and to avoid overflow/precision issues with large timestamps.
+     * Most real-world deadlines are within JS safe integer range, but using bigint is safest.
+     */
+    const now = BigInt(Math.floor(Date.now() / 1000));
+    const deadline = opts.deadline !== undefined
+        ? BigInt(opts.deadline)
+        : computeDefaultDeadline();
+    if (deadline <= now) {
+        throw new Error(`EIP-2612 deadline must be in the future (got ${deadline.toString()}, now ${now.toString()})`);
+    }
+    // Build the message with properly formatted addresses
+    const message = {
+        owner: formattedOwner,
+        spender: formattedSpender,
+        value: opts.value,
+        nonce,
+        deadline,
+    };
+    // Return complete typed data structure with formatted contract address
+    return buildTypedData({ ...meta, verifyingContract: formattedContract }, EIP2612_TYPES, 'Permit', message);
+}
+
 /**
  * Checks if a function in an ABI is read-only (view or pure).
  *
@@ -8450,7 +8674,6 @@ const abiSchema = zod.z
  * - A chainType property set to 'evm'
  * - An actionRegistry with registerHandlers method and actionHandlers record
  * - A prepare method for creating chain requests
- * - A getChain method for retrieving chain configuration
  *
  * @throws \{ValidationError\} If validation fails, with details about which properties failed
  *
@@ -8467,7 +8690,6 @@ const abiSchema = zod.z
  *     }
  *   },
  *   prepare: async (request: any) => ({}),
- *   getChain: async () => ({ name: 'Ethereum', type: 'evm' as const })
  * }
  *
  * const result = evmAdapterSchema.safeParse(validAdapter)
@@ -8569,6 +8791,44 @@ const evmTransactionHashSchema = zod.z
     .refine((hash) => /^0x[0-9a-fA-F]{64}$/.test(hash), (hash) => ({
     message: `Transaction hash "${hash}" contains invalid characters. Only hexadecimal characters (0-9, a-f, A-F) are allowed after '0x'.`,
 }));
+/**
+ * Zod schema for validating EVM private keys.
+ *
+ * This schema validates private key strings to ensure they are properly formatted:
+ * - Accepts private keys with or without '0x' prefix
+ * - Automatically normalizes by adding '0x' prefix if missing
+ * - Validates that the key is exactly 64 hexadecimal characters (32 bytes)
+ * - Ensures only valid hexadecimal characters (0-9, a-f, A-F) are used
+ *
+ * @remarks
+ * This is a shared schema used by both ethers.v6 and viem.v2 adapters to ensure
+ * consistent private key validation across all EVM adapters.
+ *
+ * @throws \{ValidationError\} If validation fails, with details about the issue
+ *
+ * @example
+ * ```typescript
+ * import { evmPrivateKeySchema } from '@core/adapter-evm/validation'
+ *
+ * // Both formats are accepted and normalized
+ * const keyWithPrefix = '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
+ * const keyWithoutPrefix = '1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
+ *
+ * const result1 = evmPrivateKeySchema.safeParse(keyWithPrefix)
+ * const result2 = evmPrivateKeySchema.safeParse(keyWithoutPrefix)
+ *
+ * // Both succeed and produce the same normalized result with '0x' prefix
+ * ```
+ */
+const evmPrivateKeySchema = zod.z
+    .string({
+    required_error: 'Private key is required. Please provide a valid private key.',
+    invalid_type_error: 'Private key must be a string. Please provide a valid private key.',
+})
+    .transform((val) => (val.startsWith('0x') ? val : `0x${val}`))
+    .pipe(zod.z.string().regex(/^0x[0-9a-fA-F]{64}$/, {
+    message: 'Private key must be a valid 64-character hex string. Please provide a valid private key with or without "0x" prefix.',
+}));
 
 const assertEvmPreparedChainRequestParamsSymbol = Symbol('assertEvmPreparedChainRequestParams');
 /**
@@ -9337,7 +9597,7 @@ const ethersAdapterOptionsSchema = zod.z.object({
  * Zod schema for validating parameters to create an EthersAdapter from a private key.
  *
  * @remarks
- * - `privateKey` must be a string starting with "0x" and 64 hexadecimal characters.
+ * - `privateKey` can be provided with or without the "0x" prefix. The schema automatically normalizes keys by adding the "0x" prefix if missing before validation.
  * - `getProvider` is optional and, if provided, must be a function accepting an object with a `chain` parameter and returning any value.
  * - `capabilities` is optional and allows partial overrides with smart defaults.
  *
@@ -9345,27 +9605,22 @@ const ethersAdapterOptionsSchema = zod.z.object({
  * ```typescript
  * import { createAdapterFromPrivateKeyParamsSchema } from '@circle-fin/adapter-ethers-v6/validation'
  *
- * const params = {
+ * // Both formats are supported:
+ * const paramsWithPrefix = {
  *   privateKey: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
  * }
  *
- * const result = createAdapterFromPrivateKeyParamsSchema.safeParse(params)
- * if (result.success) {
- *   console.log('Parameters are valid')
- * } else {
- *   console.error('Validation failed:', result.error)
+ * const paramsWithoutPrefix = {
+ *   privateKey: '1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
  * }
+ *
+ * const result1 = createAdapterFromPrivateKeyParamsSchema.safeParse(paramsWithPrefix)
+ * const result2 = createAdapterFromPrivateKeyParamsSchema.safeParse(paramsWithoutPrefix)
+ * // Both succeed and produce the same normalized result
  * ```
  */
 const createAdapterFromPrivateKeyParamsSchema = zod.z.object({
-    privateKey: zod.z
-        .string({
-        required_error: 'Private key is required. Please provide a valid private key.',
-        invalid_type_error: 'Private key must be a string. Please provide a valid private key.',
-    })
-        .regex(/^0x[0-9a-fA-F]{64}$/, {
-        message: 'Private key must be a 64-character hexadecimal string prefixed with "0x".',
-    }),
+    privateKey: evmPrivateKeySchema,
     getProvider: zod.z
         .function()
         .args(zod.z.object({ chain: zod.z.unknown() }))
@@ -9474,28 +9729,6 @@ zod.z.object({
 function validateEthersAdapterOptions(options) {
     validate(options, ethersAdapterOptionsSchema, 'EthersAdapterOptions');
 }
-/**
- * Validates parameters for creating an Ethers adapter from a private key.
- *
- * This function validates the parameters used by the createAdapterFromPrivateKey
- * factory function for the Ethers adapter.
- *
- * @param params - The parameters to validate. Must include a `privateKey` string and optionally a `getProvider` function and `capabilities`.
- * @throws \{ValidationError\} If validation fails.
- * @example
- * ```typescript
- * import { validateCreateAdapterFromPrivateKeyParams } from '@circle-fin/adapter-ethers-v6/validation'
- *
- * const params = {
- *   privateKey: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
- * }
- *
- * validateCreateAdapterFromPrivateKeyParams(params) // throws if invalid
- * ```
- */
-function validateCreateAdapterFromPrivateKeyParams(params) {
-    validate(params, createAdapterFromPrivateKeyParamsSchema, 'CreateAdapterFromPrivateKeyParams');
-}
 /**
  * Validates parameters for creating an Ethers adapter from an EIP-1193 provider.
  *
@@ -10041,6 +10274,11 @@ class EthersAdapter extends EvmAdapter {
      * ```
      */
     async getAddress(chain) {
+        // Prevent calling getAddress on developer-controlled adapters
+        if (this.capabilities?.addressContext === 'developer-controlled') {
+            throw new Error('Cannot call getAddress() on developer-controlled adapters. ' +
+                'Address must be provided explicitly in the operation context.');
+        }
         // Chain parameter should now be provided by resolveOperationContext
         if (!chain) {
             throw new Error('Chain parameter is required for address resolution. ' +
@@ -10052,45 +10290,6 @@ class EthersAdapter extends EvmAdapter {
         const address = await signer.getAddress();
         return address;
     }
-    /**
-     * Gets the current chain definition.
-     *
-     * TEMP This method is temporary and will be removed once all adapters migrate to the OperationContext pattern.
-     *
-     * **Migration Guide:**
-     *
-     * With the OperationContext pattern, chain information is provided explicitly in each operation
-     * rather than queried from the adapter. This eliminates ambiguity and enables seamless multi-chain
-     * operations with a single adapter instance.
-     *
-     * **Before (Deprecated):**
-     * ```typescript
-     * const chain = await adapter.getChain()
-     * const prepared = await adapter.prepare(params) // Uses cached chain
-     * ```
-     *
-     * **After (OperationContext):**
-     * ```typescript
-     * // Chain specified explicitly per operation
-     * const prepared = await adapter.prepare(params, { chain: 'Ethereum' })
-     *
-     * // Multi-chain operations with same adapter
-     * const ethPrepared = await adapter.prepare(params, { chain: 'Ethereum' })
-     * const basePrepared = await adapter.prepare(params, { chain: 'Base' })
-     * ```
-     *
-     * @returns A promise that resolves to the first supported chain from capabilities
-     * @throws Error when no supported chains are configured
-     */
-    async getChain() {
-        // Fallback: return first supported chain (deprecated - only for backward compatibility)
-        const firstChain = this.capabilities?.supportedChains?.[0];
-        if (!firstChain) {
-            throw new Error('No supported chains configured. ' +
-                'This method is deprecated - use OperationContext pattern instead.');
-        }
-        return await Promise.resolve(firstChain);
-    }
     /**
      * Waits for a transaction to be mined and confirmed on the blockchain.
      *
@@ -10365,16 +10564,17 @@ class EthersAdapter extends EvmAdapter {
  * ```typescript
  * import { createAdapterFromPrivateKey } from '@circle-fin/adapter-ethers-v6'
  *
- * // Minimal configuration with lazy initialization
- * const adapter = createAdapterFromPrivateKey({
- *   privateKey: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
- *   // Defaults applied:
- *   // - addressContext: 'user-controlled'
- *   // - supportedChains: all EVM chains (~29 networks)
+ * // Both private key formats are supported (with or without '0x' prefix):
+ * const adapter1 = createAdapterFromPrivateKey({
+ *   privateKey: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef' // With prefix
+ * })
+ *
+ * const adapter2 = createAdapterFromPrivateKey({
+ *   privateKey: '1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef' // Without prefix (automatically normalized)
  * })
  *
  * // Chain specified per-operation via OperationContext
- * const prepared = await adapter.prepare({
+ * const prepared = await adapter1.prepare({
  *   address: '0x...',
  *   abi: contractAbi,
  *   functionName: 'transfer',
@@ -10433,9 +10633,9 @@ class EthersAdapter extends EvmAdapter {
  * ```
  */
 function createAdapterFromPrivateKey(params) {
-    // Validate input parameters at runtime
-    validateCreateAdapterFromPrivateKeyParams(params);
-    const { privateKey, getProvider, capabilities } = params;
+    // Parse and validate input parameters at runtime (normalizes the private key by adding '0x' prefix if missing)
+    const { privateKey } = createAdapterFromPrivateKeyParamsSchema.parse(params);
+    const { getProvider, capabilities } = params;
     // Resolve capabilities with default configuration
     const resolvedCapabilities = createAdapterCapabilities('evm', capabilities);
     // Validate that capabilities are appropriate for private key adapters
@@ -10450,6 +10650,7 @@ function createAdapterFromPrivateKey(params) {
     const getProviderFn = getProvider ?? getDefaultProviderUtil(new Map());
     // Create wallet WITHOUT provider (lazy initialization)
     // The wallet will be connected to a provider when ensureChain is called
+    // Type assertion safe because we normalized the private key in the schema
     const wallet = new ethers.Wallet(privateKey);
     // Create and return the adapter
     return new EthersAdapter({
@@ -10558,13 +10759,13 @@ function createAdapterFromPrivateKey(params) {
  * ```typescript
  * // Cross-chain transfer using a single adapter
  * import { createAdapterFromProvider } from '@circle-fin/adapter-ethers-v6'
- * import { BridgingKit } from '@circle-fin/bridging-kit'
+ * import { BridgeKit } from '@circle-fin/bridge-kit'
  *
  * const adapter = await createAdapterFromProvider({
  *   provider: window.ethereum
  * })
  *
- * const kit = new BridgingKit()
+ * const kit = new BridgeKit()
  *
  * // Use the same adapter for both source and destination
  * const result = await kit.bridge({
@@ -10627,8 +10828,12 @@ const createAdapterFromProvider = async (params) => {
     }, resolvedCapabilities);
 };
 
+exports.JsonRpcProvider = ethers.JsonRpcProvider;
 exports.EthersAdapter = EthersAdapter;
+exports.buildEIP2612TypedData = buildEIP2612TypedData;
+exports.computeDefaultDeadline = computeDefaultDeadline;
 exports.createAdapterFromPrivateKey = createAdapterFromPrivateKey;
 exports.createAdapterFromProvider = createAdapterFromProvider;
+exports.parseSignature = parseSignature;
 exports.validateAdapterCapabilities = validateAdapterCapabilities;
 //# sourceMappingURL=index.cjs.js.map