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

package/dist/services/tokens/tokenService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenService.d.ts","sourceRoot":"","sources":["../../../src/services/tokens/tokenService.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAkBtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,qBAAa,YAAY;IAGX,OAAO,CAAC,YAAY;IAAgB,OAAO,CAAC,OAAO;IAF/D,OAAO,CAAC,uBAAuB,CAAyB;gBAEpC,YAAY,EAAE,YAAY,EAAU,OAAO,EAAE,MAAM;IAQvE;;;;OAIG;YACW,gBAAgB;IAqC9B;;;;OAIG;YACW,cAAc;IAa5B;;;;OAIG;IACU,eAAe,CAAC,aAAa,UAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAuC1E;;;;OAIG;IACU,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CA2C/D"}

package/dist/services/tokens/tokenService.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenService = void 0;
+const abis_1 = require("../../core/abis");
+const constants_1 = require("../../core/constants");
+const utils_1 = require("../../utils");
+const supplyAdjustmentService_1 = require("./supplyAdjustmentService");
+const supply_1 = require("./supply");
+class TokenService {
+    constructor(publicClient, chainId) {
+        this.publicClient = publicClient;
+        this.chainId = chainId;
+        this.supplyAdjustmentService = new supplyAdjustmentService_1.SupplyAdjustmentService(publicClient, chainId, new supply_1.DefaultCalculatorFactory());
+    }
+    /**
+     * Get token metadata (name, symbol, decimals)
+     * @param address - Token contract address
+     * @returns Token metadata
+     */
+    async getTokenMetadata(address) {
+        const [name, symbol, decimals] = await Promise.all([
+            (0, utils_1.retryOperation)(() => this.publicClient.readContract({
+                address: address,
+                abi: abis_1.ERC20_ABI,
+                functionName: 'name',
+                args: [],
+            })),
+            (0, utils_1.retryOperation)(() => this.publicClient.readContract({
+                address: address,
+                abi: abis_1.ERC20_ABI,
+                functionName: 'symbol',
+                args: [],
+            })),
+            (0, utils_1.retryOperation)(() => this.publicClient.readContract({
+                address: address,
+                abi: abis_1.ERC20_ABI,
+                functionName: 'decimals',
+                args: [],
+            })),
+        ]);
+        return {
+            name: name,
+            symbol: symbol,
+            decimals: Number(decimals),
+        };
+    }
+    /**
+     * Get total supply of a token
+     * @param address - Token contract address
+     * @returns Total supply as string
+     */
+    async getTotalSupply(address) {
+        const totalSupply = await (0, utils_1.retryOperation)(() => this.publicClient.readContract({
+            address: address,
+            abi: abis_1.ERC20_ABI,
+            functionName: 'totalSupply',
+            args: [],
+        }));
+        return totalSupply.toString();
+    }
+    /**
+     * Get all stable tokens from the Reserve contract
+     * @param includeSupply - Whether to fetch total supply and apply adjustments
+     * @returns Array of stable tokens
+     */
+    async getStableTokens(includeSupply = true) {
+        const reserveAddress = (0, constants_1.getContractAddress)(this.chainId, constants_1.RESERVE);
+        const tokenAddresses = (await this.publicClient.readContract({
+            address: reserveAddress,
+            abi: abis_1.RESERVE_ABI,
+            functionName: 'getTokens',
+            args: [],
+        }));
+        const tokens = [];
+        for (const address of tokenAddresses) {
+            const metadata = await this.getTokenMetadata(address);
+            let totalSupply = '0';
+            if (includeSupply) {
+                totalSupply = await this.getTotalSupply(address);
+            }
+            const token = {
+                address,
+                ...metadata,
+                totalSupply,
+            };
+            if (includeSupply) {
+                const adjustedSupply = await this.supplyAdjustmentService.getAdjustedSupply(token);
+                token.totalSupply = adjustedSupply;
+            }
+            tokens.push(token);
+        }
+        return tokens;
+    }
+    // TODO: V3 - How does USD.m fit in here?
+    /**
+     * Get all collateral assets from exchanges
+     * Filters tokens that are marked as collateral in the Reserve contract
+     * @returns Array of collateral assets
+     */
+    async getCollateralAssets() {
+        const biPoolManagerAddress = (0, constants_1.getContractAddress)(this.chainId, constants_1.BIPOOLMANAGER);
+        const reserveAddress = (0, constants_1.getContractAddress)(this.chainId, constants_1.RESERVE);
+        // TODO: V3 - Should instead use the factories.
+        // Get all exchanges to find unique token addresses
+        const exchanges = (await (0, utils_1.retryOperation)(() => this.publicClient.readContract({
+            address: biPoolManagerAddress,
+            abi: abis_1.BIPOOL_MANAGER_ABI,
+            functionName: 'getExchanges',
+        })));
+        // Extract unique token addresses from exchanges
+        const uniqueAddresses = new Set();
+        for (const exchange of exchanges) {
+            exchange.assets.forEach((address) => uniqueAddresses.add(address));
+        }
+        // Check which tokens are collateral assets and get their metadata
+        const assets = [];
+        for (const address of uniqueAddresses) {
+            const isCollateral = (await (0, utils_1.retryOperation)(() => this.publicClient.readContract({
+                address: reserveAddress,
+                abi: abis_1.RESERVE_ABI,
+                functionName: 'isCollateralAsset',
+                args: [address],
+            })));
+            if (isCollateral) {
+                const metadata = await this.getTokenMetadata(address);
+                assets.push({
+                    address,
+                    ...metadata,
+                });
+            }
+        }
+        return assets;
+    }
+}
+exports.TokenService = TokenService;
+//# sourceMappingURL=tokenService.js.map

