@mento-protocol/mento-sdk 3.2.7 → 3.2.8

package/dist/esm/core/abis/erc20.js

@@ -0,0 +1,17 @@
+import { parseAbi } from 'viem';
+/**
+ * ERC20 ABI for standard token operations
+ *
+ * Note: `as any` is used because viem's parseAbi returns a complex readonly tuple type
+ * that can cause type verbosity. This doesn't compromise type safety - viem's
+ * readContract/writeContract still infer types correctly from the ABI at usage sites.
+ */
+export const ERC20_ABI = parseAbi([
+    'function name() view returns (string)',
+    'function symbol() view returns (string)',
+    'function decimals() view returns (uint8)',
+    'function totalSupply() view returns (uint256)',
+    'function balanceOf(address) view returns (uint256)',
+    'function approve(address spender, uint256 amount) returns (bool)',
+    'function allowance(address owner, address spender) view returns (uint256)',
+]);

package/dist/esm/core/abis/fpmm.js

@@ -0,0 +1,45 @@
+import { parseAbi } from 'viem';
+export const FPMM_ABI = parseAbi([
+    'function token0() view returns (address)',
+    'function token1() view returns (address)',
+    'function lpFee() view returns (uint256)',
+    'function protocolFee() view returns (uint256)',
+    'function referenceRateFeedID() view returns (address)',
+    'function getTradingLimits(address token) view returns ((int120 limit0, int120 limit1, uint8 decimals) config, (uint32 lastUpdated0, uint32 lastUpdated1, int96 netflow0, int96 netflow1) state)',
+    'function getReserves() view returns (uint256, uint256, uint256)',
+    'function decimals0() view returns (uint256)',
+    'function decimals1() view returns (uint256)',
+    'function rebalanceIncentive() view returns (uint256)',
+    'function rebalanceThresholdAbove() view returns (uint256)',
+    'function rebalanceThresholdBelow() view returns (uint256)',
+    'function liquidityStrategy(address) view returns (bool)',
+    'function getRebalancingState() view returns (uint256, uint256, uint256, uint256, bool, uint16, uint256)',
+    // Custom errors
+    'error ReferenceRateNotSet()',
+    'error ReservesEmpty()',
+    'error InvalidToken()',
+    'error ZeroAddress()',
+    'error ProtocolFeeRecipientRequired()',
+    'error NotFeeSetter()',
+    'error FeeTooHigh()',
+    'error InsufficientLiquidityMinted()',
+    'error InsufficientLiquidityBurned()',
+    'error InsufficientOutputAmount()',
+    'error InsufficientLiquidity()',
+    'error InvalidToAddress()',
+    'error InsufficientInputAmount()',
+    'error NotLiquidityStrategy()',
+    'error OneOutputAmountRequired()',
+    'error PriceDifferenceTooSmall()',
+    'error PriceDifferenceNotImproved()',
+    'error PriceDifferenceMovedInWrongDirection()',
+    'error PriceDifferenceMovedTooFarFromThresholds()',
+    'error InsufficientAmount0In()',
+    'error InsufficientAmount1In()',
+    'error ReserveValueDecreased()',
+    'error RebalanceIncentiveTooHigh()',
+    'error RebalanceThresholdTooHigh()',
+    'error RebalanceDirectionInvalid()',
+    'error LimitDoesNotFitInInt120()',
+    'error InvalidTokenDecimals()',
+]);

package/dist/esm/core/abis/fpmmFactory.js

@@ -0,0 +1,22 @@
+import { parseAbi } from 'viem';
+export const FPMM_FACTORY_ABI = parseAbi([
+    'function deployedFPMMAddresses() view returns (address[])',
+    'function isPool(address pool) view returns (bool)',
+    // Custom errors
+    'error CreateXBytecodeHashMismatch()',
+    'error ZeroAddress()',
+    'error IdenticalTokenAddresses()',
+    'error SortTokensZeroAddress()',
+    'error InvalidOracleAdapter()',
+    'error InvalidProxyAdmin()',
+    'error InvalidOwner()',
+    'error InvalidReferenceRateFeedID()',
+    'error PairAlreadyExists()',
+    'error ImplementationNotRegistered()',
+    'error ImplementationAlreadyRegistered()',
+    'error IndexOutOfBounds()',
+    'error ImplementationIndexMismatch()',
+    'error FeeTooHigh()',
+    'error RebalanceIncentiveTooHigh()',
+    'error RebalanceThresholdTooHigh()',
+]);

