@mento-protocol/mento-sdk 3.2.3 → 3.2.4

package/dist/core/abis/virtualPool.d.ts

@@ -0,0 +1,50 @@
+export declare const VIRTUAL_POOL_ABI: readonly [{
+    readonly name: "protocolFee";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getReserves";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }, {
+        readonly type: "uint256";
+    }, {
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "metadata";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }, {
+        readonly type: "uint256";
+    }, {
+        readonly type: "uint256";
+    }, {
+        readonly type: "uint256";
+    }, {
+        readonly type: "address";
+    }, {
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "tokens";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }, {
+        readonly type: "address";
+    }];
+}];
+//# sourceMappingURL=virtualPool.d.ts.map

package/dist/core/abis/virtualPool.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VIRTUAL_POOL_ABI = void 0;
+const viem_1 = require("viem");
+exports.VIRTUAL_POOL_ABI = (0, viem_1.parseAbi)([
+    'function protocolFee() view returns (uint256)',
+    'function getReserves() view returns (uint256, uint256, uint256)',
+    'function metadata() view returns (uint256, uint256, uint256, uint256, address, address)',
+    'function tokens() view returns (address, address)',
+]);
+//# sourceMappingURL=virtualPool.js.map

package/dist/core/abis/virtualPoolFactory.d.ts

@@ -0,0 +1,59 @@
+export declare const VIRTUAL_POOL_FACTORY_ABI: readonly [{
+    readonly name: "getOrPrecomputeProxyAddress";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "token0";
+    }, {
+        readonly type: "address";
+        readonly name: "token1";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "isPool";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "pool";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "getAllPools";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address[]";
+    }];
+}, {
+    readonly name: "InvalidExchangeProvider";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}, {
+    readonly name: "InvalidExchangeId";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}, {
+    readonly name: "VirtualPoolAlreadyExistsForThisPair";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}, {
+    readonly name: "InvalidCreateXBytecode";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}, {
+    readonly name: "PoolNotFound";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}, {
+    readonly name: "PoolAlreadyDeprecated";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}];
+//# sourceMappingURL=virtualPoolFactory.d.ts.map

package/dist/core/abis/virtualPoolFactory.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VIRTUAL_POOL_FACTORY_ABI = void 0;
+const viem_1 = require("viem");
+exports.VIRTUAL_POOL_FACTORY_ABI = (0, viem_1.parseAbi)([
+    'function getOrPrecomputeProxyAddress(address token0, address token1) view returns (address)',
+    'function isPool(address pool) view returns (bool)',
+    'function getAllPools() view returns (address[])',
+    // Custom errors
+    'error InvalidExchangeProvider()',
+    'error InvalidExchangeId()',
+    'error VirtualPoolAlreadyExistsForThisPair()',
+    'error InvalidCreateXBytecode()',
+    'error PoolNotFound()',
+    'error PoolAlreadyDeprecated()',
+]);
+//# sourceMappingURL=virtualPoolFactory.js.map

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

@@ -0,0 +1,18 @@
+import { ChainId } from './chainId';
+import { ContractAddresses, ContractAddressMap } from '../types';
+export declare const addresses: ContractAddressMap;
+export type Identifier = keyof ContractAddresses;
+/**
+ * Get the address of a contract for a given chain, returning undefined if not found.
+ * Use this when the contract may not be deployed on the target chain.
+ */
+export declare function tryGetContractAddress(chainId: ChainId, contractName: Identifier): string | undefined;
+/**
+ * Get the address of a contract for a given chain
+ * @param chainId - The chain ID
+ * @param contractName - The contract name
+ * @returns The contract address
+ * @throws Error if the address is not found for the given chain
+ */
+export declare function getContractAddress(chainId: ChainId, contractName: Identifier): string;
+//# sourceMappingURL=addresses.d.ts.map

