@mento-protocol/mento-sdk 3.0.0 → 3.1.0-beta.0

package/dist/esm/cache/routes.js

@@ -1,10 +1,234 @@
 // This file is auto-generated. Do not edit manually.
-// Generated on 2026-03-03T20:21:39.044Z
+// Generated on 2026-03-10T11:55:17.883Z
 /**
  * Cached routes indexed by chain ID
  * Routes that don't exist for a chain will return an empty array
  */
 export const cachedRoutes = {
+    // Chain 143
+    143: [],
+    // Chain 10143
+    10143: [
+        {
+            "id": "USDC-USDm",
+            "tokens": [
+                {
+                    "address": "0x534b2f3A21130d7a60830c2Df862319e593943A3",
+                    "symbol": "USDC"
+                },
+                {
+                    "address": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "symbol": "USDm"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980",
+                    "poolAddr": "0x7109E0A9B4623e90755b7e5c4e10F089E5Bf8bDb",
+                    "token0": "0x534b2f3A21130d7a60830c2Df862319e593943A3",
+                    "token1": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.05,
+                "hops": [
+                    {
+                        "poolAddress": "0x7109E0A9B4623e90755b7e5c4e10F089E5Bf8bDb",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        },
+        {
+            "id": "AUSD-USDm",
+            "tokens": [
+                {
+                    "address": "0x502E67D3fE9302A5e4Ec1CFCDdbD6F34F9B9484B",
+                    "symbol": "AUSD"
+                },
+                {
+                    "address": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "symbol": "USDm"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980",
+                    "poolAddr": "0x52716E8F44E417bE8F573F8A85cA8eD3DAe1eAE1",
+                    "token0": "0x502E67D3fE9302A5e4Ec1CFCDdbD6F34F9B9484B",
+                    "token1": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.05,
+                "hops": [
+                    {
+                        "poolAddress": "0x52716E8F44E417bE8F573F8A85cA8eD3DAe1eAE1",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        },
+        {
+            "id": "AUSD-USDC",
+            "tokens": [
+                {
+                    "address": "0x502E67D3fE9302A5e4Ec1CFCDdbD6F34F9B9484B",
+                    "symbol": "AUSD"
+                },
+                {
+                    "address": "0x534b2f3A21130d7a60830c2Df862319e593943A3",
+                    "symbol": "USDC"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980",
+                    "poolAddr": "0x7109E0A9B4623e90755b7e5c4e10F089E5Bf8bDb",
+                    "token0": "0x534b2f3A21130d7a60830c2Df862319e593943A3",
+                    "token1": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "poolType": "FPMM"
+                },
+                {
+                    "factoryAddr": "0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980",
+                    "poolAddr": "0x52716E8F44E417bE8F573F8A85cA8eD3DAe1eAE1",
+                    "token0": "0x502E67D3fE9302A5e4Ec1CFCDdbD6F34F9B9484B",
+                    "token1": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.099975,
+                "hops": [
+                    {
+                        "poolAddress": "0x7109E0A9B4623e90755b7e5c4e10F089E5Bf8bDb",
+                        "costPercent": 0.05
+                    },
+                    {
+                        "poolAddress": "0x52716E8F44E417bE8F573F8A85cA8eD3DAe1eAE1",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        },
+        {
+            "id": "GBPm-USDm",
+            "tokens": [
+                {
+                    "address": "0x04de554E875c9797dC4ceBd834A9e99fa8fD5Df9",
+                    "symbol": "GBPm"
+                },
+                {
+                    "address": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "symbol": "USDm"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980",
+                    "poolAddr": "0x550D9EcB4C373510b8A41f5fB7D98E9E1c51A07e",
+                    "token0": "0x04de554E875c9797dC4ceBd834A9e99fa8fD5Df9",
+                    "token1": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.15,
+                "hops": [
+                    {
+                        "poolAddress": "0x550D9EcB4C373510b8A41f5fB7D98E9E1c51A07e",
+                        "costPercent": 0.15
+                    }
+                ]
+            }
+        },
+        {
+            "id": "GBPm-USDC",
+            "tokens": [
+                {
+                    "address": "0x04de554E875c9797dC4ceBd834A9e99fa8fD5Df9",
+                    "symbol": "GBPm"
+                },
+                {
+                    "address": "0x534b2f3A21130d7a60830c2Df862319e593943A3",
+                    "symbol": "USDC"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980",
+                    "poolAddr": "0x550D9EcB4C373510b8A41f5fB7D98E9E1c51A07e",
+                    "token0": "0x04de554E875c9797dC4ceBd834A9e99fa8fD5Df9",
+                    "token1": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "poolType": "FPMM"
+                },
+                {
+                    "factoryAddr": "0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980",
+                    "poolAddr": "0x7109E0A9B4623e90755b7e5c4e10F089E5Bf8bDb",
+                    "token0": "0x534b2f3A21130d7a60830c2Df862319e593943A3",
+                    "token1": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.199925,
+                "hops": [
+                    {
+                        "poolAddress": "0x550D9EcB4C373510b8A41f5fB7D98E9E1c51A07e",
+                        "costPercent": 0.15
+                    },
+                    {
+                        "poolAddress": "0x7109E0A9B4623e90755b7e5c4e10F089E5Bf8bDb",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        },
+        {
+            "id": "AUSD-GBPm",
+            "tokens": [
+                {
+                    "address": "0x502E67D3fE9302A5e4Ec1CFCDdbD6F34F9B9484B",
+                    "symbol": "AUSD"
+                },
+                {
+                    "address": "0x04de554E875c9797dC4ceBd834A9e99fa8fD5Df9",
+                    "symbol": "GBPm"
+                }
+            ],
+            "path": [
+                {
+                    "factoryAddr": "0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980",
+                    "poolAddr": "0x550D9EcB4C373510b8A41f5fB7D98E9E1c51A07e",
+                    "token0": "0x04de554E875c9797dC4ceBd834A9e99fa8fD5Df9",
+                    "token1": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "poolType": "FPMM"
+                },
+                {
+                    "factoryAddr": "0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980",
+                    "poolAddr": "0x52716E8F44E417bE8F573F8A85cA8eD3DAe1eAE1",
+                    "token0": "0x502E67D3fE9302A5e4Ec1CFCDdbD6F34F9B9484B",
+                    "token1": "0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc",
+                    "poolType": "FPMM"
+                }
+            ],
+            "costData": {
+                "totalCostPercent": 0.199925,
+                "hops": [
+                    {
+                        "poolAddress": "0x550D9EcB4C373510b8A41f5fB7D98E9E1c51A07e",
+                        "costPercent": 0.15
+                    },
+                    {
+                        "poolAddress": "0x52716E8F44E417bE8F573F8A85cA8eD3DAe1eAE1",
+                        "costPercent": 0.05
+                    }
+                ]
+            }
+        }
+    ],
     // Chain 42220
     42220: [
         {

package/dist/esm/cache/tokens.js

@@ -1,11 +1,12 @@
 // This file is auto-generated. Do not edit manually.
-// Generated on 2026-03-03T20:21:18.047Z
+// Generated on 2026-03-10T12:14:17.694Z
 /**
  * Enum of all token symbols across all supported chains
  */
 export var TokenSymbol;
 (function (TokenSymbol) {
     TokenSymbol["AUDm"] = "AUDm";
+    TokenSymbol["AUSD"] = "AUSD";
     TokenSymbol["BRLm"] = "BRLm";
     TokenSymbol["CADm"] = "CADm";
     TokenSymbol["CELO"] = "CELO";
@@ -30,6 +31,29 @@ export var TokenSymbol;
  * Cached tokens indexed by chain ID
  */
 export const cachedTokens = {
+    // Chain 143
+    143: [],
+    // Chain 10143
+    10143: [
+        {
+            address: '0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc',
+            symbol: TokenSymbol.USDm,
+            name: 'Mento Dollar',
+            decimals: 18,
+        },
+        {
+            address: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
+            symbol: TokenSymbol.USDC,
+            name: 'USDC',
+            decimals: 6,
+        },
+        {
+            address: '0x502E67D3fE9302A5e4Ec1CFCDdbD6F34F9B9484B',
+            symbol: TokenSymbol.AUSD,
+            name: 'Mento Mock AUSD',
+            decimals: 6,
+        }
+    ],
     // Chain 42220
     42220: [
         {
@@ -282,6 +306,12 @@ export const cachedTokens = {
  * Useful for quickly looking up a token address by its symbol on a specific chain
  */
 export const TOKEN_ADDRESSES_BY_CHAIN = {
+    143: {},
+    10143: {
+        [TokenSymbol.USDm]: '0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc',
+        [TokenSymbol.USDC]: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
+        [TokenSymbol.AUSD]: '0x502E67D3fE9302A5e4Ec1CFCDdbD6F34F9B9484B',
+    },
     42220: {
         [TokenSymbol.USDm]: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
         [TokenSymbol.EURm]: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',

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

@@ -1,6 +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/constants/addresses.js

@@ -29,6 +29,22 @@ export const addresses = {
         ReserveLiquidityStrategy: '0xa0fB8b16ce6AF3634fF9F3f4F40E49E1C1ae4f0B',
         CDPLiquidityStrategy: '0x4e78BD9565341EAbe99cDC024acB044d9BDcB985',
     },
+    [ChainId.MONAD_TESTNET]: {
+        // Oracles & Breakers
+        BreakerBox: '0x88869E30609D2C0E4032463D713328C6f541878e',
+        MedianDeltaBreaker: '0xf923C884F319b8866F67C5719A80E5cB4D0FAF2c',
+        SortedOracles: '0x85ed9ac57827132B8F60938F3165BC139E1F53cd',
+        ValueDeltaBreaker: '0xbbD0D093F5F11D16D4456FBd6229c9a3b70B8Aaf',
+        // DEX
+        Reserve: '0xbCdc1D0b92DfceEaa0FcD0a0D53355F4bF1DB8a7',
+        // Stable Tokens
+        StableToken: '0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc', // USDm
+        // V3
+        FPMMFactory: '0x353ED52bF8482027C0e0b9e3c0e5d96A9F680980',
+        Router: '0xcf6cD45210b3ffE3cA28379C4683F1e60D0C2CCd',
+        ReserveLiquidityStrategy: '0x734bb3251Ec3f1A83f8f2A8609bcEF649D54EbF8',
+    },
+    [ChainId.MONAD]: {},
     [ChainId.CELO_SEPOLIA]: {
         // Oracles & Breakers
         BreakerBox: '0x578bD46003B9D3fd4c3C3f47c98B329562a6a1dE',
@@ -56,6 +72,17 @@ export const addresses = {
         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
@@ -64,11 +91,7 @@ export const addresses = {
  * @throws Error if the address is not found for the given chain
  */
 export function getContractAddress(chainId, contractName) {
-    const addressesForChain = addresses[chainId];
-    if (!addressesForChain) {
-        throw new Error(`No addresses found for chain ID ${chainId}`);
-    }
-    const address = addressesForChain[contractName];
+    const address = tryGetContractAddress(chainId, contractName);
     if (!address) {
         throw new Error(`Address not found for contract ${contractName} on chain ID ${chainId}`);
     }

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

@@ -2,4 +2,6 @@ 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/types/provider.js

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

package/dist/esm/index.js

@@ -49,16 +49,14 @@ import { BorrowService } from './services/borrow';
  *              const status = await mento.trading.getPoolTradabilityStatus(pool);
  *
  *              // Add liquidity to a pool
- *              const { approvalA, approvalB, addLiquidity } = await mento.liquidity.buildAddLiquidityTransaction({
- *                poolAddress, tokenA, amountA, tokenB, amountB, recipient, owner,
- *                options: { slippageTolerance: 0.5, deadline: deadlineFromMinutes(5) },
- *              });
+ *              const { approval0, approval1, addLiquidity } = await mento.liquidity.buildAddLiquidityTransaction(
+ *                poolAddress, amount0, amount1, recipient, owner, { slippageTolerance: 0.5, deadline: deadlineFromMinutes(5) }
+ *              );
  *
  *              // Add liquidity using a single token (zap in)
- *              const { approval, zapIn } = await mento.liquidity.buildZapInTransaction({
- *                poolAddress, tokenIn, amountIn, amountInSplit: 0.5, recipient, owner,
- *                options: { slippageTolerance: 0.5, deadline: deadlineFromMinutes(5) },
- *              });
+ *              const { approval, zapIn } = await mento.liquidity.buildZapInTransaction(
+ *                poolAddress, tokenIn, amountIn, 0.5, recipient, owner, { slippageTolerance: 0.5, deadline: deadlineFromMinutes(5) }
+ *              );
  */
 export class Mento {
     constructor(chainId, tokens, pools, routes, quotes, swap, trading, liquidity, borrow) {

package/dist/esm/services/index.js

@@ -4,5 +4,3 @@ export * from './quotes';
 export * from './swap';
 export * from './trading';
 export * from './borrow';
-export * from './tokens';
-export * from './liquidity';

package/dist/esm/services/liquidity/liquidityHelpers.js

@@ -22,13 +22,11 @@ export async function getAllowance(publicClient, token, owner, chainId) {
     }));
 }
 export function calculateMinAmount(amount, slippageTolerance) {
-    const MAX_SLIPPAGE_TOLERANCE = 20;
     if (slippageTolerance < 0) {
         throw new Error('Slippage tolerance cannot be negative');
     }
-    if (slippageTolerance > MAX_SLIPPAGE_TOLERANCE) {
-        throw new Error(`Slippage tolerance ${slippageTolerance}% exceeds maximum of ${MAX_SLIPPAGE_TOLERANCE}%. ` +
-            'High slippage makes transactions vulnerable to sandwich attacks.');
+    if (slippageTolerance > 100) {
+        throw new Error('Slippage tolerance cannot exceed 100%');
     }
     const basisPoints = BigInt(Math.floor(slippageTolerance * 100));
     const slippageMultiplier = 10000n - basisPoints;

package/dist/esm/services/pools/poolDetails.js

@@ -37,7 +37,6 @@ export async function fetchFPMMPoolDetails(publicClient, chainId, pool) {
         const liquidityStrategy = activeIndex >= 0 ? knownStrategies[activeIndex] : null;
         // Fetch pricing separately — graceful degradation when FX market is closed
         let pricing = null;
-        let pricingUnavailableReason = null;
         let inBand = null;
         try {
             const rebalancingStateResult = await publicClient.readContract({
@@ -59,8 +58,8 @@ export async function fetchFPMMPoolDetails(publicClient, chainId, pool) {
             };
             inBand = priceDifference < BigInt(rebalanceThreshold);
         }
-        catch (error) {
-            pricingUnavailableReason = `getRebalancingState() reverted: ${error.message ?? 'unknown error'}`;
+        catch {
+            // getRebalancingState() failed (likely FXMarketClosed) — pricing stays null
         }
         return {
             ...pool,
@@ -71,7 +70,6 @@ export async function fetchFPMMPoolDetails(publicClient, chainId, pool) {
             reserve1,
             blockTimestampLast,
             pricing,
-            pricingUnavailableReason,
             fees: {
                 lpFeeBps,
                 lpFeePercent: Number(lpFeeBps) / 100,
@@ -92,9 +90,7 @@ export async function fetchFPMMPoolDetails(publicClient, chainId, pool) {
         };
     }
     catch (error) {
-        const wrapped = new Error(`Failed to fetch FPMM pool details for ${pool.poolAddr}: ${error.message}`);
-        wrapped.cause = error;
-        throw wrapped;
+        throw new Error(`Failed to fetch FPMM pool details for ${pool.poolAddr}: ${error.message}`);
     }
 }
 /**
@@ -124,9 +120,7 @@ export async function fetchVirtualPoolDetails(publicClient, pool) {
         };
     }
     catch (error) {
-        const wrapped = new Error(`Failed to fetch Virtual pool details for ${pool.poolAddr}: ${error.message}`);
-        wrapped.cause = error;
-        throw wrapped;
+        throw new Error(`Failed to fetch Virtual pool details for ${pool.poolAddr}: ${error.message}`);
     }
 }
 /**

package/dist/esm/services/pools/poolDiscovery.js

@@ -1,4 +1,4 @@
-import { getContractAddress } from '../../core/constants';
+import { tryGetContractAddress } from '../../core/constants';
 import { PoolType } from '../../core/types';
 import { FPMM_FACTORY_ABI, FPMM_ABI, VIRTUAL_POOL_FACTORY_ABI, VIRTUAL_POOL_ABI, BIPOOL_MANAGER_ABI, } from '../../core/abis';
 import { sortTokenAddresses } from '../../utils/sortUtils';
@@ -6,7 +6,7 @@ import { sortTokenAddresses } from '../../utils/sortUtils';
  * Fetches all FPMM pools from the FPMM Factory
  */
 export async function fetchFPMMPools(publicClient, chainId) {
-    const fpmmFactoryAddress = getContractAddress(chainId, 'FPMMFactory');
+    const fpmmFactoryAddress = tryGetContractAddress(chainId, 'FPMMFactory');
     if (!fpmmFactoryAddress) {
         return [];
     }
@@ -44,9 +44,7 @@ export async function fetchFPMMPools(publicClient, chainId) {
         return await Promise.all(poolDataPromises);
     }
     catch (error) {
-        const wrapped = new Error(`Failed to fetch FPMM pools: ${error.message}`);
-        wrapped.cause = error;
-        throw wrapped;
+        throw new Error(`Failed to fetch FPMM pools: ${error.message}`);
     }
 }
 /**
@@ -54,8 +52,8 @@ export async function fetchFPMMPools(publicClient, chainId) {
  * then resolves token pairs and exchange IDs from each pool and BiPoolManager.
  */
 export async function fetchVirtualPools(publicClient, chainId) {
-    const virtualPoolFactoryAddress = getContractAddress(chainId, 'VirtualPoolFactory');
-    const biPoolManagerAddress = getContractAddress(chainId, 'BiPoolManager');
+    const virtualPoolFactoryAddress = tryGetContractAddress(chainId, 'VirtualPoolFactory');
+    const biPoolManagerAddress = tryGetContractAddress(chainId, 'BiPoolManager');
     if (!virtualPoolFactoryAddress || !biPoolManagerAddress) {
         return [];
     }
@@ -106,8 +104,6 @@ export async function fetchVirtualPools(publicClient, chainId) {
         return await Promise.all(poolPromises);
     }
     catch (error) {
-        const wrapped = new Error(`Failed to fetch Virtual pools: ${error.message}`);
-        wrapped.cause = error;
-        throw wrapped;
+        throw new Error(`Failed to fetch Virtual pools: ${error.message}`);
     }
 }

package/dist/esm/services/tokens/tokenService.js

@@ -1,11 +1,18 @@
-import { RESERVE_ABI, BIPOOL_MANAGER_ABI, ERC20_ABI } from '../../core/abis';
-import { getContractAddress, RESERVE, BIPOOLMANAGER, } from '../../core/constants';
+import { RESERVE_ABI, RESERVE_V2_ABI, BIPOOL_MANAGER_ABI, ERC20_ABI } from '../../core/abis';
+import { getContractAddress, tryGetContractAddress, ChainId, RESERVE, BIPOOLMANAGER, } from '../../core/constants';
 import { retryOperation } from '../../utils';
+/**
+ * Chains that use ReserveV2 (v3) instead of the legacy Reserve contract.
+ */
+const RESERVE_V2_CHAINS = new Set([ChainId.MONAD_TESTNET, ChainId.MONAD]);
 export class TokenService {
     constructor(publicClient, chainId) {
         this.publicClient = publicClient;
         this.chainId = chainId;
     }
+    isReserveV2() {
+        return RESERVE_V2_CHAINS.has(this.chainId);
+    }
     /**
      * Get token metadata (name, symbol, decimals)
      * @param address - Token contract address
@@ -52,6 +59,26 @@ export class TokenService {
         }));
         return totalSupply.toString();
     }
+    /**
+     * Get stable token addresses from the Reserve contract.
+     * Uses getStableAssets() on ReserveV2, getTokens() on legacy Reserve.
+     */
+    async getStableTokenAddresses(reserveAddress) {
+        if (this.isReserveV2()) {
+            return (await this.publicClient.readContract({
+                address: reserveAddress,
+                abi: RESERVE_V2_ABI,
+                functionName: 'getStableAssets',
+                args: [],
+            }));
+        }
+        return (await this.publicClient.readContract({
+            address: reserveAddress,
+            abi: RESERVE_ABI,
+            functionName: 'getTokens',
+            args: [],
+        }));
+    }
     /**
      * Get all stable tokens from the Reserve contract.
      * Returns the actual on-chain ERC20 totalSupply values without adjustments.
@@ -60,12 +87,7 @@ export class TokenService {
      */
     async getStableTokens(includeSupply = true) {
         const reserveAddress = getContractAddress(this.chainId, RESERVE);
-        const tokenAddresses = (await this.publicClient.readContract({
-            address: reserveAddress,
-            abi: RESERVE_ABI,
-            functionName: 'getTokens',
-            args: [],
-        }));
+        const tokenAddresses = await this.getStableTokenAddresses(reserveAddress);
         // Fetch metadata and totalSupply for all tokens concurrently
         const tokens = await Promise.all(tokenAddresses.map(async (address) => {
             const [metadata, totalSupply] = await Promise.all([
@@ -81,12 +103,42 @@ export class TokenService {
         return tokens;
     }
     /**
-     * Get all collateral assets from exchanges
-     * Filters tokens that are marked as collateral in the Reserve contract
+     * Get all collateral assets.
+     * On ReserveV2 chains, queries the reserve directly.
+     * On legacy chains, discovers collateral via BiPoolManager exchanges.
      * @returns Array of collateral assets
      */
     async getCollateralAssets() {
-        const biPoolManagerAddress = getContractAddress(this.chainId, BIPOOLMANAGER);
+        if (this.isReserveV2()) {
+            return this.getCollateralAssetsV2();
+        }
+        return this.getCollateralAssetsLegacy();
+    }
+    /**
+     * Get collateral assets directly from ReserveV2.
+     */
+    async getCollateralAssetsV2() {
+        const reserveAddress = getContractAddress(this.chainId, RESERVE);
+        const collateralAddresses = (await retryOperation(() => this.publicClient.readContract({
+            address: reserveAddress,
+            abi: RESERVE_V2_ABI,
+            functionName: 'getCollateralAssets',
+            args: [],
+        })));
+        const assets = await Promise.all(collateralAddresses.map(async (address) => {
+            const metadata = await this.getTokenMetadata(address);
+            return { address, ...metadata };
+        }));
+        return assets;
+    }
+    /**
+     * Get collateral assets from legacy Reserve via BiPoolManager exchanges.
+     */
+    async getCollateralAssetsLegacy() {
+        const biPoolManagerAddress = tryGetContractAddress(this.chainId, BIPOOLMANAGER);
+        if (!biPoolManagerAddress) {
+            return [];
+        }
         const reserveAddress = getContractAddress(this.chainId, RESERVE);
         // Get all exchanges to find unique token addresses
         const exchanges = (await retryOperation(() => this.publicClient.readContract({