package/dist/services/tokens/tokenService.js.map

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

package/dist/utils/chainConfig.d.ts

@@ -0,0 +1,16 @@
+import { type Chain } from 'viem/chains';
+/**
+ * Get the default RPC URL for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The default RPC URL for the chain
+ * @throws Error if chain ID is not supported
+ */
+export declare function getDefaultRpcUrl(chainId: number): string;
+/**
+ * Get the viem chain configuration for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The viem chain configuration
+ * @throws Error if chain ID is not supported
+ */
+export declare function getChainConfig(chainId: number): Chain;
+//# sourceMappingURL=chainConfig.d.ts.map

package/dist/utils/chainConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainConfig.d.ts","sourceRoot":"","sources":["../../src/utils/chainConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,KAAK,EAAE,MAAM,aAAa,CAAA;AA2B9C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASxD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CASrD"}

package/dist/utils/chainConfig.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultRpcUrl = getDefaultRpcUrl;
+exports.getChainConfig = getChainConfig;
+const chains_1 = require("viem/chains");
+const viem_1 = require("viem");
+const chainId_1 = require("../core/constants/chainId");
+// Celo Sepolia chain definition (not available in viem/chains yet)
+const celoSepolia = (0, viem_1.defineChain)({
+    id: 11142220,
+    name: 'Celo Sepolia',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'CELO',
+        symbol: 'CELO',
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://forno.celo-sepolia.celo-testnet.org'],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: 'Celo Explorer',
+            url: 'https://sepolia.celoscan.io',
+        },
+    },
+    testnet: true,
+});
+/**
+ * Get the default RPC URL for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The default RPC URL for the chain
+ * @throws Error if chain ID is not supported
+ */
+function getDefaultRpcUrl(chainId) {
+    switch (chainId) {
+        case chainId_1.ChainId.CELO:
+            return 'https://forno.celo.org';
+        case chainId_1.ChainId.CELO_SEPOLIA:
+            return 'https://forno.celo-sepolia.celo-testnet.org';
+        default:
+            throw new Error(`Unsupported chain ID: ${chainId}`);
+    }
+}
+/**
+ * Get the viem chain configuration for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The viem chain configuration
+ * @throws Error if chain ID is not supported
+ */
+function getChainConfig(chainId) {
+    switch (chainId) {
+        case chainId_1.ChainId.CELO:
+            return chains_1.celo;
+        case chainId_1.ChainId.CELO_SEPOLIA:
+            return celoSepolia;
+        default:
+            throw new Error(`Unsupported chain ID: ${chainId}`);
+    }
+}
+//# sourceMappingURL=chainConfig.js.map