package/dist/core/constants/addresses.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addresses = void 0;
+exports.tryGetContractAddress = tryGetContractAddress;
+exports.getContractAddress = getContractAddress;
+const chainId_1 = require("./chainId");
+exports.addresses = {
+    [chainId_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',
+        // Stable Tokens
+        StableToken: '0x765DE816845861e75A25fCA122bb6898B8B1282a', // USDm
+        // Governance
+        Airgrab: '0x7D8E73deafDBAfc98fDBe7974168cFA6d8B9AE0C',
+        Emission: '0x5C789592E2611df1873b46D394c69f75faB99778',
+        Locking: '0x001Bb66636dCd149A1A2bA8C50E408BdDd80279C',
+        MentoGovernor: '0x47036d78bB3169b4F5560dD77BF93f4412A59852',
+        MentoToken: '0x7FF62f59e3e89EA34163EA1458EEBCc81177Cfb6',
+        TimelockController: '0x890DB8A597940165901372Dd7DB61C9f246e2147',
+        // V3
+        FPMMFactory: '0xa849b475FE5a4B5C9C3280152c7a1945b907613b',
+        VirtualPoolFactory: '0x22abd4ADF6aab38aC1022352d496A07Acee5aCB3',
+        Router: '0x4861840C2EfB2b98312B0aE34d86fD73E8f9B6f6',
+        ReserveLiquidityStrategy: '0xa0fB8b16ce6AF3634fF9F3f4F40E49E1C1ae4f0B',
+        CDPLiquidityStrategy: '0x4e78BD9565341EAbe99cDC024acB044d9BDcB985',
+    },
+    [chainId_1.ChainId.MONAD_TESTNET]: {
+        BreakerBox: '0x88869E30609D2C0E4032463D713328C6f541878e',
+        MedianDeltaBreaker: '0xf923C884F319b8866F67C5719A80E5cB4D0FAF2c',
+        SortedOracles: '0x85ed9ac57827132B8F60938F3165BC139E1F53cd',
+        ValueDeltaBreaker: '0xbbD0D093F5F11D16D4456FBd6229c9a3b70B8Aaf',
+        Reserve: '0xbCdc1D0b92DfceEaa0FcD0a0D53355F4bF1DB8a7',
+        StableToken: '0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc', // USDm
+        FPMMFactory: '0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980',
+        Router: '0xcf6cD45210b3ffE3cA28379C4683F1e60D0C2CCd',
+        ReserveLiquidityStrategy: '0x734bb3251Ec3f1A83f8f2A8609bcEF649D54EbF8',
+        OpenLiquidityStrategy: '0xCCd2aD0603a08EBc14D223a983171ef18192e8c9',
+    },
+    [chainId_1.ChainId.MONAD]: {
+        BreakerBox: '0x9fc1E0d10fb38954Da385B8B25aB2BbaF3241722',
+        MedianDeltaBreaker: '0x3E4F2Bca4f7192Be4C3c5E5bD4840F2E90a8Ba84',
+        SortedOracles: '0x6f92C745346057a61b259579256159458a0a6A92',
+        ValueDeltaBreaker: '0xca2e7563dfC30bc94687F3deAcF682E1dBAffA13',
+        Reserve: '0x4255Cf38e51516766180b33122029A88Cb853806',
+        StableToken: '0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115', // USDm
+        FPMMFactory: '0xa849b475FE5a4B5C9C3280152c7a1945b907613b',
+        Router: '0x4861840C2EfB2b98312B0aE34d86fD73E8f9B6f6',
+        ReserveLiquidityStrategy: '0xa0fB8b16ce6AF3634fF9F3f4F40E49E1C1ae4f0B',
+        OpenLiquidityStrategy: '0x54e2Ae8c8448912E17cE0b2453bAFB7B0D80E40f',
+    },
+    [chainId_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',
+        // V3
+        FPMMFactory: '0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980',
+        VirtualPoolFactory: '0x887955f28723B0e9Bddc358448CB5B1FDe692da4',
+        Router: '0xcf6cD45210b3ffE3cA28379C4683F1e60D0C2CCd',
+        ReserveLiquidityStrategy: '0x734bb3251Ec3f1A83f8f2A8609bcEF649D54EbF8',
+        CDPLiquidityStrategy: '0x065AE7D4e207C8f4dca112D0B79E668cc7e93e03',
+    },
+};
+/**
+ * Get the address of a contract for a given chain, returning undefined if not found.
+ * Use this when the contract may not be deployed on the target chain.
+ */
+function tryGetContractAddress(chainId, contractName) {
+    const addressesForChain = exports.addresses[chainId];
+    if (!addressesForChain) {
+        return undefined;
+    }
+    return addressesForChain[contractName];
+}
+/**
+ * Get the address of a contract for a given chain
+ * @param chainId - The chain ID
+ * @param contractName - The contract name
+ * @returns The contract address
+ * @throws Error if the address is not found for the given chain
+ */
+function getContractAddress(chainId, contractName) {
+    const address = tryGetContractAddress(chainId, contractName);
+    if (!address) {
+        throw new Error(`Address not found for contract ${contractName} on chain ID ${chainId}`);
+    }
+    return address;
+}
+//# sourceMappingURL=addresses.js.map

