genius-intents 0.18.2 → 0.19.0

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

@@ -7,17 +7,22 @@ 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 enums_1 = require("../../types/enums");
+const min_amount_out_1 = require("../../utils/min-amount-out");
 const wrapped_native_1 = require("../../utils/wrapped-native");
 const constants_1 = require("../../utils/constants");
 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, and SushiSwap V3.
+ * 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.
@@ -25,13 +30,48 @@ const utils_1 = require("../../utils");
  * @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.
+ * - Supports Uniswap V3, PancakeSwap V3, Slipstream, and SushiSwap V3 deployments on Avalanche, Arbitrum, BSC, Base, Ethereum, Optimism, HyperEVM, and Polygon.
  *
  * @example
  * ```typescript
- * const service = new V3StyleDexService(config);
- * const price = await service.fetchPrice({ ... });
- * const quote = await service.fetchQuote({ ... });
+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
@@ -74,6 +114,14 @@ class V3StyleDexService {
         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
          */
@@ -93,6 +141,13 @@ class V3StyleDexService {
                     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
@@ -159,6 +214,13 @@ class V3StyleDexService {
                     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
@@ -195,6 +257,13 @@ class V3StyleDexService {
                     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
@@ -272,15 +341,17 @@ class V3StyleDexService {
         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) {
-            /**
-             * 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 dexKey = (0, dex_deployment_key_1.dexDeploymentKey)({
+                dex: dex,
+                router: router,
+                network: networkIn,
+            });
             const earlyResponse = {
                 dex: dexKey,
                 amountOut: expectedAmountOutMin,
@@ -293,7 +364,7 @@ class V3StyleDexService {
                 path: pair,
                 notes: `Early return due to supplied pair and amountOutMin`,
             };
-            const priceResponse = {
+            return {
                 protocol: this.protocol,
                 networkIn,
                 networkOut,
@@ -304,11 +375,9 @@ class V3StyleDexService {
                 slippage,
                 protocolResponse: earlyResponse,
             };
-            return priceResponse;
         }
         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 ===
@@ -316,7 +385,6 @@ class V3StyleDexService {
         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}`);
         }
         const tokenInForQuote = nativeIn ? wrapped : tokenIn;
@@ -349,10 +417,37 @@ class V3StyleDexService {
         const orthodox = deployments.filter(d => !!d.quoter);
         const quoterless = deployments.filter(d => !('quoter' in d) || !d.quoter);
         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.quoteExactInputSingle
+         * Round 1: QuoterV2-style calls
+         *  - Uni/Pancake/Pangolin/etc: use fee (uint24)
+         *  - Slipstream (Velodrome/Aerodrome): use tickSpacing (int24)
          * ------------------------------------- */
-        const v2Contracts = orthodox.flatMap(d => {
+        // 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,
@@ -369,104 +464,136 @@ class V3StyleDexService {
                 ],
             }));
         });
-        const v2Metas = orthodox.flatMap(d => {
+        const v2MetasUniLike = orthodox
+            .filter(d => !this._isSlipstreamDexString(d.dex))
+            .flatMap(d => {
             const feeTiers = this._determineFeeTiersForDex(d.dex);
             return feeTiers.map(fee => ({
-                dex: this._buildDexKey(networkIn, d.router),
+                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,
+                    },
+                ],
             }));
         });
-        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 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) => {
+            for (let i = 0; i < results.length; i++) {
+                const res = results[i];
+                const meta = metas[i];
+                if (!res || !meta)
+                    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;
+                    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')
+                    continue;
                 try {
-                    const result = await client.readContract({
-                        address: contract.address,
-                        abi: contract.abi,
-                        functionName: contract.functionName,
-                        args: contract.args,
+                    const [amountOut, sqrtAfter, ticks, gas] = (0, viem_1.decodeFunctionResult)({
+                        abi,
+                        functionName: 'quoteExactInputSingle',
+                        data,
                     });
-                    return { status: 'success', 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 ?? 0n))
+                        best = candidate;
                 }
-                catch (error) {
-                    return { status: 'failure', error };
+                catch {
+                    /* ignore; continue */
                 }
-            }));
-        }
-        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 */
             }
