genius-intents 0.18.2 → 0.20.0

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

@@ -2,617 +2,269 @@
 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 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");
-/**
- * Service for interacting with V3-style decentralized exchanges (DEXs) such as Uniswap V3, PancakeSwap V3, 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, and SushiSwap V3 deployments on Avalanche, Arbitrum, BSC, Base, Ethereum, Optimism, and Polygon.
- *
- * @example
- * ```typescript
- * const service = new V3StyleDexService(config);
- * const price = await service.fetchPrice({ ... });
- * const quote = await service.fetchQuote({ ... });
- * ```
- *
- * @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];
-        /**
-         * 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: 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: 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: 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}`);
-        }
-        if (pair && expectedAmountOutMin && dex) {
-            /**
-             * Use the dex enum to find the corresponding router given the networkIn
-             */
-            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 = this._buildDexKey(networkIn, router);
-            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`,
-            };
-            const priceResponse = {
-                protocol: this.protocol,
-                networkIn,
-                networkOut,
-                tokenIn,
-                tokenOut,
-                amountIn,
-                amountOut: expectedAmountOutMin,
-                slippage,
-                protocolResponse: earlyResponse,
-            };
-            return priceResponse;
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, 'V3StyleDexService supports only single-chain swaps');
         }
         const client = this._clients[networkIn];
         if (!client) {
-            console.log(`No RPC client configured for chainId ${networkIn}`);
             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 overridePair = overrides?.pair;
+        const overrideAmountOutMin = overrides?.amountOutMin;
+        const overrideDex = overrides?.dex;
+        const overrideFeeTier = overrides?.feeOrTick;
+        const useFastRoute = overridePair && overrideAmountOutMin && overrideDex && overrideFeeTier;
+        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,
+                overrideFeeTier: overrideFeeTier,
+            });
+        }
+        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) {
-            console.log(`No wrapped native token mapping for chainId ${networkIn}`);
-            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,
-            };
-        }
-        // Split deployments by quoter availability
-        const orthodox = deployments.filter(d => !!d.quoter);
-        const quoterless = deployments.filter(d => !('quoter' in d) || !d.quoter);
-        let best;
-        /** ---------------------------------------
-         * Round 1: QuoterV2.quoteExactInputSingle
-         * ------------------------------------- */
-        const v2Contracts = orthodox.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 v2Metas = orthodox.flatMap(d => {
-            const feeTiers = this._determineFeeTiersForDex(d.dex);
-            return feeTiers.map(fee => ({
-                dex: this._buildDexKey(networkIn, d.router),
-                fee,
-                quoter: d.quoter,
-                method: 'QuoterV2.quoteExactInputSingle',
-            }));
-        });
-        let v2Results;
-        if (networkIn === enums_1.ChainIdEnum.HYPEREVM) {
-            // Use individual calls with Promise.all for HyperEVM due to 30M gas limit
-            v2Results = await Promise.all(v2Contracts.map(async (contract) => {
+        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 result = await client.readContract({
-                        address: contract.address,
-                        abi: contract.abi,
-                        functionName: contract.functionName,
-                        args: contract.args,
-                    });
-                    return { status: 'success', result };
+                    const spec = adapter.buildQuoterV2Call(task);
+                    if (!spec)
+                        continue;
+                    v2Specs.push({ spec, adapter, meta: task, d, preset: p });
                 }
-                catch (error) {
-                    return { status: 'failure', error };
+                catch {
+                    // Adapter may not support V2 (shouldn't happen here), skip
                 }
-            }));
-        }
-        else {
-            v2Results = v2Contracts.length
-                ? await client.multicall({ allowFailure: true, contracts: v2Contracts })
-                : [];
-        }
-        for (let i = 0; i < v2Results.length; i++) {
-            const res = v2Results[i];
-            const meta = v2Metas[i];
-            if (!res || !meta)
-                continue;
-            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,
-                        amountOut: amountOut.toString(),
-                        gasEstimate: gas ? gas.toString() : undefined,
-                        sqrtPriceX96After: sqrtAfter ? sqrtAfter.toString() : undefined,
-                        initializedTicksCrossed: ticks,
-                        notes: nativeIn || nativeOut
-                            ? `Quoted with wrapped native: in=${nativeIn ? 'wrapped' : 'erc20'}, out=${nativeOut ? 'wrapped' : 'erc20'}`
-                            : undefined,
-                    },
-                };
-                if (!best || candidate.amountOut > best.amountOut)
-                    best = candidate;
-                continue;
-            }
-            // Try to decode revert (some quoters return data on revert)
-            // @ts-ignore – Viem surfaces revert data in error.data
-            const data = res?.error?.data;
-            if (!data || data === '0x')
-                continue;
-            try {
-                const [amountOut, sqrtAfter, ticks, gas] = (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(),
-                        gasEstimate: gas ? gas.toString() : undefined,
-                        sqrtPriceX96After: sqrtAfter ? sqrtAfter.toString() : undefined,
-                        initializedTicksCrossed: ticks,
-                        notes: nativeIn || nativeOut
-                            ? `Quoted with wrapped native: in=${nativeIn ? 'wrapped' : 'erc20'}, out=${nativeOut ? 'wrapped' : 'erc20'}`
-                            : undefined,
-                    },
-                };
-                if (!best || candidate.amountOut > (best.amountOut ?? 0n))
-                    best = candidate;
-            }
-            catch {
-                /* ignore; fallback below */
             }
         }
-        /** ---------------------------------------
-         * Round 2: Quoter (v1) fallback if needed
-         * ------------------------------------- */
-        if (!best) {
-            const v1Contracts = orthodox.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 v1Metas = orthodox.flatMap(d => {
-                const feeTiers = this._determineFeeTiersForDex(d.dex);
-                return feeTiers.map(fee => ({
-                    dex: this._buildDexKey(networkIn, 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)
+        // Execute V2 multicall
+        let best;
+        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 results = await this._execBatch(networkIn, calls);
+            for (let i = 0; i < results.length; i++) {
+                const res = results[i];
+                const s = v2Specs[i];
+                if (!s)
                     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;
+                if (!res)
                     continue;
-                }
-                // Attempt decode from revert
-                // @ts-ignore
-                const data = res?.error?.data;
-                if (!data || data === '0x')
+                const decoded = s.adapter.decodeQuoterV2(res);
+                if (!decoded)
                     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,
-                        },
-                    };
-                    if (!best || candidate.amountOut > best.amountOut)
-                        best = candidate;
-                }
-                catch {
-                    /* ignore; no more fallbacks */
+                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',
+                        };
+                    }
                 }
             }
         }
-        /** ---------------------------------------
-         * Round 3: Off-chain quoter (no quoter deployments, e.g., Sushi V3)
-         * ------------------------------------- */
-        {
-            // Only consider quoter-less deployments that ALSO provide a factory address in config/uniV3ExtraDeployments.
-            // (If factory is absent, we cannot discover pools; we skip those entries.)
-            const offchainCapable = quoterless.filter(d => !!d?.factory);
-            if (offchainCapable.length) {
-                const offchain = new v3_offchain_quoter_service_1.V3OffchainQuoter();
-                // sequential to keep RPC load predictable across many tiers/words;
-                // user can parallelize externally if desired
-                for (const d of offchainCapable) {
+        // If no V2 winner, try V1 where supported (Uniswap/V3Fork; NOT Slipstream)
+        if (!best) {
+            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;
+                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,
+                    };
                     try {
-                        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,
-                            // optional safety knobs can be wired via UniV3Config in the future:
-                            // maxTickReads, prefetchWords
-                        });
-                        if (res?.best && res.best.ok && res.best.amountOut > 0n) {
-                            const dexKey = this._buildDexKey(networkIn, d.router);
-                            const candidate = {
-                                amountOut: res.best.amountOut,
-                                payload: {
-                                    dex: dexKey,
-                                    quoterAddress: undefined, // no on-chain quoter used
-                                    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 (!best || candidate.amountOut > best.amountOut)
-                                best = candidate;
-                        }
+                        const spec = adapter.buildQuoterV1Call(task);
+                        if (!spec)
+                            continue;
+                        v1Specs.push({ spec, adapter, meta: task, d, preset: p });
                     }
                     catch {
-                        // ignore this deployment; continue to next
+                        /* unsupported; skip */
+                    }
+                }
+            }
+            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) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, `No UniswapV3 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,
@@ -621,680 +273,219 @@ 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');
+        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 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}`);
+        let price = undefined;
+        if (priceResponse) {
+            logger.info(`V3StyleDexService: Using provided price response for quote fetch.`);
+            price = priceResponse;
         }
-        const tokenInExec = (expectNativeIn ? wrapped : tokenIn);
-        const tokenOutExec = (expectNativeOut ? wrapped : tokenOut);
-        // Price discovery (now includes off-chain fallback for quoter-less deployments)
-        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;
+        else {
+            logger.info(`V3StyleDexService: Fetching price for quote.`);
+            price = await this.fetchPrice(params);
+        }
+        const overrides = params?.overrideParamsV3Dex;
+        const sqrtPriceX96After = overrides?.sqrtPriceX96After ||
+            (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 = slippagePct > 0
-            ? (bestAmountOut * BigInt(Math.floor((100 - slippagePct) * 1000000))) / 100000000n
-            : bestAmountOut;
-        // Router resolution:
-        //  - If quoterAddress is present, match router by that quoter's deployment
-        //  - Else (off-chain path), pick any deployment with the same dex id that has a router
-        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) {
-            // final fallback: any router on this network (highly unlikely to hit)
-            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);
-        let data;
-        let methodForResponse;
-        let txValue = expectNativeIn ? amountInBI.toString() : '0';
-        if (isSushiV3) {
-            /**
-             * -------------------------
-             * Sushi Route Processor 9
-             * -------------------------
-             * We target `processRoute`-family methods depending on native input:
-             *  - Native in (expectNativeIn): use `processRouteWithTransferValueInput` (payable) so we can pass msg.value.
-             *  - ERC20 in: use `processRoute` (no value transfer needed).
-             *
-             * NOTE: `route` bytes are expected to be produced off-chain (e.g., Sushi Tines pathfinder).
-             * Here we set it to `0x` as a sentinel; upstream code should replace with a valid route prior to execution.
-             * If your pipeline already has the route bytes available at this stage, replace `routeBytes` accordingly.
-             */
-            const routeBytes = '0x';
-            const takeSurplus = false;
-            const referralCode = 0;
-            if (expectNativeIn) {
-                // Payable path: send msg.value and call *WithTransferValueInput*
-                // We forward value to the RP9 itself (common pattern); adjust if you have a dedicated treasury.
-                data = (0, viem_1.encodeFunctionData)({
-                    abi: sushiswap_route_processor_9_abi_1.sushiswapRouteProcessor9Abi,
-                    functionName: 'processRouteWithTransferValueInput',
-                    args: [
-                        (0, viem_1.getAddress)(chosenRouter), // transferValueTo
-                        amountInBI, // amountValueTransfer
-                        (0, viem_1.getAddress)(tokenInExec), // tokenIn (wrapped native is fine; RP9/tines route may unwrap/rewrap as needed)
-                        amountInBI, // amountIn
-                        (0, viem_1.getAddress)(tokenOutExec), // tokenOut (use wrapped if nativeOut; route should handle unwrap if desired)
-                        amountOutMin, // amountOutQuote
-                        (0, viem_1.getAddress)(receiver || from), // to
-                        routeBytes, // route (to be produced off-chain)
-                        takeSurplus,
-                        referralCode,
-                    ],
-                });
-                methodForResponse = 'RouteProcessor9.processRouteWithTransferValueInput';
-                // txValue already set to amountInBI for native-in case
-            }
-            else {
-                // ERC-20 in: no msg.value required; standard processRoute
-                data = (0, viem_1.encodeFunctionData)({
-                    abi: sushiswap_route_processor_9_abi_1.sushiswapRouteProcessor9Abi,
-                    functionName: 'processRoute',
-                    args: [
-                        (0, viem_1.getAddress)(tokenInExec), // tokenIn
-                        amountInBI, // amountIn
-                        (0, viem_1.getAddress)(tokenOutExec), // tokenOut
-                        amountOutMin, // amountOutQuote
-                        (0, viem_1.getAddress)(receiver || from), // to
-                        routeBytes, // route (to be produced off-chain)
-                        takeSurplus,
-                        referralCode,
-                    ],
-                });
-                methodForResponse = 'RouteProcessor9.processRoute';
-                txValue = '0';
-            }
-        }
-        else {
-            const routerAbi = isPancakeV3 || isPangolinV3 ? pacakeswapV3_router_abi_1.pancakeswapV3RouterAbi : uniswapV3_router_abi_1.uniswapV3RouterAbi;
-            const struct = isPancakeV3 || isPangolinV3
-                ? {
-                    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,
-                };
-            const 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:
-        // - For Sushi RP9 branch with native in: msg.value == amountIn
-        // - For UniV3 branch with native in: msg.value == amountIn
-        // - Else: 0
-        // (txValue already assigned above)
-        const approval = expectNativeIn
-            ? undefined
-            : {
-                token: (0, viem_1.getAddress)(tokenIn),
-                spender: chosenRouter,
-                amount: amountInBI.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,
+            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}.`);
-        }
-        const pairAddress = this._create2Address({
-            dex: dexEnum,
-            factory: deployment?.factory,
-            deployer: deployment?.deployer,
-            initHash: deployment?.initHash,
-            tokenA: tokenInExec,
-            tokenB: tokenOutExec,
-            fee: v3Price.feeTier,
-        });
-        const protocolResponse = {
-            dex: v3Price.dex,
-            pair: (0, viem_1.getAddress)(pairAddress),
-            routerAddress: chosenRouter,
-            quoterAddress: v3Price.quoterAddress, // undefined for off-chain path
-            feeTier: v3Price.feeTier,
-            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; ' : '') +
-                (isSushiV3
-                    ? 'Sushi Route Processor 9 calldata (route bytes expected from off-chain pathfinder); '
-                    : '') +
-                (expectNativeIn ? 'Native in; ' : '') +
-                (expectNativeOut
-                    ? isSushiV3
-                        ? 'Native out should be 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,
+            protocolResponse: qPayload,
         };
+        logger.info(`V3StyleDexService: Built quote response for ${amountIn} ${tokenIn} -> ${quoteResponse.amountOut} ${tokenOut} on ${networkIn} via ${deployment.dex}`);
+        return quoteResponse;
     }
