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

package/dist/utils/routes.d.ts

@@ -0,0 +1,9 @@
+import type { Route, RouteWithCost } from '../core/types';
+export type { RouteWithCost };
+/**
+ * Gets cached routes for a specific chain ID
+ * @param chainId - The chain ID to get cached routes for
+ * @returns Promise resolving to the cached routes or undefined if not available
+ */
+export declare function getCachedRoutes(chainId: number): Promise<readonly (Route | RouteWithCost)[] | undefined>;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/utils/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAGzD,YAAY,EAAE,aAAa,EAAE,CAAA;AAE7B;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,aAAa,CAAC,EAAE,GAAG,SAAS,CAAC,CAmBzD"}

package/dist/utils/routes.js

@@ -0,0 +1,49 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedRoutes = getCachedRoutes;
+/**
+ * Gets cached routes for a specific chain ID
+ * @param chainId - The chain ID to get cached routes for
+ * @returns Promise resolving to the cached routes or undefined if not available
+ */
+async function getCachedRoutes(chainId) {
+    try {
+        switch (chainId) {
+            case 42220:
+                // @ts-ignore - Cache files are generated by scripts and may not exist yet
+                return await Promise.resolve().then(() => __importStar(require('../cache/routes.42220'))).then((module) => module.routes42220);
+            case 11142220:
+                // @ts-ignore - Cache files are generated by scripts and may not exist yet
+                return await Promise.resolve().then(() => __importStar(require('../cache/routes.11142220'))).then((module) => module.routes11142220);
+            default:
+                return undefined;
+        }
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=routes.js.map

package/dist/utils/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/utils/routes.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAUA,0CAqBC;AA1BD;;;;GAIG;AACI,KAAK,UAAU,eAAe,CACnC,OAAe;IAEf,IAAI,CAAC;QACH,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,KAAK;gBACR,0EAA0E;gBAC1E,OAAO,MAAM,kDAAO,uBAAuB,IAAE,IAAI,CAC/C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAC/B,CAAA;YACH,KAAK,QAAQ;gBACX,0EAA0E;gBAC1E,OAAO,MAAM,kDAAO,0BAA0B,IAAE,IAAI,CAClD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAClC,CAAA;YACH;gBACE,OAAO,SAAS,CAAA;QACpB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/utils/sortUtils.d.ts

@@ -0,0 +1,24 @@
+import { Address } from 'viem';
+/**
+ * Sorts two token addresses to match the smart contract's _sortTokens behavior.
+ * Compares addresses as numeric values (BigInt), matching Solidity's address comparison.
+ *
+ * Solidity reference:
+ * ```solidity
+ * function _sortTokens(address a, address b) private pure returns (address, address) {
+ *   return (a < b) ? (a, b) : (b, a);
+ * }
+ * ```
+ */
+export declare function sortTokenAddresses(tokenA: Address, tokenB: Address): [Address, Address];
+/**
+ * Creates a canonical route ID from two addresses.
+ * Uses numeric address comparison to match contract behavior.
+ */
+export declare function canonicalAddressKey(addressA: Address, addressB: Address, separator?: string): string;
+/**
+ * Creates a canonical pair key from two symbols.
+ * Uses standard string comparison for human-readable IDs.
+ */
+export declare function canonicalSymbolKey(symbolA: string, symbolB: string, separator?: string): string;
+//# sourceMappingURL=sortUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sortUtils.d.ts","sourceRoot":"","sources":["../../src/utils/sortUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,GACd,CAAC,OAAO,EAAE,OAAO,CAAC,CAIpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,OAAO,EACjB,SAAS,SAAM,GACd,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,SAAM,GACd,MAAM,CAIR"}

package/dist/utils/sortUtils.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortTokenAddresses = sortTokenAddresses;
+exports.canonicalAddressKey = canonicalAddressKey;
+exports.canonicalSymbolKey = canonicalSymbolKey;
+/**
+ * Sorts two token addresses to match the smart contract's _sortTokens behavior.
+ * Compares addresses as numeric values (BigInt), matching Solidity's address comparison.
+ *
+ * Solidity reference:
+ * ```solidity
+ * function _sortTokens(address a, address b) private pure returns (address, address) {
+ *   return (a < b) ? (a, b) : (b, a);
+ * }
+ * ```
+ */
+function sortTokenAddresses(tokenA, tokenB) {
+    return BigInt(tokenA) < BigInt(tokenB)
+        ? [tokenA, tokenB]
+        : [tokenB, tokenA];
+}
+/**
+ * Creates a canonical route ID from two addresses.
+ * Uses numeric address comparison to match contract behavior.
+ */
+function canonicalAddressKey(addressA, addressB, separator = '-') {
+    const [first, second] = sortTokenAddresses(addressA, addressB);
+    return `${first}${separator}${second}`;
+}
+/**
+ * Creates a canonical pair key from two symbols.
+ * Uses standard string comparison for human-readable IDs.
+ */
+function canonicalSymbolKey(symbolA, symbolB, separator = '-') {
+    return symbolA < symbolB
+        ? `${symbolA}${separator}${symbolB}`
+        : `${symbolB}${separator}${symbolA}`;
+}
+//# sourceMappingURL=sortUtils.js.map

package/dist/utils/sortUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortUtils.js","sourceRoot":"","sources":["../../src/utils/sortUtils.ts"],"names":[],"mappings":";;AAaA,gDAOC;AAMD,kDAOC;AAMD,gDAQC;AA7CD;;;;;;;;;;GAUG;AACH,SAAgB,kBAAkB,CAChC,MAAe,EACf,MAAe;IAEf,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACpC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACtB,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,QAAiB,EACjB,QAAiB,EACjB,SAAS,GAAG,GAAG;IAEf,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC9D,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,EAAE,CAAA;AACxC,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAChC,OAAe,EACf,OAAe,EACf,SAAS,GAAG,GAAG;IAEf,OAAO,OAAO,GAAG,OAAO;QACtB,CAAC,CAAC,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,EAAE;QACpC,CAAC,CAAC,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,EAAE,CAAA;AACxC,CAAC"}

package/dist/utils/tokens.d.ts

@@ -0,0 +1,78 @@
+import type { Token } from '../core/types';
+/**
+ * Enum of all token symbols across all supported chains
+ */
+export declare enum TokenSymbol {
+    AUDm = "AUDm",
+    BRLm = "BRLm",
+    CADm = "CADm",
+    CELO = "CELO",
+    CHFm = "CHFm",
+    COPm = "COPm",
+    EURm = "EURm",
+    GBPm = "GBPm",
+    GHSm = "GHSm",
+    JPYm = "JPYm",
+    KESm = "KESm",
+    NGNm = "NGNm",
+    PHPm = "PHPm",
+    PUSO = "PUSO",
+    USDC = "USDC",
+    USDm = "USDm",
+    USD_ = "USD\u20AE",
+    XOFm = "XOFm",
+    ZARm = "ZARm",
+    axlEUROC = "axlEUROC",
+    axlUSDC = "axlUSDC",
+    cAUD = "cAUD",
+    cCAD = "cCAD",
+    cCHF = "cCHF",
+    cCOP = "cCOP",
+    cEUR = "cEUR",
+    cGBP = "cGBP",
+    cGHS = "cGHS",
+    cJPY = "cJPY",
+    cKES = "cKES",
+    cNGN = "cNGN",
+    cREAL = "cREAL",
+    cUSD = "cUSD",
+    cZAR = "cZAR",
+    eXOF = "eXOF"
+}
+/**
+ * Get cached tokens for a specific chain ID
+ * @param chainId - The chain ID to get tokens for
+ * @returns Promise resolving to the cached tokens array, or undefined if not available
+ */
+export declare function getCachedTokens(chainId: number): Promise<readonly Token[] | undefined>;
+/**
+ * Get cached tokens synchronously for a specific chain ID
+ * @param chainId - The chain ID to get tokens for
+ * @returns The cached tokens array
+ * @throws Error if tokens are not available for the chain
+ */
+export declare function getCachedTokensSync(chainId: number): readonly Token[];
+/**
+ * Mapping of token addresses by chain ID and token symbol
+ * Useful for quickly looking up a token address by its symbol on a specific chain
+ */
+export declare const TOKEN_ADDRESSES_BY_CHAIN: {
+    [chainId: number]: {
+        [tokenSymbol in TokenSymbol]?: string;
+    };
+};
+/**
+ * Get token address by chain ID and symbol
+ * @param chainId - The chain ID
+ * @param symbol - The token symbol
+ * @returns The token address or undefined if not found
+ */
+export declare function getTokenAddress(chainId: number, symbol: TokenSymbol): string | undefined;
+/**
+ * Find a token by its symbol on a specific chain
+ * @param chainId - The chain ID
+ * @param symbol - The token symbol
+ * @returns The token object or undefined if not found
+ */
+export declare function findTokenBySymbol(chainId: number, symbol: TokenSymbol): Token | undefined;
+//# sourceMappingURL=tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C;;GAEG;AACH,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,cAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC,CASvC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,EAAE,CAWrE;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE;IACrC,CAAC,OAAO,EAAE,MAAM,GAAG;SAAG,WAAW,IAAI,WAAW,CAAC,CAAC,EAAE,MAAM;KAAE,CAAA;CA8C7D,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,KAAK,GAAG,SAAS,CAOnB"}

package/dist/utils/tokens.js

@@ -0,0 +1,181 @@
+"use strict";
+// This file is auto-generated. Do not edit manually.
+// Generated on 2025-12-10T10:40:57.236Z
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKEN_ADDRESSES_BY_CHAIN = exports.TokenSymbol = void 0;
+exports.getCachedTokens = getCachedTokens;
+exports.getCachedTokensSync = getCachedTokensSync;
+exports.getTokenAddress = getTokenAddress;
+exports.findTokenBySymbol = findTokenBySymbol;
+/**
+ * Enum of all token symbols across all supported chains
+ */
+var TokenSymbol;
+(function (TokenSymbol) {
+    TokenSymbol["AUDm"] = "AUDm";
+    TokenSymbol["BRLm"] = "BRLm";
+    TokenSymbol["CADm"] = "CADm";
+    TokenSymbol["CELO"] = "CELO";
+    TokenSymbol["CHFm"] = "CHFm";
+    TokenSymbol["COPm"] = "COPm";
+    TokenSymbol["EURm"] = "EURm";
+    TokenSymbol["GBPm"] = "GBPm";
+    TokenSymbol["GHSm"] = "GHSm";
+    TokenSymbol["JPYm"] = "JPYm";
+    TokenSymbol["KESm"] = "KESm";
+    TokenSymbol["NGNm"] = "NGNm";
+    TokenSymbol["PHPm"] = "PHPm";
+    TokenSymbol["PUSO"] = "PUSO";
+    TokenSymbol["USDC"] = "USDC";
+    TokenSymbol["USDm"] = "USDm";
+    TokenSymbol["USD_"] = "USD\u20AE";
+    TokenSymbol["XOFm"] = "XOFm";
+    TokenSymbol["ZARm"] = "ZARm";
+    TokenSymbol["axlEUROC"] = "axlEUROC";
+    TokenSymbol["axlUSDC"] = "axlUSDC";
+    TokenSymbol["cAUD"] = "cAUD";
+    TokenSymbol["cCAD"] = "cCAD";
+    TokenSymbol["cCHF"] = "cCHF";
+    TokenSymbol["cCOP"] = "cCOP";
+    TokenSymbol["cEUR"] = "cEUR";
+    TokenSymbol["cGBP"] = "cGBP";
+    TokenSymbol["cGHS"] = "cGHS";
+    TokenSymbol["cJPY"] = "cJPY";
+    TokenSymbol["cKES"] = "cKES";
+    TokenSymbol["cNGN"] = "cNGN";
+    TokenSymbol["cREAL"] = "cREAL";
+    TokenSymbol["cUSD"] = "cUSD";
+    TokenSymbol["cZAR"] = "cZAR";
+    TokenSymbol["eXOF"] = "eXOF";
+})(TokenSymbol || (exports.TokenSymbol = TokenSymbol = {}));
+/**
+ * Get cached tokens for a specific chain ID
+ * @param chainId - The chain ID to get tokens for
+ * @returns Promise resolving to the cached tokens array, or undefined if not available
+ */
+async function getCachedTokens(chainId) {
+    switch (chainId) {
+        case 42220:
+            return await Promise.resolve().then(() => __importStar(require('../cache/tokens.42220'))).then((module) => module.tokens42220);
+        case 11142220:
+            return await Promise.resolve().then(() => __importStar(require('../cache/tokens.11142220'))).then((module) => module.tokens11142220);
+        default:
+            return undefined;
+    }
+}
+/**
+ * Get cached tokens synchronously for a specific chain ID
+ * @param chainId - The chain ID to get tokens for
+ * @returns The cached tokens array
+ * @throws Error if tokens are not available for the chain
+ */
+function getCachedTokensSync(chainId) {
+    switch (chainId) {
+        case 42220:
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            return require('../cache/tokens.42220').tokens42220;
+        case 11142220:
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            return require('../cache/tokens.11142220').tokens11142220;
+        default:
+            throw new Error(`No cached tokens available for chain ${chainId}`);
+    }
+}
+/**
+ * Mapping of token addresses by chain ID and token symbol
+ * Useful for quickly looking up a token address by its symbol on a specific chain
+ */
+exports.TOKEN_ADDRESSES_BY_CHAIN = {
+    42220: {
+        [TokenSymbol.cUSD]: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
+        [TokenSymbol.cEUR]: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
+        [TokenSymbol.cREAL]: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
+        [TokenSymbol.eXOF]: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
+        [TokenSymbol.cKES]: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
+        [TokenSymbol.PUSO]: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
+        [TokenSymbol.cCOP]: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
+        [TokenSymbol.cGHS]: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
+        [TokenSymbol.cGBP]: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
+        [TokenSymbol.cZAR]: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
+        [TokenSymbol.cCAD]: '0xff4Ab19391af240c311c54200a492233052B6325',
+        [TokenSymbol.cAUD]: '0x7175504C455076F15c04A2F90a8e352281F492F9',
+        [TokenSymbol.cCHF]: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
+        [TokenSymbol.cNGN]: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
+        [TokenSymbol.cJPY]: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
+        [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
+        [TokenSymbol.axlEUROC]: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
+        [TokenSymbol.USDC]: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
+        [TokenSymbol.axlUSDC]: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
+        [TokenSymbol.USD_]: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
+    },
+    11142220: {
+        [TokenSymbol.USDm]: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
+        [TokenSymbol.EURm]: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
+        [TokenSymbol.BRLm]: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
+        [TokenSymbol.XOFm]: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
+        [TokenSymbol.KESm]: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
+        [TokenSymbol.PHPm]: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
+        [TokenSymbol.COPm]: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
+        [TokenSymbol.GHSm]: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
+        [TokenSymbol.GBPm]: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
+        [TokenSymbol.ZARm]: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
+        [TokenSymbol.CADm]: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
+        [TokenSymbol.AUDm]: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
+        [TokenSymbol.CHFm]: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
+        [TokenSymbol.JPYm]: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
+        [TokenSymbol.NGNm]: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
+        [TokenSymbol.axlUSDC]: '0x6285De9DA7C1d329C0451628638908915002d9d1',
+        [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
+        [TokenSymbol.axlEUROC]: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
+        [TokenSymbol.USD_]: '0xd077A400968890Eacc75cdc901F0356c943e4fDb',
+        [TokenSymbol.USDC]: '0x01C5C0122039549AD1493B8220cABEdD739BC44E',
+    },
+};
+/**
+ * Get token address by chain ID and symbol
+ * @param chainId - The chain ID
+ * @param symbol - The token symbol
+ * @returns The token address or undefined if not found
+ */
+function getTokenAddress(chainId, symbol) {
+    return exports.TOKEN_ADDRESSES_BY_CHAIN[chainId]?.[symbol];
+}
+/**
+ * Find a token by its symbol on a specific chain
+ * @param chainId - The chain ID
+ * @param symbol - The token symbol
+ * @returns The token object or undefined if not found
+ */
+function findTokenBySymbol(chainId, symbol) {
+    try {
+        const tokens = getCachedTokensSync(chainId);
+        return tokens.find((t) => t.symbol === symbol);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=tokens.js.map

package/dist/utils/tokens.js.map

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

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@mento-protocol/mento-sdk",
   "description": "Official SDK for interacting with the Mento Protocol",
-  "version": "2.0.0-beta.8",
+  "version": "3.0.0-beta.1",
   "license": "MIT",
   "author": "Mento Labs",
   "keywords": [
     "mento",
-    "celo",
     "solidity"
   ],
   "repository": {
@@ -26,7 +25,9 @@
     "lint": "eslint --config ./.eslintrc.json src/**/*.ts",
     "prettier": "prettier --config ./.prettierrc.json --write **/*.{json,md,js,ts,yml}",
     "test": "jest --verbose",
-    "coverage": "jest --coverage"
+    "coverage": "jest --coverage",
+    "cacheRoutes": "ts-node scripts/cacheRoutes/index.ts",
+    "cacheTokens": "ts-node scripts/cacheTokens/index.ts"
   },
   "engines": {
     "node": ">=18",
@@ -36,12 +37,11 @@
     "@jest/types": "^29.6.3",
     "@size-limit/preset-small-lib": "^8.1.0",
     "@tsconfig/recommended": "^1.0.1",
-    "@types/chai": "^5.0.1",
     "@types/jest": "^29.5.14",
     "@types/node": "^18.13.0",
+    "@types/yargs-parser": "^21.0.3",
     "@typescript-eslint/eslint-plugin": "^5.53.0",
     "@typescript-eslint/parser": "^5.53.0",
-    "chai": "^5.1.2",
     "eslint": "^8.34.0",
     "eslint-config-prettier": "^8.6.0",
     "husky": "^8.0.2",
@@ -49,27 +49,14 @@
     "prettier": "^2.8.4",
     "ts-jest": "^29.0.5",
     "ts-node": "^10.9.1",
-    "typescript": "5.6.3"
-  },
-  "peerDependencies": {
-    "ethers": "^6.13.4",
-    "ethers-v5": "npm:ethers@^5.7",
-    "viem": "^2.21.44"
-  },
-  "peerDependenciesMeta": {
-    "ethers": {
-      "optional": true
-    },
-    "ethers-v5": {
-      "optional": true
-    },
-    "viem": {
-      "optional": true
-    }
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "5.6.3",
+    "yargs-parser": "^21.1.1"
   },
   "dependencies": {
     "@mento-protocol/mento-core-ts": "^0.2.0",
     "bignumber.js": "^9.1.2",
-    "dotenv": "^16.4.5"
+    "dotenv": "^16.4.5",
+    "viem": "^2.21.44"
   }
 }

package/dist/abis/bipoolmanager.d.ts

@@ -1,15 +0,0 @@
-export declare const BIPOOL_MANAGER_ABI: {
-    name: string;
-    type: string;
-    stateMutability: string;
-    inputs: never[];
-    outputs: {
-        name: string;
-        type: string;
-        components: {
-            name: string;
-            type: string;
-        }[];
-    }[];
-}[];
-//# sourceMappingURL=bipoolmanager.d.ts.map

package/dist/abis/bipoolmanager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bipoolmanager.d.ts","sourceRoot":"","sources":["../../src/abis/bipoolmanager.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;GAqB9B,CAAC"}

package/dist/abis/bipoolmanager.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BIPOOL_MANAGER_ABI = void 0;
-exports.BIPOOL_MANAGER_ABI = [
-    {
-        name: "getExchanges",
-        type: "function",
-        stateMutability: "view",
-        inputs: [],
-        outputs: [{
-                name: "exchanges",
-                type: "tuple[]",
-                components: [
-                    {
-                        name: "exchangeId",
-                        type: "bytes32",
-                    },
-                    {
-                        name: "assets",
-                        type: "address[]",
-                    },
-                ],
-            }],
-    },
-];
-//# sourceMappingURL=bipoolmanager.js.map

package/dist/abis/bipoolmanager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bipoolmanager.js","sourceRoot":"","sources":["../../src/abis/bipoolmanager.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG;IACjC;QACC,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC;gBACT,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE;oBACX;wBACC,IAAI,EAAE,YAAY;wBAClB,IAAI,EAAE,SAAS;qBACf;oBACD;wBACC,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,WAAW;qBACjB;iBACD;aACD,CAAC;KACF;CACD,CAAC"}

package/dist/abis/broker.d.ts

@@ -1,2 +0,0 @@
-export declare const BROKER_ABI: string[];
-//# sourceMappingURL=broker.d.ts.map

package/dist/abis/broker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/abis/broker.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,UAGtB,CAAA"}

package/dist/abis/broker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../src/abis/broker.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,qJAAqJ;IACrJ,mJAAmJ;CACpJ,CAAA"}

package/dist/abis/erc20.d.ts

@@ -1,2 +0,0 @@
-export declare const ERC20_ABI: string[];
-//# sourceMappingURL=erc20.d.ts.map

package/dist/abis/erc20.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"erc20.d.ts","sourceRoot":"","sources":["../../src/abis/erc20.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,UAMrB,CAAA"}

package/dist/abis/erc20.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"erc20.js","sourceRoot":"","sources":["../../src/abis/erc20.ts"],"names":[],"mappings":";;;AAAa,QAAA,SAAS,GAAG;IACvB,uCAAuC;IACvC,yCAAyC;IACzC,0CAA0C;IAC1C,+CAA+C;IAC/C,oDAAoD;CACrD,CAAA"}

package/dist/abis/index.d.ts

@@ -1,5 +0,0 @@
-export * from './erc20';
-export * from './reserve';
-export * from './bipoolmanager';
-export * from './uniswapV3';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abis/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA"}

package/dist/abis/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/abis/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,4CAAyB;AACzB,kDAA+B;AAC/B,8CAA2B"}

package/dist/abis/pricingmodule.d.ts

@@ -1,2 +0,0 @@
-export declare const PRICING_MODULE_ABI: string[];
-//# sourceMappingURL=pricingmodule.d.ts.map

package/dist/abis/pricingmodule.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pricingmodule.d.ts","sourceRoot":"","sources":["../../src/abis/pricingmodule.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,UAA4C,CAAA"}

package/dist/abis/pricingmodule.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PRICING_MODULE_ABI = void 0;
-exports.PRICING_MODULE_ABI = ['function name() view returns (string)'];
-//# sourceMappingURL=pricingmodule.js.map

package/dist/abis/pricingmodule.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pricingmodule.js","sourceRoot":"","sources":["../../src/abis/pricingmodule.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG,CAAC,uCAAuC,CAAC,CAAA"}

package/dist/abis/reserve.d.ts

@@ -1,2 +0,0 @@
-export declare const RESERVE_ABI: string[];
-//# sourceMappingURL=reserve.d.ts.map

package/dist/abis/reserve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reserve.d.ts","sourceRoot":"","sources":["../../src/abis/reserve.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,UAIvB,CAAC"}

package/dist/abis/reserve.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESERVE_ABI = void 0;
-exports.RESERVE_ABI = [
-    "function getTokens() view returns (address[])",
-    "function isToken(address) view returns (bool)",
-    "function isCollateralAsset(address) view returns (bool)",
-];
-//# sourceMappingURL=reserve.js.map

package/dist/abis/reserve.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reserve.js","sourceRoot":"","sources":["../../src/abis/reserve.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IAC1B,+CAA+C;IAC/C,+CAA+C;IAC/C,yDAAyD;CACzD,CAAC"}

package/dist/abis/uniswapV3.d.ts

@@ -1,4 +0,0 @@
-export declare const UNIV3_POSITION_MANAGER_ABI: string[];
-export declare const UNIV3_FACTORY_ABI: string[];
-export declare const UNIV3_POOL_ABI: string[];
-//# sourceMappingURL=uniswapV3.d.ts.map

package/dist/abis/uniswapV3.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"uniswapV3.d.ts","sourceRoot":"","sources":["../../src/abis/uniswapV3.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,UAItC,CAAA;AAED,eAAO,MAAM,iBAAiB,UAE7B,CAAA;AACD,eAAO,MAAM,cAAc,UAE1B,CAAA"}

package/dist/abis/uniswapV3.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"uniswapV3.js","sourceRoot":"","sources":["../../src/abis/uniswapV3.ts"],"names":[],"mappings":";;;AAAa,QAAA,0BAA0B,GAAG;IACxC,oDAAoD;IACpD,uEAAuE;IACvE,iJAAiJ;CAClJ,CAAA;AAEY,QAAA,iBAAiB,GAAG;IAC/B,mEAAmE;CACpE,CAAA;AACY,QAAA,cAAc,GAAG;IAC5B,gFAAgF;CACjF,CAAA"}

package/dist/adapters/implementations/ethersAdapter.d.ts

@@ -1,9 +0,0 @@
-import { Provider as EthersProvider } from 'ethers';
-import { ContractCallOptions, ProviderAdapter } from '../../types';
-export declare class EthersAdapter implements ProviderAdapter {
-    private provider;
-    constructor(provider: EthersProvider);
-    readContract(options: ContractCallOptions): Promise<unknown>;
-    getChainId(): Promise<number>;
-}
-//# sourceMappingURL=ethersAdapter.d.ts.map

package/dist/adapters/implementations/ethersAdapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ethersAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/implementations/ethersAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,QAAQ,IAAI,cAAc,EAAE,MAAM,QAAQ,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElE,qBAAa,aAAc,YAAW,eAAe;IACvC,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAEtC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAIpC"}