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

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

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 cUSD = '0x765DE816845861e75A25fCA122bb6898B8B1282a'
+     * const cBRL = '0xE4D5...'
+     * const route = await routeService.findRoute(cUSD, cBRL)
+     *
+     * 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,EAAS,MAAM,kBAAkB,CAAA;AAG7E,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;CAyB/B"}