@mento-protocol/mento-sdk 3.2.2-beta1 → 3.2.3

package/dist/cjs/ChainClient.d.ts

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,58 @@
+"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

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1,41 @@
+"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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1,59 @@
+"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

@@ -0,0 +1,5 @@
+/**
+ * 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

@@ -0,0 +1,29 @@
+"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

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

package/dist/{services/borrow → cjs/constants}/index.js

@@ -14,7 +14,7 @@ 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("./BorrowService"), exports);
-__exportStar(require("./borrowHelpers"), exports);
-__exportStar(require("./borrowMath"), exports);
-//# sourceMappingURL=index.js.map
+__exportStar(require("./addresses"), exports);
+__exportStar(require("./currencies"), exports);
+__exportStar(require("./tokens"), exports);
+__exportStar(require("./tradablePairs"), exports);

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

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

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

@@ -0,0 +1,128 @@
+"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

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

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

@@ -0,0 +1,128 @@
+"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

@@ -0,0 +1,65 @@
+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>>;
+};