@mento-protocol/mento-sdk 1.11.0 → 1.13.0

package/dist/cjs/constants/tokens.js

@@ -0,0 +1,207 @@
+"use strict";
+// This file is auto-generated. Do not edit manually.
+// Generated on 2025-10-02T13:52:20.430Z
+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;
+};
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findTokenBySymbol = exports.getTokenAddress = exports.TOKEN_ADDRESSES_BY_CHAIN = exports.TokenSymbol = exports.getCachedTokensSync = exports.getCachedTokens = void 0;
+/**
+ * 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
+ */
+function getCachedTokens(chainId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        switch (chainId) {
+            case 42220:
+                return yield Promise.resolve().then(() => __importStar(require('./tokens.42220'))).then((module) => module.tokens42220);
+            case 44787:
+                return yield Promise.resolve().then(() => __importStar(require('./tokens.44787'))).then((module) => module.tokens44787);
+            case 11142220:
+                return yield Promise.resolve().then(() => __importStar(require('./tokens.11142220'))).then((module) => module.tokens11142220);
+            default:
+                return undefined;
+        }
+    });
+}
+exports.getCachedTokens = getCachedTokens;
+/**
+ * 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
+ */
+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)`);
+    }
+}
+exports.getCachedTokensSync = getCachedTokensSync;
+/**
+ * Type-safe token symbols available across all chains
+ * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
+ */
+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 = exports.TokenSymbol || (exports.TokenSymbol = {}));
+/**
+ * Token addresses mapped by chain ID and symbol
+ * Use this for type-safe token address lookups
+ */
+exports.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 chainId - The chain ID
+ * @param symbol - The token symbol
+ * @returns The token address or undefined if not found
+ */
+function getTokenAddress(chainId, symbol) {
+    var _a;
+    return (_a = exports.TOKEN_ADDRESSES_BY_CHAIN[chainId]) === null || _a === void 0 ? void 0 : _a[symbol];
+}
+exports.getTokenAddress = getTokenAddress;
+/**
+ * Helper function to find a token by symbol in the cached tokens
+ * @param chainId - The chain ID
+ * @param symbol - The token symbol to search for
+ * @returns The token object or undefined if not found
+ */
+function findTokenBySymbol(chainId, symbol) {
+    const tokens = getCachedTokensSync(chainId);
+    return tokens.find((token) => token.symbol === symbol);
+}
+exports.findTokenBySymbol = findTokenBySymbol;

package/dist/cjs/constants/tradablePairs.js

@@ -45,6 +45,8 @@ function getCachedTradablePairs(chainId) {
                 return yield Promise.resolve().then(() => __importStar(require('./tradablePairs.42220'))).then((module) => module.tradablePairs42220);
             case 44787:
                 return yield Promise.resolve().then(() => __importStar(require('./tradablePairs.44787'))).then((module) => module.tradablePairs44787);
+            case 11142220:
+                return yield Promise.resolve().then(() => __importStar(require('./tradablePairs.11142220'))).then((module) => module.tradablePairs11142220);
             default:
                 return undefined;
         }

package/dist/cjs/enums/chainId.d.ts

@@ -1,6 +1,5 @@
 export declare enum ChainId {
     CELO = 42220,
     CELO_SEPOLIA = 11142220,
-    ALFAJORES = 44787,
-    BASE = 8453
+    ALFAJORES = 44787
 }

package/dist/cjs/enums/chainId.js

@@ -6,5 +6,4 @@ var ChainId;
     ChainId[ChainId["CELO"] = 42220] = "CELO";
     ChainId[ChainId["CELO_SEPOLIA"] = 11142220] = "CELO_SEPOLIA";
     ChainId[ChainId["ALFAJORES"] = 44787] = "ALFAJORES";
-    ChainId[ChainId["BASE"] = 8453] = "BASE";
 })(ChainId = exports.ChainId || (exports.ChainId = {}));

package/dist/cjs/mento.d.ts

@@ -12,6 +12,12 @@ export interface Asset {
     address: Address;
     symbol: string;
 }
+export interface Token {
+    address: Address;
+    symbol: string;
+    name: string;
+    decimals: number;
+}
 export type TradablePairID = `${Address}-${Address}`;
 export interface TradablePair {
     id: TradablePairID;
@@ -91,6 +97,28 @@ export declare class Mento {
      * Attempts to get cached tradable pairs for the current chain
      */
     private getCachedTradablePairs;
+    /**
+     * Returns a list of all unique tokens available on the current chain.
+     * 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).
+     *                         If true, attempts to load from static cache first.
+     * @returns A Promise resolving to an array of unique Token objects.
+     */
+    getTokensAsync({ cached, }?: {
+        cached?: boolean;
+    }): Promise<Token[]>;
     /**
      * Returns the amount of tokenIn to be sold to buy amountOut of tokenOut.
      * If the provided tradablePair has a single (direct) pricing path, then direct pricing is used.

package/dist/cjs/mento.js

@@ -43,7 +43,10 @@ class Mento {
     static create(signerOrProvider) {
         return __awaiter(this, void 0, void 0, function* () {
             (0, utils_1.validateSignerOrProvider)(signerOrProvider);
-            return new Mento(signerOrProvider, (0, addresses_1.getAddress)('Broker', yield (0, utils_1.getChainId)(signerOrProvider)), (0, addresses_1.getAddress)('MentoRouter', yield (0, utils_1.getChainId)(signerOrProvider)));
+            const chainId = yield (0, utils_1.getChainId)(signerOrProvider);
+            const instance = new Mento(signerOrProvider, (0, addresses_1.getAddress)('Broker', chainId), (0, addresses_1.getAddress)('MentoRouter', chainId));
+            instance.cachedChainId = chainId;
+            return instance;
         });
     }
     /**
@@ -160,6 +163,66 @@ class Mento {
             return yield (0, tradablePairs_1.getCachedTradablePairs)(chainId);
         });
     }
+    /**
+     * Returns a list of all unique tokens available on the current chain.
+     * 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).
+     *                         If true, attempts to load from static cache first.
+     * @returns A Promise resolving to an array of unique Token objects.
+     */
+    getTokensAsync({ cached = true, } = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // 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)));
+            // 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([
+                    (0, utils_1.getSymbolFromTokenAddress)(address, this.signerOrProvider),
+                    (0, utils_1.getNameFromTokenAddress)(address, this.signerOrProvider),
+                    (0, utils_1.getDecimalsFromTokenAddress)(address, this.signerOrProvider),
+                ]);
+                return {
+                    address,
+                    symbol,
+                    name,
+                    decimals,
+                };
+            })));
+            // Sort by symbol
+            return tokens.sort((a, b) => a.symbol.localeCompare(b.symbol));
+        });
+    }
     /**
      * Returns the amount of tokenIn to be sold to buy amountOut of tokenOut.
      * If the provided tradablePair has a single (direct) pricing path, then direct pricing is used.

package/dist/cjs/utils.d.ts

@@ -26,6 +26,20 @@ export declare function validateSignerOrProvider(signerOrProvider: Signer | prov
  * @returns the symbol of the erc20 token
  */
 export declare function getSymbolFromTokenAddress(tokenAddr: Address, signerOrProvider: Signer | providers.Provider): Promise<string>;
+/**
+ * Returns the name of an erc20 token
+ * @param tokenAddr the address of the erc20 token
+ * @param signerOrProvider an ethers provider or signer
+ * @returns the name of the erc20 token
+ */
+export declare function getNameFromTokenAddress(tokenAddr: Address, signerOrProvider: Signer | providers.Provider): Promise<string>;
+/**
+ * Returns the decimals of an erc20 token
+ * @param tokenAddr the address of the erc20 token
+ * @param signerOrProvider an ethers provider or signer
+ * @returns the decimals of the erc20 token
+ */
+export declare function getDecimalsFromTokenAddress(tokenAddr: Address, signerOrProvider: Signer | providers.Provider): Promise<number>;
 /**
  * Returns a populated tx obj for increasing the allowance of a spender for a given erc20 token by a given amount
  * @param tokenAddr the address of the erc20 token
@@ -41,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/cjs/utils.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.capitalize = exports.findTokenBySymbol = exports.increaseAllowance = exports.getSymbolFromTokenAddress = exports.validateSignerOrProvider = exports.validateSigner = exports.getChainId = void 0;
+exports.capitalize = exports.findTokenBySymbolInTradablePairs = exports.increaseAllowance = exports.getDecimalsFromTokenAddress = exports.getNameFromTokenAddress = exports.getSymbolFromTokenAddress = exports.validateSignerOrProvider = exports.validateSigner = exports.getChainId = void 0;
 const ethers_1 = require("ethers");
 /**
  * Gets the chain ID from a signer or provider
@@ -69,6 +69,34 @@ function getSymbolFromTokenAddress(tokenAddr, signerOrProvider) {
     });
 }
 exports.getSymbolFromTokenAddress = getSymbolFromTokenAddress;
+/**
+ * Returns the name of an erc20 token
+ * @param tokenAddr the address of the erc20 token
+ * @param signerOrProvider an ethers provider or signer
+ * @returns the name of the erc20 token
+ */
+function getNameFromTokenAddress(tokenAddr, signerOrProvider) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const erc20Abi = ['function name() external view returns (string memory)'];
+        const contract = new ethers_1.Contract(tokenAddr, erc20Abi, signerOrProvider);
+        return contract.name();
+    });
+}
+exports.getNameFromTokenAddress = getNameFromTokenAddress;
+/**
+ * Returns the decimals of an erc20 token
+ * @param tokenAddr the address of the erc20 token
+ * @param signerOrProvider an ethers provider or signer
+ * @returns the decimals of the erc20 token
+ */
+function getDecimalsFromTokenAddress(tokenAddr, signerOrProvider) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const erc20Abi = ['function decimals() external view returns (uint8)'];
+        const contract = new ethers_1.Contract(tokenAddr, erc20Abi, signerOrProvider);
+        return contract.decimals();
+    });
+}
+exports.getDecimalsFromTokenAddress = getDecimalsFromTokenAddress;
 /**
  * Returns a populated tx obj for increasing the allowance of a spender for a given erc20 token by a given amount
  * @param tokenAddr the address of the erc20 token
@@ -95,7 +123,7 @@ exports.increaseAllowance = increaseAllowance;
  * @param symbol the token symbol to find (case-insensitive)
  * @returns the token address if found, null otherwise
  */
-function findTokenBySymbol(pairs, symbol) {
+function findTokenBySymbolInTradablePairs(pairs, symbol) {
     for (const pair of pairs) {
         for (const asset of pair.assets) {
             if (asset.symbol.toLowerCase() === symbol.toLowerCase()) {
@@ -105,7 +133,7 @@ function findTokenBySymbol(pairs, symbol) {
     }
     return null;
 }
-exports.findTokenBySymbol = findTokenBySymbol;
+exports.findTokenBySymbolInTradablePairs = findTokenBySymbolInTradablePairs;
 function capitalize(str) {
     return str.charAt(0).toUpperCase() + str.slice(1);
 }

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

@@ -1,3 +1,4 @@
 export * from './addresses';
 export * from './currencies';
+export * from './tokens';
 export * from './tradablePairs';

package/dist/esm/constants/index.js

@@ -1,3 +1,4 @@
 export * from './addresses';
 export * from './currencies';
+export * from './tokens';
 export * from './tradablePairs';

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

@@ -0,0 +1,2 @@
+import { Token } from '../mento';
+export declare const tokens11142220: readonly Token[];

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

@@ -0,0 +1,124 @@
+// This file is auto-generated. Do not edit manually.
+// Generated on 2025-10-02T13:52:20.427Z
+export const tokens11142220 = [
+    {
+        "address": "0x9883d788d40F1C7595a780ed881Ea833C7743B4B",
+        "symbol": "axlEUROC",
+        "name": "Mento Mock axlEUROC",
+        "decimals": 18
+    },
+    {
+        "address": "0x6285De9DA7C1d329C0451628638908915002d9d1",
+        "symbol": "axlUSDC",
+        "name": "Mento Mock axlUSDC",
+        "decimals": 18
+    },
+    {
+        "address": "0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139",
+        "symbol": "cAUD",
+        "name": "Celo Australian Dollar",
+        "decimals": 18
+    },
+    {
+        "address": "0xF151c9a13b78C84f93f50B8b3bC689fedc134F60",
+        "symbol": "cCAD",
+        "name": "Celo Canadian Dollar",
+        "decimals": 18
+    },
+    {
+        "address": "0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980",
+        "symbol": "cCHF",
+        "name": "Celo Swiss Franc",
+        "decimals": 18
+    },
+    {
+        "address": "0x5F8d55c3627d2dc0a2B4afa798f877242F382F67",
+        "symbol": "cCOP",
+        "name": "Celo Colombian Peso",
+        "decimals": 18
+    },
+    {
+        "address": "0x471EcE3750Da237f93B8E339c536989b8978a438",
+        "symbol": "CELO",
+        "name": "Celo native asset",
+        "decimals": 18
+    },
+    {
+        "address": "0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a",
+        "symbol": "cEUR",
+        "name": "Celo Euro",
+        "decimals": 18
+    },
+    {
+        "address": "0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3",
+        "symbol": "cGBP",
+        "name": "Celo British Pound",
+        "decimals": 18
+    },
+    {
+        "address": "0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C",
+        "symbol": "cGHS",
+        "name": "Celo Ghanaian Cedi",
+        "decimals": 18
+    },
+    {
+        "address": "0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426",
+        "symbol": "cJPY",
+        "name": "Celo Japanese Yen",
+        "decimals": 18
+    },
+    {
+        "address": "0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF",
+        "symbol": "cKES",
+        "name": "Celo Kenyan Shilling",
+        "decimals": 18
+    },
+    {
+        "address": "0x3d5ae86F34E2a82771496D140daFAEf3789dF888",
+        "symbol": "cNGN",
+        "name": "Celo Nigerian Naira",
+        "decimals": 18
+    },
+    {
+        "address": "0x2294298942fdc79417DE9E0D740A4957E0e7783a",
+        "symbol": "cREAL",
+        "name": "Celo Brazilian Real",
+        "decimals": 18
+    },
+    {
+        "address": "0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b",
+        "symbol": "cUSD",
+        "name": "Celo Dollar",
+        "decimals": 18
+    },
+    {
+        "address": "0x10CCfB235b0E1Ed394bACE4560C3ed016697687e",
+        "symbol": "cZAR",
+        "name": "Celo South African Rand",
+        "decimals": 18
+    },
+    {
+        "address": "0x5505b70207aE3B826c1A7607F19F3Bf73444A082",
+        "symbol": "eXOF",
+        "name": "ECO CFA",
+        "decimals": 18
+    },
+    {
+        "address": "0x0352976d940a2C3FBa0C3623198947Ee1d17869E",
+        "symbol": "PUSO",
+        "name": "PUSO",
+        "decimals": 18
+    },
+    {
+        "address": "0xBD63e46Be8eF8D89dFde3054E7b9ECAEb8Ad83e9",
+        "symbol": "USDC",
+        "name": "Mento Mock USDC",
+        "decimals": 18
+    },
+    {
+        "address": "0xCA53d9b72646B254d29EBeEb4c5cde7BB4bb59e0",
+        "symbol": "USDT",
+        "name": "Mento Mock USDT",
+        "decimals": 18
+    }
+];

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

@@ -0,0 +1,2 @@
+import { Token } from '../mento';
+export declare const tokens42220: readonly Token[];