@mento-protocol/mento-sdk 3.2.7 → 3.3.0-beta.0

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

@@ -0,0 +1,85 @@
+import { parseAbi } from 'viem';
+/**
+ * BorrowerOperations ABI for Bold protocol trove 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 BORROWER_OPERATIONS_ABI = parseAbi([
+    // Core trove operations
+    'function openTrove(address _owner, uint256 _ownerIndex, uint256 _ETHAmount, uint256 _boldAmount, uint256 _upperHint, uint256 _lowerHint, uint256 _annualInterestRate, uint256 _maxUpfrontFee, address _addManager, address _removeManager, address _receiver) returns (uint256)',
+    'function openTroveAndJoinInterestBatchManager((address owner, uint256 ownerIndex, uint256 collAmount, uint256 boldAmount, uint256 upperHint, uint256 lowerHint, address interestBatchManager, uint256 maxUpfrontFee, address addManager, address removeManager, address receiver) _params) returns (uint256)',
+    'function addColl(uint256 _troveId, uint256 _ETHAmount)',
+    'function withdrawColl(uint256 _troveId, uint256 _amount)',
+    'function withdrawBold(uint256 _troveId, uint256 _amount, uint256 _maxUpfrontFee)',
+    'function repayBold(uint256 _troveId, uint256 _amount)',
+    'function closeTrove(uint256 _troveId)',
+    'function adjustTrove(uint256 _troveId, uint256 _collChange, bool _isCollIncrease, uint256 _debtChange, bool isDebtIncrease, uint256 _maxUpfrontFee)',
+    'function adjustZombieTrove(uint256 _troveId, uint256 _collChange, bool _isCollIncrease, uint256 _boldChange, bool _isDebtIncrease, uint256 _upperHint, uint256 _lowerHint, uint256 _maxUpfrontFee)',
+    'function adjustTroveInterestRate(uint256 _troveId, uint256 _newAnnualInterestRate, uint256 _upperHint, uint256 _lowerHint, uint256 _maxUpfrontFee)',
+    'function applyPendingDebt(uint256 _troveId, uint256 _lowerHint, uint256 _upperHint)',
+    'function claimCollateral()',
+    // Batch manager operations
+    'function setInterestBatchManager(uint256 _troveId, address _newBatchManager, uint256 _upperHint, uint256 _lowerHint, uint256 _maxUpfrontFee)',
+    'function removeFromBatch(uint256 _troveId, uint256 _newAnnualInterestRate, uint256 _upperHint, uint256 _lowerHint, uint256 _maxUpfrontFee)',
+    'function switchBatchManager(uint256 _troveId, uint256 _removeUpperHint, uint256 _removeLowerHint, address _newBatchManager, uint256 _addUpperHint, uint256 _addLowerHint, uint256 _maxUpfrontFee)',
+    // Individual delegate
+    'function setInterestIndividualDelegate(uint256 _troveId, address _delegate, uint128 _minInterestRate, uint128 _maxInterestRate, uint256 _newAnnualInterestRate, uint256 _upperHint, uint256 _lowerHint, uint256 _maxUpfrontFee, uint256 _minInterestRateChangePeriod)',
+    'function removeInterestIndividualDelegate(uint256 _troveId)',
+    // View functions
+    'function hasBeenShutDown() view returns (bool)',
+    'function interestBatchManagerOf(uint256 _troveId) view returns (address)',
+    'function getInterestBatchManager(address _account) view returns ((uint128 minInterestRate, uint128 maxInterestRate, uint256 minInterestRateChangePeriod))',
+    'function checkBatchManagerExists(address _batchManager) view returns (bool)',
+    'function getInterestIndividualDelegateOf(uint256 _troveId) view returns ((address account, uint128 minInterestRate, uint128 maxInterestRate, uint256 minInterestRateChangePeriod))',
+    // Inherited view functions from LiquityBase
+    'function getEntireBranchDebt() view returns (uint256)',
+    'function getEntireBranchColl() view returns (uint256)',
+    'function systemParams() view returns (address)',
+    'function CCR() view returns (uint256)',
+    'function MCR() view returns (uint256)',
+    // Custom errors (BorrowerOperations.sol)
+    'error IsShutDown()',
+    'error TCRNotBelowSCR()',
+    'error ZeroAdjustment()',
+    'error NotOwnerNorInterestManager()',
+    'error TroveInBatch()',
+    'error TroveNotInBatch()',
+    'error InterestNotInRange()',
+    'error BatchInterestRateChangePeriodNotPassed()',
+    'error DelegateInterestRateChangePeriodNotPassed()',
+    'error TroveExists()',
+    'error TroveNotOpen()',
+    'error TroveNotActive()',
+    'error TroveNotZombie()',
+    'error TroveWithZeroDebt()',
+    'error UpfrontFeeTooHigh()',
+    'error ICRBelowMCR()',
+    'error ICRBelowMCRPlusBCR()',
+    'error RepaymentNotMatchingCollWithdrawal()',
+    'error TCRBelowCCR()',
+    'error DebtBelowMin()',
+    'error CollWithdrawalTooHigh()',
+    'error NotEnoughBoldBalance()',
+    'error InterestRateTooLow()',
+    'error InterestRateTooHigh()',
+    'error InterestRateNotNew()',
+    'error InvalidInterestBatchManager()',
+    'error BatchManagerExists()',
+    'error BatchManagerNotNew()',
+    'error NewFeeNotLower()',
+    'error CallerNotTroveManager()',
+    'error CallerNotPriceFeed()',
+    'error CallerNotSelf()',
+    'error MinGeMax()',
+    'error AnnualManagementFeeTooHigh()',
+    'error MinInterestRateChangePeriodTooLow()',
+    'error NewOracleFailureDetected()',
+    'error BatchSharesRatioTooLow()',
+    // Custom errors (inherited from AddRemoveManagers)
+    'error EmptyManager()',
+    'error NotBorrower()',
+    'error NotOwnerNorAddManager()',
+    'error NotOwnerNorRemoveManager()',
+]);

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

@@ -0,0 +1,4 @@
+import { parseAbi } from 'viem';
+export const BREAKERBOX_ABI = parseAbi([
+    'function getRateFeedTradingMode(address rateFeedID) view returns (uint8)',
+]);

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

@@ -0,0 +1,5 @@
+import { parseAbi } from 'viem';
+export const BROKER_ABI = parseAbi([
+    'function tradingLimitsConfig(bytes32) view returns (uint32 timestep0, uint32 timestep1, int48 limit0, int48 limit1, int48 limitGlobal, uint8 flags)',
+    'function tradingLimitsState(bytes32) view returns (uint32 lastUpdated0, uint32 lastUpdated1, int48 netflow0, int48 netflow1, int48 netflowGlobal)',
+]);

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,119 @@
+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.POLYGON_AMOY]: {
+        BreakerBox: '0x88869E30609D2C0E4032463D713328C6f541878e',
+        MedianDeltaBreaker: '0xf923C884F319b8866F67C5719A80E5cB4D0FAF2c',
+        SortedOracles: '0x85ed9ac57827132B8F60938F3165BC139E1F53cd',
+        ValueDeltaBreaker: '0xbbD0D093F5F11D16D4456FBd6229c9a3b70B8Aaf',
+        Reserve: '0xbCdc1D0b92DfceEaa0FcD0a0D53355F4bF1DB8a7',
+        StableToken: '0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc', // USDm
+        FPMMFactory: '0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980',
+        Router: '0xcf6cD45210b3ffE3cA28379C4683F1e60D0C2CCd',
+        ReserveLiquidityStrategy: '0x734bb3251Ec3f1A83f8f2A8609bcEF649D54EbF8',
+        OpenLiquidityStrategy: '0xCCd2aD0603a08EBc14D223a983171ef18192e8c9',
+    },
+    [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,8 @@
+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["POLYGON_AMOY"] = 80002] = "POLYGON_AMOY";
+})(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.');
+    }
+}