@mento-protocol/mento-sdk 1.12.0 → 1.14.0

package/dist/esm/constants/tokens.44787.js

@@ -0,0 +1,124 @@
+// This file is auto-generated. Do not edit manually.
+// Generated on 2025-10-02T13:54:36.998Z
+export const tokens44787 = [
+    {
+        "address": "0x6e673502c5b55F3169657C004e5797fFE5be6653",
+        "symbol": "BridgedEUROC",
+        "name": "mockBridgedEUROC",
+        "decimals": 6
+    },
+    {
+        "address": "0x87D61dA3d668797786D73BC674F053f87111570d",
+        "symbol": "BridgedUSDC",
+        "name": "mockBridgedUSDC",
+        "decimals": 6
+    },
+    {
+        "address": "0x84CBD49F5aE07632B6B88094E81Cce8236125Fe0",
+        "symbol": "cAUD",
+        "name": "Celo Australian Dollar",
+        "decimals": 18
+    },
+    {
+        "address": "0x02EC9E0D2Fd73e89168C1709e542a48f58d7B133",
+        "symbol": "cCAD",
+        "name": "Celo Canadian Dollar",
+        "decimals": 18
+    },
+    {
+        "address": "0xADC57C2C34aD021Df4421230a6532F4e2E1dCE4F",
+        "symbol": "cCHF",
+        "name": "Celo Swiss Franc",
+        "decimals": 18
+    },
+    {
+        "address": "0xe6A57340f0df6E020c1c0a80bC6E13048601f0d4",
+        "symbol": "cCOP",
+        "name": "Celo Colombian Peso",
+        "decimals": 18
+    },
+    {
+        "address": "0xF194afDf50B03e69Bd7D057c1Aa9e10c9954E4C9",
+        "symbol": "CELO",
+        "name": "Celo native asset",
+        "decimals": 18
+    },
+    {
+        "address": "0x10c892A6EC43a53E45D0B916B4b7D383B1b78C0F",
+        "symbol": "cEUR",
+        "name": "Celo Euro",
+        "decimals": 18
+    },
+    {
+        "address": "0x47f2Fb88105155a18c390641C8a73f1402B2BB12",
+        "symbol": "cGBP",
+        "name": "Celo British Pound",
+        "decimals": 18
+    },
+    {
+        "address": "0x295B66bE7714458Af45E6A6Ea142A5358A6cA375",
+        "symbol": "cGHS",
+        "name": "cGHS",
+        "decimals": 18
+    },
+    {
+        "address": "0x2E51F41238cA36a421C9B8b3e189e8Cc7653FE67",
+        "symbol": "cJPY",
+        "name": "Celo Japanese Yen",
+        "decimals": 18
+    },
+    {
+        "address": "0x1E0433C1769271ECcF4CFF9FDdD515eefE6CdF92",
+        "symbol": "cKES",
+        "name": "Celo Kenyan Shilling",
+        "decimals": 18
+    },
+    {
+        "address": "0x4a5b03B8b16122D330306c65e4CA4BC5Dd6511d0",
+        "symbol": "cNGN",
+        "name": "Celo Nigerian Naira",
+        "decimals": 18
+    },
+    {
+        "address": "0xE4D517785D091D3c54818832dB6094bcc2744545",
+        "symbol": "cREAL",
+        "name": "Celo Brazilian Real",
+        "decimals": 18
+    },
+    {
+        "address": "0x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1",
+        "symbol": "cUSD",
+        "name": "Celo Dollar",
+        "decimals": 18
+    },
+    {
+        "address": "0x1e5b44015Ff90610b54000DAad31C89b3284df4d",
+        "symbol": "cZAR",
+        "name": "Celo South African Rand",
+        "decimals": 18
+    },
+    {
+        "address": "0xB0FA15e002516d0301884059c0aaC0F0C72b019D",
+        "symbol": "eXOF",
+        "name": "ECO CFA",
+        "decimals": 18
+    },
+    {
+        "address": "0x5E0E3c9419C42a1B04e2525991FB1A2C467AB8bF",
+        "symbol": "PUSO",
+        "name": "PUSO",
+        "decimals": 18
+    },
+    {
+        "address": "0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B",
+        "symbol": "USDC",
+        "name": "USDC",
+        "decimals": 6
+    },
+    {
+        "address": "0xBba91F588d031469ABCCA566FE80fB1Ad8Ee3287",
+        "symbol": "USDT",
+        "name": "mockNativeUSDT",
+        "decimals": 6
+    }
+];