package/dist/core/constants/borrowConstants.d.ts

@@ -0,0 +1,10 @@
+export declare const MAX_ANNUAL_INTEREST_RATE = 2500000000000000000n;
+export declare const UPFRONT_INTEREST_PERIOD = 604800;
+export declare const INTEREST_RATE_ADJ_COOLDOWN = 604800;
+export declare const MAX_LTV_ALLOWED_RATIO = 916n;
+export declare const LTV_RISK_MEDIUM = 540n;
+export declare const LTV_RISK_HIGH = 730n;
+export declare const REDEMPTION_RISK_MEDIUM = 50n;
+export declare const REDEMPTION_RISK_LOW = 600n;
+export declare const COLL_INDEX = 0n;
+//# sourceMappingURL=borrowConstants.d.ts.map

package/dist/core/constants/borrowConstants.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COLL_INDEX = exports.REDEMPTION_RISK_LOW = exports.REDEMPTION_RISK_MEDIUM = exports.LTV_RISK_HIGH = exports.LTV_RISK_MEDIUM = exports.MAX_LTV_ALLOWED_RATIO = exports.INTEREST_RATE_ADJ_COOLDOWN = exports.UPFRONT_INTEREST_PERIOD = exports.MAX_ANNUAL_INTEREST_RATE = void 0;
+// Compile-time constants from Constants.sol
+exports.MAX_ANNUAL_INTEREST_RATE = 2500000000000000000n; // 250%
+exports.UPFRONT_INTEREST_PERIOD = 604800; // 7 days in seconds
+exports.INTEREST_RATE_ADJ_COOLDOWN = 604800; // 7 days in seconds
+// UI-level constants from Bold frontend (constants.ts)
+exports.MAX_LTV_ALLOWED_RATIO = 916n; // 91.6% (per-mille)
+exports.LTV_RISK_MEDIUM = 540n; // 54% of maxLtv
+exports.LTV_RISK_HIGH = 730n; // 73% of maxLtv
+exports.REDEMPTION_RISK_MEDIUM = 50n; // 5% of total debt
+exports.REDEMPTION_RISK_LOW = 600n; // 60% of total debt
+// Single branch index for Mento
+exports.COLL_INDEX = 0n;
+//# sourceMappingURL=borrowConstants.js.map

package/dist/core/constants/borrowRegistries.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Known AddressesRegistry contracts per chain, keyed by debt token symbol.
+ * Each registry is the entry point for one Bold deployment.
+ */
+export declare const borrowRegistries: Record<number, Record<string, string>>;
+export declare function getBorrowRegistry(chainId: number, debtTokenSymbol: string): string;
+//# sourceMappingURL=borrowRegistries.d.ts.map

