@mento-protocol/mento-sdk 2.0.0-beta.9 → 3.0.0-beta.10

package/dist/services/pools/poolDetails.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchFPMMPoolDetails = fetchFPMMPoolDetails;
+exports.fetchVirtualPoolDetails = fetchVirtualPoolDetails;
+const constants_1 = require("../../core/constants");
+const abis_1 = require("../../core/abis");
+/**
+ * Fetches enriched details for an FPMM pool
+ */
+async function fetchFPMMPoolDetails(publicClient, chainId, pool) {
+    const address = pool.poolAddr;
+    try {
+        // Known liquidity strategy addresses for this chain
+        const knownStrategies = getKnownLiquidityStrategies(chainId);
+        const [reservesResult, pricesResult, decimals0, decimals1, lpFee, protocolFee, rebalanceIncentive, rebalanceThresholdAbove, rebalanceThresholdBelow, ...strategyResults] = await Promise.all([
+            publicClient.readContract({ address, abi: abis_1.FPMM_ABI, functionName: 'getReserves' }),
+            publicClient.readContract({ address, abi: abis_1.FPMM_ABI, functionName: 'getPrices' }),
+            publicClient.readContract({ address, abi: abis_1.FPMM_ABI, functionName: 'decimals0' }),
+            publicClient.readContract({ address, abi: abis_1.FPMM_ABI, functionName: 'decimals1' }),
+            publicClient.readContract({ address, abi: abis_1.FPMM_ABI, functionName: 'lpFee' }),
+            publicClient.readContract({ address, abi: abis_1.FPMM_ABI, functionName: 'protocolFee' }),
+            publicClient.readContract({ address, abi: abis_1.FPMM_ABI, functionName: 'rebalanceIncentive' }),
+            publicClient.readContract({ address, abi: abis_1.FPMM_ABI, functionName: 'rebalanceThresholdAbove' }),
+            publicClient.readContract({ address, abi: abis_1.FPMM_ABI, functionName: 'rebalanceThresholdBelow' }),
+            ...knownStrategies.map((strategyAddr) => publicClient.readContract({
+                address,
+                abi: abis_1.FPMM_ABI,
+                functionName: 'liquidityStrategy',
+                args: [strategyAddr],
+            })),
+        ]);
+        const [reserve0, reserve1, blockTimestampLast] = reservesResult;
+        const [oraclePriceNum, oraclePriceDen, reservePriceNum, reservePriceDen, priceDifference, reservePriceAboveOraclePrice,] = pricesResult;
+        const lpFeeBps = lpFee;
+        const protocolFeeBps = protocolFee;
+        const rebalanceIncentiveBps = rebalanceIncentive;
+        const thresholdAboveBps = rebalanceThresholdAbove;
+        const thresholdBelowBps = rebalanceThresholdBelow;
+        // Find the active liquidity strategy (first match wins)
+        // Note: this could break at some point in the future if we decide to use
+        //       more than one stragegy for a pool. For now it is not an issue,
+        //       if we do forget to change this the impact is low as this function
+        //       is just for informational purposes.
+        const activeIndex = strategyResults.findIndex((result) => result === true);
+        const liquidityStrategy = activeIndex >= 0 ? knownStrategies[activeIndex] : null;
+        const applicableThreshold = reservePriceAboveOraclePrice ? thresholdAboveBps : thresholdBelowBps;
+        const inBand = priceDifference < applicableThreshold;
+        return {
+            ...pool,
+            poolType: 'FPMM',
+            decimals0: decimals0,
+            decimals1: decimals1,
+            reserve0,
+            reserve1,
+            blockTimestampLast,
+            pricing: {
+                oraclePriceNum,
+                oraclePriceDen,
+                oraclePrice: Number(oraclePriceNum) / Number(oraclePriceDen),
+                reservePriceNum,
+                reservePriceDen,
+                reservePrice: Number(reservePriceNum) / Number(reservePriceDen),
+                priceDifferenceBps: priceDifference,
+                priceDifferencePercent: Number(priceDifference) / 100,
+                reservePriceAboveOraclePrice,
+            },
+            fees: {
+                lpFeeBps,
+                lpFeePercent: Number(lpFeeBps) / 100,
+                protocolFeeBps,
+                protocolFeePercent: Number(protocolFeeBps) / 100,
+                totalFeePercent: (Number(lpFeeBps) + Number(protocolFeeBps)) / 100,
+            },
+            rebalancing: {
+                rebalanceIncentiveBps,
+                rebalanceIncentivePercent: Number(rebalanceIncentiveBps) / 100,
+                rebalanceThresholdAboveBps: thresholdAboveBps,
+                rebalanceThresholdAbovePercent: Number(thresholdAboveBps) / 100,
+                rebalanceThresholdBelowBps: thresholdBelowBps,
+                rebalanceThresholdBelowPercent: Number(thresholdBelowBps) / 100,
+                inBand,
+                liquidityStrategy,
+            },
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch FPMM pool details for ${pool.poolAddr}: ${error.message}`);
+    }
+}
+/**
+ * Fetches enriched details for a Virtual pool
+ */
+async function fetchVirtualPoolDetails(publicClient, pool) {
+    const address = pool.poolAddr;
+    try {
+        const [reservesResult, protocolFee, metadataResult] = await Promise.all([
+            publicClient.readContract({ address, abi: abis_1.VIRTUAL_POOL_ABI, functionName: 'getReserves' }),
+            publicClient.readContract({ address, abi: abis_1.VIRTUAL_POOL_ABI, functionName: 'protocolFee' }),
+            publicClient.readContract({ address, abi: abis_1.VIRTUAL_POOL_ABI, functionName: 'metadata' }),
+        ]);
+        const [reserve0, reserve1, blockTimestampLast] = reservesResult;
+        const [dec0, dec1] = metadataResult;
+        const spreadBps = protocolFee;
+        return {
+            ...pool,
+            poolType: 'Virtual',
+            decimals0: dec0,
+            decimals1: dec1,
+            reserve0,
+            reserve1,
+            blockTimestampLast,
+            spreadBps,
+            spreadPercent: Number(spreadBps) / 100,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch Virtual pool details for ${pool.poolAddr}: ${error.message}`);
+    }
+}
+/**
+ * Returns the known liquidity strategy addresses for the given chain.
+ */
+function getKnownLiquidityStrategies(chainId) {
+    const strategies = [];
+    const chainAddresses = constants_1.addresses[chainId];
+    if (!chainAddresses)
+        return strategies;
+    if (chainAddresses.ReserveLiquidityStrategy) {
+        strategies.push(chainAddresses.ReserveLiquidityStrategy);
+    }
+    if (chainAddresses.CDPLiquidityStrategy) {
+        strategies.push(chainAddresses.CDPLiquidityStrategy);
+    }
+    return strategies;
+}
+//# sourceMappingURL=poolDetails.js.map

