genius-intents 0.19.0 → 0.20.1-develop.0

package/dist/protocols/v3-dex/v3-dex.service.js

@@ -2,745 +2,270 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.V3StyleDexService = void 0;
 const viem_1 = require("viem");
-const ethers_1 = require("ethers");
 const v3_dex_types_1 = require("./v3-dex.types");
-const sushiswap_route_processor_9_abi_1 = require("../../lib/dex/sushiswap/sushiswap-route-processor-9.abi");
-const pacakeswapV3_router_abi_1 = require("../../lib/dex/pancakeswap/pacakeswapV3-router.abi");
-const v3_offchain_quoter_service_1 = require("../../lib/dex/uniswapv3/v3-offchain-quoter.service");
-const slipstream_quoter_abi_1 = require("../../lib/dex/uniswapv3/slipstream-quoter.abi");
-const slipstream_router_abi_1 = require("../../lib/dex/uniswapv3/slipstream-router.abi");
-const uniswapV3_quoter_abi_1 = require("../../lib/dex/uniswapv3/uniswapV3-quoter.abi");
-const uniswapV3_router_abi_1 = require("../../lib/dex/uniswapv3/uniswapV3-router.abi");
-const uniswapV3_pool_abi_1 = require("../../lib/dex/uniswapv3/uniswapV3-pool.abi");
+const v3_dex_deployments_1 = require("../../lib/dex/uniswapv3/v3-dex-deployments");
 const enums_1 = require("../../types/enums");
+const slipstream_adapter_1 = require("./adapters/slipstream.adapter");
+const uniswap_fork_adapter_1 = require("./adapters/uniswap-fork.adapter");
 const min_amount_out_1 = require("../../utils/min-amount-out");
 const wrapped_native_1 = require("../../utils/wrapped-native");
+const uniswap_adapter_1 = require("./adapters/uniswap.adapter");
+const chainId_to_chain_1 = require("../../utils/chainId-to-chain");
 const constants_1 = require("../../utils/constants");
+const to_pool_key_1 = require("../../utils/to-pool-key");
 const is_native_1 = require("../../utils/is-native");
-const logger_1 = require("../../utils/logger");
 const utils_1 = require("../../utils");