package/dist/utils/chainConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainConfig.js","sourceRoot":"","sources":["../../src/utils/chainConfig.ts"],"names":[],"mappings":";;AAiCA,4CASC;AAQD,wCASC;AA3DD,wCAA8C;AAC9C,+BAAkC;AAClC,uDAAmD;AAEnD,mEAAmE;AACnE,MAAM,WAAW,GAAG,IAAA,kBAAW,EAAC;IAC9B,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,cAAc;IACpB,cAAc,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,MAAM;KACf;IACD,OAAO,EAAE;QACP,OAAO,EAAE;YACP,IAAI,EAAE,CAAC,6CAA6C,CAAC;SACtD;KACF;IACD,cAAc,EAAE;QACd,OAAO,EAAE;YACP,IAAI,EAAE,eAAe;YACrB,GAAG,EAAE,6BAA6B;SACnC;KACF;IACD,OAAO,EAAE,IAAI;CACd,CAAC,CAAA;AAEF;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,iBAAO,CAAC,IAAI;YACf,OAAO,wBAAwB,CAAA;QACjC,KAAK,iBAAO,CAAC,YAAY;YACvB,OAAO,6CAA6C,CAAA;QACtD;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAA;IACvD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC5C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,iBAAO,CAAC,IAAI;YACf,OAAO,aAAI,CAAA;QACb,KAAK,iBAAO,CAAC,YAAY;YACvB,OAAO,WAAW,CAAA;QACpB;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAA;IACvD,CAAC;AACH,CAAC"}

package/dist/utils/costUtils.d.ts

@@ -0,0 +1,12 @@
+import { Pool } from '../core/types';
+import type { PublicClient } from 'viem';
+/**
+ * Calculate cost percentage for a pool based on its type
+ * Returns cost as a percentage (e.g., 0.5 = 0.5%)
+ *
+ * @param pool - The pool to calculate cost for
+ * @param publicClient - Viem public client for RPC calls
+ * @returns Cost percentage for the pool
+ */
+export declare function getPoolCostPercent(pool: Pool, publicClient: PublicClient): Promise<number>;
+//# sourceMappingURL=costUtils.d.ts.map

package/dist/utils/costUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costUtils.d.ts","sourceRoot":"","sources":["../../src/utils/costUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,IAAI,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGxC;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhG"}

package/dist/utils/costUtils.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPoolCostPercent = getPoolCostPercent;
+const types_1 = require("../core/types");
+const abis_1 = require("../core/abis");
+const virtualPool_1 = require("../core/abis/virtualPool");
+/**
+ * Calculate cost percentage for a pool based on its type
+ * Returns cost as a percentage (e.g., 0.5 = 0.5%)
+ *
+ * @param pool - The pool to calculate cost for
+ * @param publicClient - Viem public client for RPC calls
+ * @returns Cost percentage for the pool
+ */
+async function getPoolCostPercent(pool, publicClient) {
+    if (pool.poolType === types_1.PoolType.FPMM) {
+        return getFPMMCostPercent(pool.poolAddr, publicClient);
+    }
+    else if (pool.poolType === types_1.PoolType.Virtual) {
+        return getVirtualPoolCostPercent(pool.poolAddr, publicClient);
+    }
+    else {
+        throw new Error('Invalid pool type');
+    }
+}
+/**
+ * Calculate cost for FPMM pools
+ * FPMM pools use lpFee + protocolFee in basis points (10000 = 100%)
+ */
+async function getFPMMCostPercent(poolAddress, publicClient) {
+    const [lpFee, protocolFee] = await Promise.all([
+        publicClient.readContract({
+            address: poolAddress,
+            abi: abis_1.FPMM_ABI,
+            functionName: 'lpFee',
+        }),
+        publicClient.readContract({
+            address: poolAddress,
+            abi: abis_1.FPMM_ABI,
+            functionName: 'protocolFee',
+        }),
+    ]);
+    // Convert from basis points to percentage
+    const totalBasisPoints = Number(lpFee) + Number(protocolFee);
+    return totalBasisPoints / 100;
+}
+/**
+ * Calculate cost for Virtual pools
+ */
+async function getVirtualPoolCostPercent(poolAddress, publicClient) {
+    const protocolFee = await publicClient.readContract({
+        address: poolAddress,
+        abi: virtualPool_1.VIRTUAL_POOL_ABI,
+        functionName: 'protocolFee',
+    });
+    //TODO: Confirim calculation
+    return Number(protocolFee) / 100;
+}
+//# sourceMappingURL=costUtils.js.map

