@mento-protocol/mento-sdk 1.17.1-beta.0 → 1.18.0

package/README.md

@@ -30,25 +30,25 @@ Current token connectivity on Celo Mainnet (last updated: 2025-10-02):
 ```mermaid
 graph TD
     USDT["USD₮"]
-    USDC --- cUSD
-    axlUSDC --- cUSD
-    USDT --- cUSD
-    cAUD --- cUSD
-    cCAD --- cUSD
-    CELO --- cUSD
-    cGBP --- cUSD
-    cUSD --- cZAR
-    cCHF --- cUSD
-    PUSO --- cUSD
-    cJPY --- cUSD
-    cCOP --- cUSD
-    cREAL --- cUSD
-    axlEUROC --- cEUR
-    cEUR --- cUSD
-    cGHS --- cUSD
-    cNGN --- cUSD
-    cKES --- cUSD
-    cUSD --- eXOF
+    USDC --- USDm
+    axlUSDC --- USDm
+    USDT --- USDm
+    AUDm --- USDm
+    CADm --- USDm
+    CELO --- USDm
+    GBPm --- USDm
+    USDm --- ZARm
+    CHFm --- USDm
+    PHPm --- USDm
+    JPYm --- USDm
+    COPm --- USDm
+    BRLm --- USDm
+    axlEUROC --- EURm
+    EURm --- USDm
+    GHSm --- USDm
+    NGNm --- USDm
+    KESm --- USDm
+    USDm --- XOFm
 ```
 
 **Network Stats:** 20 tokens, 19 direct trading pairs

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mento-protocol/mento-sdk",
   "description": "Official SDK for interacting with the Mento Protocol",
-  "version": "1.17.1-beta.0",
+  "version": "1.18.0",
   "license": "MIT",
   "author": "Mento Labs",
   "keywords": [

package/dist/cjs/ChainClient.d.ts

@@ -1,9 +0,0 @@
-import { PopulatedTransaction, ethers, providers } from 'ethers';
-import { IChainClient } from './interfaces';
-export declare class ChainClient implements IChainClient {
-    private readonly signerOrProvider;
-    constructor(signerOrProvider: ethers.Signer | providers.Provider);
-    getSigner(): Promise<ethers.Signer | providers.Provider>;
-    getChainId(): Promise<number>;
-    populateTransaction(tx: PopulatedTransaction): Promise<providers.TransactionRequest>;
-}

package/dist/cjs/ChainClient.js

@@ -1,58 +0,0 @@
-"use strict";
-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.ChainClient = void 0;
-const ethers_1 = require("ethers");
-const utils_1 = require("./utils");
-class ChainClient {
-    constructor(signerOrProvider) {
-        (0, utils_1.validateSignerOrProvider)(signerOrProvider);
-        this.signerOrProvider = signerOrProvider;
-    }
-    getSigner() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.signerOrProvider;
-        });
-    }
-    getChainId() {
-        var _a;
-        return __awaiter(this, void 0, void 0, function* () {
-            let chainId = 0;
-            if (ethers_1.Signer.isSigner(this.signerOrProvider)) {
-                const network = yield ((_a = this.signerOrProvider.provider) === null || _a === void 0 ? void 0 : _a.getNetwork());
-                if (network) {
-                    chainId = network.chainId;
-                }
-            }
-            else if (ethers_1.providers.Provider.isProvider(this.signerOrProvider)) {
-                const network = yield this.signerOrProvider.getNetwork();
-                if (network) {
-                    chainId = network.chainId;
-                }
-            }
-            if (chainId === 0) {
-                throw new Error('Could not get chainId from signer or provider');
-            }
-            return chainId;
-        });
-    }
-    populateTransaction(tx) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (ethers_1.Signer.isSigner(this.signerOrProvider)) {
-                return this.signerOrProvider.populateTransaction(tx);
-            }
-            else {
-                return tx;
-            }
-        });
-    }
-}
-exports.ChainClient = ChainClient;

package/dist/cjs/TestChainClient.d.ts

@@ -1,7 +0,0 @@
-import { PopulatedTransaction, ethers, providers } from 'ethers';
-import { IChainClient } from './interfaces';
-export declare class TestChainClient implements IChainClient {
-    getSigner(): Promise<ethers.Signer | providers.Provider>;
-    getChainId(): Promise<number>;
-    populateTransaction(tx: PopulatedTransaction): Promise<providers.TransactionRequest>;
-}

package/dist/cjs/TestChainClient.js

