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

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/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 [];
     }
@@ -52,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 [];
     }

package/dist/esm/services/swap/SwapService.js

@@ -27,6 +27,7 @@ export class SwapService {
      * @param options - Swap configuration options (slippage, deadline)
      * @param route - Optional pre-fetched route for better performance
      * @returns Combined transaction with approval (if needed) and swap params
+     * @throws {Error} 'amountIn must be greater than zero' - if amountIn <= 0
      * @throws {Error} 'Slippage tolerance cannot be negative' - if slippageTolerance < 0
      * @throws {Error} 'Slippage tolerance exceeds maximum' - if slippageTolerance > 20%
      * @throws {Error} 'Deadline must be in the future' - if deadline is not a future timestamp
@@ -54,6 +55,7 @@ export class SwapService {
      * ```
      */
     async buildSwapTransaction(tokenIn, tokenOut, amountIn, recipient, owner, options, route) {
+        this.validateAmountIn(amountIn);
         // Validate all address inputs
         validateAddress(tokenIn, 'tokenIn');
         validateAddress(tokenOut, 'tokenOut');
@@ -77,6 +79,7 @@ export class SwapService {
      * @param options - Swap configuration options (slippage, deadline)
      * @param route - Optional pre-fetched route for better performance
      * @returns Detailed swap parameters including transaction data
+     * @throws {Error} 'amountIn must be greater than zero' - if amountIn <= 0
      * @throws {Error} 'Slippage tolerance cannot be negative' - if slippageTolerance < 0
      * @throws {Error} 'Slippage tolerance exceeds maximum' - if slippageTolerance > 20%
      * @throws {Error} 'Deadline must be in the future' - if deadline is not a future timestamp
@@ -98,6 +101,7 @@ export class SwapService {
      * ```
      */
     async buildSwapParams(tokenIn, tokenOut, amountIn, recipient, options, route) {
+        this.validateAmountIn(amountIn);
         const deadline = options.deadline;
         if (deadline <= BigInt(Date.now()) / 1000n) {
             throw new Error('Deadline must be in the future');
@@ -155,6 +159,15 @@ export class SwapService {
             args: [owner, routerAddress],
         }));
     }
+    /**
+     * Validates that the input amount is strictly positive.
+     * @private
+     */
+    validateAmountIn(amountIn) {
+        if (amountIn <= 0n) {
+            throw new Error('amountIn must be greater than zero');
+        }
+    }
     /**
      * Calculates minimum output amount after applying slippage tolerance
      * @param amountOut - Expected output amount

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({

package/dist/esm/services/trading/TradingLimitsService.js

@@ -1,6 +1,6 @@
 import { PoolType } from '../../core/types';
 import { FPMM_ABI, BROKER_ABI } from '../../core/abis';
-import { getContractAddress } from '../../core/constants';
+import { tryGetContractAddress } from '../../core/constants';
 import { computeLimitId, calculateTradingLimitsV1, calculateTradingLimitsV2, hasConfiguredLimitsV1, hasConfiguredLimitsV2, } from '../../utils/tradingLimits';
 /**
  * Service for querying trading limits from the Mento protocol.
@@ -97,7 +97,10 @@ export class TradingLimitsService {
      * Get trading limits for a specific token in a Virtual pool.
      */
     async getVirtualPoolTokenLimits(exchangeId, token) {
-        const brokerAddr = getContractAddress(this.chainId, 'Broker');
+        const brokerAddr = tryGetContractAddress(this.chainId, 'Broker');
+        if (!brokerAddr) {
+            return [];
+        }
         const limitId = computeLimitId(exchangeId, token);
         try {
             // Fetch config and state in parallel

package/dist/esm/utils/chainConfig.js

@@ -23,6 +23,47 @@ const celoSepolia = defineChain({
     },
     testnet: true,
 });
+const monadTestnet = defineChain({
+    id: 10143,
+    name: 'Monad Testnet',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'MON',
+        symbol: 'MON',
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://testnet-rpc.monad.xyz'],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: 'Monad Explorer',
+            url: 'https://testnet.monadexplorer.com',
+        },
+    },
+    testnet: true,
+});
+const monad = defineChain({
+    id: 143,
+    name: 'Monad',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'MON',
+        symbol: 'MON',
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://rpc.monad.xyz'],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: 'Monad Explorer',
+            url: 'https://monadvision.com',
+        },
+    },
+});
 /**
  * Get the default RPC URL for a given chain ID
  * @param chainId - The chain ID
@@ -35,6 +76,10 @@ export function getDefaultRpcUrl(chainId) {
             return 'https://forno.celo.org';
         case ChainId.CELO_SEPOLIA:
             return 'https://forno.celo-sepolia.celo-testnet.org';
+        case ChainId.MONAD_TESTNET:
+            return 'https://testnet-rpc.monad.xyz';
+        case ChainId.MONAD:
+            return 'https://rpc.monad.xyz';
         default:
             throw new Error(`Unsupported chain ID: ${chainId}`);
     }
@@ -51,6 +96,10 @@ export function getChainConfig(chainId) {
             return celo;
         case ChainId.CELO_SEPOLIA:
             return celoSepolia;
+        case ChainId.MONAD_TESTNET:
+            return monadTestnet;
+        case ChainId.MONAD:
+            return monad;
         default:
             throw new Error(`Unsupported chain ID: ${chainId}`);
     }

package/dist/services/pools/poolDiscovery.js

@@ -10,7 +10,7 @@ const sortUtils_1 = require("../../utils/sortUtils");
  * Fetches all FPMM pools from the FPMM Factory
  */
 async function fetchFPMMPools(publicClient, chainId) {
-    const fpmmFactoryAddress = (0, constants_1.getContractAddress)(chainId, 'FPMMFactory');
+    const fpmmFactoryAddress = (0, constants_1.tryGetContractAddress)(chainId, 'FPMMFactory');
     if (!fpmmFactoryAddress) {
         return [];
     }
@@ -56,8 +56,8 @@ async function fetchFPMMPools(publicClient, chainId) {
  * then resolves token pairs and exchange IDs from each pool and BiPoolManager.
  */
 async function fetchVirtualPools(publicClient, chainId) {
-    const virtualPoolFactoryAddress = (0, constants_1.getContractAddress)(chainId, 'VirtualPoolFactory');
-    const biPoolManagerAddress = (0, constants_1.getContractAddress)(chainId, 'BiPoolManager');
+    const virtualPoolFactoryAddress = (0, constants_1.tryGetContractAddress)(chainId, 'VirtualPoolFactory');
+    const biPoolManagerAddress = (0, constants_1.tryGetContractAddress)(chainId, 'BiPoolManager');
     if (!virtualPoolFactoryAddress || !biPoolManagerAddress) {
         return [];
     }

package/dist/services/swap/SwapService.d.ts

@@ -85,6 +85,7 @@ export declare class SwapService {
      * @param options - Swap configuration options (slippage, deadline)
      * @param route - Optional pre-fetched route for better performance
      * @returns Combined transaction with approval (if needed) and swap params
+     * @throws {Error} 'amountIn must be greater than zero' - if amountIn <= 0
      * @throws {Error} 'Slippage tolerance cannot be negative' - if slippageTolerance < 0
      * @throws {Error} 'Slippage tolerance exceeds maximum' - if slippageTolerance > 20%
      * @throws {Error} 'Deadline must be in the future' - if deadline is not a future timestamp
@@ -123,6 +124,7 @@ export declare class SwapService {
      * @param options - Swap configuration options (slippage, deadline)
      * @param route - Optional pre-fetched route for better performance
      * @returns Detailed swap parameters including transaction data
+     * @throws {Error} 'amountIn must be greater than zero' - if amountIn <= 0
      * @throws {Error} 'Slippage tolerance cannot be negative' - if slippageTolerance < 0
      * @throws {Error} 'Slippage tolerance exceeds maximum' - if slippageTolerance > 20%
      * @throws {Error} 'Deadline must be in the future' - if deadline is not a future timestamp
@@ -154,6 +156,11 @@ export declare class SwapService {
      * @private
      */
     private getAllowance;
+    /**
+     * Validates that the input amount is strictly positive.
+     * @private
+     */
+    private validateAmountIn;
     /**
      * Calculates minimum output amount after applying slippage tolerance
      * @param amountOut - Expected output amount

package/dist/services/swap/SwapService.js

@@ -30,6 +30,7 @@ class SwapService {
      * @param options - Swap configuration options (slippage, deadline)
      * @param route - Optional pre-fetched route for better performance
      * @returns Combined transaction with approval (if needed) and swap params
+     * @throws {Error} 'amountIn must be greater than zero' - if amountIn <= 0
      * @throws {Error} 'Slippage tolerance cannot be negative' - if slippageTolerance < 0
      * @throws {Error} 'Slippage tolerance exceeds maximum' - if slippageTolerance > 20%
      * @throws {Error} 'Deadline must be in the future' - if deadline is not a future timestamp
@@ -57,6 +58,7 @@ class SwapService {
      * ```
      */
     async buildSwapTransaction(tokenIn, tokenOut, amountIn, recipient, owner, options, route) {
+        this.validateAmountIn(amountIn);
         // Validate all address inputs
         (0, validation_1.validateAddress)(tokenIn, 'tokenIn');
         (0, validation_1.validateAddress)(tokenOut, 'tokenOut');
@@ -80,6 +82,7 @@ class SwapService {
      * @param options - Swap configuration options (slippage, deadline)
      * @param route - Optional pre-fetched route for better performance
      * @returns Detailed swap parameters including transaction data
+     * @throws {Error} 'amountIn must be greater than zero' - if amountIn <= 0
      * @throws {Error} 'Slippage tolerance cannot be negative' - if slippageTolerance < 0
      * @throws {Error} 'Slippage tolerance exceeds maximum' - if slippageTolerance > 20%
      * @throws {Error} 'Deadline must be in the future' - if deadline is not a future timestamp
@@ -101,6 +104,7 @@ class SwapService {
      * ```
      */
     async buildSwapParams(tokenIn, tokenOut, amountIn, recipient, options, route) {
+        this.validateAmountIn(amountIn);
         const deadline = options.deadline;
         if (deadline <= BigInt(Date.now()) / 1000n) {
             throw new Error('Deadline must be in the future');
@@ -158,6 +162,15 @@ class SwapService {
             args: [owner, routerAddress],
         }));
     }
+    /**
+     * Validates that the input amount is strictly positive.
+     * @private
+     */
+    validateAmountIn(amountIn) {
+        if (amountIn <= 0n) {
+            throw new Error('amountIn must be greater than zero');
+        }
+    }
     /**
      * Calculates minimum output amount after applying slippage tolerance
      * @param amountOut - Expected output amount

package/dist/services/tokens/tokenService.d.ts

@@ -4,6 +4,7 @@ export declare class TokenService {
     private publicClient;
     private chainId;
     constructor(publicClient: PublicClient, chainId: number);
+    private isReserveV2;
     /**
      * Get token metadata (name, symbol, decimals)
      * @param address - Token contract address
@@ -16,6 +17,11 @@ export declare class TokenService {
      * @returns Total supply as string
      */
     private getTotalSupply;
+    /**
+     * Get stable token addresses from the Reserve contract.
+     * Uses getStableAssets() on ReserveV2, getTokens() on legacy Reserve.
+     */
+    private getStableTokenAddresses;
     /**
      * Get all stable tokens from the Reserve contract.
      * Returns the actual on-chain ERC20 totalSupply values without adjustments.
@@ -24,10 +30,19 @@ export declare class TokenService {
      */
     getStableTokens(includeSupply?: boolean): Promise<StableToken[]>;
     /**
-     * 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
      */
     getCollateralAssets(): Promise<CollateralAsset[]>;
+    /**
+     * Get collateral assets directly from ReserveV2.
+     */
+    private getCollateralAssetsV2;
+    /**
+     * Get collateral assets from legacy Reserve via BiPoolManager exchanges.
+     */
+    private getCollateralAssetsLegacy;
 }
 //# sourceMappingURL=tokenService.d.ts.map

package/dist/services/tokens/tokenService.js

@@ -4,11 +4,18 @@ exports.TokenService = void 0;
 const abis_1 = require("../../core/abis");
 const constants_1 = require("../../core/constants");
 const utils_1 = require("../../utils");
+/**
+ * Chains that use ReserveV2 (v3) instead of the legacy Reserve contract.
+ */
+const RESERVE_V2_CHAINS = new Set([constants_1.ChainId.MONAD_TESTNET, constants_1.ChainId.MONAD]);
 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
@@ -55,6 +62,26 @@ 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: abis_1.RESERVE_V2_ABI,
+                functionName: 'getStableAssets',
+                args: [],
+            }));
+        }
+        return (await this.publicClient.readContract({
+            address: reserveAddress,
+            abi: abis_1.RESERVE_ABI,
+            functionName: 'getTokens',
+            args: [],
+        }));
+    }
     /**
      * Get all stable tokens from the Reserve contract.
      * Returns the actual on-chain ERC20 totalSupply values without adjustments.
@@ -63,12 +90,7 @@ class TokenService {
      */
     async getStableTokens(includeSupply = true) {
         const reserveAddress = (0, constants_1.getContractAddress)(this.chainId, constants_1.RESERVE);
-        const tokenAddresses = (await this.publicClient.readContract({
-            address: reserveAddress,
-            abi: abis_1.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([
@@ -84,12 +106,42 @@ 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 = (0, constants_1.getContractAddress)(this.chainId, constants_1.BIPOOLMANAGER);
+        if (this.isReserveV2()) {
+            return this.getCollateralAssetsV2();
+        }
+        return this.getCollateralAssetsLegacy();
+    }
+    /**
+     * Get collateral assets directly from ReserveV2.
+     */
+    async getCollateralAssetsV2() {
+        const reserveAddress = (0, constants_1.getContractAddress)(this.chainId, constants_1.RESERVE);
+        const collateralAddresses = (await (0, utils_1.retryOperation)(() => this.publicClient.readContract({
+            address: reserveAddress,
+            abi: abis_1.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 = (0, constants_1.tryGetContractAddress)(this.chainId, constants_1.BIPOOLMANAGER);
+        if (!biPoolManagerAddress) {
+            return [];
+        }
         const reserveAddress = (0, constants_1.getContractAddress)(this.chainId, constants_1.RESERVE);
         // Get all exchanges to find unique token addresses
         const exchanges = (await (0, utils_1.retryOperation)(() => this.publicClient.readContract({

package/dist/services/trading/TradingLimitsService.js

@@ -100,7 +100,10 @@ class TradingLimitsService {
      * Get trading limits for a specific token in a Virtual pool.
      */
     async getVirtualPoolTokenLimits(exchangeId, token) {
-        const brokerAddr = (0, constants_1.getContractAddress)(this.chainId, 'Broker');
+        const brokerAddr = (0, constants_1.tryGetContractAddress)(this.chainId, 'Broker');
+        if (!brokerAddr) {
+            return [];
+        }
         const limitId = (0, tradingLimits_1.computeLimitId)(exchangeId, token);
         try {
             // Fetch config and state in parallel