@mento-protocol/mento-sdk 3.1.0-beta.5 → 3.1.0-beta.7

package/dist/cache/routes.js

@@ -1,6 +1,6 @@
 "use strict";
 // This file is auto-generated. Do not edit manually.
-// Generated on 2026-03-10T11:55:17.883Z
+// Generated on 2026-03-11T16:58:21.374Z
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cachedRoutes = void 0;
 exports.getCachedRoutes = getCachedRoutes;
@@ -10,7 +10,227 @@ exports.getCachedRoutes = getCachedRoutes;
  */
 exports.cachedRoutes = {
     // Chain 143
-    143: [],
+    143: [
+        {
+            "id": "USDC-USDm",
+            "tokens": [
+                {
+                    "address": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+                    "symbol": "USDC"
+                },
+                {
+                    "address": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "symbol": "USDm"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0xa849b475FE5a4B5C9C3280152c7a1945b907613b",
+                    "poolAddr": "0x463c0d1F04bcd99A1efCF94AC2a75bc19Ea4A7E5",
+                    "token0": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+                    "token1": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.05,
+                "hops": [
+                    {
+                        "poolAddress": "0x463c0d1F04bcd99A1efCF94AC2a75bc19Ea4A7E5",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        },
+        {
+            "id": "AUSD-USDm",
+            "tokens": [
+                {
+                    "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+                    "symbol": "AUSD"
+                },
+                {
+                    "address": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "symbol": "USDm"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0xa849b475FE5a4B5C9C3280152c7a1945b907613b",
+                    "poolAddr": "0xb0a0264Ce6847F101b76ba36A4a3083ba489F501",
+                    "token0": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+                    "token1": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.05,
+                "hops": [
+                    {
+                        "poolAddress": "0xb0a0264Ce6847F101b76ba36A4a3083ba489F501",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        },
+        {
+            "id": "AUSD-USDC",
+            "tokens": [
+                {
+                    "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+                    "symbol": "AUSD"
+                },
+                {
+                    "address": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+                    "symbol": "USDC"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0xa849b475FE5a4B5C9C3280152c7a1945b907613b",
+                    "poolAddr": "0x463c0d1F04bcd99A1efCF94AC2a75bc19Ea4A7E5",
+                    "token0": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+                    "token1": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "poolType": "FPMM"
+                },
+                {
+                    "factoryAddr": "0xa849b475FE5a4B5C9C3280152c7a1945b907613b",
+                    "poolAddr": "0xb0a0264Ce6847F101b76ba36A4a3083ba489F501",
+                    "token0": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+                    "token1": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.099975,
+                "hops": [
+                    {
+                        "poolAddress": "0x463c0d1F04bcd99A1efCF94AC2a75bc19Ea4A7E5",
+                        "costPercent": 0.05
+                    },
+                    {
+                        "poolAddress": "0xb0a0264Ce6847F101b76ba36A4a3083ba489F501",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        },
+        {
+            "id": "GBPm-USDm",
+            "tokens": [
+                {
+                    "address": "0x39bb4E0a204412bB98e821d25e7d955e69d40Fd1",
+                    "symbol": "GBPm"
+                },
+                {
+                    "address": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "symbol": "USDm"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0xa849b475FE5a4B5C9C3280152c7a1945b907613b",
+                    "poolAddr": "0xD0E9c1a718D2a693d41eacd4B2696180403Ce081",
+                    "token0": "0x39bb4E0a204412bB98e821d25e7d955e69d40Fd1",
+                    "token1": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.15,
+                "hops": [
+                    {
+                        "poolAddress": "0xD0E9c1a718D2a693d41eacd4B2696180403Ce081",
+                        "costPercent": 0.15
+                    }
+                ]
+            }
+        },
+        {
+            "id": "GBPm-USDC",
+            "tokens": [
+                {
+                    "address": "0x39bb4E0a204412bB98e821d25e7d955e69d40Fd1",
+                    "symbol": "GBPm"
+                },
+                {
+                    "address": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+                    "symbol": "USDC"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0xa849b475FE5a4B5C9C3280152c7a1945b907613b",
+                    "poolAddr": "0xD0E9c1a718D2a693d41eacd4B2696180403Ce081",
+                    "token0": "0x39bb4E0a204412bB98e821d25e7d955e69d40Fd1",
+                    "token1": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "poolType": "FPMM"
+                },
+                {
+                    "factoryAddr": "0xa849b475FE5a4B5C9C3280152c7a1945b907613b",
+                    "poolAddr": "0x463c0d1F04bcd99A1efCF94AC2a75bc19Ea4A7E5",
+                    "token0": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+                    "token1": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.199925,
+                "hops": [
+                    {
+                        "poolAddress": "0xD0E9c1a718D2a693d41eacd4B2696180403Ce081",
+                        "costPercent": 0.15
+                    },
+                    {
+                        "poolAddress": "0x463c0d1F04bcd99A1efCF94AC2a75bc19Ea4A7E5",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        },
+        {
+            "id": "AUSD-GBPm",
+            "tokens": [
+                {
+                    "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+                    "symbol": "AUSD"
+                },
+                {
+                    "address": "0x39bb4E0a204412bB98e821d25e7d955e69d40Fd1",
+                    "symbol": "GBPm"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0xa849b475FE5a4B5C9C3280152c7a1945b907613b",
+                    "poolAddr": "0xD0E9c1a718D2a693d41eacd4B2696180403Ce081",
+                    "token0": "0x39bb4E0a204412bB98e821d25e7d955e69d40Fd1",
+                    "token1": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "poolType": "FPMM"
+                },
+                {
+                    "factoryAddr": "0xa849b475FE5a4B5C9C3280152c7a1945b907613b",
+                    "poolAddr": "0xb0a0264Ce6847F101b76ba36A4a3083ba489F501",
+                    "token0": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+                    "token1": "0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.199925,
+                "hops": [
+                    {
+                        "poolAddress": "0xD0E9c1a718D2a693d41eacd4B2696180403Ce081",
+                        "costPercent": 0.15
+                    },
+                    {
+                        "poolAddress": "0xb0a0264Ce6847F101b76ba36A4a3083ba489F501",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        }
+    ],
     // Chain 10143
     10143: [
         {

package/dist/cache/tokens.js

@@ -1,6 +1,6 @@
 "use strict";
 // This file is auto-generated. Do not edit manually.
-// Generated on 2026-03-10T14:45:05.132Z
+// Generated on 2026-03-11T16:57:52.465Z
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TOKEN_ADDRESSES_BY_CHAIN = exports.cachedTokens = exports.TokenSymbol = void 0;
 exports.getCachedTokens = getCachedTokens;
@@ -36,7 +36,32 @@ var TokenSymbol;
  */
 exports.cachedTokens = {
     // Chain 143
-    143: [],
+    143: [
+        {
+            address: '0x39bb4E0a204412bB98e821d25e7d955e69d40Fd1',
+            symbol: TokenSymbol.GBPm,
+            name: 'Mento British Pound',
+            decimals: 18,
+        },
+        {
+            address: '0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115',
+            symbol: TokenSymbol.USDm,
+            name: 'Mento Dollar',
+            decimals: 18,
+        },
+        {
+            address: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',
+            symbol: TokenSymbol.USDC,
+            name: 'USDC',
+            decimals: 6,
+        },
+        {
+            address: '0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a',
+            symbol: TokenSymbol.AUSD,
+            name: 'AUSD',
+            decimals: 6,
+        }
+    ],
     // Chain 10143
     10143: [
         {
@@ -280,7 +305,12 @@ exports.cachedTokens = {
  * Useful for quickly looking up a token address by its symbol on a specific chain
  */
 exports.TOKEN_ADDRESSES_BY_CHAIN = {
-    143: {},
+    143: {
+        [TokenSymbol.GBPm]: '0x39bb4E0a204412bB98e821d25e7d955e69d40Fd1',
+        [TokenSymbol.USDm]: '0xBC69212B8E4d445b2307C9D32dD68E2A4Df00115',
+        [TokenSymbol.USDC]: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',
+        [TokenSymbol.AUSD]: '0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a',
+    },
     10143: {
         [TokenSymbol.GBPm]: '0x04de554E875c9797dC4ceBd834A9e99fa8fD5Df9',
         [TokenSymbol.USDm]: '0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc',

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

@@ -18,4 +18,5 @@ export * from './troveNFT';
 export * from './priceFeed';
 export * from './addressesRegistry';
 export * from './systemParams';
+export * from './liquidityStrategy';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/abis/index.js

@@ -34,4 +34,5 @@ __exportStar(require("./troveNFT"), exports);
 __exportStar(require("./priceFeed"), exports);
 __exportStar(require("./addressesRegistry"), exports);
 __exportStar(require("./systemParams"), exports);
+__exportStar(require("./liquidityStrategy"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,132 @@
+export declare const LIQUIDITY_STRATEGY_ABI: readonly [{
+    readonly name: "poolConfigs";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+        readonly name: "isToken0Debt";
+    }, {
+        readonly type: "uint32";
+        readonly name: "lastRebalance";
+    }, {
+        readonly type: "uint32";
+        readonly name: "rebalanceCooldown";
+    }, {
+        readonly type: "address";
+        readonly name: "protocolFeeRecipient";
+    }, {
+        readonly type: "uint64";
+        readonly name: "liquiditySourceIncentiveExpansion";
+    }, {
+        readonly type: "uint64";
+        readonly name: "protocolIncentiveExpansion";
+    }, {
+        readonly type: "uint64";
+        readonly name: "liquiditySourceIncentiveContraction";
+    }, {
+        readonly type: "uint64";
+        readonly name: "protocolIncentiveContraction";
+    }];
+}, {
+    readonly name: "determineAction";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "pool";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "address";
+            readonly name: "pool";
+        }, {
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly type: "uint256";
+                readonly name: "reserveNum";
+            }, {
+                readonly type: "uint256";
+                readonly name: "reserveDen";
+            }];
+            readonly name: "reserves";
+        }, {
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly type: "uint256";
+                readonly name: "oracleNum";
+            }, {
+                readonly type: "uint256";
+                readonly name: "oracleDen";
+            }, {
+                readonly type: "bool";
+                readonly name: "poolPriceAbove";
+            }, {
+                readonly type: "uint16";
+                readonly name: "rebalanceThreshold";
+            }];
+            readonly name: "prices";
+        }, {
+            readonly type: "address";
+            readonly name: "token0";
+        }, {
+            readonly type: "address";
+            readonly name: "token1";
+        }, {
+            readonly type: "uint64";
+            readonly name: "token0Dec";
+        }, {
+            readonly type: "uint64";
+            readonly name: "token1Dec";
+        }, {
+            readonly type: "bool";
+            readonly name: "isToken0Debt";
+        }, {
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly type: "uint64";
+                readonly name: "liquiditySourceIncentiveExpansion";
+            }, {
+                readonly type: "uint64";
+                readonly name: "protocolIncentiveExpansion";
+            }, {
+                readonly type: "uint64";
+                readonly name: "liquiditySourceIncentiveContraction";
+            }, {
+                readonly type: "uint64";
+                readonly name: "protocolIncentiveContraction";
+            }];
+            readonly name: "incentives";
+        }];
+        readonly name: "ctx";
+    }, {
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "uint8";
+            readonly name: "dir";
+        }, {
+            readonly type: "uint256";
+            readonly name: "amount0Out";
+        }, {
+            readonly type: "uint256";
+            readonly name: "amount1Out";
+        }, {
+            readonly type: "uint256";
+            readonly name: "amountOwedToPool";
+        }];
+        readonly name: "action";
+    }];
+}, {
+    readonly name: "rebalance";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "pool";
+    }];
+    readonly outputs: readonly [];
+}];
+//# sourceMappingURL=liquidityStrategy.d.ts.map

package/dist/core/abis/liquidityStrategy.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIQUIDITY_STRATEGY_ABI = void 0;
+const viem_1 = require("viem");
+exports.LIQUIDITY_STRATEGY_ABI = (0, viem_1.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)',
+]);
+//# sourceMappingURL=liquidityStrategy.js.map

package/dist/core/constants/addresses.js

@@ -44,8 +44,20 @@ exports.addresses = {
         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.MONAD]: {},
     [chainId_1.ChainId.CELO_SEPOLIA]: {
         // Oracles & Breakers
         BreakerBox: '0x578bD46003B9D3fd4c3C3f47c98B329562a6a1dE',

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

@@ -30,6 +30,7 @@ export type ContractAddresses = {
     Router?: string;
     ReserveLiquidityStrategy?: string;
     CDPLiquidityStrategy?: string;
+    OpenLiquidityStrategy?: string;
 };
 /**
  * Map of chain IDs to their contract addresses.

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

@@ -1,4 +1,5 @@
 import { CallParams } from './transaction';
+import { LiquidityStrategyDirection } from './pool';
 import { RouterRoute } from '../../utils/pathEncoder';
 export interface LiquidityOptions {
     slippageTolerance: number;
@@ -114,6 +115,25 @@ export interface ZapOutTransaction {
     approval: TokenApproval | null;
     zapOut: ZapOutDetails;
 }
+export interface RebalanceDetails {
+    params: CallParams;
+    poolAddress: string;
+    strategyAddress: string;
+    inputToken: string;
+    outputToken: string;
+    amountRequired: bigint;
+    expectedAmountTransferred: bigint;
+    expectedProtocolIncentive: bigint;
+    expectedLiquiditySourceIncentive: bigint;
+    approvalToken: string;
+    approvalSpender: string;
+    approvalAmount: bigint;
+    direction: LiquidityStrategyDirection;
+}
+export interface RebalanceTransaction {
+    approval: TokenApproval | null;
+    rebalance: RebalanceDetails;
+}
 export interface PreparedZapIn {
     routesA: RouterRoute[];
     routesB: RouterRoute[];
@@ -168,4 +188,7 @@ export interface ZapOutInput {
 export interface PrepareZapOutInput extends ZapOutInput {
     owner?: string;
 }
+export interface RebalanceInput {
+    poolAddress: string;
+}
 //# sourceMappingURL=liquidity.d.ts.map

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

@@ -92,9 +92,72 @@ export interface FPMMRebalancing {
     rebalanceThresholdBelowPercent: number;
     /** Whether the current price is within rebalancing thresholds (null when pricing unavailable) */
     inBand: boolean | null;
-    /** The active liquidity strategy address for this pool, or null if none */
+    /** The registered Open Liquidity Strategy address for this pool, or null if none */
     liquidityStrategy: string | null;
 }
+export type LiquidityStrategyDirection = 'Expand' | 'Contract';
+export interface LiquidityStrategyRebalanceIncentives {
+    liquiditySourceIncentiveExpansion: bigint;
+    protocolIncentiveExpansion: bigint;
+    liquiditySourceIncentiveContraction: bigint;
+    protocolIncentiveContraction: bigint;
+}
+export interface LiquidityStrategyPoolConfig {
+    isToken0Debt: boolean;
+    lastRebalance: number;
+    rebalanceCooldown: number;
+    protocolFeeRecipient: string;
+    liquiditySourceIncentiveExpansion: bigint;
+    protocolIncentiveExpansion: bigint;
+    liquiditySourceIncentiveContraction: bigint;
+    protocolIncentiveContraction: bigint;
+}
+export interface LiquidityStrategyContext {
+    pool: string;
+    reserves: {
+        reserveNum: bigint;
+        reserveDen: bigint;
+    };
+    prices: {
+        oracleNum: bigint;
+        oracleDen: bigint;
+        poolPriceAbove: boolean;
+        rebalanceThreshold: number;
+    };
+    token0: string;
+    token1: string;
+    token0Dec: bigint;
+    token1Dec: bigint;
+    isToken0Debt: boolean;
+    incentives: LiquidityStrategyRebalanceIncentives;
+}
+export interface LiquidityStrategyAction {
+    dir: LiquidityStrategyDirection;
+    amount0Out: bigint;
+    amount1Out: bigint;
+    amountOwedToPool: bigint;
+}
+export interface PoolRebalanceTokenAmount {
+    token: string;
+    amount: bigint;
+}
+export interface PoolRebalancePreview {
+    poolAddress: string;
+    strategyAddress: string;
+    direction: LiquidityStrategyDirection;
+    config: LiquidityStrategyPoolConfig;
+    context: LiquidityStrategyContext;
+    action: LiquidityStrategyAction;
+    inputToken: string;
+    outputToken: string;
+    amountRequired: PoolRebalanceTokenAmount;
+    amountTransferred: PoolRebalanceTokenAmount;
+    protocolIncentive: PoolRebalanceTokenAmount;
+    liquiditySourceIncentive: PoolRebalanceTokenAmount;
+    approvalToken: string;
+    approvalSpender: string;
+    approvalAmount: bigint;
+}
 /**
  * Enriched details for an FPMM pool including pricing, fees, and rebalancing state
  */