@mento-protocol/mento-sdk 2.0.0-beta.8 → 3.0.0-beta.1

package/dist/index.js

@@ -15,108 +15,84 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Mento = void 0;
-const adapters_1 = require("./adapters");
-const services_1 = require("./services");
-const addresses_1 = require("./constants/addresses");
-/** Helper type guard for Ethers v5 Provider */
-function isEthersV5Provider(provider) {
-    // Check for v5 specific properties that don't exist in v6
-    return ('getNetwork' in provider &&
-        '_network' in provider &&
-        // v5 specific internal property
-        'formatter' in provider);
-}
-/** Helper type guard for Ethers v6 Provider */
-function isEthersV6Provider(provider) {
-    // Check for v6 specific properties that don't exist in v5
-    return ('getNetwork' in provider &&
-        // v6 specific methods
-        'broadcastTransaction' in provider);
-}
-/** Helper type guard for Viem Provider */
-function isViemProvider(provider) {
-    return !('getNetwork' in provider);
-}
+const viem_1 = require("viem");
+const addresses_1 = require("./core/constants/addresses");
+const chainConfig_1 = require("./utils/chainConfig");
+const tokens_1 = require("@services/tokens");
+const pools_1 = require("@services/pools");
+const routes_1 = require("@services/routes");
+const quotes_1 = require("@services/quotes");
+const swap_1 = require("@services/swap");
 /**
  * @class Mento
- * @description The main class for the Mento SDK. It initializes the provider and services,
+ * @description The main class for the Mento SDK. Initializes a viem PublicClient internally
  *              and provides a public API for interacting with the Mento Protocol.
  * @dev         example usage:
- *              // Ethers v6
- *              const mento = await Mento.create({
- *                provider: new ethers.JsonRpcProvider("https://forno.celo.org")
- *              });
- *
- *              // Ethers v5
- *              const mento = await Mento.create({
- *                provider: new ethersV5.providers.JsonRpcProvider("https://forno.celo.org")
- *              });
- *
- *              // Viem
- *              const mento = await Mento.create({
- *                provider: createPublicClient({
- *                  transport: http("https://forno.celo.org")
- *                })
- *              });
+ *              const mento = await Mento.create(ChainId.CELO);
+ *              // or with custom RPC URL
+ *              const mento = await Mento.create(ChainId.CELO, 'https://custom-rpc-url.com');
  *
  *              // Get all stable tokens
- *              const stableTokens = await mento.getStableTokens();
+ *              const stableTokens = await mento.tokens.getStableTokens();
  *
  *              // Get all collateral assets
- *              const collateralAssets = await mento.getCollateralAssets();
+ *              const collateralAssets = await mento.tokens.getCollateralAssets();
+ *
+ *              // Get all pools
+ *              const pools = await mento.pools.getPools();
+ *
+ *              // Find a route between tokens
+ *              const route = await mento.routes.findRoute(cUSD, CELO);
+ *
+ *              // Get a quote for a swap
+ *              const amountOut = await mento.quotes.getAmountOut(cUSD, CELO, amountIn);
+ *
+ *              // Build swap parameters
+ *              const swapDetails = await mento.swap.buildSwapParams(cUSD, CELO, amountIn, { slippageTolerance: 0.5 });
  */
 class Mento {
-    constructor(provider, stableTokenService, collateralAssetService) {
-        this.provider = provider;
-        this.stableTokenService = stableTokenService;
-        this.collateralAssetService = collateralAssetService;
-    }
-    static async create(config) {
-        if (!config.provider) {
-            throw new Error('Provider is required to initialize Mento SDK');
-        }
-        let provider;
-        if (isEthersV5Provider(config.provider)) {
-            provider = new adapters_1.EthersV5Adapter(config.provider);
-        }
-        else if (isEthersV6Provider(config.provider)) {
-            provider = new adapters_1.EthersAdapter(config.provider);
-        }
-        else if (isViemProvider(config.provider)) {
-            provider = new adapters_1.ViemAdapter(config.provider);
-        }
-        else {
-            throw new Error('Unsupported provider type');
-        }
-        const stableTokenService = new services_1.StableTokenService(provider);
-        const collateralAssetService = new services_1.CollateralAssetService(provider);
-        return new Mento(provider, stableTokenService, collateralAssetService);
-    }
-    async getStableTokens() {
-        return this.stableTokenService.getStableTokens();
+    constructor(chainId, tokens, pools, routes, quotes, swap) {
+        this.chainId = chainId;
+        this.tokens = tokens;
+        this.pools = pools;
+        this.routes = routes;
+        this.quotes = quotes;
+        this.swap = swap;
     }
     /**
-     * Get all collateral assets that are available on the current chain.
-     * @returns An array of collateral assets
+     * Create a new Mento SDK instance
+     * @param chainId - The chain ID (e.g., ChainId.CELO, ChainId.CELO_SEPOLIA)
+     * @param rpcUrl - Optional RPC URL. If not provided, uses default for the chain
+     * @returns A new Mento instance
      */
-    async getCollateralAssets() {
-        return this.collateralAssetService.getCollateralAssets();
+    static async create(chainId, rpcUrl) {
+        // Use provided RPC URL or default for the chain
+        const transport = (0, viem_1.http)(rpcUrl || (0, chainConfig_1.getDefaultRpcUrl)(chainId));
+        // Create viem PublicClient
+        const publicClient = (0, viem_1.createPublicClient)({
+            chain: (0, chainConfig_1.getChainConfig)(chainId),
+            transport,
+        });
+        const tokenService = new tokens_1.TokenService(publicClient, chainId);
+        const poolService = new pools_1.PoolService(publicClient, chainId);
+        const routeService = new routes_1.RouteService(publicClient, chainId, poolService);
+        const quoteService = new quotes_1.QuoteService(publicClient, chainId, routeService);
+        const swapService = new swap_1.SwapService(publicClient, chainId, routeService, quoteService);
+        // Return new mento
+        return new Mento(chainId, tokenService, poolService, routeService, quoteService, swapService);
     }
     /**
      * Get the address of a contract for the current chain
      * @param contractName - The contract name
      * @returns The contract address
      */
-    async getContractAddress(contractName) {
-        const chainId = (await this.provider.getChainId());
-        return addresses_1.addresses[chainId][contractName];
+    getContractAddress(contractName) {
+        return (0, addresses_1.getContractAddress)(this.chainId, contractName);
     }
 }
 exports.Mento = Mento;
-__exportStar(require("./constants"), exports);
-__exportStar(require("./types"), exports);
-__exportStar(require("./adapters"), exports);
+__exportStar(require("./core/constants"), exports);
+__exportStar(require("./core/types"), exports);
+__exportStar(require("./core/abis"), exports);
 __exportStar(require("./services"), exports);
-__exportStar(require("./abis"), exports);
-__exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAIA,yCAAwE;AAOxE,yCAAuE;AAEvE,qDAAiD;AAgBjD,+CAA+C;AAC/C,SAAS,kBAAkB,CACzB,QAA2B;IAE3B,0DAA0D;IAC1D,OAAO,CACL,YAAY,IAAI,QAAQ;QACxB,UAAU,IAAI,QAAQ;QACtB,gCAAgC;QAChC,WAAW,IAAI,QAAQ,CACxB,CAAA;AACH,CAAC;AAED,+CAA+C;AAC/C,SAAS,kBAAkB,CACzB,QAA2B;IAE3B,0DAA0D;IAC1D,OAAO,CACL,YAAY,IAAI,QAAQ;QACxB,sBAAsB;QACtB,sBAAsB,IAAI,QAAQ,CACnC,CAAA;AACH,CAAC;AAED,0CAA0C;AAC1C,SAAS,cAAc,CAAC,QAA2B;IACjD,OAAO,CAAC,CAAC,YAAY,IAAI,QAAQ,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAa,KAAK;IAKhB,YACE,QAAyB,EACzB,kBAAsC,EACtC,sBAA8C;QAE9C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAA;QAC5C,IAAI,CAAC,sBAAsB,GAAG,sBAAsB,CAAA;IACtD,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAmB;QAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;QAED,IAAI,QAAyB,CAAA;QAC7B,IAAI,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,QAAQ,GAAG,IAAI,0BAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACjD,CAAC;aAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,QAAQ,GAAG,IAAI,wBAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC/C,CAAC;aAAM,IAAI,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,QAAQ,GAAG,IAAI,sBAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC7C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;QAC9C,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAI,6BAAkB,CAAC,QAAQ,CAAC,CAAA;QAC3D,MAAM,sBAAsB,GAAG,IAAI,iCAAsB,CAAC,QAAQ,CAAC,CAAA;QAEnE,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,kBAAkB,EAAE,sBAAsB,CAAC,CAAA;IACxE,CAAC;IAEM,KAAK,CAAC,eAAe;QAC1B,OAAO,IAAI,CAAC,kBAAkB,CAAC,eAAe,EAAE,CAAA;IAClD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,mBAAmB;QAC9B,OAAO,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,EAAE,CAAA;IAC1D,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,kBAAkB,CAC7B,YAAqC;QAErC,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAY,CAAA;QAC7D,OAAO,qBAAS,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAA;IACzC,CAAC;CACF;AA5DD,sBA4DC;AAED,8CAA2B;AAC3B,0CAAuB;AACvB,6CAA0B;AAC1B,6CAA0B;AAC1B,yCAAsB;AACtB,0CAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+BAAkE;AAGlE,0DAA+D;AAC/D,qDAAsE;AACtE,6CAA+C;AAC/C,2CAA6C;AAC7C,6CAA+C;AAC/C,6CAA+C;AAC/C,yCAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAa,KAAK;IAChB,YACU,OAAe,EAChB,MAAoB,EACpB,KAAkB,EAClB,MAAoB,EACpB,MAAoB,EACpB,IAAiB;QALhB,YAAO,GAAP,OAAO,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAc;QACpB,UAAK,GAAL,KAAK,CAAa;QAClB,WAAM,GAAN,MAAM,CAAc;QACpB,WAAM,GAAN,MAAM,CAAc;QACpB,SAAI,GAAJ,IAAI,CAAa;IACvB,CAAC;IAEJ;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,MAAe;QACzD,gDAAgD;QAChD,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,MAAM,IAAI,IAAA,8BAAgB,EAAC,OAAO,CAAC,CAAC,CAAA;QAE3D,2BAA2B;QAC3B,MAAM,YAAY,GAAG,IAAA,yBAAkB,EAAC;YACtC,KAAK,EAAE,IAAA,4BAAc,EAAC,OAAO,CAAC;YAC9B,SAAS;SACV,CAAC,CAAA;QAEF,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC5D,MAAM,WAAW,GAAG,IAAI,mBAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC1D,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;QACzE,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QAC1E,MAAM,WAAW,GAAG,IAAI,kBAAW,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAA;QAEtF,mBAAmB;QACnB,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAA;IAC/F,CAAC;IAED;;;;OAIG;IACI,kBAAkB,CAAC,YAAqC;QAC7D,OAAO,IAAA,8BAAkB,EAAC,IAAI,CAAC,OAAkB,EAAE,YAAY,CAAC,CAAA;IAClE,CAAC;CACF;AA5CD,sBA4CC;AAED,mDAAgC;AAChC,+CAA4B;AAC5B,8CAA2B;AAC3B,6CAA0B"}

package/dist/services/index.d.ts

@@ -1,6 +1,7 @@
-export * from './collateralAssetService';
-export * from './stableTokenService';
-export * from './supplyAdjustmentService';
-export * from './tokenMetadataService';
-export * from './supply';
+export * from './tokens/supplyAdjustmentService';
+export * from './tokens/supply';
+export * from './pools';
+export * from './routes';
+export * from './quotes';
+export * from './swap';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA"}

package/dist/services/index.js

@@ -14,9 +14,10 @@ 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("./collateralAssetService"), exports);
-__exportStar(require("./stableTokenService"), exports);
-__exportStar(require("./supplyAdjustmentService"), exports);
-__exportStar(require("./tokenMetadataService"), exports);
-__exportStar(require("./supply"), exports);
+__exportStar(require("./tokens/supplyAdjustmentService"), exports);
+__exportStar(require("./tokens/supply"), exports);
+__exportStar(require("./pools"), exports);
+__exportStar(require("./routes"), exports);
+__exportStar(require("./quotes"), exports);
+__exportStar(require("./swap"), exports);
 //# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAwC;AACxC,uDAAoC;AACpC,4DAAyC;AACzC,yDAAsC;AACtC,2CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAgD;AAChD,kDAA+B;AAC/B,0CAAuB;AACvB,2CAAwB;AACxB,2CAAwB;AACxB,yCAAsB"}

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

@@ -0,0 +1,37 @@
+import { Pool } from '../../core/types';
+import { PublicClient } from 'viem';
+/**
+ * Service for discovering liquidity pools in the Mento protocol.
+ * Aggregates pools from multiple factory contracts (FPMM and VirtualPool).
+ */
+export declare class PoolService {
+    private publicClient;
+    private chainId;
+    private poolsCache;
+    constructor(publicClient: PublicClient, chainId: number);
+    /**
+     * Fetches all pools available in the protocol from both FPMM and Virtual pool factories
+     * Results are cached in memory for the service instance lifetime
+     *
+     * @returns Array of all pools available in the protocol
+     * @throws {Error} If RPC call fails or pools are unavailable
+     *
+     * @example
+     * ```typescript
+     * const pools = await poolService.getPools()
+     * console.log(`Found ${pools.length} pools`)
+     * ```
+     */
+    getPools(): Promise<Pool[]>;
+    /**
+     * Fetches all FPMM pools from the FPMM Factory
+     */
+    private fetchFPMMPools;
+    /**
+     * 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.
+     */
+    private fetchVirtualPools;
+}
+//# sourceMappingURL=PoolService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PoolService.d.ts","sourceRoot":"","sources":["../../../src/services/pools/PoolService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAY,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAW,MAAM,MAAM,CAAA;AAK5C;;;GAGG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,YAAY;IAAgB,OAAO,CAAC,OAAO;IAF/D,OAAO,CAAC,UAAU,CAAsB;gBAEpB,YAAY,EAAE,YAAY,EAAU,OAAO,EAAE,MAAM;IAEvE;;;;;;;;;;;;OAYG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAoBjC;;OAEG;YACW,cAAc;IAkD5B;;;;OAIG;YACW,iBAAiB;CAmEhC"}

package/dist/services/pools/PoolService.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolService = void 0;
+const constants_1 = require("../../core/constants");
+const types_1 = require("../../core/types");
+const abis_1 = require("../../core/abis");
+const sortUtils_1 = require("../../utils/sortUtils");
+// TODO: Update to enrich pools with more data as needed. Use optional flag to include more data.
+/**
+ * Service for discovering liquidity pools in the Mento protocol.
+ * Aggregates pools from multiple factory contracts (FPMM and VirtualPool).
+ */
+class PoolService {
+    constructor(publicClient, chainId) {
+        this.publicClient = publicClient;
+        this.chainId = chainId;
+        this.poolsCache = null;
+    }
+    /**
+     * Fetches all pools available in the protocol from both FPMM and Virtual pool factories
+     * Results are cached in memory for the service instance lifetime
+     *
+     * @returns Array of all pools available in the protocol
+     * @throws {Error} If RPC call fails or pools are unavailable
+     *
+     * @example
+     * ```typescript
+     * const pools = await poolService.getPools()
+     * console.log(`Found ${pools.length} pools`)
+     * ```
+     */
+    async getPools() {
+        if (this.poolsCache) {
+            return this.poolsCache;
+        }
+        // TODO: Update to use router.factoryRegistry.poolFactories()
+        //       for dynamic factory discovery. For now we will use
+        //       the hardcoded factory addresses for the chain for v1.
+        const pools = [];
+        const fpmmPools = await this.fetchFPMMPools();
+        pools.push(...fpmmPools);
+        const virtualPools = await this.fetchVirtualPools();
+        pools.push(...virtualPools);
+        this.poolsCache = pools;
+        return pools;
+    }
+    /**
+     * Fetches all FPMM pools from the FPMM Factory
+     */
+    async fetchFPMMPools() {
+        const fpmmFactoryAddress = (0, constants_1.getContractAddress)(this.chainId, 'FPMMFactory');
+        if (!fpmmFactoryAddress) {
+            console.warn('FPMM Factory address not found for this chain');
+            return [];
+        }
+        try {
+            // Get all deployed FPMM pool addresses
+            const poolAddresses = (await this.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([
+                    this.publicClient.readContract({
+                        address: poolAddress,
+                        abi: abis_1.FPMM_ABI,
+                        functionName: 'token0',
+                    }),
+                    this.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) {
+            console.error('Failed to fetch FPMM pools:', 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 fetchVirtualPools() {
+        const virtualPoolFactoryAddress = (0, constants_1.getContractAddress)(this.chainId, 'VirtualPoolFactory');
+        const biPoolManagerAddress = (0, constants_1.getContractAddress)(this.chainId, 'BiPoolManager');
+        if (!virtualPoolFactoryAddress || !biPoolManagerAddress) {
+            console.warn('VirtualPoolFactory or BiPoolManager address not found for this chain');
+            return [];
+        }
+        try {
+            // TODO: When new virtual pool factory is deployed
+            //       we can simplify this by using VirtualPoolFactory.getAllPools() returns(address[])
+            // Get all exchanges from BiPoolManager
+            const exchangesData = (await this.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) {
+                    console.warn(`Skipping invalid exchange ${exchange.exchangeId}: expected 2 assets`);
+                    return null;
+                }
+                const [token0, token1] = (0, sortUtils_1.sortTokenAddresses)(exchange.assets[0], exchange.assets[1]);
+                const poolAddress = (await this.publicClient.readContract({
+                    address: virtualPoolFactoryAddress,
+                    abi: abis_1.VIRTUAL_POOL_FACTORY_ABI,
+                    functionName: 'getOrPrecomputeProxyAddress',
+                    args: [token0, token1],
+                }));
+                const isDeployed = (await this.publicClient.readContract({
+                    address: virtualPoolFactoryAddress,
+                    abi: abis_1.VIRTUAL_POOL_FACTORY_ABI,
+                    functionName: 'isPool',
+                    args: [poolAddress],
+                }));
+                if (!isDeployed) {
+                    return null;
+                }
+                return {
+                    factoryAddr: virtualPoolFactoryAddress,
+                    poolAddr: poolAddress,
+                    token0: token0,
+                    token1: token1,
+                    poolType: types_1.PoolType.Virtual,
+                };
+            });
+            const results = await Promise.all(poolPromises);
+            return results.filter((pool) => pool !== null);
+        }
+        catch (error) {
+            console.error('Failed to fetch Virtual pools:', error);
+            throw new Error(`Failed to fetch Virtual pools: ${error.message}`);
+        }
+    }
+}
+exports.PoolService = PoolService;
+//# sourceMappingURL=PoolService.js.map

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

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

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

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

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

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

package/dist/services/pools/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("./PoolService"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,41 @@
+import { Address, 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
+     * @param tokenOut - The address of the output token
+     * @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
+     * const cUSD = '0x765DE816845861e75A25fCA122bb6898B8B1282a'
+     * const CELO = '0x471EcE3750Da237f93B8E339c536989b8978a438'
+     *
+     * // Calculate output for 100 cUSD
+     * const amountIn = BigInt(100) * BigInt(10 ** 18) // 100 cUSD in wei
+     * const expectedOut = await quoteService.getAmountOut(cUSD, CELO, amountIn)
+     * console.log(`Expected CELO output: ${expectedOut}`)
+     *
+     * // Or provide a pre-fetched route for better performance
+     * const route = await routeService.findRoute(cUSD, CELO)
+     * const expectedOut2 = await quoteService.getAmountOut(cUSD, CELO, amountIn, route)
+     * ```
+     */
+    getAmountOut(tokenIn: Address, tokenOut: Address, 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,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAKxC;;;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;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;CAmB1G"}

package/dist/services/quotes/QuoteService.js

@@ -0,0 +1,61 @@
+"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");
+/**
+ * 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
+     * @param tokenOut - The address of the output token
+     * @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
+     * const cUSD = '0x765DE816845861e75A25fCA122bb6898B8B1282a'
+     * const CELO = '0x471EcE3750Da237f93B8E339c536989b8978a438'
+     *
+     * // Calculate output for 100 cUSD
+     * const amountIn = BigInt(100) * BigInt(10 ** 18) // 100 cUSD in wei
+     * const expectedOut = await quoteService.getAmountOut(cUSD, CELO, amountIn)
+     * console.log(`Expected CELO output: ${expectedOut}`)
+     *
+     * // Or provide a pre-fetched route for better performance
+     * const route = await routeService.findRoute(cUSD, CELO)
+     * const expectedOut2 = await quoteService.getAmountOut(cUSD, CELO, amountIn, route)
+     * ```
+     */
+    async getAmountOut(tokenIn, tokenOut, amountIn, route) {
+        // 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;AAEzD;;;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;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,YAAY,CAAC,OAAgB,EAAE,QAAiB,EAAE,QAAgB,EAAE,KAAa;QACrF,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,OAAO,EAAE,QAAQ,CAAC,CAAA;QACnE,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;AApDD,oCAoDC"}

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"}