-const sort_addresses_1 = require("../../utils/sort-addresses");
-const dex_deployment_key_1 = require("../../utils/dex-deployment-key");
-/**
- * Service for interacting with V3-style decentralized exchanges (DEXs) such as Uniswap V3, PancakeSwap V3, Slipstream, and SushiSwap V3.
- *
- * This service provides price discovery and swap quote functionality for supported chains and DEX deployments.
- * It supports multicall-based quoting across multiple fee tiers and deployments, with fallback logic for different quoter contract versions.
- *
- * @remarks
- * - Only single-chain swaps are supported.
- * - Deployments and RPC clients are configured via the constructor.
- * - Supports Uniswap V3, PancakeSwap V3, Slipstream, and SushiSwap V3 deployments on Avalanche, Arbitrum, BSC, Base, Ethereum, Optimism, HyperEVM, and Polygon.
- *
- * @example
- * ```typescript
-import { base, optimism } from 'viem/chains';
-
-async function t() {
-  const rpcs = {
-    [ChainIdEnum.BASE]: '<url>',
-    [ChainIdEnum.OPTIMISM]: '<url>',
-  };
-
-  const solidlyChainConfigs = {
-    [ChainIdEnum.BASE]: base,
-    [ChainIdEnum.OPTIMISM]: optimism,
-  };
-
-  const s = new V3StyleDexService({ rpcs, uniV3ChainConfigs: solidlyChainConfigs });
-  const a = await s.fetchQuote({
-    from: '0x055698dead6666c0690B1419647556149005504D',
-    receiver: '0x055698dead6666c0690B1419647556149005504D',
-    tokenOut: ZERO_ADDRESS, // WETH
-    tokenIn: '0x940181a94A35A4569E4529A3CDfB74e38FD98631', // USDC
-    amountIn: '100000000000000000000', // s0.01 WETH
-    networkIn: ChainIdEnum.BASE,
-    networkOut: ChainIdEnum.BASE,
-    slippage: 10, // 1%
-  });
-
-  const c = await s.fetchQuote({
-    from: '0x055698dead6666c0690B1419647556149005504D',
-    receiver: '0x055698dead6666c0690B1419647556149005504D',
-    tokenIn: ZERO_ADDRESS, // WETH
-    tokenOut: '0x9560e827aF36c94D2Ac33a39bCE1Fe78631088Db', // USDC
-    amountIn: '100000000000000000', // 0.01 WETH
-    networkIn: ChainIdEnum.OPTIMISM,
-    networkOut: ChainIdEnum.OPTIMISM,
-    slippage: 10, // 1%
-  });
-}
-
-t();
- * ```
- *
- * @implements IIntentProtocol
- */
+const logger_1 = require("../../utils/logger");
+let logger;
+/** -----------------------------------------------------------------------
+ * V3StyleDexService
+ * --------------------------------------------------------------------- */
 class V3StyleDexService {
     constructor(config) {
-        /**
-         * The protocol that the service produces
-         */
         this.protocol = enums_1.ProtocolEnum.UNISWAP_V3;
-        /**
-         * Whether the service supports a single chain
-         */
         this.singleChain = true;
-        /**
-         * Whether the service supports multiple chains
-         */
         this.multiChain = false;
-        /**
-         * The chains that the service supports
-         */
-        this.chains = [
-            enums_1.ChainIdEnum.AVALANCHE,
-            enums_1.ChainIdEnum.ARBITRUM,
-            enums_1.ChainIdEnum.BSC,
-            enums_1.ChainIdEnum.BASE,
-            enums_1.ChainIdEnum.ETHEREUM,
-            enums_1.ChainIdEnum.OPTIMISM,
-            enums_1.ChainIdEnum.POLYGON,
-            enums_1.ChainIdEnum.HYPEREVM,
-        ];
-        /**
-         * Public clients by chain
-         */
+        this.chains = v3_dex_deployments_1.uniV3SupportedChains;
         this._clients = {};
-        /**
-         * V3 style Fee tiers for liquidity Pools
-         */
-        this.uniFeeTiers = [100, 500, 3000, 10000];
-        this.pancakeFeeTiers = [100, 500, 2500, 10000];
-        this.pangolinFeeTiers = [40, 100, 500, 2500, 8000];
-        this.hyperswapFeeTiers = [100, 500, 3000, 10000];
-        this.pharaohFeeTiers = [50, 100, 250, 500, 3000, 10000];
-        this.aerodromeFeeTiers = [100, 400, 500, 3000, 10000];
-        this.velodromeFeeTiers = [500, 3000, 10000];
-        /**
-         * Tick spacings for slipstream style dexes
-         */
-        this.aerodromeTickSpacings = [1, 10, 60, 200];
-        this.velodromeTickSpacings = [10, 60, 200];
-        /**
-         * The deployments supported out of the box for V3 style dexes
-         */
-        this.deployments = {
-            [enums_1.ChainIdEnum.AVALANCHE]: [
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3,
-                    quoter: '0xbe0F5544EC67e9B3b2D979aaA43f18Fd87E6257F',
-                    router: '0xbb00FF08d01D300023C629E8fFfFcb65A5a578cE',
-                    factory: '0x740b1c1de25031C31FF4fC9A62f554A55cdC1baD',
-                    initHash: '0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54',
-                },
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.PANGOLIN_V3,
-                    quoter: '0xA86522CCc412dBC4FA10991900FE46De95983822',
-                    factory: '0x1128F23D0bc0A8396E9FBC3c0c68f5EA228B8256',
-                    router: '0x5485A0751a249225D3bA2f6f296551507e22547f',
-                    initHash: '0x40231f6b438bce0797c9ada29b718a87ea0a5cea3fe9a771abdd76bd41a3e545',
-                },
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.PHARAOH_CLMM, // reuse existing UNISWAP_V3 branch/ABIs
-                    router: '0x062c62cA66E50Cfe277A95564Fe5bB504db1Fab8', // SwapRouter (immutable & verified)
-                    quoter: '0xAAAEA10b0e6FBe566FE27c3A023DC5D8cA6Bca3d', // QuoterV2
-                    factory: '0xAAA32926fcE6bE95ea2c51cB4Fcb60836D320C42', // PharaohV2Factory (CL)
-                    initHash: '0x1565b129f2d1790f12d45301b9b084335626f0c92410bc43130763b69971135d',
-                },
-                //   {
-                //     dex: UniswapV3StyleDexEnum.SUSHISWAP_V3,
-                //     router: '0x81602ef321c46d73f5ba7f476947ae1a862957dc', // RouteProcessor9
-                //     factory: '0x3e603c14af37ebdad31709c4f848fc6ad5bec715',
-                //   },
-            ],
-            [enums_1.ChainIdEnum.ARBITRUM]: [
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3,
-                    quoter: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
-                    router: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
-                    factory: '0x1F98431c8aD98523631AE4a59f267346ea31F984',
-                    initHash: '0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54',
-                },
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3,
-                    quoter: '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997',
-                    deployer: '0x41ff9AA7e16B8B1a8a8dc4f0eFacd93D02d071c9',
-                    router: '0x1b81D678ffb9C0263b24A97847620C99d213eB14',
-                    factory: '0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865',
-                    initHash: '0x6ce8eb472fa82df5469c6ab6d485f17c3ad13c8cd7af59b3d4a8026c5ce0f7e2',
-                },
-                //   {
-                //     dex: UniswapV3StyleDexEnum.SUSHISWAP_V3,
-                //     router: '0x81602ef321c46d73f5ba7f476947ae1a862957dc', // RouteProcessor9
-                //     factory: '0x1af415a1eba07a4986a52b6f2e7de7003d82231e',
-                //   },
-            ],
-            [enums_1.ChainIdEnum.BSC]: [
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3,
-                    quoter: '0x78D78E420Da98ad378D7799bE8f4AF69033EB077',
-                    router: '0xB971eF87ede563556b2ED4b1C0b0019111Dd85d2',
-                    factory: '0xdB1d10011AD0Ff90774D0C6Bb92e5C5c8b4461F7',
-                    initHash: '0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54',
-                },
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3,
-                    quoter: '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997',
-                    deployer: '0x41ff9AA7e16B8B1a8a8dc4f0eFacd93D02d071c9',
-                    router: '0x1b81D678ffb9C0263b24A97847620C99d213eB14',
-                    factory: '0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865',
-                    initHash: '0x6ce8eb472fa82df5469c6ab6d485f17c3ad13c8cd7af59b3d4a8026c5ce0f7e2',
-                },
-                //   {
-                //     dex: UniswapV3StyleDexEnum.SUSHISWAP_V3,
-                //     router: '0x81602ef321c46d73f5ba7f476947ae1a862957dc', // RouteProcessor9
-                //     factory: '0x126555dd55a39328f69400d6ae4f782bd4c34abb',
-                //   },
-            ],
-            [enums_1.ChainIdEnum.BASE]: [
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3,
-                    quoter: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
-                    router: '0x2626664c2603336E57B271c5C0b26F421741e481',
-                    factory: '0x33128a8fC17869897dcE68Ed026d694621f6FDfD',
-                    initHash: '0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54',
-                },
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3,
-                    quoter: '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997',
-                    deployer: '0x41ff9AA7e16B8B1a8a8dc4f0eFacd93D02d071c9',
-                    router: '0x1b81D678ffb9C0263b24A97847620C99d213eB14',
-                    factory: '0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865',
-                    initHash: '0x6ce8eb472fa82df5469c6ab6d485f17c3ad13c8cd7af59b3d4a8026c5ce0f7e2',
-                },
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM,
-                    quoter: '0x254cF9E1E6e233aa1AC962CB9B05b2cfeAaE15b0',
-                    router: '0xBE6D8f0d05cC4be24d5167a3eF062215bE6D18a5',
-                    factory: '0x5e7BB104d84c7CB9B682AaC2F3d509f5F406809A',
-                    initHash: '0xffb9af9ea6d9e39da47392ecc7055277b9915b8bfc9f83f105821b7791a6ae30',
-                },
-                //   {
-                //     dex: UniswapV3StyleDexEnum.SUSHISWAP_V3,
-                //     router: '0x81602ef321c46d73f5ba7f476947ae1a862957dc', // RouteProcessor9
-                //     factory: '0xc35dadb65012ec5796536bd9864ed8773abc74c4',
-                //   },
-            ],
-            [enums_1.ChainIdEnum.ETHEREUM]: [
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3,
-                    quoter: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
-                    router: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
-                    factory: '0x1F98431c8aD98523631AE4a59f267346ea31F984',
-                    initHash: '0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54',
-                },
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3,
-                    quoter: '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997',
-                    deployer: '0x41ff9AA7e16B8B1a8a8dc4f0eFacd93D02d071c9',
-                    router: '0x1b81D678ffb9C0263b24A97847620C99d213eB14',
-                    factory: '0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865',
-                    initHash: '0x6ce8eb472fa82df5469c6ab6d485f17c3ad13c8cd7af59b3d4a8026c5ce0f7e2',
-                },
-                //   {
-                //     dex: UniswapV3StyleDexEnum.SUSHISWAP_V3,
-                //     router: '0x81602ef321c46d73f5ba7f476947ae1a862957dc', // RouteProcessor9
-                //     factory: '0xbaceb8ec6b9355dfc0269c18bac9d6e2bdc29c4f',
-                //   },
-            ],
-            [enums_1.ChainIdEnum.OPTIMISM]: [
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3,
-                    quoter: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
-                    router: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
-                    factory: '0x1F98431c8aD98523631AE4a59f267346ea31F984',
-                    initHash: '0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54',
-                },
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM,
-                    quoter: '0x89D8218ed5fF1e46d8dcd33fb0bbeE3be1621466',
-                    router: '0x0792a633F0c19c351081CF4B211F68F79bCc9676',
-                    factory: '0xCc0bDDB707055e04e497aB22a59c2aF4391cd12F',
-                    initHash: '0x339492e30b7a68609e535da9b0773082bfe60230ca47639ee5566007d525f5a7',
-                },
-                //   {
-                //     dex: UniswapV3StyleDexEnum.SUSHISWAP_V3,
-                //     router: '0x81602ef321c46d73f5ba7f476947ae1a862957dc', // RouteProcessor9
-                //     factory: '0x9c6522117e2ed1fe5bdb72bb0ed5e3f2bde7dbe0',
-                //   },
-            ],
-            [enums_1.ChainIdEnum.POLYGON]: [
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3,
-                    quoter: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
-                    router: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
-                    factory: '0x1F98431c8aD98523631AE4a59f267346ea31F984',
-                    initHash: '0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54',
-                },
-                //   {
-                //     dex: UniswapV3StyleDexEnum.SUSHISWAP_V3,
-                //     router: '0x81602ef321c46d73f5ba7f476947ae1a862957dc', // RouteProcessor9
-                //     factory: '0x917933899c6a5f8e37f31e19f92cdbff7e8ff0e2',
-                //   },
-            ],
-            [enums_1.ChainIdEnum.HYPEREVM]: [
-                {
-                    dex: v3_dex_types_1.UniswapV3StyleDexEnum.HYPERSWAP_V3,
-                    quoter: '0x03A918028f22D9E1473B7959C927AD7425A45C7C',
-                    router: '0x6D99e7f6747AF2cDbB5164b6DD50e40D4fDe1e77',
-                    factory: '0xB1c0fa0B789320044A6F623cFe5eBda9562602E3',
-                    initHash: '0xe3572921be1688dba92df30c6781b8770499ff274d20ae9b325f4242634774fb',
-                },
-            ],
-        };
-        if (config?.rpcs) {
-            for (const [chainIdStr, rpc] of Object.entries(config.rpcs)) {
-                const chainId = Number(chainIdStr);
-                if (!rpc || rpc === '') {
-                    logger_1.logger.warn(`Skipping empty RPC for chainId ${chainId}`);
-                    continue;
-                }
-                const expectedConfig = config.uniV3ChainConfigs[chainId];
-                if (!expectedConfig) {
-                    logger_1.logger.warn(`No RPC URL found for chainId ${chainId}, skipping client creation`);
-                    continue;
-                }
-                const chainConfig = config.uniV3ChainConfigs[chainId];
-                this._clients[chainId] = (0, viem_1.createPublicClient)({
-                    chain: chainConfig,
-                    transport: (0, viem_1.http)(rpc),
-                });
-            }
-        }
-        if (config?.uniV3ExtraDeployments) {
-            for (const [k, extras] of Object.entries(config.uniV3ExtraDeployments)) {
-                const chain = Number(k);
-                const base = this.deployments[chain] ?? [];
-                this.deployments[chain] = [...base, ...(extras ?? [])];
+        this._deployments = v3_dex_deployments_1.uniV3DexDeployments;
+        this._adapterCache = new Map();
+        if (!config) {
+            throw new Error('V3StyleDexService requires configuration');
+        }
+        if (config?.debug) {
+            logger_1.LoggerFactory.configure(logger_1.LoggerFactory.createConsoleLogger({ level: logger_1.LogLevelEnum.DEBUG }));
+        }
+        // Use custom logger if provided
+        else if (config?.logger) {
+            logger_1.LoggerFactory.configure(config.logger);
+        }
+        logger = logger_1.LoggerFactory.getLogger();
+        // Create clients where both chainConfig & rpc are provided
+        for (const [key, rpcUrl] of Object.entries(config.rpcs ?? {})) {
+            const chainId = Number(key);
+            const chainObj = chainId_to_chain_1.chainIdToChain[chainId];
+            if (!rpcUrl || !chainObj) {
+                logger.warn(`Skipping V3StyleDexService client creation for chainId ${chainId} - missing RPC or chain config`);
+                continue;
             }
+            this._clients[chainId] = (0, viem_1.createPublicClient)({
+                chain: chainObj,
+                transport: (0, viem_1.http)(rpcUrl),
+            });
         }
     }
+    // --------------------------- Public API -----------------------------------
     isCorrectConfig(_config) {
-        // V2StyleDexService has no required config fields, all are optional
         return true;
     }
+    /** -----------------------------------------------------------------------
+     * fetchPrice
+     * --------------------------------------------------------------------- */
     async fetchPrice(params) {
-        const { networkIn, networkOut, tokenIn, tokenOut, amountIn, slippage, overrideParamsV3Dex } = params;
-        const pair = overrideParamsV3Dex?.pair;
-        const expectedAmountOutMin = overrideParamsV3Dex?.amountOutMin;
-        const dex = overrideParamsV3Dex?.dex;
+        const { networkIn, networkOut, tokenIn, tokenOut, amountIn, slippage } = params;
         if (networkIn !== networkOut) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, 'V3StyleDexService.fetchPrice supports only single-chain quotes');
-        }
-        const amountInBI = BigInt(amountIn);
-        if (amountInBI <= 0n) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, 'amountIn must be greater than zero');
-        }
-        const deployments = this.deployments[networkIn] ?? [];
-        if (!deployments.length) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No V3-style deployments configured for network ${networkIn}`);
-        }
-        // Early exit if caller supplied a known pair & minOut (optimistic path)
-        if (pair && expectedAmountOutMin && dex) {
-            const router = deployments.find(d => d.dex === dex)?.router;
-            if (!router) {
-                throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No router found for dex ${dex} on chainId ${networkIn}`);
-            }
-            const dexKey = (0, dex_deployment_key_1.dexDeploymentKey)({
-                dex: dex,
-                router: router,
-                network: networkIn,
-            });
-            const earlyResponse = {
-                dex: dexKey,
-                amountOut: expectedAmountOutMin,
-                quoterAddress: undefined,
-                feeTier: 3000,
-                sqrtPriceX96After: undefined,
-                initializedTicksCrossed: undefined,
-                gasEstimate: undefined,
-                method: 'ExpectedAmountOut',
-                path: pair,
-                notes: `Early return due to supplied pair and amountOutMin`,
-            };
-            return {
-                protocol: this.protocol,
-                networkIn,
-                networkOut,
-                tokenIn,
-                tokenOut,
-                amountIn,
-                amountOut: expectedAmountOutMin,
-                slippage,
-                protocolResponse: earlyResponse,
-            };
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, 'V3StyleDexService supports only single-chain swaps');
         }
         const client = this._clients[networkIn];
         if (!client) {
             throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No RPC client configured for chainId ${networkIn}`);
         }
-        // === Native <-> Wrapped normalization ===
+        let deployments = this._deployments[networkIn] ?? [];
+        /**
+         * If an override pair + amountOutMin + dex + feeTier is provided, use fast route
+         * logic, which does not rely on any on-chain quoting – assumes the caller has done
+         * their own due diligence to verify the pair exists and is valid.
+         */
+        const overrides = params?.overrideParamsV3Dex;
+        const overridePairCandidate = overrides?.pairCandidate;
+        const overridePair = overridePairCandidate?.pair;
+        const overrideAmountOutMin = overridePairCandidate?.amountOutMin;
+        const overrideDex = overridePairCandidate?.dex;
+        const overrideFeeOrTick = overridePairCandidate?.feeOrTick;
+        const useFastRoute = overridePair && overrideAmountOutMin && overrideDex && overrideFeeOrTick;
+        if (useFastRoute) {
+            logger.info(`V3StyleDexService: Using fast route price fetch logic.`);
+            return this._buildFastRoutePriceResponse({
+                networkIn: networkIn,
+                networkOut: networkOut,
+                tokenIn: tokenIn,
+                tokenOut: tokenOut,
+                slippage: slippage ?? 0,
+                amountIn: amountIn,
+                overrideDex: overrideDex,
+                overrideAmountOutMin: overrideAmountOutMin,
+                overrideFeeOrTick: overrideFeeOrTick,
+            });
+        }
+        const deploymentsToExclude = overrides?.excludeDexes ?? [];
+        if (deploymentsToExclude) {
+            logger.info(`V3StyleDexService: Excluding deployments for dexes: ${deploymentsToExclude.join(', ')}`);
+            deployments = deployments.filter(d => !deploymentsToExclude?.includes(d.dex));
+        }
+        if (!deployments.length) {
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No CLMM deployments for chainId ${networkIn}`);
+        }
+        const amountInBI = BigInt(amountIn);
+        if (amountInBI <= 0n) {
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, 'amountIn must be greater than zero');
+        }
+        // Normalize for quoting (wrap native)
         const nativeIn = (0, is_native_1.isNative)(tokenIn);
         const nativeOut = (0, is_native_1.isNative)(tokenOut);
         const wrapped = wrapped_native_1.wrappedNativeTokens[networkIn];
         if ((nativeIn || nativeOut) && !wrapped) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Missing wrapped native token mapping for chainId ${networkIn}`);
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Missing wrapped native token mapping for ${networkIn}`);
         }