package/dist/esm/constants/tokens.d.ts

@@ -0,0 +1,67 @@
+import { Token } from '../mento';
+/**
+ * Gets cached tokens for a specific chain ID
+ * @param chainId - The chain ID to get cached tokens for
+ * @returns Promise resolving to the cached tokens or undefined if not available
+ */
+export declare function getCachedTokens(chainId: number): Promise<readonly Token[] | undefined>;
+/**
+ * Synchronously gets cached tokens for a specific chain ID
+ * Note: This function throws if no cached tokens are available.
+ * Use getCachedTokens() for async loading or when you want to handle missing cache gracefully.
+ *
+ * @param chainId - The chain ID to get cached tokens for
+ * @returns The cached tokens
+ * @throws Error if no cached tokens are available for the chain
+ */
+export declare function getCachedTokensSync(chainId: number): readonly Token[];
+/**
+ * Type-safe token symbols available across all chains
+ * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
+ */
+export declare enum TokenSymbol {
+    BridgedEUROC = "BridgedEUROC",
+    BridgedUSDC = "BridgedUSDC",
+    CELO = "CELO",
+    PUSO = "PUSO",
+    USDC = "USDC",
+    USDT = "USDT",
+    USD_ = "USD\u20AE",
+    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"
+}
+/**
+ * Token addresses mapped by chain ID and symbol
+ * Use this for type-safe token address lookups
+ */
+export declare const TOKEN_ADDRESSES_BY_CHAIN: {
+    [chainId: number]: Partial<Record<TokenSymbol, string>>;
+};
+/**
+ * Helper function to get token address by symbol for a specific chain
+ * @param symbol - The token symbol
+ * @param chainId - The chain ID
+ * @returns The token address or undefined if not found
+ */
+export declare function getTokenAddress(symbol: TokenSymbol, chainId: number): string | undefined;
+/**
+ * Helper function to find a token by symbol in the cached tokens
+ * @param symbol - The token symbol to search for
+ * @param chainId - The chain ID
+ * @returns The token object or undefined if not found
+ */
+export declare function findTokenBySymbol(symbol: string, chainId: number): Token | undefined;

package/dist/esm/constants/tokens.js