package/dist/services/pools/poolDetails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poolDetails.js","sourceRoot":"","sources":["../../../src/services/pools/poolDetails.ts"],"names":[],"mappings":"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"}

package/dist/services/pools/poolDiscovery.d.ts

@@ -0,0 +1,13 @@
+import { Pool } from '../../core/types';
+import { PublicClient } from 'viem';
+/**
+ * Fetches all FPMM pools from the FPMM Factory
+ */
+export declare function fetchFPMMPools(publicClient: PublicClient, chainId: number): Promise<Pool[]>;
+/**
+ * Fetches all Virtual pools by discovering them from BiPoolManager exchanges.
+ * VirtualPoolFactory doesn't have an enumeration method,
+ * so we have to derive pools from BiPoolManager.
+ */
+export declare function fetchVirtualPools(publicClient: PublicClient, chainId: number): Promise<Pool[]>;
+//# sourceMappingURL=poolDiscovery.d.ts.map

package/dist/services/pools/poolDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poolDiscovery.d.ts","sourceRoot":"","sources":["../../../src/services/pools/poolDiscovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAY,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAW,MAAM,MAAM,CAAA;AAG5C;;GAEG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CA8CjG;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAiEpG"}

package/dist/services/pools/poolDiscovery.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchFPMMPools = fetchFPMMPools;
+exports.fetchVirtualPools = fetchVirtualPools;
+const constants_1 = require("../../core/constants");
+const types_1 = require("../../core/types");
+const abis_1 = require("../../core/abis");
+const sortUtils_1 = require("../../utils/sortUtils");
+/**
+ * Fetches all FPMM pools from the FPMM Factory
+ */
+async function fetchFPMMPools(publicClient, chainId) {
+    const fpmmFactoryAddress = (0, constants_1.getContractAddress)(chainId, 'FPMMFactory');
+    if (!fpmmFactoryAddress) {
+        return [];
+    }
+    try {
+        // Get all deployed FPMM pool addresses
+        const poolAddresses = (await publicClient.readContract({
+            address: fpmmFactoryAddress,
+            abi: abis_1.FPMM_FACTORY_ABI,
+            functionName: 'deployedFPMMAddresses',
+        }));
+        if (poolAddresses.length === 0) {
+            return [];
+        }
+        const poolDataPromises = poolAddresses.map(async (poolAddress) => {
+            const [token0, token1] = await Promise.all([
+                publicClient.readContract({
+                    address: poolAddress,
+                    abi: abis_1.FPMM_ABI,
+                    functionName: 'token0',
+                }),
+                publicClient.readContract({
+                    address: poolAddress,
+                    abi: abis_1.FPMM_ABI,
+                    functionName: 'token1',
+                }),
+            ]);
+            return {
+                factoryAddr: fpmmFactoryAddress,
+                poolAddr: poolAddress,
+                token0: token0,
+                token1: token1,
+                poolType: types_1.PoolType.FPMM,
+            };
+        });
+        return await Promise.all(poolDataPromises);
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch FPMM pools: ${error.message}`);
+    }
+}
+/**
+ * Fetches all Virtual pools by discovering them from BiPoolManager exchanges.
+ * VirtualPoolFactory doesn't have an enumeration method,
+ * so we have to derive pools from BiPoolManager.
+ */
+async function fetchVirtualPools(publicClient, chainId) {
+    const virtualPoolFactoryAddress = (0, constants_1.getContractAddress)(chainId, 'VirtualPoolFactory');
+    const biPoolManagerAddress = (0, constants_1.getContractAddress)(chainId, 'BiPoolManager');
+    if (!virtualPoolFactoryAddress || !biPoolManagerAddress) {
+        return [];
+    }
+    try {
+        // TODO: When the latest virtual pool factory contract is deployed
+        //       we can simplify this by using VirtualPoolFactory.getAllPools() returns(address[])
+        // Get all exchanges from BiPoolManager
+        const exchangesData = (await publicClient.readContract({
+            address: biPoolManagerAddress,
+            abi: abis_1.BIPOOL_MANAGER_ABI,
+            functionName: 'getExchanges',
+        }));
+        if (exchangesData.length === 0) {
+            return [];
+        }
+        // For each exchange, check if a virtual pool exists, and if so, return the pool address.
+        const poolPromises = exchangesData.map(async (exchange) => {
+            if (exchange.assets.length !== 2) {
+                return null;
+            }
+            const [token0, token1] = (0, sortUtils_1.sortTokenAddresses)(exchange.assets[0], exchange.assets[1]);
+            const poolAddress = (await publicClient.readContract({
+                address: virtualPoolFactoryAddress,
+                abi: abis_1.VIRTUAL_POOL_FACTORY_ABI,
+                functionName: 'getOrPrecomputeProxyAddress',
+                args: [token0, token1],
+            }));
+            const isDeployed = (await publicClient.readContract({
+                address: virtualPoolFactoryAddress,
+                abi: abis_1.VIRTUAL_POOL_FACTORY_ABI,
+                functionName: 'isPool',
+                args: [poolAddress],
+            }));
+            if (!isDeployed) {
+                return null;
+            }
+            const pool = {
+                factoryAddr: virtualPoolFactoryAddress,
+                poolAddr: poolAddress,
+                token0: token0,
+                token1: token1,
+                poolType: types_1.PoolType.Virtual,
+                exchangeId: exchange.exchangeId,
+            };
+            return pool;
+        });
+        const results = await Promise.all(poolPromises);
+        return results.filter((pool) => pool !== null);
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch Virtual pools: ${error.message}`);
+    }
+}
+//# sourceMappingURL=poolDiscovery.js.map