-        const tokenInForQuote = nativeIn ? wrapped : tokenIn;
-        const tokenOutForQuote = nativeOut ? wrapped : tokenOut;
-        /** =========================
-         *  FAST PATH: known pair
-         *  ========================= */
-        const suppliedPair = params.overrideParamsV3Dex?.pair;
-        if (suppliedPair) {
-            const best = await this._fetchKnownPairPrice({
-                network: networkIn,
-                tokenInForQuote: (0, viem_1.getAddress)(tokenInForQuote),
-                tokenOutForQuote: (0, viem_1.getAddress)(tokenOutForQuote),
-                amountInBI,
-                pair: (0, viem_1.getAddress)(suppliedPair),
-            });
-            return {
-                protocol: this.protocol,
-                networkIn,
-                networkOut,
-                tokenIn,
-                tokenOut,
-                amountIn,
-                amountOut: best.amountOut.toString(),
-                slippage,
-                protocolResponse: best.payload,
-            };
+        const tokenInQ = (nativeIn ? wrapped : tokenIn);
+        const tokenOutQ = (nativeOut ? wrapped : tokenOut);
+        // Build all QuoterV2 calls (first pass)
+        const v2Specs = [];
+        for (const d of deployments) {
+            const adapter = this._getAdapter(d.dex);
+            const presets = adapter.presets(networkIn); // fee tiers or tick spacings
+            for (const p of presets) {
+                const poolKey = (0, to_pool_key_1.toPoolKey)(tokenInQ, tokenOutQ, p);
+                const task = {
+                    deployment: d,
+                    tokenIn: tokenInQ,
+                    tokenOut: tokenOutQ,
+                    amountIn: amountInBI,
+                    poolKey,
+                    nativeIn,
+                    nativeOut,
+                };
+                try {
+                    const spec = adapter.buildQuoterV2Call(task);
+                    if (!spec)
+                        continue;
+                    v2Specs.push({ spec, adapter, meta: task, d, preset: p });
+                }
+                catch {
+                    // Adapter may not support V2 (shouldn't happen here), skip
+                }
+            }
         }
-        // Split deployments by quoter availability
-        const orthodox = deployments.filter(d => !!d.quoter);
-        const quoterless = deployments.filter(d => !('quoter' in d) || !d.quoter);
+        // Execute V2 multicall
         let best;
-        // Helper: execute a batch (multicall vs per-call for HyperEVM)
-        const execBatch = async (contracts) => {
-            if (!contracts.length)
-                return [];
-            if (networkIn === enums_1.ChainIdEnum.HYPEREVM) {
-                return Promise.all(contracts.map(async (c) => {
-                    try {
-                        const result = await client.readContract({
-                            address: c.address,
-                            abi: c.abi,
-                            functionName: c.functionName,
-                            args: c.args,
-                        });
-                        return { status: 'success', result };
-                    }
-                    catch (error) {
-                        return { status: 'failure', error };
-                    }
-                }));
-            }
-            return client.multicall({ allowFailure: true, contracts });
-        };
-        /** ---------------------------------------
-         * Round 1: QuoterV2-style calls
-         *  - Uni/Pancake/Pangolin/etc: use fee (uint24)
-         *  - Slipstream (Velodrome/Aerodrome): use tickSpacing (int24)
-         * ------------------------------------- */
-        // A) Uni-like group (fee tiers)
-        const v2ContractsUniLike = orthodox
-            .filter(d => !this._isSlipstreamDexString(d.dex))
-            .flatMap(d => {
-            const feeTiers = this._determineFeeTiersForDex(d.dex);
-            return feeTiers.map(fee => ({
-                address: d.quoter,
-                abi: uniswapV3_quoter_abi_1.uniswapV3QuoterAbi,
-                functionName: 'quoteExactInputSingle',
-                args: [
-                    {
-                        tokenIn: (0, viem_1.getAddress)(tokenInForQuote),
-                        tokenOut: (0, viem_1.getAddress)(tokenOutForQuote),
-                        amountIn: amountInBI,
-                        fee,
-                        sqrtPriceLimitX96: 0n,
-                    },
-                ],
-            }));
-        });
-        const v2MetasUniLike = orthodox
-            .filter(d => !this._isSlipstreamDexString(d.dex))
-            .flatMap(d => {
-            const feeTiers = this._determineFeeTiersForDex(d.dex);
-            return feeTiers.map(fee => ({
-                dex: (0, dex_deployment_key_1.dexDeploymentKey)({
-                    dex: d.dex,
-                    network: networkIn,
-                    router: d.router,
-                }),
-                fee,
-                quoter: d.quoter,
-                method: 'QuoterV2.quoteExactInputSingle',
-                isSlip: false,
-            }));
-        });
-        // B) Slipstream group (tick spacing)
-        const v2ContractsSlip = orthodox
-            .filter(d => this._isSlipstreamDexString(d.dex))
-            .flatMap(d => {
-            const tss = this._determineTickSpacingsForDex(d.dex);
-            return tss.map(ts => ({
-                address: d.quoter,
-                abi: slipstream_quoter_abi_1.slipstreamQuoterAbi,
-                functionName: 'quoteExactInputSingle',
-                args: [
-                    {
-                        tokenIn: (0, viem_1.getAddress)(tokenInForQuote),
-                        tokenOut: (0, viem_1.getAddress)(tokenOutForQuote),
-                        amountIn: amountInBI,
-                        tickSpacing: ts,
-                        sqrtPriceLimitX96: 0n,
-                    },
-                ],
+        if (v2Specs.length) {
+            const calls = v2Specs.map(s => ({
+                address: s.spec.address,
+                abi: s.spec.abi,
+                functionName: s.spec.fn,
+                args: s.spec.args,
             }));
-        });
-        const v2MetasSlip = orthodox
-            .filter(d => this._isSlipstreamDexString(d.dex))
-            .flatMap(d => this._determineTickSpacingsForDex(d.dex).map(ts => ({
-            dex: (0, dex_deployment_key_1.dexDeploymentKey)({
-                dex: d.dex,
-                network: networkIn,
-                router: d.router,
-            }),
-            fee: ts, // store tickSpacing in "fee" slot to reuse payload shape
-            quoter: d.quoter,
-            method: 'QuoterV2.quoteExactInputSingle',
-            isSlip: true,
-        })));
-        // Execute both groups
-        const [v2ResultsUniLike, v2ResultsSlip] = await Promise.all([
-            execBatch(v2ContractsUniLike),
-            execBatch(v2ContractsSlip),
-        ]);
-        // Unified handling for success/revert-decode
-        const handleV2Group = (results, metas, abi) => {
+            const results = await this._execBatch(networkIn, calls);
             for (let i = 0; i < results.length; i++) {
                 const res = results[i];
-                const meta = metas[i];
-                if (!res || !meta)
+                const s = v2Specs[i];
+                if (!s)
                     continue;
-                // success path
-                if (res.status === 'success' && Array.isArray(res.result)) {
-                    const [amountOut, sqrtAfter, ticks, gas] = res.result;
-                    const candidate = {
-                        amountOut,
-                        payload: {
-                            dex: meta.dex,
-                            quoterAddress: meta.quoter,
-                            method: meta.method,
-                            feeTier: meta.fee, // NOTE: tickSpacing for Slipstream
-                            amountOut: amountOut.toString(),
-                            gasEstimate: gas ? gas.toString() : undefined,
-                            sqrtPriceX96After: sqrtAfter ? sqrtAfter.toString() : undefined,
-                            initializedTicksCrossed: ticks,
-                            notes: (meta.isSlip ? 'Slipstream tickSpacing; ' : '') +
-                                (nativeIn || nativeOut
-                                    ? `Quoted with wrapped native: in=${nativeIn ? 'wrapped' : 'erc20'}, out=${nativeOut ? 'wrapped' : 'erc20'}`
-                                    : ''),
-                        },
-                    };
-                    if (!best || candidate.amountOut > best.amountOut)
-                        best = candidate;
+                if (!res)
                     continue;
-                }
-                // revert decode (some quoters return data on revert)
-                // @ts-ignore – Viem surfaces revert data in error.data
-                const data = res?.error?.data;
-                if (!data || data === '0x')
+                const decoded = s.adapter.decodeQuoterV2(res);
+                if (!decoded)
                     continue;
-                try {
-                    const [amountOut, sqrtAfter, ticks, gas] = (0, viem_1.decodeFunctionResult)({
-                        abi,
-                        functionName: 'quoteExactInputSingle',
-                        data,
-                    });
-                    const candidate = {
-                        amountOut,
-                        payload: {
-                            dex: meta.dex,
-                            quoterAddress: meta.quoter,
-                            method: meta.method,
-                            feeTier: meta.fee, // NOTE: tickSpacing for Slipstream
-                            amountOut: amountOut.toString(),
-                            gasEstimate: gas ? gas.toString() : undefined,
-                            sqrtPriceX96After: sqrtAfter ? sqrtAfter.toString() : undefined,
-                            initializedTicksCrossed: ticks,
-                            notes: (meta.isSlip ? 'Slipstream tickSpacing; ' : '') +
-                                (nativeIn || nativeOut
-                                    ? `Quoted with wrapped native: in=${nativeIn ? 'wrapped' : 'erc20'}, out=${nativeOut ? 'wrapped' : 'erc20'}`
-                                    : ''),
-                        },
-                    };
-                    if (!best || candidate.amountOut > (best.amountOut ?? 0n))
-                        best = candidate;
-                }
-                catch {
-                    /* ignore; continue */
+                if (decoded.amountOut > 0n) {
+                    if (!best || decoded.amountOut > best.amountOut) {
+                        best = {
+                            adapter: s.adapter,
+                            d: s.d,
+                            p: s.preset,
+                            amountOut: decoded.amountOut,
+                            sqrt: decoded.sqrt,
+                            ticks: decoded.ticks,
+                            gas: decoded.gas,
+                            meta: s.meta,
+                            method: 'QuoterV2.quoteExactInputSingle',
+                        };
+                    }
                 }
             }
-        };
-        handleV2Group(v2ResultsUniLike, v2MetasUniLike, uniswapV3_quoter_abi_1.uniswapV3QuoterAbi);
-        handleV2Group(v2ResultsSlip, v2MetasSlip, slipstream_quoter_abi_1.slipstreamQuoterAbi);
-        /** ---------------------------------------
-         * Round 2: Legacy Quoter (tuple) fallback
-         *   - Only for Uni-like deployments (Slipstream has no v1 tuple form)
-         * ------------------------------------- */
+        }
+        // If no V2 winner, try V1 where supported (Uniswap/V3Fork; NOT Slipstream)
         if (!best) {
-            const orthodoxUniLike = orthodox.filter(d => !this._isSlipstreamDexString(d.dex));
-            const v1Contracts = orthodoxUniLike.flatMap(d => {
-                const feeTiers = this._determineFeeTiersForDex(d.dex);
-                return feeTiers.map(fee => ({
-                    address: d.quoter,
-                    abi: uniswapV3_quoter_abi_1.uniswapV3QuoterAbi,
-                    functionName: 'quoteExactInputSingle',
-                    args: [
-                        {
-                            tokenIn: (0, viem_1.getAddress)(tokenInForQuote),
-                            tokenOut: (0, viem_1.getAddress)(tokenOutForQuote),
-                            fee,
-                            amountIn: amountInBI,
-                            sqrtPriceLimitX96: 0n,
-                        },
-                    ],
-                }));
-            });
-            const v1Metas = orthodoxUniLike.flatMap(d => this._determineFeeTiersForDex(d.dex).map(fee => ({
-                dex: (0, dex_deployment_key_1.dexDeploymentKey)({
-                    dex: d.dex,
-                    network: networkIn,
-                    router: d.router,
-                }),
-                fee,
-                quoter: d.quoter,
-                method: 'Quoter.quoteExactInputSingle',
-            })));
-            const v1Results = v1Contracts.length
-                ? await client.multicall({
-                    allowFailure: true,
-                    contracts: v1Contracts,
-                    ...(networkIn === enums_1.ChainIdEnum.HYPEREVM && {
-                        multicallAddress: '0xcA11bde05977b3631167028862bE2a173976CA11',
-                    }),
-                })
-                : [];
-            for (let i = 0; i < v1Results.length; i++) {
-                const res = v1Results[i];
-                const meta = v1Metas[i];
-                if (!meta || !res)
-                    continue;
-                if (res.status === 'success') {
-                    const [amountOut] = res.result;
-                    const candidate = {
-                        amountOut,
-                        payload: {
-                            dex: meta.dex,
-                            quoterAddress: meta.quoter,
-                            method: meta.method,
-                            feeTier: meta.fee,
-                            amountOut: amountOut.toString(),
-                            notes: nativeIn || nativeOut
-                                ? `Quoted with wrapped native: in=${nativeIn ? 'wrapped' : 'erc20'}, out=${nativeOut ? 'wrapped' : 'erc20'}`
-                                : undefined,
-                        },
-                    };
-                    if (!best || candidate.amountOut > best.amountOut)
-                        best = candidate;
+            const v1Specs = [];
+            for (const d of deployments) {
+                const adapter = this._getAdapter(d.dex);
+                // Slipstream throws on V1 – guard out by capability or key
+                const skipV1 = adapter.caps?.usesTickSpacing ||
+                    adapter.family === v3_dex_types_1.UniswapV3StyleDexFamilyEnum.SLIPSTREAM;
+                if (skipV1)
                     continue;
-                }
-                // Attempt decode from revert
-                // @ts-ignore
-                const data = res?.error?.data;
-                if (!data || data === '0x')
-                    continue;
-                try {
-                    const [amountOut] = (0, viem_1.decodeFunctionResult)({
-                        abi: uniswapV3_quoter_abi_1.uniswapV3QuoterAbi,
-                        functionName: 'quoteExactInputSingle',
-                        data,
-                    });
-                    const candidate = {
-                        amountOut,
-                        payload: {
-                            dex: meta.dex,
-                            quoterAddress: meta.quoter,
-                            method: meta.method,
-                            feeTier: meta.fee,
-                            amountOut: amountOut.toString(),
-                            notes: nativeIn || nativeOut
-                                ? `Quoted with wrapped native: in=${nativeIn ? 'wrapped' : 'erc20'}, out=${nativeOut ? 'wrapped' : 'erc20'}`
-                                : undefined,
-                        },
+                const presets = adapter.presets(networkIn);
+                for (const p of presets) {
+                    const poolKey = (0, to_pool_key_1.toPoolKey)(tokenInQ, tokenOutQ, p);
+                    const task = {
+                        deployment: d,
+                        tokenIn: tokenInQ,
+                        tokenOut: tokenOutQ,
+                        amountIn: amountInBI,
+                        poolKey,
+                        nativeIn,
+                        nativeOut,
                     };
-                    if (!best || candidate.amountOut > best.amountOut)
-                        best = candidate;
-                }
-                catch {
-                    /* ignore */
+                    try {
+                        const spec = adapter.buildQuoterV1Call(task);
+                        if (!spec)
+                            continue;
+                        v1Specs.push({ spec, adapter, meta: task, d, preset: p });
+                    }
+                    catch {
+                        /* unsupported; skip */
+                    }
                 }
             }
-        }
-        /** ---------------------------------------
-         * Round 3: Off-chain quoter (no on-chain quoter)
-         * ------------------------------------- */
-        {
-            const offchainCapable = quoterless.filter(d => !!d?.factory);
-            if (offchainCapable.length) {
-                const offchain = new v3_offchain_quoter_service_1.V3OffchainQuoter();
-                for (const d of offchainCapable) {
-                    try {
-                        // For off-chain we keep fee tiers (Uni-like). Slipstream off-chain
-                        // could be added later by scanning tickSpacing set; omitted here intentionally.
-                        const res = await offchain.fetchV3Quote({
-                            client,
-                            tokenIn: (0, viem_1.getAddress)(tokenInForQuote),
-                            tokenOut: (0, viem_1.getAddress)(tokenOutForQuote),
-                            amountIn: amountInBI,
-                            factory: (0, viem_1.getAddress)(d.factory),
-                            fees: this.uniFeeTiers,
-                        });
-                        if (res?.best && res.best.ok && res.best.amountOut > 0n) {
-                            const dexKey = (0, dex_deployment_key_1.dexDeploymentKey)({
-                                network: networkIn,
-                                router: d.router,
-                                dex: d.dex,
-                            });
-                            const candidate = {
-                                amountOut: res.best.amountOut,
-                                payload: {
-                                    dex: dexKey,
-                                    quoterAddress: undefined,
-                                    method: 'OffchainQuoter.simulateExactInputSingle',
-                                    feeTier: res.best.fee,
-                                    amountOut: res.best.amountOut.toString(),
-                                    sqrtPriceX96After: res.best.sqrtPriceX96After
-                                        ? res.best.sqrtPriceX96After.toString()
-                                        : undefined,
-                                    initializedTicksCrossed: res.best.initializedTicksCrossed,
-                                    notes: (nativeIn || nativeOut
-                                        ? `Quoted with wrapped native: in=${nativeIn ? 'wrapped' : 'erc20'}, out=${nativeOut ? 'wrapped' : 'erc20'}; `
-                                        : '') + `Factory=${(0, viem_1.getAddress)(d.factory)}`,
-                                },
+            if (v1Specs.length) {
+                const calls = v1Specs.map(s => ({
+                    address: s.spec.address,
+                    abi: s.spec.abi,
+                    functionName: s.spec.fn,
+                    args: s.spec.args,
+                }));
+                const results = await this._execBatch(networkIn, calls);
+                for (let i = 0; i < results.length; i++) {
+                    const res = results[i];
+                    const s = v1Specs[i];
+                    if (!s)
+                        continue;
+                    if (!res)
+                        continue;
+                    const decoded = s.adapter.decodeQuoterV1(res);
+                    if (!decoded)
+                        continue;
+                    if (decoded.amountOut > 0n) {
+                        if (!best || decoded.amountOut > best.amountOut) {
+                            best = {
+                                adapter: s.adapter,
+                                d: s.d,
+                                p: s.preset,
+                                amountOut: decoded.amountOut,
+                                meta: s.meta,
+                                method: 'Quoter.quoteExactInputSingle',
                             };
-                            if (!best || candidate.amountOut > best.amountOut)
-                                best = candidate;
                         }
                     }
-                    catch {
-                        // ignore this deployment; continue to next
-                    }
                 }
             }
         }
         if (!best) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, `No V3-style quote could be found`);
-        }
-        return {
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, 'No CLMM quote could be found');
+        }
+        const payload = {
+            dex: best.d.dex,
+            router: best.d.router,
+            quoter: best.d.quoter,
+            method: best.method,
+            feeOrTick: best.p,
+            amountOut: best.amountOut.toString(),
+            sqrtPriceX96After: best.sqrt ? best.sqrt.toString() : undefined,
+            initializedTicksCrossed: best?.ticks,
+            gasEstimate: best.gas ? best.gas.toString() : undefined,
+            notes: (nativeIn || nativeOut
+                ? `Quoted with wrapped native (in=${nativeIn ? 'wrapped' : 'erc20'}, out=${nativeOut ? 'wrapped' : 'erc20'}). `
+                : '') + `Adapter=${best.adapter.constructor.name}`,
+        };
+        const priceResponse = {
             protocol: this.protocol,
             networkIn,
             networkOut,
@@ -749,728 +274,222 @@ class V3StyleDexService {
             amountIn,
             amountOut: best.amountOut.toString(),
             slippage,
-            protocolResponse: best.payload,
+            protocolResponse: payload,
         };
+        logger.info(`V3StyleDexService: Fetched price: ${amountIn} ${tokenIn} -> ${priceResponse.amountOut} ${tokenOut} on ${networkIn} via ${best.d.dex}`);
+        return priceResponse;
     }
+    /** -----------------------------------------------------------------------
+     * fetchQuote
+     * --------------------------------------------------------------------- */
     async fetchQuote(params) {
-        const { networkIn, networkOut, tokenIn, tokenOut, amountIn, slippage, from, receiver, overrideParamsV3Dex, } = params;
-        if (overrideParamsV3Dex &&
-            overrideParamsV3Dex.nativePrice &&
-            overrideParamsV3Dex.tokenInPrice &&
-            overrideParamsV3Dex.tokenInDecimals) {
-            await this._validateNativeLiquidity({
-                tokenIn,
-                networkIn: enums_1.ChainIdEnum.UNKNOWN,
-                dexes: this.deployments[networkIn]?.map(d => d.dex) ?? [],
-                nativePrice: overrideParamsV3Dex.nativePrice,
-                tokenInPrice: overrideParamsV3Dex.tokenInPrice,
-                tokenInDecimals: overrideParamsV3Dex.tokenInDecimals,
-            });
-        }
+        const { networkIn, networkOut, tokenIn, tokenOut, amountIn, slippage, from, receiver, priceResponse, } = params;
         if (networkIn !== networkOut) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, 'V3StyleDexService.fetchQuote supports only single-chain swaps');
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, 'V3StyleDexService supports only single-chain swaps');
         }
-        const amountInBI = BigInt(amountIn);
-        if (amountInBI <= 0n) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, 'amountIn must be greater than zero to fetch quote');
-        }
-        // Native normalization for execution paths
-        const expectNativeIn = (0, is_native_1.isNative)(tokenIn);
-        const expectNativeOut = (0, is_native_1.isNative)(tokenOut);
-        const wrapped = wrapped_native_1.wrappedNativeTokens[networkIn];
-        if ((expectNativeIn || expectNativeOut) && !wrapped) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Missing wrapped native token mapping for chainId ${networkIn}`);
+        const client = this._clients[networkIn];
+        if (!client) {
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No RPC client configured for chainId ${networkIn}`);
         }
-        const tokenInExec = (expectNativeIn ? wrapped : tokenIn);
-        const tokenOutExec = (expectNativeOut ? wrapped : tokenOut);
-        // Price discovery (now includes Slipstream tickSpacing handling via fetchPrice)
-        let v3Price;
-        if (!params?.priceResponse) {
-            let priceRes;
-            try {
-                priceRes = await this.fetchPrice({
-                    networkIn,
-                    networkOut,
-                    tokenIn,
-                    tokenOut,
-                    amountIn,
-                    from,
-                    slippage,
-                    overrideParamsV3Dex,
-                });
-            }
-            catch (e) {
-                const errorMessage = e.message ?? e;
-                throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, errorMessage);
-            }
-            v3Price = priceRes.protocolResponse;
+        let price = undefined;
+        if (priceResponse) {
+            logger.info(`V3StyleDexService: Using provided price response for quote fetch.`);
+            price = priceResponse;
         }
         else {
-            v3Price = params.priceResponse.protocolResponse;
+            logger.info(`V3StyleDexService: Fetching price for quote.`);
+            price = await this.fetchPrice(params);
+        }
+        const overrides = params?.overrideParamsV3Dex;
+        const overridePairCandidate = overrides?.pairCandidate;
+        const overrideSqrtPriceX96After = overridePairCandidate?.sqrtPriceX96After;
+        const sqrtPriceX96After = overrideSqrtPriceX96After
+            ? overrideSqrtPriceX96After
+            : price.protocolResponse && 'sqrtPriceX96After' in price.protocolResponse
+                ? price.protocolResponse.sqrtPriceX96After
+                : undefined;
+        const pp = price.protocolResponse;
+        const deployments = this._deployments[networkIn] ?? [];
+        const deployment = deployments.find(d => d.dex === pp.dex && d.router.toLowerCase() === pp.router.toLowerCase()) ?? deployments.find(d => d.dex === pp.dex);
+        if (!deployment) {
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No deployment found for ${pp.dex} on ${networkIn}`);
         }
-        if (!v3Price || !v3Price.amountOut || v3Price.amountOut === '0') {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, 'No V3-style quote could be found');
+        const adapter = this._getAdapter(deployment.dex);
+        logger.info(`V3StyleDexService: Building quote for ${amountIn} ${tokenIn} -> ${price.amountOut} ${tokenOut} on ${networkIn} via ${deployment.dex}`);
+        // Native flags & recipient
+        const nativeIn = (0, is_native_1.isNative)(tokenIn);
+        const nativeOut = (0, is_native_1.isNative)(tokenOut);
+        const wrapped = wrapped_native_1.wrappedNativeTokens[networkIn];
+        if ((nativeIn || nativeOut) && !wrapped) {
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Missing wrapped native token mapping for ${networkIn}`);
         }
-        // Slippage handling (percent)
-        const bestAmountOut = BigInt(v3Price.amountOut);
+        const recipient = (receiver || from);
         const slippagePct = typeof slippage === 'number' ? slippage : Number(slippage || 0);
-        const amountOutMin = (0, min_amount_out_1.calculateMinAmountOut)({
-            amountOut: bestAmountOut.toString(),
+        // Build the "pick" for the adapter
+        const poolKey = (0, to_pool_key_1.toPoolKey)(nativeIn ? wrapped : tokenIn, nativeOut ? wrapped : tokenOut, pp.feeOrTick);
+        const task = {
+            deployment,
+            tokenIn: poolKey.tokenA === tokenIn
+                ? tokenIn
+                : nativeIn
+                    ? wrapped
+                    : tokenIn,
+            tokenOut: poolKey.tokenB === tokenOut
+                ? tokenOut
+                : nativeOut
+                    ? wrapped
+                    : tokenOut,
+            amountIn: BigInt(amountIn),
+            poolKey,
+            nativeIn,
+            nativeOut,
+        };
+        const pick = {
+            task,
+            amountOut: BigInt(price.amountOut),
+            decoded: { feeOrTick: pp.feeOrTick, quoter: pp.quoter, method: pp.method },
+        };
+        // Adapter calldata
+        const calldataInput = {
+            pick,
             slippage: slippagePct,
-        });
-        // Router resolution:
-        const deployments = this.deployments[networkIn] ?? [];
-        let chosenRouter;
-        if (v3Price.quoterAddress) {
-            const matching = deployments.find(d => (d.quoter?.toLowerCase() ?? '') === v3Price.quoterAddress.toLowerCase());
-            chosenRouter = matching?.router;
-        }
-        if (!chosenRouter && v3Price.dex) {
-            // dex is encoded as "<DEX_ENUM>:<router>:<network>" from _buildDexKey
-            const maybeRouter = deployments.find(d => v3Price.dex.startsWith(`${d.dex}:`))?.router;
-            chosenRouter = maybeRouter;
-        }
-        if (!chosenRouter) {
-            chosenRouter = deployments.find(d => !!d.router)?.router;
-        }
-        if (!chosenRouter) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No router found for selected deployment on network ${networkIn}`);
-        }
-        const deadline = BigInt(Math.floor(Date.now() / 1000) + 30 * 60); // 30 minutes
-        const recipientForFirstLeg = expectNativeOut
-            ? (0, viem_1.getAddress)(chosenRouter)
-            : (0, viem_1.getAddress)(receiver || from);
-        const isSushiV3 = this._isDex(v3_dex_types_1.UniswapV3StyleDexEnum.SUSHISWAP_V3, v3Price);
-        const isPancakeV3 = this._isDex(v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3, v3Price);
-        const isPangolinV3 = this._isDex(v3_dex_types_1.UniswapV3StyleDexEnum.PANGOLIN_V3, v3Price);
-        const isPharaoh = this._isDex(v3_dex_types_1.UniswapV3StyleDexEnum.PHARAOH_CLMM, v3Price);
-        const isSlipstream = this._isDex(v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM, v3Price) ||
-            this._isDex(v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM, v3Price);
-        let data;
-        let methodForResponse;
-        let txValue = expectNativeIn ? amountInBI.toString() : '0';
-        if (isSushiV3) {
-            /**
-             * -------------------------
-             * Sushi Route Processor 9
-             * -------------------------
-             * Uses route bytes (off-chain). We set a sentinel here.
-             */
-            const routeBytes = '0x';
-            const takeSurplus = false;
-            const referralCode = 0;
-            if (expectNativeIn) {
-                data = (0, viem_1.encodeFunctionData)({
-                    abi: sushiswap_route_processor_9_abi_1.sushiswapRouteProcessor9Abi,
-                    functionName: 'processRouteWithTransferValueInput',
-                    args: [
-                        (0, viem_1.getAddress)(chosenRouter), // transferValueTo (RP9)
-                        amountInBI, // amountValueTransfer
-                        (0, viem_1.getAddress)(tokenInExec),
-                        amountInBI,
-                        (0, viem_1.getAddress)(tokenOutExec),
-                        amountOutMin,
-                        (0, viem_1.getAddress)(receiver || from),
-                        routeBytes,
-                        takeSurplus,
-                        referralCode,
-                    ],
-                });
-                methodForResponse = 'RouteProcessor9.processRouteWithTransferValueInput';
-                // txValue already equals amountIn for native-in
-            }
-            else {
-                data = (0, viem_1.encodeFunctionData)({
-                    abi: sushiswap_route_processor_9_abi_1.sushiswapRouteProcessor9Abi,
-                    functionName: 'processRoute',
-                    args: [
-                        (0, viem_1.getAddress)(tokenInExec),
-                        amountInBI,
-                        (0, viem_1.getAddress)(tokenOutExec),
-                        amountOutMin,
-                        (0, viem_1.getAddress)(receiver || from),
-                        routeBytes,
-                        takeSurplus,
-                        referralCode,
-                    ],
-                });
-                methodForResponse = 'RouteProcessor9.processRoute';
-                txValue = '0';
-            }
-        }
-        else {
-            // Choose router ABI (Slipstream vs Uni-like)
-            const routerAbi = isSlipstream
-                ? slipstream_router_abi_1.slipstreamRouterAbi
-                : isPancakeV3 || isPangolinV3 || isPharaoh
-                    ? pacakeswapV3_router_abi_1.pancakeswapV3RouterAbi
-                    : uniswapV3_router_abi_1.uniswapV3RouterAbi;
-            // Build exactInputSingle calldata
-            let exactInputSingleCalldata;
-            if (isSlipstream) {
-                // Slipstream uses tickSpacing (int24) and includes deadline in the struct
-                const struct = {
-                    tokenIn: (0, viem_1.getAddress)(tokenInExec),
-                    tokenOut: (0, viem_1.getAddress)(tokenOutExec),
-                    tickSpacing: Number(v3Price.feeTier ?? 60), // feeTier carries tickSpacing for Slipstream
-                    recipient: recipientForFirstLeg,
-                    deadline,
-                    amountIn: amountInBI,
-                    amountOutMinimum: amountOutMin,
-                    sqrtPriceLimitX96: 0n,
-                };
-                exactInputSingleCalldata = (0, viem_1.encodeFunctionData)({
-                    abi: routerAbi,
-                    functionName: 'exactInputSingle',
-                    args: [struct],
-                });
-            }
-            else {
-                // Uni/Pancake/Pangolin use fee (uint24)
-                const struct = isPancakeV3 || isPangolinV3 || isPharaoh
-                    ? {
-                        tokenIn: (0, viem_1.getAddress)(tokenInExec),
-                        tokenOut: (0, viem_1.getAddress)(tokenOutExec),
-                        fee: (v3Price.feeTier ?? 3000),
-                        recipient: recipientForFirstLeg,
-                        deadline,
-                        amountIn: amountInBI,
-                        amountOutMinimum: amountOutMin,
-                        sqrtPriceLimitX96: 0n,
-                    }
-                    : {
-                        tokenIn: (0, viem_1.getAddress)(tokenInExec),
-                        tokenOut: (0, viem_1.getAddress)(tokenOutExec),
-                        fee: (v3Price.feeTier ?? 3000),
-                        recipient: recipientForFirstLeg,
-                        amountIn: amountInBI,
-                        amountOutMinimum: amountOutMin,
-                        sqrtPriceLimitX96: 0n,
-                    };
-                exactInputSingleCalldata = (0, viem_1.encodeFunctionData)({
-                    abi: routerAbi,
-                    functionName: 'exactInputSingle',
-                    args: [struct],
-                });
-            }
-            if (expectNativeOut) {
-                const unwrapCalldata = (0, viem_1.encodeFunctionData)({
-                    abi: routerAbi,
-                    functionName: 'unwrapWETH9',
-                    args: [amountOutMin, (0, viem_1.getAddress)(receiver || from)],
-                });
-                data = (0, viem_1.encodeFunctionData)({
-                    abi: routerAbi,
-                    functionName: 'multicall',
-                    args: [[exactInputSingleCalldata, unwrapCalldata]],
-                });
-                methodForResponse = 'SwapRouter.exactInputSingle';
-            }
-            else {
-                data = exactInputSingleCalldata;
-                methodForResponse = 'SwapRouter.exactInputSingle';
-            }
-        }
-        // ETH value handling:
-        const approval = expectNativeIn
-            ? undefined
-            : {
-                token: (0, viem_1.getAddress)(tokenIn),
-                spender: chosenRouter,
-                amount: amountInBI.toString(),
-            };
+            recipient,
+            expectNativeIn: nativeIn,
+            expectNativeOut: nativeOut,
+            deadline: BigInt(Math.floor(Date.now() / 1000) + 1800), // +30 mins
+            sqrtPriceLimitX96: BigInt(sqrtPriceX96After || 0),
+        };
+        const cd = adapter.buildCalldata(calldataInput);
+        logger.info(`V3StyleDexService: Built calldata for quote: to=${cd.to} data=${cd.data} value=${cd.valueWei}`);
+        // Build approval if ERC-20 in
+        const approvalToken = nativeIn ? constants_1.ZERO_ADDRESS : tokenIn;
+        const approvalAmount = nativeIn ? BigInt(0) : BigInt(amountIn);
+        const approvalSpender = nativeIn ? constants_1.ZERO_ADDRESS : cd.to;
+        const approval = {
+            token: approvalToken,
+            spender: approvalSpender,
+            amount: approvalAmount.toString(),
+        };
         const evmExecutionPayload = {
             transactionData: {
-                to: chosenRouter,
-                data,
-                value: txValue,
+                to: cd.to,
+                data: cd.data,
+                value: cd.valueWei ?? '0',
                 gasEstimate: '0',
                 gasLimit: '0',
             },
-            ...(approval && { approval }),
+            approval,
         };
-        const dexEnum = this._convertKeyToDexEnum(v3Price.dex);
-        const deployment = this.deployments[networkIn]?.find(d => d.dex === dexEnum && d.router.toLowerCase() === chosenRouter.toLowerCase());
-        if (!deployment) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No deployment found for dex ${dexEnum} on network ${networkIn}.`);
-        }
-        // CREATE2 pair computation:
-        const pairAddress = this._create2Address({
-            dex: dexEnum,
-            factory: deployment?.factory,
-            deployer: deployment?.deployer,
-            initHash: deployment?.initHash,
-            tokenA: tokenInExec,
-            tokenB: tokenOutExec,
-            fee: v3Price.feeTier, // NOTE: for Slipstream this is tickSpacing (int24)
-        });
-        const protocolResponse = {
-            dex: v3Price.dex,
-            pair: (0, viem_1.getAddress)(pairAddress),
-            routerAddress: chosenRouter,
-            quoterAddress: v3Price.quoterAddress,
-            feeTier: v3Price.feeTier, // tickSpacing for Slipstream
-            method: methodForResponse,
-            amountOut: bestAmountOut.toString(),
-            amountOutMin: amountOutMin.toString(),
-            calldata: data,
-            value: txValue,
-            gasEstimate: v3Price.gasEstimate,
-            sqrtPriceX96After: v3Price.sqrtPriceX96After,
-            initializedTicksCrossed: v3Price.initializedTicksCrossed,
-            notes: (v3Price.method?.startsWith('OffchainQuoter') ? 'Off-chain pool simulation; ' : '') +
-                (isSlipstream ? 'Slipstream tickSpacing; ' : '') +
-                (isSushiV3
-                    ? 'Sushi Route Processor 9 calldata (route bytes expected from off-chain pathfinder); '
-                    : '') +
-                (expectNativeIn ? 'Native in; ' : '') +
-                (expectNativeOut
-                    ? isSushiV3
-                        ? 'Native out handled inside route bytes.'
-                        : 'Native out via multicall(unwrapWETH9).'
-                    : 'ERC-20 out to recipient.'),
+        // For completeness, compute minOut here for protocol payload
+        const amountOutMin = (0, min_amount_out_1.calculateMinAmountOut)({
+            amountOut: price.amountOut,
+            slippage: slippagePct,
+        }).toString();
+        const qPayload = {
+            dex: deployment.dex,
+            router: cd.to,
+            quoter: deployment.quoter,
+            method: cd.methodName,
+            feeOrTick: pp.feeOrTick,
+            amountOut: price.amountOut,
+            amountOutMin,
+            calldata: cd.data,
+            value: cd.valueWei ?? '0',
+            notes: (nativeIn ? 'Native in; ' : '') +
+                (nativeOut ? 'Native out via unwrap; ' : '') +
+                `Adapter=${adapter.constructor.name}`,
         };
-        return {
+        const quoteResponse = {
             protocol: this.protocol,
             networkIn,
             networkOut,
             tokenIn,
             tokenOut,
             amountIn,
-            amountOut: bestAmountOut.toString(),
-            estimatedGas: v3Price.gasEstimate,
+            amountOut: price.amountOut,
+            estimatedGas: pp.gasEstimate,
             slippage,
             from,
             receiver,
             evmExecutionPayload,
-            protocolResponse,
-        };
-    }
-    _convertKeyToDexEnum(dexKey) {
-        const parts = dexKey.split(':');
-        if (parts.length !== 3) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Invalid dex key format: ${dexKey}`);
-        }
-        const dexEnum = parts[0];
-        if (![
-            v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3,
-            v3_dex_types_1.UniswapV3StyleDexEnum.SUSHISWAP_V3,
-            v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3,
-            v3_dex_types_1.UniswapV3StyleDexEnum.PANGOLIN_V3,
-            v3_dex_types_1.UniswapV3StyleDexEnum.HYPERSWAP_V3,
-            v3_dex_types_1.UniswapV3StyleDexEnum.PHARAOH_CLMM,
-            v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM,
-            v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM,
-        ].includes(dexEnum)) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Unknown dex enum in key: ${dexKey}`);
-        }
-        return dexEnum;
-    }
-    _determineFeeTiersForDex(dexString) {
-        const dex = dexString === v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3
-            ? v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3
-            : dexString === v3_dex_types_1.UniswapV3StyleDexEnum.PANGOLIN_V3
-                ? v3_dex_types_1.UniswapV3StyleDexEnum.PANGOLIN_V3
-                : dexString === v3_dex_types_1.UniswapV3StyleDexEnum.SUSHISWAP_V3
-                    ? v3_dex_types_1.UniswapV3StyleDexEnum.SUSHISWAP_V3
-                    : dexString === v3_dex_types_1.UniswapV3StyleDexEnum.HYPERSWAP_V3
-                        ? v3_dex_types_1.UniswapV3StyleDexEnum.HYPERSWAP_V3
-                        : dexString === v3_dex_types_1.UniswapV3StyleDexEnum.PHARAOH_CLMM
-                            ? v3_dex_types_1.UniswapV3StyleDexEnum.PHARAOH_CLMM
-                            : dexString === v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM
-                                ? v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM
-                                : dexString === v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM
-                                    ? v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM
-                                    : v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3;
-        switch (dex) {
-            case v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3:
-                return this.pancakeFeeTiers;
-            case v3_dex_types_1.UniswapV3StyleDexEnum.PANGOLIN_V3:
-                return this.pangolinFeeTiers;
-            case v3_dex_types_1.UniswapV3StyleDexEnum.SUSHISWAP_V3:
-                return this.uniFeeTiers;
-            case v3_dex_types_1.UniswapV3StyleDexEnum.HYPERSWAP_V3:
-                return this.hyperswapFeeTiers;
-            case v3_dex_types_1.UniswapV3StyleDexEnum.PHARAOH_CLMM:
-                return this.pharaohFeeTiers;
-            case v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM:
-                return this.aerodromeFeeTiers;
-            case v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM:
-                return this.velodromeFeeTiers;
-            case v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3:
-            default:
-                return this.uniFeeTiers;
-        }
-    }
-    _isDex(expectedDex, v3Price) {
-        return !!v3Price?.dex && v3Price.dex.startsWith(`${expectedDex}:`);
-    }
-    _create2Address(params) {
-        const { dex, initHash, tokenA, tokenB, fee, deployer, factory } = params;
-        const isSlip = dex === v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM || dex === v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM;
-        // For Pancake V3 you already special-case deployer vs factory; Slipstream uses factory as deployer.
-        const addressToUse = dex === v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3 ? deployer : factory;
-        const a = (0, viem_1.getAddress)(tokenA);
-        const b = (0, viem_1.getAddress)(tokenB);
-        const [token0, token1] = (0, sort_addresses_1.sortAddresses)(a, b);
-        // SLIPSTREAM: salt = keccak256(abi.encode(address,address,int24 tickSpacing))
-        // UNI-LIKE:   salt = keccak256(abi.encode(address,address,uint24 fee))
-        const encoded = isSlip
-            ? (0, viem_1.encodeAbiParameters)([{ type: 'address' }, { type: 'address' }, { type: 'int24' }], [token0, token1, fee])
-            : (0, viem_1.encodeAbiParameters)([{ type: 'address' }, { type: 'address' }, { type: 'uint24' }], [token0, token1, fee]);
-        const salt = (0, ethers_1.keccak256)(encoded);
-        const digest = (0, ethers_1.keccak256)((0, viem_1.concat)([
-            (0, viem_1.hexToBytes)('0xff'),
-            (0, viem_1.hexToBytes)(addressToUse),
-            (0, viem_1.hexToBytes)(salt),
-            (0, viem_1.hexToBytes)(initHash),
-        ]));
-        return (0, viem_1.getAddress)(`0x${digest.slice(26)}`);
-    }
-    async _validateNativeLiquidity(params) {
-        const { tokenIn, networkIn, dexes, nativePrice, tokenInPrice, tokenInDecimals } = params;
-        // --- setup & guards
-        const stable = constants_1.networkStablecoins[networkIn];
-        if (!stable) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No stablecoin mapping for chainId ${networkIn}`);
-        }
-        const usdcEntry = stable.usdc; // { address, decimals } | undefined
-        const usdtEntry = stable.usdt;
-        const wrappedNative = wrapped_native_1.wrappedNativeTokens[networkIn]; // string
-        const tokenInAddr = (0, viem_1.getAddress)(tokenIn);
-        const baseTokenAddrs = [wrappedNative, usdcEntry?.address, usdtEntry?.address]
-            .filter((a) => !!a)
-            .filter(a => !(0, is_native_1.isNative)(a))
-            .map(a => (0, viem_1.getAddress)(a))
-            .filter(a => a !== tokenInAddr);
-        if (baseTokenAddrs.length === 0) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No valid base tokens (WETH/USDC/USDT) for liquidity check on chainId ${networkIn}`);
-        }
-        const deployments = (this.deployments[networkIn] ?? []).filter(d => dexes.includes(d.dex));
-        if (!deployments.length) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No V3-style deployments configured for network ${networkIn} (requested: ${dexes.join(', ')})`);
-        }
-        const client = this._clients[networkIn];
-        if (!client) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No RPC client configured for chainId ${networkIn}`);
-        }
-        const feeTiers = this.uniFeeTiers; // e.g. [500, 3000, 10000]
-        // --- helpers
-        const isWrappedNative = (addr) => !!wrappedNative &&
-            (0, viem_1.getAddress)(addr).toLowerCase() === (0, viem_1.getAddress)(wrappedNative).toLowerCase();
-        const stableAddrLower = new Set([
-            usdcEntry?.address ? (0, viem_1.getAddress)(usdcEntry.address).toLowerCase() : '',
-            usdtEntry?.address ? (0, viem_1.getAddress)(usdtEntry.address).toLowerCase() : '',
-        ].filter(Boolean));
-        const isStable = (addr) => stableAddrLower.has(addr.toLowerCase());
-        const getBaseDecimals = (base) => {
-            const lower = base.toLowerCase();
-            if (usdcEntry && (0, viem_1.getAddress)(usdcEntry.address).toLowerCase() === lower)
-                return usdcEntry.decimals;
-            if (usdtEntry && (0, viem_1.getAddress)(usdtEntry.address).toLowerCase() === lower)
-                return usdtEntry.decimals;
-            if (isWrappedNative(base))
-                return 18; // adjust per-chain if needed
-            return 18; // fallback for any other ERC-20s you might allow as base later
+            protocolResponse: qPayload,
         };