-    _buildDexKey(network, router) {
-        // Find the deployment from `deployments` where the router address is equal to the router param
-        const deployment = this.deployments[network]?.find(d => d.router.toLowerCase() === router.toLowerCase());
-        if (!deployment) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `No deployment found for router ${router} on network ${network}.`);
-        }
-        return `${deployment.dex}:${router}:${network}`;
-    }
-    _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}`);
+    // --------------------------- 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}`);
         }
-        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,
-        ].includes(dexEnum)) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.INVALID_PARAMS, `Unknown dex enum in key: ${dexKey}`);
+        if (network === enums_1.ChainIdEnum.HYPEREVM) {
+            return Promise.all(contracts.map(async (c) => {
+                try {
+                    const result = await client.readContract(c);
+                    return { status: 'success', result };
+                }
+                catch (error) {
+                    return { status: 'failure', error };
+                }
+            }));
         }
-        return dexEnum;
+        return client.multicall({ allowFailure: true, contracts });
     }
-    _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
-                        : v3_dex_types_1.UniswapV3StyleDexEnum.UNISWAP_V3;
+    _getAdapter(dex) {
+        const cached = this._adapterCache.get(dex);
+        if (cached)
+            return cached;
+        let adapter;
         switch (dex) {
+            case v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM:
+            case v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM:
+                adapter = new slipstream_adapter_1.SlipstreamDexAdapter(dex);
+                break;
             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:
+            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 this.uniFeeTiers;
+                throw new Error(`Unsupported CLMM DEX enum: ${dex}`);
         }
+        this._adapterCache.set(dex, adapter);
+        return adapter;
     }