package/dist/services/pools/poolDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poolDiscovery.js","sourceRoot":"","sources":["../../../src/services/pools/poolDiscovery.ts"],"names":[],"mappings":"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"}

package/dist/services/quotes/QuoteService.d.ts

@@ -0,0 +1,50 @@
+import { PublicClient } from 'viem';
+import { RouteService } from '../routes';
+import { Route } from '../../core/types';
+/**
+ * Service for getting swap quotes from the Mento protocol.
+ * Calculates expected output amounts for trades without executing them.
+ */
+export declare class QuoteService {
+    private publicClient;
+    private chainId;
+    private routeService;
+    constructor(publicClient: PublicClient, chainId: number, routeService: RouteService);
+    /**
+     * Calculates the expected output amount for a swap between two tokens.
+     *
+     * @param tokenIn - The address of the input token (e.g., '0x765DE816845861e75A25fCA122bb6898B8B1282a')
+     * @param tokenOut - The address of the output token (e.g., '0x471EcE3750Da237f93B8E339c536989b8978a438')
+     * @param amountIn - The amount of input tokens (in wei/smallest unit)
+     * @param route - Optional pre-fetched route. If not provided, the optimal route will be found automatically.
+     * @returns The expected output amount (in wei/smallest unit)
+     * @throws {RouteNotFoundError} If no route exists between the token pair
+     * @throws {Error} If the Router contract call fails
+     *
+     * @example
+     * ```typescript
+     * // Calculate output for 100 USDm
+     * const amountIn = BigInt(100) * BigInt(10 ** 18) // 100 USDm in wei
+     * const expectedOut = await quoteService.getAmountOut(
+     *   '0x765DE816845861e75A25fCA122bb6898B8B1282a', // USDm
+     *   '0x471EcE3750Da237f93B8E339c536989b8978a438', // CELO
+     *   amountIn
+     * )
+     * console.log(`Expected CELO output: ${expectedOut}`)
+     *
+     * // Or provide a pre-fetched route for better performance
+     * const route = await routeService.findRoute(
+     *   '0x765DE816845861e75A25fCA122bb6898B8B1282a',
+     *   '0x471EcE3750Da237f93B8E339c536989b8978a438'
+     * )
+     * const expectedOut2 = await quoteService.getAmountOut(
+     *   '0x765DE816845861e75A25fCA122bb6898B8B1282a',
+     *   '0x471EcE3750Da237f93B8E339c536989b8978a438',
+     *   amountIn,
+     *   route
+     * )
+     * ```
+     */
+    getAmountOut(tokenIn: string, tokenOut: string, amountIn: bigint, route?: Route): Promise<bigint>;
+}
+//# sourceMappingURL=QuoteService.d.ts.map