@@ -1,41 +0,0 @@
-"use strict";
-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.TestChainClient = void 0;
-class TestChainClient {
-    getSigner() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const fakeProvider = {};
-            return fakeProvider;
-        });
-    }
-    getChainId() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return 11142220;
-        });
-    }
-    populateTransaction(tx) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const fakeTx = {
-                to: tx.to,
-                from: tx.from,
-                data: tx.data,
-                value: tx.value,
-                nonce: 0,
-                gasLimit: 0,
-                gasPrice: 0,
-                chainId: 1,
-            };
-            return fakeTx;
-        });
-    }
-}
-exports.TestChainClient = TestChainClient;

package/dist/cjs/constants/addresses.d.ts

@@ -1,4 +0,0 @@
-import { ContractAddressMap } from '../types';
-export declare const addresses: ContractAddressMap;
-export type Identifier = keyof ContractAddressMap[keyof ContractAddressMap];
-export declare function getAddress(identifier: Identifier, chainId: number): string;

package/dist/cjs/constants/addresses.js

@@ -1,59 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAddress = exports.addresses = void 0;
-const enums_1 = require("./../enums");
-exports.addresses = {
-    [enums_1.ChainId.CELO]: {
-        // Oracles & Breakers
-        BreakerBox: '0x303ED1df62Fa067659B586EbEe8De0EcE824Ab39',
-        MedianDeltaBreaker: '0x49349F92D2B17d491e42C8fdB02D19f072F9B5D9',
-        SortedOracles: '0xefB84935239dAcdecF7c5bA76d8dE40b077B7b33',
-        ValueDeltaBreaker: '0x4DBC33B3abA78475A5AA4BC7A5B11445d387BF68',
-        // DEX
-        BiPoolManager: '0x22d9db95E6Ae61c104A7B6F6C78D7993B94ec901',
-        Broker: '0x777A8255cA72412f0d706dc03C9D1987306B4CaD',
-        ConstantProductPricingModule: '0x0c07126d0CB30E66eF7553Cc7C37143B4f06DddB',
-        ConstantSumPricingModule: '0xDebED1F6f6ce9F6e73AA25F95acBFFE2397550Fb',
-        MentoRouter: '0xbe729350f8cdfc19db6866e8579841188ee57f67',
-        Reserve: '0x9380fA34Fd9e4Fd14c06305fd7B6199089eD4eb9',
-        // Governance
-        Airgrab: '0x7D8E73deafDBAfc98fDBe7974168cFA6d8B9AE0C',
-        Emission: '0x5C789592E2611df1873b46D394c69f75faB99778',
-        Locking: '0x001Bb66636dCd149A1A2bA8C50E408BdDd80279C',
-        MentoGovernor: '0x47036d78bB3169b4F5560dD77BF93f4412A59852',
-        MentoToken: '0x7FF62f59e3e89EA34163EA1458EEBCc81177Cfb6',
-        TimelockController: '0x890DB8A597940165901372Dd7DB61C9f246e2147',
-    },
-    [enums_1.ChainId.CELO_SEPOLIA]: {
-        // Oracles & Breakers
-        BreakerBox: '0x578bD46003B9D3fd4c3C3f47c98B329562a6a1dE',
-        MedianDeltaBreaker: '0xd29B4e743F7B84D63fBF9149B6D983DF2eF5C952',
-        SortedOracles: '0xfaa7Ca2B056E60F6733aE75AA0709140a6eAfD20',
-        ValueDeltaBreaker: '0x03CDf2966185Eb0b980f2481Ad386B8aFdAB4534',
-        // DEX
-        BiPoolManager: '0xeCB3C656C131fCd9bB8D1d80898716bD684feb78',
-        Broker: '0xB9Ae2065142EB79b6c5EB1E8778F883fad6B07Ba',
-        ConstantProductPricingModule: '0x2584a5835e3aE7E901e6462E1de06920c2C68028',
-        ConstantSumPricingModule: '0x3b199d9EbEbe509bb711BfFb455c2d79102A9602',
-        MentoRouter: '0x8e4Fb12D86D5DF911086a9153e79CA27e0c96156',
-        Reserve: '0x2bC2D48735842924C508468C5A02580aD4F6d99A',
-        // Governance
-        Emission: '0x3C1BEA0F35b5dcAc1065CA9b3b6877657dEa4A69',
-        Locking: '0xB72320fC501cb30E55bAF0DA48c20b11fAc9f79D',
-        MentoGovernor: '0x23173Ac37b8E4e5a60d787aC543B3F51e8f398b4',
-        MentoToken: '0x07867fd40EB56b4380bE39c88D0a7EA59Aa99A20',
-        TimelockController: '0x74c44Be99937815173A3C56274331e0A05611e0D',
-    },
-};
-function getAddress(identifier, chainId) {
-    const addressesForChain = exports.addresses[chainId];
-    if (!addressesForChain) {
-        throw new Error(`No addresses found for chain ID ${chainId}`);
-    }
-    const address = addressesForChain[identifier];
-    if (!address) {
-        throw new Error(`Address not found for identifier ${identifier} on chain ID ${chainId}`);
-    }
-    return address;
-}
-exports.getAddress = getAddress;