package/dist/esm/core/abis/hintHelpers.js

@@ -0,0 +1,10 @@
+import { parseAbi } from 'viem';
+export const HINT_HELPERS_ABI = parseAbi([
+    'function getApproxHint(uint256 _collIndex, uint256 _interestRate, uint256 _numTrials, uint256 _inputRandomSeed) view returns (uint256 hintId, uint256 diff, uint256 latestRandomSeed)',
+    'function predictOpenTroveUpfrontFee(uint256 _collIndex, uint256 _borrowedAmount, uint256 _interestRate) view returns (uint256)',
+    'function predictAdjustTroveUpfrontFee(uint256 _collIndex, uint256 _troveId, uint256 _debtIncrease) view returns (uint256)',
+    'function predictAdjustInterestRateUpfrontFee(uint256 _collIndex, uint256 _troveId, uint256 _newInterestRate) view returns (uint256)',
+    'function forcePredictAdjustInterestRateUpfrontFee(uint256 _collIndex, uint256 _troveId, uint256 _newInterestRate) view returns (uint256)',
+    'function predictAdjustBatchInterestRateUpfrontFee(uint256 _collIndex, address _batchAddress, uint256 _newInterestRate) view returns (uint256)',
+    'function predictJoinBatchInterestRateUpfrontFee(uint256 _collIndex, uint256 _troveId, address _batchAddress) view returns (uint256)',
+]);

package/dist/esm/core/abis/index.js

@@ -0,0 +1,21 @@
+export * from './erc20';
+export * from './reserve';
+export * from './bipoolmanager';
+export * from './broker';
+export * from './fpmmFactory';
+export * from './fpmm';
+export * from './virtualPoolFactory';
+export * from './virtualPool';
+export * from './router';
+export * from './breakerbox';
+export * from './borrowerOperations';
+export * from './troveManager';
+export * from './hintHelpers';
+export * from './sortedTroves';
+export * from './activePool';
+export * from './multiTroveGetter';
+export * from './troveNFT';
+export * from './priceFeed';
+export * from './addressesRegistry';
+export * from './systemParams';
+export * from './liquidityStrategy';

package/dist/esm/core/abis/liquidityStrategy.js

@@ -0,0 +1,6 @@
+import { parseAbi } from 'viem';
+export const LIQUIDITY_STRATEGY_ABI = parseAbi([
+    'function poolConfigs(address) view returns (bool isToken0Debt, uint32 lastRebalance, uint32 rebalanceCooldown, address protocolFeeRecipient, uint64 liquiditySourceIncentiveExpansion, uint64 protocolIncentiveExpansion, uint64 liquiditySourceIncentiveContraction, uint64 protocolIncentiveContraction)',
+    'function determineAction(address pool) view returns ((address pool, (uint256 reserveNum, uint256 reserveDen) reserves, (uint256 oracleNum, uint256 oracleDen, bool poolPriceAbove, uint16 rebalanceThreshold) prices, address token0, address token1, uint64 token0Dec, uint64 token1Dec, bool isToken0Debt, (uint64 liquiditySourceIncentiveExpansion, uint64 protocolIncentiveExpansion, uint64 liquiditySourceIncentiveContraction, uint64 protocolIncentiveContraction) incentives) ctx, (uint8 dir, uint256 amount0Out, uint256 amount1Out, uint256 amountOwedToPool) action)',
+    'function rebalance(address pool)',
+]);

package/dist/esm/core/abis/multiTroveGetter.js