package/dist/services/quotes/QuoteService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuoteService.d.ts","sourceRoot":"","sources":["../../../src/services/quotes/QuoteService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,YAAY,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAMxC;;;GAGG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,YAAY;gBAFZ,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY;IAGpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;CAuBxG"}

package/dist/services/quotes/QuoteService.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuoteService = void 0;
+const abis_1 = require("../../core/abis");
+const constants_1 = require("../../core/constants");
+const pathEncoder_1 = require("../../utils/pathEncoder");
+const validation_1 = require("../../utils/validation");
+/**
+ * Service for getting swap quotes from the Mento protocol.
+ * Calculates expected output amounts for trades without executing them.
+ */
+class QuoteService {
+    constructor(publicClient, chainId, routeService) {
+        this.publicClient = publicClient;
+        this.chainId = chainId;
+        this.routeService = routeService;
+    }
+    /**
+     * Calculates the expected output amount for a swap between two tokens.
+     *
+     * @param tokenIn - The address of the input token (e.g., '0x765DE816845861e75A25fCA122bb6898B8B1282a')
+     * @param tokenOut - The address of the output token (e.g., '0x471EcE3750Da237f93B8E339c536989b8978a438')
+     * @param amountIn - The amount of input tokens (in wei/smallest unit)
+     * @param route - Optional pre-fetched route. If not provided, the optimal route will be found automatically.
+     * @returns The expected output amount (in wei/smallest unit)
+     * @throws {RouteNotFoundError} If no route exists between the token pair
+     * @throws {Error} If the Router contract call fails
+     *
+     * @example
+     * ```typescript
+     * // Calculate output for 100 USDm
+     * const amountIn = BigInt(100) * BigInt(10 ** 18) // 100 USDm in wei
+     * const expectedOut = await quoteService.getAmountOut(
+     *   '0x765DE816845861e75A25fCA122bb6898B8B1282a', // USDm
+     *   '0x471EcE3750Da237f93B8E339c536989b8978a438', // CELO
+     *   amountIn
+     * )
+     * console.log(`Expected CELO output: ${expectedOut}`)
+     *
+     * // Or provide a pre-fetched route for better performance
+     * const route = await routeService.findRoute(
+     *   '0x765DE816845861e75A25fCA122bb6898B8B1282a',
+     *   '0x471EcE3750Da237f93B8E339c536989b8978a438'
+     * )
+     * const expectedOut2 = await quoteService.getAmountOut(
+     *   '0x765DE816845861e75A25fCA122bb6898B8B1282a',
+     *   '0x471EcE3750Da237f93B8E339c536989b8978a438',
+     *   amountIn,
+     *   route
+     * )
+     * ```
+     */
+    async getAmountOut(tokenIn, tokenOut, amountIn, route) {
+        // Validate address inputs
+        (0, validation_1.validateAddress)(tokenIn, 'tokenIn');
+        (0, validation_1.validateAddress)(tokenOut, 'tokenOut');
+        // If the consumer does not provide a route then we find the best route.
+        if (!route) {
+            route = await this.routeService.findRoute(tokenIn, tokenOut);
+        }
+        // Convert route.path to Router contract's Route[] format
+        const routerRoutes = (0, pathEncoder_1.encodeRoutePath)(route.path, tokenIn, tokenOut);
+        const routerAddress = (0, constants_1.getContractAddress)(this.chainId, 'Router');
+        const amounts = (await this.publicClient.readContract({
+            address: routerAddress,
+            abi: abis_1.ROUTER_ABI,
+            functionName: 'getAmountsOut',
+            args: [amountIn, routerRoutes],
+        }));
+        return amounts[amounts.length - 1];
+    }
+}
+exports.QuoteService = QuoteService;
+//# sourceMappingURL=QuoteService.js.map