-        }
+        };
+        handleV2Group(v2ResultsUniLike, v2MetasUniLike, uniswapV3_quoter_abi_1.uniswapV3QuoterAbi);
+        handleV2Group(v2ResultsSlip, v2MetasSlip, slipstream_quoter_abi_1.slipstreamQuoterAbi);
         /** ---------------------------------------
-         * Round 2: Quoter (v1) fallback if needed
+         * Round 2: Legacy Quoter (tuple) fallback
+         *   - Only for Uni-like deployments (Slipstream has no v1 tuple form)
          * ------------------------------------- */
         if (!best) {
-            const v1Contracts = orthodox.flatMap(d => {
+            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,
@@ -476,22 +603,23 @@ class V3StyleDexService {
                         {
                             tokenIn: (0, viem_1.getAddress)(tokenInForQuote),
                             tokenOut: (0, viem_1.getAddress)(tokenOutForQuote),
-                            amountIn: amountInBI,
                             fee,
+                            amountIn: amountInBI,
                             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 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,
@@ -553,23 +681,21 @@ class V3StyleDexService {
                         best = candidate;
                 }
                 catch {
-                    /* ignore; no more fallbacks */
+                    /* ignore */
                 }
             }
         }
         /** ---------------------------------------
-         * Round 3: Off-chain quoter (no quoter deployments, e.g., Sushi V3)
+         * Round 3: Off-chain quoter (no on-chain quoter)
          * ------------------------------------- */
         {
-            // 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) {
                     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),
@@ -577,16 +703,18 @@ class V3StyleDexService {
                             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 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, // no on-chain quoter used
+                                    quoterAddress: undefined,
                                     method: 'OffchainQuoter.simulateExactInputSingle',
                                     feeTier: res.best.fee,
                                     amountOut: res.best.amountOut.toString(),
@@ -610,7 +738,7 @@ class V3StyleDexService {
             }
         }
         if (!best) {
-            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, `No UniswapV3 style quote could be found`);
+            throw (0, utils_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, `No V3-style quote could be found`);
         }
         return {
             protocol: this.protocol,
@@ -655,7 +783,7 @@ class V3StyleDexService {
         }
         const tokenInExec = (expectNativeIn ? wrapped : tokenIn);
         const tokenOutExec = (expectNativeOut ? wrapped : tokenOut);
-        // Price discovery (now includes off-chain fallback for quoter-less deployments)
+        // Price discovery (now includes Slipstream tickSpacing handling via fetchPrice)
         let v3Price;
         if (!params?.priceResponse) {
             let priceRes;
@@ -677,18 +805,20 @@ class V3StyleDexService {
             }
             v3Price = priceRes.protocolResponse;
         }
+        else {
+            v3Price = params.priceResponse.protocolResponse;
+        }
         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');
         }
         // Slippage handling (percent)
         const bestAmountOut = BigInt(v3Price.amountOut);
         const slippagePct = typeof slippage === 'number' ? slippage : Number(slippage || 0);
-        const amountOutMin = slippagePct > 0
-            ? (bestAmountOut * BigInt(Math.floor((100 - slippagePct) * 1000000))) / 100000000n
-            : bestAmountOut;
+        const amountOutMin = (0, min_amount_out_1.calculateMinAmountOut)({
+            amountOut: bestAmountOut.toString(),
+            slippage: slippagePct,
+        });
         // 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) {
@@ -701,7 +831,6 @@ class V3StyleDexService {
             chosenRouter = maybeRouter;
         }
         if (!chosenRouter) {
-            // final fallback: any router on this network (highly unlikely to hit)
             chosenRouter = deployments.find(d => !!d.router)?.router;
         }
         if (!chosenRouter) {
@@ -714,6 +843,9 @@ class V3StyleDexService {
         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';
@@ -722,51 +854,42 @@ class V3StyleDexService {
              * -------------------------
              * 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.
+             * Uses route bytes (off-chain). We set a sentinel here.
              */
             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
+                        (0, viem_1.getAddress)(chosenRouter), // transferValueTo (RP9)
                         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)
+                        (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 set to amountInBI for native-in case
+                // txValue already equals amountIn for native-in
             }
             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)
+                        (0, viem_1.getAddress)(tokenInExec),
+                        amountInBI,
+                        (0, viem_1.getAddress)(tokenOutExec),
+                        amountOutMin,
+                        (0, viem_1.getAddress)(receiver || from),
+                        routeBytes,
                         takeSurplus,
                         referralCode,
                     ],
@@ -776,32 +899,60 @@ class V3StyleDexService {
             }
         }
         else {
-            const routerAbi = isPancakeV3 || isPangolinV3 ? pacakeswapV3_router_abi_1.pancakeswapV3RouterAbi : uniswapV3_router_abi_1.uniswapV3RouterAbi;
-            const struct = isPancakeV3 || isPangolinV3
-                ? {
+            // 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),
-                    fee: (v3Price.feeTier ?? 3000),
+                    tickSpacing: Number(v3Price.feeTier ?? 60), // feeTier carries tickSpacing for Slipstream
                     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],
-            });
+                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,
@@ -821,10 +972,6 @@ class V3StyleDexService {
             }
         }
         // 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
             : {
@@ -847,6 +994,7 @@ class V3StyleDexService {
         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,
@@ -854,14 +1002,14 @@ class V3StyleDexService {
             initHash: deployment?.initHash,
             tokenA: tokenInExec,
             tokenB: tokenOutExec,
-            fee: v3Price.feeTier,
+            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, // undefined for off-chain path
-            feeTier: v3Price.feeTier,
+            quoterAddress: v3Price.quoterAddress,
+            feeTier: v3Price.feeTier, // tickSpacing for Slipstream
             method: methodForResponse,
             amountOut: bestAmountOut.toString(),
             amountOutMin: amountOutMin.toString(),
@@ -871,13 +1019,14 @@ class V3StyleDexService {
             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 should be handled inside route bytes.'
+                        ? 'Native out handled inside route bytes.'
                         : 'Native out via multicall(unwrapWETH9).'
                     : 'ERC-20 out to recipient.'),
         };
@@ -897,14 +1046,6 @@ class V3StyleDexService {
             protocolResponse,
         };
     }
-    _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) {
@@ -917,6 +1058,9 @@ class V3StyleDexService {
             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}`);
         }
@@ -931,7 +1075,13 @@ class V3StyleDexService {
                     ? 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;
+                        : 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;
@@ -941,6 +1091,12 @@ class V3StyleDexService {
                 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;
@@ -951,23 +1107,25 @@ class V3StyleDexService {
     }
     _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;
-        // 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 [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);
-        // 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)
+        return (0, viem_1.getAddress)(`0x${digest.slice(26)}`);
     }
     async _validateNativeLiquidity(params) {
         const { tokenIn, networkIn, dexes, nativePrice, tokenInPrice, tokenInDecimals } = params;
@@ -1193,7 +1351,11 @@ class V3StyleDexService {
             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);
+        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)
@@ -1296,6 +1458,20 @@ class V3StyleDexService {
         }
         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);
+    }
+    _determineTickSpacingsForDex(dexString) {
+        switch (dexString) {
+            case v3_dex_types_1.UniswapV3StyleDexEnum.AERODROME_CLMM:
+                return this.aerodromeTickSpacings;
+            case v3_dex_types_1.UniswapV3StyleDexEnum.VELODROME_CLMM:
+                return this.velodromeTickSpacings;
+            default:
+                return [];
+        }
+    }
 }
 exports.V3StyleDexService = V3StyleDexService;
 //# sourceMappingURL=v3-dex.service.js.map