package/dist/core/constants/borrowRegistries.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.borrowRegistries = void 0;
+exports.getBorrowRegistry = getBorrowRegistry;
+const chainId_1 = require("./chainId");
+/**
+ * Known AddressesRegistry contracts per chain, keyed by debt token symbol.
+ * Each registry is the entry point for one Bold deployment.
+ */
+exports.borrowRegistries = {
+    [chainId_1.ChainId.CELO]: {
+        GBPm: '0xB3136DBadB14Ab587FFa91545538126938Fe0C6E',
+    },
+    [chainId_1.ChainId.CELO_SEPOLIA]: {
+        GBPm: '0x8b33D626E8d79388889d404fBC515Ed131c9508e',
+    },
+};
+function getBorrowRegistry(chainId, debtTokenSymbol) {
+    const registries = exports.borrowRegistries[chainId];
+    if (!registries) {
+        throw new Error(`No borrow registries found for chain ID ${chainId}`);
+    }
+    const registry = registries[debtTokenSymbol];
+    if (!registry) {
+        const available = Object.keys(registries).join(', ') || 'none';
+        throw new Error(`No borrow registry found for "${debtTokenSymbol}" on chain ${chainId}. Available: ${available}`);
+    }
+    return registry;
+}
+//# sourceMappingURL=borrowRegistries.js.map

package/dist/core/constants/chainId.d.ts

@@ -0,0 +1,7 @@
+export declare enum ChainId {
+    CELO = 42220,
+    CELO_SEPOLIA = 11142220,
+    MONAD_TESTNET = 10143,
+    MONAD = 143
+}
+//# sourceMappingURL=chainId.d.ts.map

package/dist/{cjs/enums → core/constants}/chainId.js

@@ -5,4 +5,7 @@ var ChainId;
 (function (ChainId) {
     ChainId[ChainId["CELO"] = 42220] = "CELO";
     ChainId[ChainId["CELO_SEPOLIA"] = 11142220] = "CELO_SEPOLIA";
-})(ChainId = exports.ChainId || (exports.ChainId = {}));
+    ChainId[ChainId["MONAD_TESTNET"] = 10143] = "MONAD_TESTNET";
+    ChainId[ChainId["MONAD"] = 143] = "MONAD";
+})(ChainId || (exports.ChainId = ChainId = {}));
+//# sourceMappingURL=chainId.js.map

package/dist/core/constants/contractNames.d.ts

@@ -0,0 +1,21 @@
+export declare const GOVERNANCEFACTORY = "GovernanceFactory";
+export declare const AIRGRAB = "Airgrab";
+export declare const EMISSION = "Emission";
+export declare const MENTOGOVERNOR = "MentoGovernor";
+export declare const MENTOTOKEN = "MentoToken";
+export declare const TIMELOCKCONTROLLER = "TimelockController";
+export declare const LOCKING = "Locking";
+export declare const BROKER = "Broker";
+export declare const BIPOOLMANAGER = "BiPoolManager";
+export declare const BREAKERBOX = "BreakerBox";
+export declare const RESERVE = "Reserve";
+export declare const CONSTANTSUM = "ConstantSumPricingModule";
+export declare const CONSTANTPRODUCT = "ConstantProductPricingModule";
+export declare const MEDIANDELTA = "MedianDeltaBreaker";
+export declare const VALUEDELTA = "ValueDeltaBreaker";
+export declare const STABLETOKEN = "StableToken";
+export declare const STABLETOKNEUR = "StableTokenEUR";
+export declare const STABLETOKENBRL = "StableTokenBRL";
+export declare const STABLETOKENXOF = "StableTokenXOF";
+export declare const SORTEDORACLES = "SortedOracles";
+//# sourceMappingURL=contractNames.d.ts.map