package/dist/services/quotes/QuoteService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuoteService.js","sourceRoot":"","sources":["../../../src/services/quotes/QuoteService.ts"],"names":[],"mappings":";;;AAGA,0CAA4C;AAC5C,oDAAkE;AAClE,yDAAyD;AACzD,uDAAwD;AAExD;;;GAGG;AACH,MAAa,YAAY;IACvB,YACU,YAA0B,EAC1B,OAAe,EACf,YAA0B;QAF1B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,YAAO,GAAP,OAAO,CAAQ;QACf,iBAAY,GAAZ,YAAY,CAAc;IACjC,CAAC;IAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,QAAgB,EAAE,QAAgB,EAAE,KAAa;QACnF,0BAA0B;QAC1B,IAAA,4BAAe,EAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QACnC,IAAA,4BAAe,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QAErC,wEAAwE;QACxE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC9D,CAAC;QAED,yDAAyD;QACzD,MAAM,YAAY,GAAG,IAAA,6BAAe,EAAC,KAAK,CAAC,IAAI,EAAE,OAAkB,EAAE,QAAmB,CAAC,CAAA;QACzF,MAAM,aAAa,GAAG,IAAA,8BAAkB,EAAC,IAAI,CAAC,OAAkB,EAAE,QAAQ,CAAC,CAAA;QAE3E,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;YACpD,OAAO,EAAE,aAA8B;YACvC,GAAG,EAAE,iBAAU;YACf,YAAY,EAAE,eAAe;YAC7B,IAAI,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC/B,CAAC,CAAa,CAAA;QAEf,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpC,CAAC;CACF;AAjED,oCAiEC"}

package/dist/services/quotes/index.d.ts

@@ -0,0 +1,2 @@
+export * from './QuoteService';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/quotes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/quotes/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA"}

package/dist/services/quotes/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./QuoteService"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/quotes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/quotes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA8B"}

package/dist/services/routes/RouteService.d.ts