@@ -0,0 +1,11 @@
+import { parseAbi } from 'viem';
+/**
+ * MultiTroveGetter ABI for batch trove queries
+ *
+ * Source: MultiTroveGetter.sol
+ * Note: Both functions require `_collIndex` as first param — SDK passes `0n`.
+ */
+export const MULTI_TROVE_GETTER_ABI = parseAbi([
+    'function getMultipleSortedTroves(uint256 _collIndex, int256 _startIdx, uint256 _count) view returns ((uint256 id, uint256 entireDebt, uint256 entireColl, uint256 redistBoldDebtGain, uint256 redistCollGain, uint256 accruedInterest, uint256 recordedDebt, uint256 annualInterestRate, uint256 accruedBatchManagementFee, uint256 lastInterestRateAdjTime, uint256 stake, uint256 lastDebtUpdateTime, address interestBatchManager, uint256 batchDebtShares, uint256 snapshotETH, uint256 snapshotBoldDebt)[])',
+    'function getDebtPerInterestRateAscending(uint256 _collIndex, uint256 _startId, uint256 _maxIterations) view returns ((address interestBatchManager, uint256 interestRate, uint256 debt)[] data, uint256 currId)',
+]);

package/dist/esm/core/abis/priceFeed.js

@@ -0,0 +1,12 @@
+import { parseAbi } from 'viem';
+/**
+ * Deliberate frontend-read shim:
+ * `fetchPrice` is non-view in source contracts, but marked `view` here so it can
+ * be called via `readContract`/`eth_call` without write simulation.
+ */
+export const PRICE_FEED_ABI = parseAbi([
+    'function fetchPrice() view returns (uint256)',
+    'function lastValidPrice() view returns (uint256)',
+    'function isL2SequencerUp() view returns (bool)',
+    'function isShutdown() view returns (bool)',
+]);

package/dist/esm/core/abis/pricingmodule.js

@@ -0,0 +1,2 @@
+import { parseAbi } from 'viem';
+export const PRICING_MODULE_ABI = parseAbi(['function name() view returns (string)']);

package/dist/esm/core/abis/reserve.js

@@ -0,0 +1,14 @@
+import { parseAbi } from 'viem';
+// Legacy Reserve (Celo)
+export const RESERVE_ABI = parseAbi([
+    'function getTokens() view returns (address[])',
+    'function isToken(address) view returns (bool)',
+    'function isCollateralAsset(address) view returns (bool)',
+]);
+// ReserveV2 (Monad)
+export const RESERVE_V2_ABI = parseAbi([
+    'function getStableAssets() view returns (address[])',
+    'function getCollateralAssets() view returns (address[])',
+    'function isStableAsset(address) view returns (bool)',
+    'function isCollateralAsset(address) view returns (bool)',
+]);

package/dist/esm/core/abis/router.js