package/dist/core/constants/contractNames.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SORTEDORACLES = exports.STABLETOKENXOF = exports.STABLETOKENBRL = exports.STABLETOKNEUR = exports.STABLETOKEN = exports.VALUEDELTA = exports.MEDIANDELTA = exports.CONSTANTPRODUCT = exports.CONSTANTSUM = exports.RESERVE = exports.BREAKERBOX = exports.BIPOOLMANAGER = exports.BROKER = exports.LOCKING = exports.TIMELOCKCONTROLLER = exports.MENTOTOKEN = exports.MENTOGOVERNOR = exports.EMISSION = exports.AIRGRAB = exports.GOVERNANCEFACTORY = void 0;
+exports.GOVERNANCEFACTORY = 'GovernanceFactory';
+exports.AIRGRAB = 'Airgrab';
+exports.EMISSION = 'Emission';
+exports.MENTOGOVERNOR = 'MentoGovernor';
+exports.MENTOTOKEN = 'MentoToken';
+exports.TIMELOCKCONTROLLER = 'TimelockController';
+exports.LOCKING = 'Locking';
+exports.BROKER = 'Broker';
+exports.BIPOOLMANAGER = 'BiPoolManager';
+exports.BREAKERBOX = 'BreakerBox';
+exports.RESERVE = 'Reserve';
+exports.CONSTANTSUM = 'ConstantSumPricingModule';
+exports.CONSTANTPRODUCT = 'ConstantProductPricingModule';
+exports.MEDIANDELTA = 'MedianDeltaBreaker';
+exports.VALUEDELTA = 'ValueDeltaBreaker';
+exports.STABLETOKEN = 'StableToken';
+exports.STABLETOKNEUR = 'StableTokenEUR';
+exports.STABLETOKENBRL = 'StableTokenBRL';
+exports.STABLETOKENXOF = 'StableTokenXOF';
+exports.SORTEDORACLES = 'SortedOracles';
+//# sourceMappingURL=contractNames.js.map

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

@@ -0,0 +1,6 @@
+export * from './addresses';
+export * from './chainId';
+export * from './contractNames';
+export * from './borrowConstants';
+export * from './borrowRegistries';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/constants/index.js

