@mento-protocol/mento-sdk 1.11.0 → 1.13.0

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

@@ -0,0 +1,124 @@
+// This file is auto-generated. Do not edit manually.
+// Generated on 2025-10-02T13:54:27.948Z
+export const tokens42220 = [
+    {
+        "address": "0x061cc5a2C863E0C1Cb404006D559dB18A34C762d",
+        "symbol": "axlEUROC",
+        "name": "Axelar Wrapped EUROC",
+        "decimals": 6
+    },
+    {
+        "address": "0xEB466342C4d449BC9f53A865D5Cb90586f405215",
+        "symbol": "axlUSDC",
+        "name": "Axelar Wrapped USDC",
+        "decimals": 6
+    },
+    {
+        "address": "0x7175504C455076F15c04A2F90a8e352281F492F9",
+        "symbol": "cAUD",
+        "name": "Celo Australian Dollar",
+        "decimals": 18
+    },
+    {
+        "address": "0xff4Ab19391af240c311c54200a492233052B6325",
+        "symbol": "cCAD",
+        "name": "Celo Canadian Dollar",
+        "decimals": 18
+    },
+    {
+        "address": "0xb55a79F398E759E43C95b979163f30eC87Ee131D",
+        "symbol": "cCHF",
+        "name": "Celo Swiss Franc",
+        "decimals": 18
+    },
+    {
+        "address": "0x8A567e2aE79CA692Bd748aB832081C45de4041eA",
+        "symbol": "cCOP",
+        "name": "Celo Colombian Peso",
+        "decimals": 18
+    },
+    {
+        "address": "0x471EcE3750Da237f93B8E339c536989b8978a438",
+        "symbol": "CELO",
+        "name": "Celo native asset",
+        "decimals": 18
+    },
+    {
+        "address": "0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73",
+        "symbol": "cEUR",
+        "name": "Celo Euro",
+        "decimals": 18
+    },
+    {
+        "address": "0xCCF663b1fF11028f0b19058d0f7B674004a40746",
+        "symbol": "cGBP",
+        "name": "Celo British Pound",
+        "decimals": 18
+    },
+    {
+        "address": "0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313",
+        "symbol": "cGHS",
+        "name": "Celo Ghanaian Cedi",
+        "decimals": 18
+    },
+    {
+        "address": "0xc45eCF20f3CD864B32D9794d6f76814aE8892e20",
+        "symbol": "cJPY",
+        "name": "Celo Japanese Yen",
+        "decimals": 18
+    },
+    {
+        "address": "0x456a3D042C0DbD3db53D5489e98dFb038553B0d0",
+        "symbol": "cKES",
+        "name": "Celo Kenyan Shilling",
+        "decimals": 18
+    },
+    {
+        "address": "0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71",
+        "symbol": "cNGN",
+        "name": "Celo Nigerian Naira",
+        "decimals": 18
+    },
+    {
+        "address": "0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787",
+        "symbol": "cREAL",
+        "name": "Celo Brazilian Real",
+        "decimals": 18
+    },
+    {
+        "address": "0x765DE816845861e75A25fCA122bb6898B8B1282a",
+        "symbol": "cUSD",
+        "name": "Celo Dollar",
+        "decimals": 18
+    },
+    {
+        "address": "0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6",
+        "symbol": "cZAR",
+        "name": "Celo South African Rand",
+        "decimals": 18
+    },
+    {
+        "address": "0x73F93dcc49cB8A239e2032663e9475dd5ef29A08",
+        "symbol": "eXOF",
+        "name": "ECO CFA",
+        "decimals": 18
+    },
+    {
+        "address": "0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B",
+        "symbol": "PUSO",
+        "name": "PUSO",
+        "decimals": 18
+    },
+    {
+        "address": "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e",
+        "symbol": "USD₮",
+        "name": "Tether USD",
+        "decimals": 6
+    },
+    {
+        "address": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
+        "symbol": "USDC",
+        "name": "USDC",
+        "decimals": 6
+    }
+];

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

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

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 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;
+/**
+ * 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
+ */
+export declare function findTokenBySymbol(chainId: number, symbol: string): 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:52:20.430Z
+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 chainId - The chain ID
+ * @param symbol - The token symbol
+ * @returns The token address or undefined if not found
+ */
+export function getTokenAddress(chainId, symbol) {
+    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 chainId - The chain ID
+ * @param symbol - The token symbol to search for
+ * @returns The token object or undefined if not found
+ */
+export function findTokenBySymbol(chainId, symbol) {
+    const tokens = getCachedTokensSync(chainId);
+    return tokens.find((token) => token.symbol === symbol);
+}

package/dist/esm/constants/tradablePairs.js

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

package/dist/esm/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/esm/enums/chainId.js

@@ -3,5 +3,4 @@ export 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 || (ChainId = {}));

package/dist/esm/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/esm/mento.js

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { BiPoolManager__factory, Broker__factory, IBreakerBox__factory, IBroker__factory, IExchangeProvider__factory, } from '@mento-protocol/mento-core-ts';
 import { Signer } from 'ethers';
 import { getLimits, getLimitsConfig, getLimitsState } from './limits';
-import { getChainId, getSymbolFromTokenAddress, increaseAllowance, validateSigner, validateSignerOrProvider, } from './utils';
+import { getChainId, getDecimalsFromTokenAddress, getNameFromTokenAddress, getSymbolFromTokenAddress, increaseAllowance, validateSigner, validateSignerOrProvider, } from './utils';
 import { strict as assert } from 'assert';
 import { IMentoRouter__factory } from 'mento-router-ts';
 import { getAddress } from './constants/addresses';
@@ -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;
         });
     }
     /**
@@ -157,6 +160,66 @@ export class Mento {
             return yield 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([
+                    getSymbolFromTokenAddress(address, this.signerOrProvider),
+                    getNameFromTokenAddress(address, this.signerOrProvider),
+                    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.