@@ -0,0 +1,41 @@
+import { parseAbi } from 'viem';
+export const ROUTER_ABI = parseAbi([
+    // Swap operations
+    'function getAmountsOut(uint256 amountIn, Route[] memory routes) view returns (uint256[] memory amounts)',
+    'function swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, Route[] calldata routes, address to, uint256 deadline) returns (uint256[] memory amounts)',
+    // Basic liquidity operations
+    'function addLiquidity(address tokenA, address tokenB, uint256 amountADesired, uint256 amountBDesired, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline) returns (uint256 amountA, uint256 amountB, uint256 liquidity)',
+    'function removeLiquidity(address tokenA, address tokenB, uint256 liquidity, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline) returns (uint256 amountA, uint256 amountB)',
+    'function quoteAddLiquidity(address tokenA, address tokenB, address _factory, uint256 amountADesired, uint256 amountBDesired) view returns (uint256 amountA, uint256 amountB, uint256 liquidity)',
+    'function quoteRemoveLiquidity(address tokenA, address tokenB, address _factory, uint256 liquidity) view returns (uint256 amountA, uint256 amountB)',
+    // Zap operations
+    'function zapIn(address tokenIn, uint256 amountInA, uint256 amountInB, Zap calldata zapInPool, Route[] calldata routesA, Route[] calldata routesB, address to) payable returns (uint256 liquidity)',
+    'function zapOut(address tokenOut, uint256 liquidity, Zap calldata zapOutPool, Route[] calldata routesA, Route[] calldata routesB)',
+    'function generateZapInParams(address tokenA, address tokenB, address _factory, uint256 amountInA, uint256 amountInB, Route[] calldata routesA, Route[] calldata routesB) view returns (uint256 amountOutMinA, uint256 amountOutMinB, uint256 amountAMin, uint256 amountBMin)',
+    'function generateZapOutParams(address tokenA, address tokenB, address _factory, uint256 liquidity, Route[] calldata routesA, Route[] calldata routesB) view returns (uint256 amountOutMinA, uint256 amountOutMinB, uint256 amountAMin, uint256 amountBMin)',
+    // Structs
+    'struct Route { address from; address to; address factory; }',
+    'struct Zap { address tokenA; address tokenB; address factory; uint256 amountOutMinA; uint256 amountOutMinB; uint256 amountAMin; uint256 amountBMin; }',
+    // Custom errors (Router)
+    'error ETHTransferFailed()',
+    'error Expired()',
+    'error InsufficientAmount()',
+    'error InsufficientAmountA()',
+    'error InsufficientAmountB()',
+    'error InsufficientAmountADesired()',
+    'error InsufficientAmountBDesired()',
+    'error InsufficientAmountAOptimal()',
+    'error InsufficientLiquidity()',
+    'error InsufficientOutputAmount()',
+    'error InvalidAmountInForETHDeposit()',
+    'error InvalidTokenInForETHDeposit()',
+    'error InvalidPath()',
+    'error InvalidRouteA()',
+    'error InvalidRouteB()',
+    'error OnlyWETH()',
+    'error PoolDoesNotExist()',
+    'error PoolFactoryDoesNotExist()',
+    'error SameAddresses()',
+    'error ZeroAddress()',
+    'error FXMarketClosed()',
+]);

package/dist/esm/core/abis/sortedTroves.js

@@ -0,0 +1,11 @@
+import { parseAbi } from 'viem';
+export const SORTED_TROVES_ABI = parseAbi([
+    'function findInsertPosition(uint256 _annualInterestRate, uint256 _prevId, uint256 _nextId) view returns (uint256, uint256)',
+    'function getSize() view returns (uint256)',
+    'function getFirst() view returns (uint256)',
+    'function getLast() view returns (uint256)',
+    'function getNext(uint256 _id) view returns (uint256)',
+    'function getPrev(uint256 _id) view returns (uint256)',
+    'function contains(uint256 _id) view returns (bool)',
+    'function isEmpty() view returns (bool)',
+]);

package/dist/esm/core/abis/systemParams.js

@@ -0,0 +1,10 @@
+import { parseAbi } from 'viem';
+export const SYSTEM_PARAMS_ABI = parseAbi([
+    'function CCR() view returns (uint256)',
+    'function MCR() view returns (uint256)',
+    'function SCR() view returns (uint256)',
+    'function BCR() view returns (uint256)',
+    'function MIN_DEBT() view returns (uint256)',
+    'function ETH_GAS_COMPENSATION() view returns (uint256)',
+    'function MIN_ANNUAL_INTEREST_RATE() view returns (uint256)',
+]);

package/dist/esm/core/abis/troveManager.js