package/dist/utils/costUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costUtils.js","sourceRoot":"","sources":["../../src/utils/costUtils.ts"],"names":[],"mappings":";;AAaA,gDAQC;AArBD,yCAA8C;AAC9C,uCAAuC;AAEvC,0DAA2D;AAE3D;;;;;;;GAOG;AACI,KAAK,UAAU,kBAAkB,CAAC,IAAU,EAAE,YAA0B;IAC7E,IAAI,IAAI,CAAC,QAAQ,KAAK,gBAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IACxD,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,gBAAQ,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,yBAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IAC/D,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;IACtC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAAC,WAAmB,EAAE,YAA0B;IAC/E,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,WAA4B;YACrC,GAAG,EAAE,eAAQ;YACb,YAAY,EAAE,OAAO;SACtB,CAAoB;QACrB,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,WAA4B;YACrC,GAAG,EAAE,eAAQ;YACb,YAAY,EAAE,aAAa;SAC5B,CAAoB;KACtB,CAAC,CAAA;IAEF,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;IAC5D,OAAO,gBAAgB,GAAG,GAAG,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,yBAAyB,CAAC,WAAmB,EAAE,YAA0B;IACtF,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;QAClD,OAAO,EAAE,WAA4B;QACrC,GAAG,EAAE,8BAAgB;QACrB,YAAY,EAAE,aAAa;KAC5B,CAAC,CAAA;IAEF,4BAA4B;IAC5B,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,CAAA;AAClC,CAAC"}

package/dist/utils/index.d.ts

@@ -1,2 +1,6 @@
 export * from './retry';
+export * from './chainConfig';
+export * from './routes';
+export * from './sortUtils';
+export * from './pathEncoder';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/dist/utils/index.js

@@ -15,4 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./retry"), exports);
+__exportStar(require("./chainConfig"), exports);
+__exportStar(require("./routes"), exports);
+__exportStar(require("./sortUtils"), exports);
+__exportStar(require("./pathEncoder"), exports);
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,gDAA6B;AAC7B,2CAAwB;AACxB,8CAA2B;AAC3B,gDAA6B"}

package/dist/utils/pathEncoder.d.ts

@@ -0,0 +1,28 @@
+import { Address } from 'viem';
+import { Pool } from '../core/types';
+/**
+ * Route structure expected by the Router contract's getAmountsOut and swapTokensForTokens functions
+ */
+export interface RouterRoute {
+    from: Address;
+    to: Address;
+    factory: Address;
+}
+/**
+ * Converts a route path to the format expected by the Router contract.
+ * Used by both QuoteService (getAmountsOut) and SwapService (swapTokensForTokens).
+ *
+ * @param path - The route path (array of pools)
+ * @param tokenIn - The input token address (determines swap direction)
+ * @param _tokenOut - The output token address (unused but kept for API clarity)
+ * @returns Array of RouterRoute objects for the contract call
+ *
+ * @example
+ * ```typescript
+ * const route = await routeService.findRoute(cUSD, CELO)
+ * const routerRoutes = encodeRoutePath(route.path, cUSD, CELO)
+ * // routerRoutes can now be passed to Router.getAmountsOut or Router.swapTokensForTokens
+ * ```
+ */
+export declare function encodeRoutePath(path: Pool[], tokenIn: Address, _tokenOut: Address): RouterRoute[];
+//# sourceMappingURL=pathEncoder.d.ts.map