package/dist/cjs/constants/currencies.d.ts

@@ -1,5 +0,0 @@
-/**
- * List of supported currencies for rate feed generation and validation
- */
-export declare const CURRENCIES: readonly ["AUD", "USD", "PHP", "ZAR", "CAD", "EUR", "BRL", "XOF", "COP", "GHS", "CHF", "NGN", "JPY", "GBP", "KES", "CELO", "ETH", "EURC", "EUROC", "USDC", "USDT"];
-export type Currency = typeof CURRENCIES[number];

package/dist/cjs/constants/currencies.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CURRENCIES = void 0;
-/**
- * List of supported currencies for rate feed generation and validation
- */
-exports.CURRENCIES = [
-    "AUD",
-    "USD",
-    "PHP",
-    "ZAR",
-    "CAD",
-    "EUR",
-    "BRL",
-    "XOF",
-    "COP",
-    "GHS",
-    "CHF",
-    "NGN",
-    "JPY",
-    "GBP",
-    "KES",
-    "CELO",
-    "ETH",
-    "EURC",
-    "EUROC",
-    "USDC",
-    "USDT"
-];

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

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

package/dist/cjs/constants/index.js

@@ -1,20 +0,0 @@
-"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./addresses"), exports);
-__exportStar(require("./currencies"), exports);
-__exportStar(require("./tokens"), exports);
-__exportStar(require("./tradablePairs"), exports);

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

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

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

@@ -1,128 +0,0 @@
-"use strict";
-// This file is auto-generated. Do not edit manually.
-// Generated on 2025-12-10T13:15:03.083Z
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tokens11142220 = void 0;
-const mento_1 = require("../mento");
-exports.tokens11142220 = [
-    {
-        address: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
-        symbol: mento_1.TokenSymbol.AUDm,
-        name: 'Mento Australian Dollar',
-        decimals: 18,
-    },
-    {
-        address: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
-        symbol: mento_1.TokenSymbol.axlEUROC,
-        name: 'Mento Mock axlEUROC',
-        decimals: 18,
-    },
-    {
-        address: '0x6285De9DA7C1d329C0451628638908915002d9d1',
-        symbol: mento_1.TokenSymbol.axlUSDC,
-        name: 'Mento Mock axlUSDC',
-        decimals: 18,
-    },
-    {
-        address: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
-        symbol: mento_1.TokenSymbol.BRLm,
-        name: 'Mento Brazilian Real',
-        decimals: 18,
-    },
-    {
-        address: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
-        symbol: mento_1.TokenSymbol.CADm,
-        name: 'Mento Canadian Dollar',
-        decimals: 18,
-    },
-    {
-        address: '0x471EcE3750Da237f93B8E339c536989b8978a438',
-        symbol: mento_1.TokenSymbol.CELO,
-        name: 'Celo native asset',
-        decimals: 18,
-    },
-    {
-        address: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
-        symbol: mento_1.TokenSymbol.CHFm,
-        name: 'Mento Swiss Franc',
-        decimals: 18,
-    },
-    {
-        address: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
-        symbol: mento_1.TokenSymbol.COPm,
-        name: 'Mento Colombian Peso',
-        decimals: 18,
-    },
-    {
-        address: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
-        symbol: mento_1.TokenSymbol.EURm,
-        name: 'Mento Euro',
-        decimals: 18,
-    },
-    {
-        address: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
-        symbol: mento_1.TokenSymbol.GBPm,
-        name: 'Mento British Pound',
-        decimals: 18,
-    },
-    {
-        address: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
-        symbol: mento_1.TokenSymbol.GHSm,
-        name: 'Mento Ghanaian Cedi',
-        decimals: 18,
-    },
-    {
-        address: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
-        symbol: mento_1.TokenSymbol.JPYm,
-        name: 'Mento Japanese Yen',
-        decimals: 18,
-    },
-    {
-        address: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
-        symbol: mento_1.TokenSymbol.KESm,
-        name: 'Mento Kenyan Shilling',
-        decimals: 18,
-    },
-    {
-        address: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
-        symbol: mento_1.TokenSymbol.NGNm,
-        name: 'Mento Nigerian Naira',
-        decimals: 18,
-    },
-    {
-        address: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
-        symbol: mento_1.TokenSymbol.PHPm,
-        name: 'Mento Philippine Peso',
-        decimals: 18,
-    },
-    {
-        address: '0xd077A400968890Eacc75cdc901F0356c943e4fDb',
-        symbol: mento_1.TokenSymbol.USD_,
-        name: 'Tether USD',
-        decimals: 6,
-    },
-    {
-        address: '0x01C5C0122039549AD1493B8220cABEdD739BC44E',
-        symbol: mento_1.TokenSymbol.USDC,
-        name: 'USDC',
-        decimals: 6,
-    },
-    {
-        address: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
-        symbol: mento_1.TokenSymbol.USDm,
-        name: 'Mento Dollar',
-        decimals: 18,
-    },
-    {
-        address: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
-        symbol: mento_1.TokenSymbol.XOFm,
-        name: 'Mento West African CFA franc',
-        decimals: 18,
-    },
-    {
-        address: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
-        symbol: mento_1.TokenSymbol.ZARm,
-        name: 'Mento South African Rand',
-        decimals: 18,
-    },
-];

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

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

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