@@ -0,0 +1,23 @@
+import { parseAbi } from 'viem';
+export const TROVE_MANAGER_ABI = parseAbi([
+    'function getLatestTroveData(uint256 _troveId) view returns ((uint256 entireDebt, uint256 entireColl, uint256 redistBoldDebtGain, uint256 redistCollGain, uint256 accruedInterest, uint256 recordedDebt, uint256 annualInterestRate, uint256 weightedRecordedDebt, uint256 accruedBatchManagementFee, uint256 lastInterestRateAdjTime))',
+    'function getTroveStatus(uint256 _troveId) view returns (uint8)',
+    'function getTroveAnnualInterestRate(uint256 _troveId) view returns (uint256)',
+    'function Troves(uint256 _id) view returns (uint256 debt, uint256 coll, uint256 stake, uint8 status, uint64 arrayIndex, uint64 lastDebtUpdateTime, uint64 lastInterestRateAdjTime, uint256 annualInterestRate, address interestBatchManager, uint256 batchDebtShares)',
+    'function getCurrentICR(uint256 _troveId, uint256 _price) view returns (uint256)',
+    'function getTroveIdsCount() view returns (uint256)',
+    'function getTroveFromTroveIdsArray(uint256 _index) view returns (uint256)',
+    'function shutdownTime() view returns (uint256)',
+    // Custom errors
+    'error EmptyData()',
+    'error NothingToLiquidate()',
+    'error CallerNotBorrowerOperations()',
+    'error CallerNotCollateralRegistry()',
+    'error OnlyOneTroveLeft()',
+    'error NotShutDown()',
+    'error ZeroAmount()',
+    'error NotEnoughBoldBalance()',
+    'error MinCollNotReached(uint256 _coll)',
+    'error BatchSharesRatioTooHigh()',
+    'error L2SequencerDown()',
+]);

package/dist/esm/core/abis/troveNFT.js

@@ -0,0 +1,5 @@
+import { parseAbi } from 'viem';
+export const TROVE_NFT_ABI = parseAbi([
+    'function balanceOf(address owner) view returns (uint256)',
+    'function ownerOf(uint256 tokenId) view returns (address)',
+]);

package/dist/esm/core/abis/virtualPool.js

@@ -0,0 +1,7 @@
+import { parseAbi } from 'viem';
+export const VIRTUAL_POOL_ABI = 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)',
+]);

package/dist/esm/core/abis/virtualPoolFactory.js

@@ -0,0 +1,13 @@
+import { parseAbi } from 'viem';
+export const VIRTUAL_POOL_FACTORY_ABI = 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()',
+]);

package/dist/esm/core/constants/addresses.js