-        const getBasePriceUSD = (base) => (isStable(base) ? 1 : nativePrice);
-        // --- 1) deterministically build all candidate pool addresses (off-chain)
-        // UniswapV3 pools always order tokens by address (token0 < token1) for the salt.
-        // _create2Address MUST do this internally (or we do it here before calling).
-        const candidatesMap = new Map(); // dedupe by pool address
-        for (const d of deployments) {
-            for (const base of baseTokenAddrs) {
-                for (const fee of feeTiers) {
-                    // compute deterministic address
-                    const poolAddr = this._create2Address({
-                        dex: d.dex,
-                        factory: d.factory,
-                        deployer: d.deployer,
-                        initHash: d.initHash, // whatever your deployment holds
-                        tokenA: tokenInAddr,
-                        tokenB: base,
-                        fee,
-                    });
-                    const key = poolAddr.toLowerCase();
-                    if (!candidatesMap.has(key)) {
-                        candidatesMap.set(key, { pool: poolAddr, baseToken: base, dex: d.dex, fee });
-                    }
-                }
-            }
-        }
-        const candidates = [...candidatesMap.values()];
-        if (!candidates.length) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No candidate V3 pools could be constructed for chainId ${networkIn}`);
-        }
-        // --- 2) single multicall: balanceOf(tokenIn, pool) + balanceOf(base, pool) for each candidate
-        const balanceCalls = candidates.flatMap(({ pool, baseToken }) => [
-            {
-                address: tokenInAddr,
-                abi: viem_1.erc20Abi,
-                functionName: 'balanceOf',
-                args: [pool],
-            },
-            {
-                address: baseToken,
-                abi: viem_1.erc20Abi,
-                functionName: 'balanceOf',
-                args: [pool],
-            },
-        ]);
-        const balanceResults = await client.multicall({
-            allowFailure: true,
-            contracts: balanceCalls,
-            ...(networkIn === enums_1.ChainIdEnum.HYPEREVM && {
-                multicallAddress: '0xcA11bde05977b3631167028862bE2a173976CA11',
-            }),
-        });
-        const poolTVLs = [];
-        for (let i = 0; i < candidates.length; i++) {
-            const candidate = candidates[i];
-            if (!candidate)
-                continue; // should not happen
-            const { pool, baseToken } = candidate;
-            const tokenInBalRes = balanceResults[i * 2];
-            const baseBalRes = balanceResults[i * 2 + 1];
-            const tokenInRaw = tokenInBalRes?.status === 'success' && typeof tokenInBalRes.result === 'bigint'
-                ? tokenInBalRes.result
-                : 0n;
-            const baseRaw = baseBalRes?.status === 'success' && typeof baseBalRes.result === 'bigint'
-                ? baseBalRes.result
-                : 0n;
-            // quick skip if both zero to avoid NaN issues later
-            if (tokenInRaw === 0n && baseRaw === 0n)
-                continue;
-            const baseDec = getBaseDecimals(baseToken);
-            const tokenInAmt = Number(tokenInRaw) / 10 ** tokenInDecimals;
-            const baseAmt = Number(baseRaw) / 10 ** baseDec;
-            const usdValue = tokenInAmt * tokenInPrice + baseAmt * getBasePriceUSD(baseToken);
-            poolTVLs.push({
-                pool,
-                baseToken,
-                usdValue,
-                baseIsNative: isWrappedNative(baseToken) ?? false,
-            });
-        }
-        if (!poolTVLs.length) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, `No liquidity detected for ${tokenIn} on chainId ${networkIn} across requested dexes: ${dexes.join(', ')}`);
-        }
-        // --- 4) pick the most liquid and validate base
-        poolTVLs.sort((a, b) => b.usdValue - a.usdValue);
-        const top = poolTVLs[0];
-        if (!top) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, `No liquidity detected for ${tokenIn} on chainId ${networkIn} across requested dexes: ${dexes.join(', ')}`);
-        }
-        if (isStable(top.baseToken)) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, `Most liquid pool for ${tokenIn} on chain ${networkIn} is against a stablecoin, not native.`);
-        }
-        if (!top.baseIsNative) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, `Most liquid pool for ${tokenIn} is not against the native token.`);
-        }
-        // success — top pool is native-based
-        return;
-    }
-    /**
-     * Read token0, token1, fee from a known pool via a single multicall,
-     * then identify which configured deployment this pool belongs to by
-     * recomputing CREATE2 for each deployment and comparing addresses.
-     */
-    async _resolvePairDeploymentFast(network, pair) {
-        const client = this._clients[network];
-        if (!client) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No RPC client configured for chainId ${network}`);
-        }
-        const [t0, t1, feeRes] = (await client.multicall({
-            allowFailure: false,
-            contracts: [
-                { address: pair, abi: uniswapV3_pool_abi_1.uniswapV3PoolAbi, functionName: 'token0' },
-                { address: pair, abi: uniswapV3_pool_abi_1.uniswapV3PoolAbi, functionName: 'token1' },
-                { address: pair, abi: uniswapV3_pool_abi_1.uniswapV3PoolAbi, functionName: 'fee' },
-            ],
-            ...(network === enums_1.ChainIdEnum.HYPEREVM && {
-                multicallAddress: '0xcA11bde05977b3631167028862bE2a173976CA11',
-            }),
-        }));
-        if (t0.status !== 'success' || t1.status !== 'success' || feeRes.status !== 'success') {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Failed to read pool data from pair address ${pair} on chain ${network}`);
-        }
-        const token0 = (0, viem_1.getAddress)(t0.result);
-        const token1 = (0, viem_1.getAddress)(t1.result);
-        const fee = Number(feeRes.result);
-        const pairLower = pair.toLowerCase();
-        const deployments = this.deployments[network] ?? [];
-        for (const d of deployments) {
-            const expected = this._create2Address({
-                dex: d.dex,
-                factory: d.factory,
-                deployer: d.deployer,
-                initHash: d.initHash,
-                tokenA: token0,
-                tokenB: token1,
-                fee,
-            });
-            if (expected.toLowerCase() === pairLower) {
-                return {
-                    token0,
-                    token1,
-                    fee,
-                    deployment: {
-                        dex: d.dex,
-                        router: d.router,
-                        quoter: d.quoter,
-                        factory: d.factory,
-                        deployer: d.deployer,
-                        initHash: d.initHash,
-                    },
-                };
-            }
-        }
-        throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Pair ${pair} does not match any configured V3 deployments on chain ${network}`);
+        logger.info(`V3StyleDexService: Built quote response for ${amountIn} ${tokenIn} -> ${quoteResponse.amountOut} ${tokenOut} on ${networkIn} via ${deployment.dex}`);
+        return quoteResponse;
     }