@@ -1,128 +0,0 @@
-"use strict";
-// This file is auto-generated. Do not edit manually.
-// Generated on 2025-11-06T15:50:03.777Z
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tokens42220 = void 0;
-const mento_1 = require("../mento");
-exports.tokens42220 = [
-    {
-        address: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
-        symbol: mento_1.TokenSymbol.axlEUROC,
-        name: 'Axelar Wrapped EUROC',
-        decimals: 6,
-    },
-    {
-        address: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
-        symbol: mento_1.TokenSymbol.axlUSDC,
-        name: 'Axelar Wrapped USDC',
-        decimals: 6,
-    },
-    {
-        address: '0x7175504C455076F15c04A2F90a8e352281F492F9',
-        symbol: mento_1.TokenSymbol.cAUD,
-        name: 'Celo Australian Dollar',
-        decimals: 18,
-    },
-    {
-        address: '0xff4Ab19391af240c311c54200a492233052B6325',
-        symbol: mento_1.TokenSymbol.cCAD,
-        name: 'Celo Canadian Dollar',
-        decimals: 18,
-    },
-    {
-        address: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
-        symbol: mento_1.TokenSymbol.cCHF,
-        name: 'Celo Swiss Franc',
-        decimals: 18,
-    },
-    {
-        address: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
-        symbol: mento_1.TokenSymbol.cCOP,
-        name: 'Celo Colombian Peso',
-        decimals: 18,
-    },
-    {
-        address: '0x471EcE3750Da237f93B8E339c536989b8978a438',
-        symbol: mento_1.TokenSymbol.CELO,
-        name: 'Celo native asset',
-        decimals: 18,
-    },
-    {
-        address: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
-        symbol: mento_1.TokenSymbol.cEUR,
-        name: 'Celo Euro',
-        decimals: 18,
-    },
-    {
-        address: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
-        symbol: mento_1.TokenSymbol.cGBP,
-        name: 'Celo British Pound',
-        decimals: 18,
-    },
-    {
-        address: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
-        symbol: mento_1.TokenSymbol.cGHS,
-        name: 'Celo Ghanaian Cedi',
-        decimals: 18,
-    },
-    {
-        address: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
-        symbol: mento_1.TokenSymbol.cJPY,
-        name: 'Celo Japanese Yen',
-        decimals: 18,
-    },
-    {
-        address: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
-        symbol: mento_1.TokenSymbol.cKES,
-        name: 'Celo Kenyan Shilling',
-        decimals: 18,
-    },
-    {
-        address: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
-        symbol: mento_1.TokenSymbol.cNGN,
-        name: 'Celo Nigerian Naira',
-        decimals: 18,
-    },
-    {
-        address: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
-        symbol: mento_1.TokenSymbol.cREAL,
-        name: 'Celo Brazilian Real',
-        decimals: 18,
-    },
-    {
-        address: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
-        symbol: mento_1.TokenSymbol.cUSD,
-        name: 'Celo Dollar',
-        decimals: 18,
-    },
-    {
-        address: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
-        symbol: mento_1.TokenSymbol.cZAR,
-        name: 'Celo South African Rand',
-        decimals: 18,
-    },
-    {
-        address: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
-        symbol: mento_1.TokenSymbol.eXOF,
-        name: 'ECO CFA',
-        decimals: 18,
-    },
-    {
-        address: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
-        symbol: mento_1.TokenSymbol.PUSO,
-        name: 'PUSO',
-        decimals: 18,
-    },
-    {
-        address: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
-        symbol: mento_1.TokenSymbol.USD_,
-        name: 'Tether USD',
-        decimals: 6,
-    },
-    {
-        address: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
-        symbol: mento_1.TokenSymbol.USDC,
-        name: 'USDC',
-        decimals: 6,
-    },
-];

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

@@ -1,65 +0,0 @@
-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[];
-/**
- * Token symbol enum for type-safe access across all chains
- * Note: Not all tokens are available on all chains - check TOKEN_ADDRESSES_BY_CHAIN
- */
-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"
-}
-/**
- * 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>>;
-};