@@ -0,0 +1,107 @@
+import { ChainId } from './chainId';
+export const addresses = {
+    [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.MONAD_TESTNET]: {
+        BreakerBox: '0x88869E30609D2C0E4032463D713328C6f541878e',
+        MedianDeltaBreaker: '0xf923C884F319b8866F67C5719A80E5cB4D0FAF2c',
+        SortedOracles: '0x85ed9ac57827132B8F60938F3165BC139E1F53cd',
+        ValueDeltaBreaker: '0xbbD0D093F5F11D16D4456FBd6229c9a3b70B8Aaf',
+        Reserve: '0xbCdc1D0b92DfceEaa0FcD0a0D53355F4bF1DB8a7',
+        StableToken: '0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc', // USDm
+        FPMMFactory: '0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980',
+        Router: '0xcf6cD45210b3ffE3cA28379C4683F1e60D0C2CCd',
+        ReserveLiquidityStrategy: '0x734bb3251Ec3f1A83f8f2A8609bcEF649D54EbF8',
+        OpenLiquidityStrategy: '0xCCd2aD0603a08EBc14D223a983171ef18192e8c9',
+    },
+    [ChainId.MONAD]: {
+        BreakerBox: '0x9fc1E0d10fb38954Da385B8B25aB2BbaF3241722',
+        MedianDeltaBreaker: '0x3E4F2Bca4f7192Be4C3c5E5bD4840F2E90a8Ba84',
+        SortedOracles: '0x6f92C745346057a61b259579256159458a0a6A92',
+        ValueDeltaBreaker: '0xca2e7563dfC30bc94687F3deAcF682E1dBAffA13',
+        Reserve: '0x4255Cf38e51516766180b33122029A88Cb853806',
+        StableToken: '0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115', // USDm
+        FPMMFactory: '0xa849b475FE5a4B5C9C3280152c7a1945b907613b',
+        Router: '0x4861840C2EfB2b98312B0aE34d86fD73E8f9B6f6',
+        ReserveLiquidityStrategy: '0xa0fB8b16ce6AF3634fF9F3f4F40E49E1C1ae4f0B',
+        OpenLiquidityStrategy: '0x54e2Ae8c8448912E17cE0b2453bAFB7B0D80E40f',
+    },
+    [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.
+ */
+export function tryGetContractAddress(chainId, contractName) {
+    const addressesForChain = 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
+ */
+export 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;
+}

package/dist/esm/core/constants/borrowConstants.js

@@ -0,0 +1,12 @@
+// Compile-time constants from Constants.sol
+export const MAX_ANNUAL_INTEREST_RATE = 2500000000000000000n; // 250%
+export const UPFRONT_INTEREST_PERIOD = 604800; // 7 days in seconds
+export const INTEREST_RATE_ADJ_COOLDOWN = 604800; // 7 days in seconds
+// UI-level constants from Bold frontend (constants.ts)
+export const MAX_LTV_ALLOWED_RATIO = 916n; // 91.6% (per-mille)
+export const LTV_RISK_MEDIUM = 540n; // 54% of maxLtv
+export const LTV_RISK_HIGH = 730n; // 73% of maxLtv
+export const REDEMPTION_RISK_MEDIUM = 50n; // 5% of total debt
+export const REDEMPTION_RISK_LOW = 600n; // 60% of total debt
+// Single branch index for Mento
+export const COLL_INDEX = 0n;

package/dist/esm/core/constants/borrowRegistries.js

@@ -0,0 +1,29 @@
+import { ChainId } from './chainId';
+/**
+ * Known AddressesRegistry contracts per chain, keyed by debt token symbol.
+ * Each registry is the entry point for one Bold deployment.
+ */
+export const borrowRegistries = {
+    [ChainId.CELO]: {
+        GBPm: '0xB3136DBadB14Ab587FFa91545538126938Fe0C6E',
+        CHFm: '0xCa70801D91576d069190d1D4CFDDEbdc237A4537',
+        JPYm: '0x8f99Aac2FE09A1390617D4AcDD1519f775eE931A',
+    },
+    [ChainId.CELO_SEPOLIA]: {
+        GBPm: '0x8b33D626E8d79388889d404fBC515Ed131c9508e',
+        CHFm: '0x1e3CCCC62cEBd9Bf2a26Ba512E3abee086816c58',
+        JPYm: '0x812e5ccEC5E55B81F4270898FDF1C916e3a284Fb',
+    },
+};
+export function getBorrowRegistry(chainId, debtTokenSymbol) {
+    const registries = 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;
+}

package/dist/esm/core/constants/chainId.js

@@ -0,0 +1,7 @@
+export var ChainId;
+(function (ChainId) {
+    ChainId[ChainId["CELO"] = 42220] = "CELO";
+    ChainId[ChainId["CELO_SEPOLIA"] = 11142220] = "CELO_SEPOLIA";
+    ChainId[ChainId["MONAD_TESTNET"] = 10143] = "MONAD_TESTNET";
+    ChainId[ChainId["MONAD"] = 143] = "MONAD";
+})(ChainId || (ChainId = {}));

package/dist/esm/core/constants/contractNames.js

@@ -0,0 +1,20 @@
+export const GOVERNANCEFACTORY = 'GovernanceFactory';
+export const AIRGRAB = 'Airgrab';
+export const EMISSION = 'Emission';
+export const MENTOGOVERNOR = 'MentoGovernor';
+export const MENTOTOKEN = 'MentoToken';
+export const TIMELOCKCONTROLLER = 'TimelockController';
+export const LOCKING = 'Locking';
+export const BROKER = 'Broker';
+export const BIPOOLMANAGER = 'BiPoolManager';
+export const BREAKERBOX = 'BreakerBox';
+export const RESERVE = 'Reserve';
+export const CONSTANTSUM = 'ConstantSumPricingModule';
+export const CONSTANTPRODUCT = 'ConstantProductPricingModule';
+export const MEDIANDELTA = 'MedianDeltaBreaker';
+export const VALUEDELTA = 'ValueDeltaBreaker';
+export const STABLETOKEN = 'StableToken';
+export const STABLETOKNEUR = 'StableTokenEUR';
+export const STABLETOKENBRL = 'StableTokenBRL';
+export const STABLETOKENXOF = 'StableTokenXOF';
+export const SORTEDORACLES = 'SortedOracles';

package/dist/esm/core/constants/index.js

@@ -0,0 +1,5 @@
+export * from './addresses';
+export * from './chainId';
+export * from './contractNames';
+export * from './borrowConstants';
+export * from './borrowRegistries';

package/dist/esm/core/errors/base.js

@@ -0,0 +1,12 @@
+/**
+ * Base error class for all Mento SDK errors.
+ * Provides consistent error naming and proper prototype chain setup.
+ */
+export 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);
+    }
+}