@@ -0,0 +1,22 @@
+"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("./chainId"), exports);
+__exportStar(require("./contractNames"), exports);
+__exportStar(require("./borrowConstants"), exports);
+__exportStar(require("./borrowRegistries"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/errors/base.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Base error class for all Mento SDK errors.
+ * Provides consistent error naming and proper prototype chain setup.
+ */
+export declare class MentoError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/core/errors/base.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MentoError = void 0;
+/**
+ * Base error class for all Mento SDK errors.
+ * Provides consistent error naming and proper prototype chain setup.
+ */
+class MentoError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+        // Maintains proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.MentoError = MentoError;
+//# sourceMappingURL=base.js.map

package/dist/core/errors/index.d.ts

@@ -0,0 +1,4 @@
+export * from './base';
+export * from './oracle';
+export * from './router';
+//# sourceMappingURL=index.d.ts.map

package/dist/{cjs/constants → core/errors}/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("./addresses"), exports);
-__exportStar(require("./currencies"), exports);
-__exportStar(require("./tokens"), exports);
-__exportStar(require("./tradablePairs"), exports);
+__exportStar(require("./base"), exports);
+__exportStar(require("./oracle"), exports);
+__exportStar(require("./router"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/errors/oracle.d.ts

@@ -0,0 +1,9 @@
+import { MentoError } from './base';
+/**
+ * Error thrown when the FX market is closed and oracle prices are unavailable.
+ * The OracleAdapter reverts with FXMarketClosed() (sig 0xa407143a) during market closure.
+ */
+export declare class FXMarketClosedError extends MentoError {
+    constructor();
+}
+//# sourceMappingURL=oracle.d.ts.map

package/dist/core/errors/oracle.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FXMarketClosedError = void 0;
+const base_1 = require("./base");
+/**
+ * Error thrown when the FX market is closed and oracle prices are unavailable.
+ * The OracleAdapter reverts with FXMarketClosed() (sig 0xa407143a) during market closure.
+ */
+class FXMarketClosedError extends base_1.MentoError {
+    constructor() {
+        super('FX market is currently closed. Swap quotes are unavailable until the market reopens.');
+    }
+}
+exports.FXMarketClosedError = FXMarketClosedError;
+//# sourceMappingURL=oracle.js.map

package/dist/core/errors/router.d.ts

@@ -0,0 +1,14 @@
+import { MentoError } from './base';
+/**
+ * Error thrown when no tradable route exists between two tokens.
+ */
+export declare class RouteNotFoundError extends MentoError {
+    constructor(tokenIn: string, tokenOut: string);
+}
+/**
+ * Error thrown when no executable zap-out route exists for the requested amount.
+ */
+export declare class ZapOutRouteNotViableError extends MentoError {
+    constructor(poolAddress: string, tokenOut: string);
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/core/errors/router.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZapOutRouteNotViableError = exports.RouteNotFoundError = void 0;
+const base_1 = require("./base");
+/**
+ * Error thrown when no tradable route exists between two tokens.
+ */
+class RouteNotFoundError extends base_1.MentoError {
+    constructor(tokenIn, tokenOut) {
+        super(`No route found for tokens ${tokenIn} and ${tokenOut}. They may not have a tradable path.`);
+    }
+}
+exports.RouteNotFoundError = RouteNotFoundError;
+/**
+ * Error thrown when no executable zap-out route exists for the requested amount.
+ */
+class ZapOutRouteNotViableError extends base_1.MentoError {
+    constructor(poolAddress, tokenOut) {
+        super(`No viable zap-out route for pool ${poolAddress} to ${tokenOut}. ` +
+            'Try reducing the amount or removing liquidity in balanced mode.');
+    }
+}
+exports.ZapOutRouteNotViableError = ZapOutRouteNotViableError;
+//# sourceMappingURL=router.js.map

package/dist/core/types/borrow.d.ts

@@ -0,0 +1,87 @@
+export interface BorrowPosition {
+    troveId: string;
+    collateral: bigint;
+    debt: bigint;
+    annualInterestRate: bigint;
+    status: TroveStatus;
+    interestBatchManager: string | null;
+    lastDebtUpdateTime: number;
+    lastInterestRateAdjTime: number;
+    redistBoldDebtGain: bigint;
+    redistCollGain: bigint;
+    accruedInterest: bigint;
+    recordedDebt: bigint;
+    accruedBatchManagementFee: bigint;
+}
+export type TroveStatus = 'active' | 'closedByOwner' | 'closedByLiquidation' | 'zombie' | 'nonExistent';
+export interface LoanDetails {
+    collateral: bigint | null;
+    collateralUsd: bigint | null;
+    collPrice: bigint | null;
+    debt: bigint | null;
+    interestRate: bigint | null;
+    ltv: bigint | null;
+    maxLtv: bigint;
+    maxLtvAllowed: bigint;
+    liquidationPrice: bigint | null;
+    liquidationRisk: RiskLevel | null;
+    maxDebt: bigint | null;
+    maxDebtAllowed: bigint | null;
+    status: 'healthy' | 'at-risk' | 'liquidatable' | 'underwater' | null;
+}
+export type RiskLevel = 'low' | 'medium' | 'high';
+export interface OpenTroveParams {
+    owner: string;
+    ownerIndex: number;
+    collAmount: bigint;
+    boldAmount: bigint;
+    annualInterestRate: bigint;
+    maxUpfrontFee: bigint;
+    interestBatchManager?: string;
+    addManager?: string;
+    removeManager?: string;
+    receiver?: string;
+}
+export interface AdjustTroveParams {
+    troveId: string;
+    collChange: bigint;
+    isCollIncrease: boolean;
+    debtChange: bigint;
+    isDebtIncrease: boolean;
+    maxUpfrontFee: bigint;
+}
+export interface InterestRateBracket {
+    rate: bigint;
+    totalDebt: bigint;
+}
+export interface SystemParams {
+    mcr: bigint;
+    ccr: bigint;
+    scr: bigint;
+    bcr: bigint;
+    minDebt: bigint;
+    ethGasCompensation: bigint;
+    minAnnualInterestRate: bigint;
+}
+export interface BorrowContractAddresses {
+    borrowerOperations: string;
+    troveManager: string;
+    sortedTroves: string;
+    activePool: string;
+    defaultPool: string;
+    hintHelpers: string;
+    multiTroveGetter: string;
+    collToken: string;
+    debtToken: string;
+    troveNFT: string;
+    metadataNFT: string;
+    stabilityPool: string;
+    priceFeed: string;
+    collSurplusPool: string;
+    interestRouter: string;
+    collateralRegistry: string;
+    gasToken: string;
+    gasPoolAddress: string;
+    liquidityStrategy: string;
+}
+//# sourceMappingURL=borrow.d.ts.map

package/dist/{cjs/interfaces/tradingLimitsConfig.js → core/types/borrow.js}

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=borrow.js.map