@@ -0,0 +1,109 @@
+import { PoolService } from '../pools';
+import { Route, RouteWithCost } from '../../core/types';
+import { PublicClient } from 'viem';
+export interface RouteOptions {
+    /**
+     * Whether to use pre-generated cached routes (default: true)
+     */
+    cached?: boolean;
+    /**
+     * Whether to return all possible routes or just the optimal one per pair (default: false)
+     */
+    returnAllRoutes?: boolean;
+}
+/**
+ * Service for discovering and managing trading routes in the Mento protocol.
+ * Handles route discovery for both direct (single-hop) and multi-hop trading paths.
+ *
+ * Routes are identified by their token pair and include the path of pools
+ * needed to execute the trade. Multi-hop routes (up to 2 hops) are automatically
+ * discovered when no direct route exists between two tokens.
+ */
+export declare class RouteService {
+    private publicClient;
+    private chainId;
+    private poolService;
+    private symbolCache;
+    constructor(publicClient: PublicClient, chainId: number, poolService: PoolService);
+    /**
+     * Generates all direct (single-hop) routes from available pools
+     * Routes are deduplicated and assets are sorted alphabetically by symbol
+     *
+     * @returns Array of direct routes with single-hop paths
+     * @throws {Error} If RPC calls fail
+     *
+     * @example
+     * ```typescript
+     * const directRoutes = await routeService.getDirectRoutes()
+     * console.log(`Found ${directRoutes.length} direct routes`)
+     * ```
+     */
+    getDirectRoutes(): Promise<Route[]>;
+    /**
+     * Discovers all tradable routes including multi-hop routes (up to 2 hops)
+     * Uses cached data by default for instant results, or generates fresh from blockchain
+     *
+     * @param options - Configuration options
+     * @param options.cached - Whether to use pre-generated cached routes (default: true)
+     * @param options.returnAllRoutes - Whether to return all possible routes or just the optimal one per pair (default: false)
+     * @returns Array of all tradable routes (direct + multi-hop routes)
+     *
+     * @example
+     * ```typescript
+     * // Fast: use pre-generated cache
+     * const cachedRoutes = await routeService.getRoutes({ cached: true })
+     *
+     * // Slower but fresh: generate from blockchain
+     * const freshRoutes = await routeService.getRoutes({ cached: false })
+     *
+     * // Get all route variants (useful for cache generation)
+     * const allRoutes = await routeService.getRoutes({ cached: false, returnAllRoutes: true })
+     * ```
+     */
+    getRoutes(options?: RouteOptions): Promise<readonly (Route | RouteWithCost)[]>;
+    /**
+     * Looks up the tradable route between two tokens (direct or multi-hop)
+     *
+     * @param tokenIn - Input token address (direction matters for routing)
+     * @param tokenOut - Output token address (direction matters for routing)
+     * @param options - Optional configuration (e.g., cached)
+     * @returns The optimal tradable route connecting the two tokens
+     * @throws {RouteNotFoundError} If no route exists between the token pair
+     *
+     * @example
+     * ```typescript
+     * const USDm = '0x765DE816845861e75A25fCA122bb6898B8B1282a'
+     * const BRLm = '0xE4D5...'
+     * const route = await routeService.findRoute(USDm, BRLm)
+     *
+     * if (route.path.length === 1) {
+     *   console.log('Direct route available')
+     * } else {
+     *   console.log('Two-hop route:', route.path)
+     * }
+     * ```
+     */
+    findRoute(tokenIn: string, tokenOut: string, options?: {
+        cached?: boolean;
+    }): Promise<Route>;
+    /**
+     * Generate fresh tradable routes from blockchain data
+     * @param returnAllRoutes - Whether to return all routes or just optimal ones per pair
+     * @private
+     */
+    private generateFreshRoutes;
+    /**
+     * Load cached tradable routes for current chain
+     * @private
+     */
+    private loadCachedRoutes;
+    /**
+     * Helper: Fetch token symbol from on-chain
+     * Results are cached to avoid redundant RPC calls
+     * Falls back to address if symbol fetch fails
+     *
+     * @private
+     */
+    private fetchTokenSymbol;
+}
+//# sourceMappingURL=RouteService.d.ts.map

package/dist/services/routes/RouteService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteService.d.ts","sourceRoot":"","sources":["../../../src/services/routes/RouteService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAGtC,OAAO,EAAE,KAAK,EAAiB,aAAa,EAAc,MAAM,kBAAkB,CAAA;AAGlF,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAEnC,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,YAAY;IAAgB,OAAO,CAAC,OAAO;IAAU,OAAO,CAAC,WAAW;IAF5F,OAAO,CAAC,WAAW,CAAiC;gBAEhC,YAAY,EAAE,YAAY,EAAU,OAAO,EAAE,MAAM,EAAU,WAAW,EAAE,WAAW;IAEzG;;;;;;;;;;;;OAYG;IACG,eAAe,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAuDzC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,aAAa,CAAC,EAAE,CAAC;IAoBpF;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAuBlG;;;;OAIG;YACW,mBAAmB;IAoBjC;;;OAGG;YACW,gBAAgB;IAM9B;;;;;;OAMG;YACW,gBAAgB;CAuB/B"}