package/dist/esm/core/errors/index.js

@@ -0,0 +1,3 @@
+export * from './base';
+export * from './oracle';
+export * from './router';

package/dist/esm/core/errors/oracle.js

@@ -0,0 +1,10 @@
+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 class FXMarketClosedError extends MentoError {
+    constructor() {
+        super('FX market is currently closed. Swap quotes are unavailable until the market reopens.');
+    }
+}

package/dist/esm/core/errors/router.js

@@ -0,0 +1,18 @@
+import { MentoError } from './base';
+/**
+ * Error thrown when no tradable route exists between two tokens.
+ */
+export class RouteNotFoundError extends MentoError {
+    constructor(tokenIn, tokenOut) {
+        super(`No route found for tokens ${tokenIn} and ${tokenOut}. They may not have a tradable path.`);
+    }
+}
+/**
+ * Error thrown when no executable zap-out route exists for the requested amount.
+ */
+export class ZapOutRouteNotViableError extends 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.');
+    }
+}

package/dist/esm/core/types/borrow.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/types/contractAddresses.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/types/index.js

@@ -0,0 +1,9 @@
+export * from './contractAddresses';
+export * from './transaction';
+export * from './token';
+export * from './route';
+export * from './pool';
+export * from './tradingMode';
+export * from './tradingLimits';
+export * from './liquidity';
+export * from './borrow';

package/dist/esm/core/types/liquidity.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/types/pool.js

@@ -0,0 +1,10 @@
+/**
+ * Types of liquidity pools supported in the Mento protocol
+ */
+export var PoolType;
+(function (PoolType) {
+    /** FPMM (Fixed Product Market Maker) pools - v3 native pools */
+    PoolType["FPMM"] = "FPMM";
+    /** Virtual pools - wrapper around v2 BiPoolManager exchanges */
+    PoolType["Virtual"] = "Virtual";
+})(PoolType || (PoolType = {}));

package/dist/esm/core/types/provider.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/types/route.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/types/token.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/types/tradingLimits.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/types/tradingMode.js

@@ -0,0 +1,26 @@
+/**
+ * Trading modes for rate feeds in the BreakerBox circuit breaker.
+ *
+ * The BreakerBox uses a bitmask approach where multiple breakers can
+ * contribute to the final trading mode. In practice:
+ * - 0 = Bidirectional (trading enabled)
+ * - Any non-zero value = Trading suspended
+ *
+ * For SDK consumers, use isTradingEnabled() helper to check if trading
+ * is allowed.
+ */
+export var TradingMode;
+(function (TradingMode) {
+    /** Bidirectional trading is enabled (normal operation) */
+    TradingMode[TradingMode["BIDIRECTIONAL"] = 0] = "BIDIRECTIONAL";
+    /** Trading is suspended (circuit breaker tripped) - any non-zero value */
+    TradingMode[TradingMode["SUSPENDED"] = 1] = "SUSPENDED";
+})(TradingMode || (TradingMode = {}));
+/**
+ * Check if trading is enabled for a given trading mode.
+ * @param mode - The trading mode value from BreakerBox
+ * @returns true if trading is enabled (mode === 0)
+ */
+export function isTradingEnabled(mode) {
+    return mode === TradingMode.BIDIRECTIONAL;
+}

package/dist/esm/core/types/transaction.js

@@ -0,0 +1 @@
+export {};