-    /**
-     * Fast-quote using a known pair:
-     *  - Validate the pair matches tokenIn/tokenOut (after native wrapping).
-     *  - Use the single matched deployment's quoter if present (V2 -> V1 fallback).
-     *  - Else, fallback to Offchain quoter limited to this one factory + fee.
-     */
-    async _fetchKnownPairPrice(params) {
-        const { network, tokenInForQuote, tokenOutForQuote, amountInBI, pair } = params;
+    // --------------------------- Internals -------------------------------------
+    async _execBatch(network, contracts) {
         const client = this._clients[network];
         if (!client) {
             throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No RPC client configured for chainId ${network}`);
         }
-        // 1) Resolve pool meta + deployment (single multicall + deterministic match)
-        const { token0, token1, fee, deployment } = await this._resolvePairDeploymentFast(network, pair);
-        // Confirm the requested direction is (tokenIn, tokenOut) ∈ {(token0,token1),(token1,token0)}
-        const inLower = (0, viem_1.getAddress)(tokenInForQuote).toLowerCase();
-        const outLower = (0, viem_1.getAddress)(tokenOutForQuote).toLowerCase();
-        const t0 = token0.toLowerCase();
-        const t1 = token1.toLowerCase();
-        const directionValid = (inLower === t0 && outLower === t1) || (inLower === t1 && outLower === t0);
-        if (!directionValid) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Supplied pair/token direction mismatch. Pair ${pair} tokens are ${token0}/${token1}; received ${tokenInForQuote}/${tokenOutForQuote}`);
-        }
-        // Build dex key for response routing
-        const dexKey = (0, dex_deployment_key_1.dexDeploymentKey)({
-            dex: deployment.dex,
-            router: deployment.router,
-            network,
-        });
-        // 2) Try on-chain quoter (struct signature first, then legacy)
-        if (deployment?.quoter) {
-            // V2 (struct)
-            try {
-                // V2 (struct) via static call
-                const sim = await client.simulateContract({
-                    address: deployment.quoter,
-                    abi: uniswapV3_quoter_abi_1.uniswapV3QuoterAbi,
-                    functionName: 'quoteExactInputSingle',
-                    args: [
-                        {
-                            tokenIn: (0, viem_1.getAddress)(tokenInForQuote),
-                            tokenOut: (0, viem_1.getAddress)(tokenOutForQuote),
-                            amountIn: amountInBI,
-                            fee,
-                            sqrtPriceLimitX96: 0n,
-                        },
-                    ],
-                });
-                const [amountOut, sqrtAfter, ticks, gas] = sim.result;
-                return {
-                    amountOut,
-                    payload: {
-                        dex: dexKey,
-                        quoterAddress: deployment.quoter,
-                        method: 'QuoterV2.quoteExactInputSingle',
-                        feeTier: fee,
-                        amountOut: amountOut.toString(),
-                        gasEstimate: gas ? gas.toString() : undefined,
-                        sqrtPriceX96After: sqrtAfter ? sqrtAfter.toString() : undefined,
-                        initializedTicksCrossed: ticks,
-                        notes: `Known pair fast path (${pair}).`,
-                    },
-                };
-            }
-            catch (eV2) {
-                // Legacy V1 (tuple) via static call
+        if (network === enums_1.ChainIdEnum.HYPEREVM) {
+            return Promise.all(contracts.map(async (c) => {
                 try {
-                    const simV1 = await client.simulateContract({
-                        address: deployment.quoter,
-                        abi: uniswapV3_quoter_abi_1.uniswapV3QuoterAbi,
-                        functionName: 'quoteExactInputSingle',
-                        args: [
-                            {
-                                tokenIn: (0, viem_1.getAddress)(tokenInForQuote),
-                                tokenOut: (0, viem_1.getAddress)(tokenOutForQuote),
-                                fee,
-                                amountIn: amountInBI,
-                                sqrtPriceLimitX96: 0n,
-                            },
-                        ],
-                    });
-                    const [amountOut] = simV1.result;
-                    return {
-                        amountOut,
-                        payload: {
-                            dex: dexKey,
-                            quoterAddress: deployment.quoter,
-                            method: 'Quoter.quoteExactInputSingle',
-                            feeTier: fee,
-                            amountOut: amountOut.toString(),
-                            notes: `Known pair fast path (${pair}).`,
-                        },
-                    };
+                    const result = await client.readContract(c);
+                    return { status: 'success', result };
                 }
-                catch (eV1) {
-                    console.log(`Warning: on-chain quoter calls failed for pair ${pair} on chain ${network}. V2 error: ${eV2}; V1 error: ${eV1}. Falling back to off-chain quoter.`);
-                    // fall through to off-chain
+                catch (error) {
+                    return { status: 'failure', error };
                 }
-            }
-        }
-        // 3) Off-chain fallback (constrained)
-        if (deployment.factory) {
-            const off = new v3_offchain_quoter_service_1.V3OffchainQuoter();
-            const res = await off.fetchV3Quote({
-                client,
-                tokenIn: (0, viem_1.getAddress)(tokenInForQuote),
-                tokenOut: (0, viem_1.getAddress)(tokenOutForQuote),
-                amountIn: amountInBI,
-                factory: (0, viem_1.getAddress)(deployment.factory),
-                fees: [fee],
-            });
-            if (res?.best && res.best.ok && res.best.amountOut > 0n) {
-                return {
-                    amountOut: res.best.amountOut,
-                    payload: {
-                        dex: dexKey,
-                        quoterAddress: undefined,
-                        method: 'OffchainQuoter.simulateExactInputSingle',
-                        feeTier: fee,
-                        amountOut: res.best.amountOut.toString(),
-                        sqrtPriceX96After: res.best.sqrtPriceX96After
-                            ? res.best.sqrtPriceX96After.toString()
-                            : undefined,
-                        initializedTicksCrossed: res.best.initializedTicksCrossed,
-                        notes: `Known pair fast path (${pair}).`,
-                    },
-                };
-            }
+            }));
         }
-        throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, `Unable to quote via known pair ${pair}`);
-    }
-    _isSlipstreamDexString(dexString) {
-        return (dexString === v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM ||
-            dexString === v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM);
+        return client.multicall({ allowFailure: true, contracts });
     }
-    _determineTickSpacingsForDex(dexString) {
-        switch (dexString) {
+    _getAdapter(dex) {
+        const cached = this._adapterCache.get(dex);
+        if (cached)
+            return cached;
+        let adapter;
+        switch (dex) {
             case v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM:
-                return this.aerodromeTickSpacings;
             case v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM:
-                return this.velodromeTickSpacings;
+                adapter = new slipstream_adapter_1.SlipstreamDexAdapter(dex);
+                break;
+            case v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3:
+            case v3_dex_types_1.UniswapV3StyleDexEnum.PANGOLIN_V3:
+            case v3_dex_types_1.UniswapV3StyleDexEnum.PHARAOH_CLMM:
+            case v3_dex_types_1.UniswapV3StyleDexEnum.RAMSES_CLMM:
+                adapter = new uniswap_fork_adapter_1.V3ForkDexAdapter(dex);
+                break;
+            case v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3:
+            case v3_dex_types_1.UniswapV3StyleDexEnum.HYPERSWAP_V3:
+                adapter = new uniswap_adapter_1.UniswapV3DexAdapter(dex);
+                break;
             default:
-                return [];
+                throw new Error(`Unsupported CLMM DEX enum: ${dex}`);
         }
+        this._adapterCache.set(dex, adapter);
+        return adapter;
+    }
+    _buildFastRoutePriceResponse(params) {
+        const { networkIn, networkOut, tokenIn, tokenOut, slippage, amountIn, overrideDex, overrideAmountOutMin, overrideFeeOrTick, } = params;
+        const deployment = this._deployments[networkIn]?.find(d => d.dex === overrideDex);
+        if (!deployment) {
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No CLMM deployment for DEX ${overrideDex} on chainId ${networkIn}`);
+        }
+        const router = deployment.router ?? constants_1.ZERO_ADDRESS;
+        const quoter = deployment.quoter ?? constants_1.ZERO_ADDRESS;
+        const rawPriceResponse = {
+            dex: overrideDex,
+            router,
+            quoter,
+            method: `ExpectedAmountOut`,
+            feeOrTick: overrideFeeOrTick,
+            amountOut: overrideAmountOutMin,
+        };
+        const priceResponse = {
+            protocol: this.protocol,
+            networkIn,
+            networkOut,
+            tokenIn,
+            tokenOut,
+            amountIn,
+            amountOut: overrideAmountOutMin,
+            protocolResponse: rawPriceResponse,
+            slippage,
+        };
+        return priceResponse;
     }
 }
 exports.V3StyleDexService = V3StyleDexService;