package/dist/utils/pathEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathEncoder.d.ts","sourceRoot":"","sources":["../../src/utils/pathEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEpC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAA;IACb,EAAE,EAAE,OAAO,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,WAAW,EAAE,CA4CjG"}

package/dist/utils/pathEncoder.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeRoutePath = encodeRoutePath;
+/**
+ * Converts a route path to the format expected by the Router contract.
+ * Used by both QuoteService (getAmountsOut) and SwapService (swapTokensForTokens).
+ *
+ * @param path - The route path (array of pools)
+ * @param tokenIn - The input token address (determines swap direction)
+ * @param _tokenOut - The output token address (unused but kept for API clarity)
+ * @returns Array of RouterRoute objects for the contract call
+ *
+ * @example
+ * ```typescript
+ * const route = await routeService.findRoute(cUSD, CELO)
+ * const routerRoutes = encodeRoutePath(route.path, cUSD, CELO)
+ * // routerRoutes can now be passed to Router.getAmountsOut or Router.swapTokensForTokens
+ * ```
+ */
+function encodeRoutePath(path, tokenIn, _tokenOut) {
+    const routes = [];
+    const tokenInLower = tokenIn.toLowerCase();
+    // Check if we need to reverse the path
+    // The path is stored in canonical order, but we may need to traverse it backwards
+    const firstPool = path[0];
+    const startsWithTokenIn = firstPool.token0.toLowerCase() === tokenInLower || firstPool.token1.toLowerCase() === tokenInLower;
+    // If tokenIn isn't in the first pool, reverse the path
+    const orderedPath = startsWithTokenIn ? path : [...path].reverse();
+    let currentTokenIn = tokenInLower;
+    for (const pool of orderedPath) {
+        const token0 = pool.token0.toLowerCase();
+        const token1 = pool.token1.toLowerCase();
+        // Determine direction: which token is the input for this hop?
+        let from;
+        let to;
+        if (currentTokenIn === token0) {
+            from = pool.token0;
+            to = pool.token1;
+        }
+        else if (currentTokenIn === token1) {
+            from = pool.token1;
+            to = pool.token0;
+        }
+        else {
+            throw new Error(`Token ${currentTokenIn} not found in pool ${pool.poolAddr}`);
+        }
+        routes.push({
+            from,
+            to,
+            factory: pool.factoryAddr,
+        });
+        // The output of this hop becomes the input of the next hop
+        currentTokenIn = to.toLowerCase();
+    }
+    return routes;
+}
+//# sourceMappingURL=pathEncoder.js.map

package/dist/utils/pathEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathEncoder.js","sourceRoot":"","sources":["../../src/utils/pathEncoder.ts"],"names":[],"mappings":";;AA4BA,0CA4CC;AA5DD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,eAAe,CAAC,IAAY,EAAE,OAAgB,EAAE,SAAkB;IAChF,MAAM,MAAM,GAAkB,EAAE,CAAA;IAChC,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAA;IAE1C,uCAAuC;IACvC,kFAAkF;IAClF,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACzB,MAAM,iBAAiB,GACrB,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,YAAY,IAAI,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,YAAY,CAAA;IAEpG,uDAAuD;IACvD,MAAM,WAAW,GAAG,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAA;IAElE,IAAI,cAAc,GAAG,YAAY,CAAA;IAEjC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;QAExC,8DAA8D;QAC9D,IAAI,IAAa,CAAA;QACjB,IAAI,EAAW,CAAA;QAEf,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;YAC9B,IAAI,GAAG,IAAI,CAAC,MAAiB,CAAA;YAC7B,EAAE,GAAG,IAAI,CAAC,MAAiB,CAAA;QAC7B,CAAC;aAAM,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,CAAC,MAAiB,CAAA;YAC7B,EAAE,GAAG,IAAI,CAAC,MAAiB,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,SAAS,cAAc,sBAAsB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC/E,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,EAAE;YACF,OAAO,EAAE,IAAI,CAAC,WAAsB;SACrC,CAAC,CAAA;QAEF,2DAA2D;QAC3D,cAAc,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;IACnC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}