-    _isDex(expectedDex, v3Price) {
-        return !!v3Price?.dex && v3Price.dex.startsWith(`${expectedDex}:`);
-    }
-    _create2Address(params) {
-        const { dex, initHash, tokenA, tokenB, fee, deployer, factory } = params;
-        const addressToUse = dex === v3_dex_types_1.UniswapV3StyleDexEnum.PANCAKESWAP_V3 ? deployer : factory;
-        // Uniswap/Pancake V3 salt uses token0 < token1 ordering
-        const a = (0, viem_1.getAddress)(tokenA);
-        const b = (0, viem_1.getAddress)(tokenB);
-        const [token0, token1] = a.toLowerCase() < b.toLowerCase() ? [a, b] : [b, a];
-        // Salt = keccak256(abi.encode(address,address,uint24))
-        const encoded = (0, viem_1.encodeAbiParameters)([{ type: 'address' }, { type: 'address' }, { type: 'uint24' }], [token0, token1, fee]);
-        const salt = (0, ethers_1.keccak256)(encoded);
-        // CREATE2 addr = last 20 bytes of keccak256(0xff ++ addressToUse ++ salt ++ initCodeHash)
-        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),
-        ]));
-        // Take last 20 bytes
-        return (0, viem_1.getAddress)(`0x${digest.slice(26)}`); // remove '0x' + 24 hex (12 bytes)
-    }
-    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
+    _buildFastRoutePriceResponse(params) {
+        const { networkIn, networkOut, tokenIn, tokenOut, slippage, amountIn, overrideDex, overrideAmountOutMin, overrideFeeTier, } = 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: overrideFeeTier,
+            amountOut: overrideAmountOutMin,
         };
-        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}`);
-    }
-    /**
-     * 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;
-        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 = this._buildDexKey(network, deployment.router);
-        // 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
-                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}).`,
-                        },
-                    };
-                }
-                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
-                }
-            }
-        }
-        // 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}`);
+        const priceResponse = {
+            protocol: this.protocol,
+            networkIn,
+            networkOut,
+            tokenIn,
+            tokenOut,
+            amountIn,
+            amountOut: overrideAmountOutMin,
+            protocolResponse: rawPriceResponse,
+            slippage,
+        };
+        return priceResponse;
     }
 }
 exports.V3StyleDexService = V3StyleDexService;