@@ -0,0 +1,177 @@
+// This file is auto-generated. Do not edit manually.
+// Generated on 2025-10-02T13:54:45.878Z
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Gets cached tokens for a specific chain ID
+ * @param chainId - The chain ID to get cached tokens for
+ * @returns Promise resolving to the cached tokens or undefined if not available
+ */
+export function getCachedTokens(chainId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        switch (chainId) {
+            case 42220:
+                return yield import('./tokens.42220').then((module) => module.tokens42220);
+            case 44787:
+                return yield import('./tokens.44787').then((module) => module.tokens44787);
+            case 11142220:
+                return yield import('./tokens.11142220').then((module) => module.tokens11142220);
+            default:
+                return undefined;
+        }
+    });
+}
+/**
+ * Synchronously gets cached tokens for a specific chain ID
+ * Note: This function throws if no cached tokens are available.
+ * Use getCachedTokens() for async loading or when you want to handle missing cache gracefully.
+ *
+ * @param chainId - The chain ID to get cached tokens for
+ * @returns The cached tokens
+ * @throws Error if no cached tokens are available for the chain
+ */
+export function getCachedTokensSync(chainId) {
+    switch (chainId) {
+        case 42220:
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            return require('./tokens.42220').tokens42220;
+        case 44787:
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            return require('./tokens.44787').tokens44787;
+        case 11142220:
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            return require('./tokens.11142220').tokens11142220;
+        default:
+            throw new Error(`No cached tokens available for chain ID ${chainId}. ` +
+                `Supported chains: 42220 (Celo), 44787 (Alfajores), 11142220 (Celo Sepolia)`);
+    }
+}
+/**
+ * Type-safe token symbols available across all chains
+ * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
+ */
+export var TokenSymbol;
+(function (TokenSymbol) {
+    TokenSymbol["BridgedEUROC"] = "BridgedEUROC";
+    TokenSymbol["BridgedUSDC"] = "BridgedUSDC";
+    TokenSymbol["CELO"] = "CELO";
+    TokenSymbol["PUSO"] = "PUSO";
+    TokenSymbol["USDC"] = "USDC";
+    TokenSymbol["USDT"] = "USDT";
+    TokenSymbol["USD_"] = "USD\u20AE";
+    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 || (TokenSymbol = {}));
+/**
+ * Token addresses mapped by chain ID and symbol
+ * Use this for type-safe token address lookups
+ */
+export const TOKEN_ADDRESSES_BY_CHAIN = {
+    42220: {
+        [TokenSymbol.axlEUROC]: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
+        [TokenSymbol.axlUSDC]: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
+        [TokenSymbol.cAUD]: '0x7175504C455076F15c04A2F90a8e352281F492F9',
+        [TokenSymbol.cCAD]: '0xff4Ab19391af240c311c54200a492233052B6325',
+        [TokenSymbol.cCHF]: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
+        [TokenSymbol.cCOP]: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
+        [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
+        [TokenSymbol.cEUR]: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
+        [TokenSymbol.cGBP]: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
+        [TokenSymbol.cGHS]: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
+        [TokenSymbol.cJPY]: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
+        [TokenSymbol.cKES]: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
+        [TokenSymbol.cNGN]: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
+        [TokenSymbol.cREAL]: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
+        [TokenSymbol.cUSD]: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
+        [TokenSymbol.cZAR]: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
+        [TokenSymbol.eXOF]: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
+        [TokenSymbol.PUSO]: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
+        [TokenSymbol.USD_]: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
+        [TokenSymbol.USDC]: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
+    },
+    44787: {
+        [TokenSymbol.BridgedEUROC]: '0x6e673502c5b55F3169657C004e5797fFE5be6653',
+        [TokenSymbol.BridgedUSDC]: '0x87D61dA3d668797786D73BC674F053f87111570d',
+        [TokenSymbol.cAUD]: '0x84CBD49F5aE07632B6B88094E81Cce8236125Fe0',
+        [TokenSymbol.cCAD]: '0x02EC9E0D2Fd73e89168C1709e542a48f58d7B133',
+        [TokenSymbol.cCHF]: '0xADC57C2C34aD021Df4421230a6532F4e2E1dCE4F',
+        [TokenSymbol.cCOP]: '0xe6A57340f0df6E020c1c0a80bC6E13048601f0d4',
+        [TokenSymbol.CELO]: '0xF194afDf50B03e69Bd7D057c1Aa9e10c9954E4C9',
+        [TokenSymbol.cEUR]: '0x10c892A6EC43a53E45D0B916B4b7D383B1b78C0F',
+        [TokenSymbol.cGBP]: '0x47f2Fb88105155a18c390641C8a73f1402B2BB12',
+        [TokenSymbol.cGHS]: '0x295B66bE7714458Af45E6A6Ea142A5358A6cA375',
+        [TokenSymbol.cJPY]: '0x2E51F41238cA36a421C9B8b3e189e8Cc7653FE67',
+        [TokenSymbol.cKES]: '0x1E0433C1769271ECcF4CFF9FDdD515eefE6CdF92',
+        [TokenSymbol.cNGN]: '0x4a5b03B8b16122D330306c65e4CA4BC5Dd6511d0',
+        [TokenSymbol.cREAL]: '0xE4D517785D091D3c54818832dB6094bcc2744545',
+        [TokenSymbol.cUSD]: '0x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1',
+        [TokenSymbol.cZAR]: '0x1e5b44015Ff90610b54000DAad31C89b3284df4d',
+        [TokenSymbol.eXOF]: '0xB0FA15e002516d0301884059c0aaC0F0C72b019D',
+        [TokenSymbol.PUSO]: '0x5E0E3c9419C42a1B04e2525991FB1A2C467AB8bF',
+        [TokenSymbol.USDC]: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
+        [TokenSymbol.USDT]: '0xBba91F588d031469ABCCA566FE80fB1Ad8Ee3287',
+    },
+    11142220: {
+        [TokenSymbol.axlEUROC]: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
+        [TokenSymbol.axlUSDC]: '0x6285De9DA7C1d329C0451628638908915002d9d1',
+        [TokenSymbol.cAUD]: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
+        [TokenSymbol.cCAD]: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
+        [TokenSymbol.cCHF]: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
+        [TokenSymbol.cCOP]: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
+        [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
+        [TokenSymbol.cEUR]: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
+        [TokenSymbol.cGBP]: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
+        [TokenSymbol.cGHS]: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
+        [TokenSymbol.cJPY]: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
+        [TokenSymbol.cKES]: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
+        [TokenSymbol.cNGN]: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
+        [TokenSymbol.cREAL]: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
+        [TokenSymbol.cUSD]: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
+        [TokenSymbol.cZAR]: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
+        [TokenSymbol.eXOF]: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
+        [TokenSymbol.PUSO]: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
+        [TokenSymbol.USDC]: '0xBD63e46Be8eF8D89dFde3054E7b9ECAEb8Ad83e9',
+        [TokenSymbol.USDT]: '0xCA53d9b72646B254d29EBeEb4c5cde7BB4bb59e0',
+    },
+};
+/**
+ * Helper function to get token address by symbol for a specific chain
+ * @param symbol - The token symbol
+ * @param chainId - The chain ID
+ * @returns The token address or undefined if not found
+ */
+export function getTokenAddress(symbol, chainId) {
+    var _a;
+    return (_a = TOKEN_ADDRESSES_BY_CHAIN[chainId]) === null || _a === void 0 ? void 0 : _a[symbol];
+}
+/**
+ * Helper function to find a token by symbol in the cached tokens
+ * @param symbol - The token symbol to search for
+ * @param chainId - The chain ID
+ * @returns The token object or undefined if not found
+ */
+export function findTokenBySymbol(symbol, chainId) {
+    const tokens = getCachedTokensSync(chainId);
+    return tokens.find((token) => token.symbol === symbol);
+}

package/dist/esm/mento.d.ts

@@ -99,12 +99,24 @@ export declare class Mento {
     private getCachedTradablePairs;
     /**
      * Returns a list of all unique tokens available on the current chain.
-     * Each token includes its address, symbol, name, and decimals.
+     * This method is synchronous and uses pre-cached token data.
+     * For runtime fetching from the blockchain, use getTokensAsync().
+     *
+     * @returns An array of unique Token objects from the static cache.
+     * @throws Error if no cached tokens are available for the current chain or if chainId is not yet initialized
+     */
+    getTokens(): Token[];
+    /**
+     * Fetches token metadata from the blockchain at runtime.
+     * This method is async and makes blockchain calls to get fresh token data.
+     * For synchronous access using cached data, use getTokens().
+     *
      * @param options - Optional parameters
-     * @param options.cached - Whether to use cached data (default: true)
-     * @returns An array of unique Token objects.
+     * @param options.cached - Whether to use cached data (default: true).
+     *                         If true, attempts to load from static cache first.
+     * @returns A Promise resolving to an array of unique Token objects.
      */
-    getTokens({ cached, }?: {
+    getTokensAsync({ cached, }?: {
         cached?: boolean;
     }): Promise<Token[]>;
     /**

package/dist/esm/mento.js

@@ -40,7 +40,10 @@ export class Mento {
     static create(signerOrProvider) {
         return __awaiter(this, void 0, void 0, function* () {
             validateSignerOrProvider(signerOrProvider);
-            return new Mento(signerOrProvider, getAddress('Broker', yield getChainId(signerOrProvider)), getAddress('MentoRouter', yield getChainId(signerOrProvider)));
+            const chainId = yield getChainId(signerOrProvider);
+            const instance = new Mento(signerOrProvider, getAddress('Broker', chainId), getAddress('MentoRouter', chainId));
+            instance.cachedChainId = chainId;
+            return instance;
         });
     }
     /**
@@ -159,16 +162,46 @@ export class Mento {
     }
     /**
      * Returns a list of all unique tokens available on the current chain.
-     * Each token includes its address, symbol, name, and decimals.
+     * This method is synchronous and uses pre-cached token data.
+     * For runtime fetching from the blockchain, use getTokensAsync().
+     *
+     * @returns An array of unique Token objects from the static cache.
+     * @throws Error if no cached tokens are available for the current chain or if chainId is not yet initialized
+     */
+    getTokens() {
+        if (this.cachedChainId === null) {
+            throw new Error('Chain ID not yet initialized. Use Mento.create() to initialize the SDK, or use getTokensAsync() instead.');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { getCachedTokensSync } = require('./constants/tokens');
+        return Array.from(getCachedTokensSync(this.cachedChainId));
+    }
+    /**
+     * Fetches token metadata from the blockchain at runtime.
+     * This method is async and makes blockchain calls to get fresh token data.
+     * For synchronous access using cached data, use getTokens().
+     *
      * @param options - Optional parameters
-     * @param options.cached - Whether to use cached data (default: true)
-     * @returns An array of unique Token objects.
+     * @param options.cached - Whether to use cached data (default: true).
+     *                         If true, attempts to load from static cache first.
+     * @returns A Promise resolving to an array of unique Token objects.
      */
-    getTokens({ cached = true, } = {}) {
+    getTokensAsync({ cached = true, } = {}) {
         return __awaiter(this, void 0, void 0, function* () {
-            const tradablePairs = yield this.getTradablePairsWithPath({ cached });
+            // If cached is true, try to use the static cache first
+            if (cached) {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { getCachedTokens } = require('./constants/tokens');
+                const chainId = yield this.chainId();
+                const cachedTokens = yield getCachedTokens(chainId);
+                if (cachedTokens) {
+                    return Array.from(cachedTokens);
+                }
+            }
+            // Fall back to fetching from blockchain
+            const tradablePairs = yield this.getTradablePairsWithPath({ cached: false });
             // Collect unique token addresses
-            const uniqueAddresses = new Set(tradablePairs.flatMap(pair => pair.assets.map(asset => asset.address)));
+            const uniqueAddresses = new Set(tradablePairs.flatMap((pair) => pair.assets.map((asset) => asset.address)));
             // Fetch token metadata for each unique address
             const tokens = yield Promise.all(Array.from(uniqueAddresses).map((address) => __awaiter(this, void 0, void 0, function* () {
                 const [symbol, name, decimals] = yield Promise.all([

package/dist/esm/utils.d.ts

@@ -55,5 +55,5 @@ export declare function increaseAllowance(tokenAddr: string, spender: string, am
  * @param symbol the token symbol to find (case-insensitive)
  * @returns the token address if found, null otherwise
  */
-export declare function findTokenBySymbol(pairs: readonly TradablePair[], symbol: string): string | null;
+export declare function findTokenBySymbolInTradablePairs(pairs: readonly TradablePair[], symbol: string): string | null;
 export declare function capitalize(str: string): string;

package/dist/esm/utils.js

@@ -113,7 +113,7 @@ export function increaseAllowance(tokenAddr, spender, amount, signerOrProvider)
  * @param symbol the token symbol to find (case-insensitive)
  * @returns the token address if found, null otherwise
  */
-export function findTokenBySymbol(pairs, symbol) {
+export function findTokenBySymbolInTradablePairs(pairs, symbol) {
     for (const pair of pairs) {
         for (const asset of pair.assets) {
             if (asset.symbol.toLowerCase() === symbol.toLowerCase()) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mento-protocol/mento-sdk",
   "description": "Official SDK for interacting with the Mento Protocol",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "license": "MIT",
   "author": "Mento Labs",
   "keywords": [
@@ -33,6 +33,7 @@
     "test": "jest --runInBand --verbose",
     "coverage": "jest --coverage",
     "cacheTradablePairs": "ts-node scripts/cacheTradablePairs.ts",
+    "cacheTokens": "ts-node scripts/cacheTokens/index.ts",
     "printTradablePairs": "ts-node scripts/printTradablePairs.ts",
     "tradingLimits": "ts-node scripts/printTradingLimits.ts",
     "limits": "yarn tradingLimits",