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

package/dist/cache/routes.js

@@ -1,6 +1,6 @@
 "use strict";
 // 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
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cachedRoutes = void 0;
 exports.getCachedRoutes = getCachedRoutes;
@@ -9,6 +9,230 @@ exports.getCachedRoutes = getCachedRoutes;
  * Routes that don't exist for a chain will return an empty array
  */
 exports.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/cache/tokens.d.ts

@@ -4,6 +4,7 @@ import type { Token } from '../core/types';
  */
 export declare enum TokenSymbol {
     AUDm = "AUDm",
+    AUSD = "AUSD",
     BRLm = "BRLm",
     CADm = "CADm",
     CELO = "CELO",

package/dist/cache/tokens.js

@@ -1,6 +1,6 @@
 "use strict";
 // 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
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TOKEN_ADDRESSES_BY_CHAIN = exports.cachedTokens = exports.TokenSymbol = void 0;
 exports.getCachedTokens = getCachedTokens;
@@ -13,6 +13,7 @@ exports.findTokenBySymbol = findTokenBySymbol;
 var TokenSymbol;
 (function (TokenSymbol) {
     TokenSymbol["AUDm"] = "AUDm";
+    TokenSymbol["AUSD"] = "AUSD";
     TokenSymbol["BRLm"] = "BRLm";
     TokenSymbol["CADm"] = "CADm";
     TokenSymbol["CELO"] = "CELO";
@@ -37,6 +38,29 @@ var TokenSymbol;
  * Cached tokens indexed by chain ID
  */
 exports.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: [
         {
@@ -289,6 +313,12 @@ exports.cachedTokens = {
  * Useful for quickly looking up a token address by its symbol on a specific chain
  */
 exports.TOKEN_ADDRESSES_BY_CHAIN = {
+    143: {},
+    10143: {
+        [TokenSymbol.USDm]: '0x5eCc03111ad2A78F981A108759bc73BAE2AB31bc',
+        [TokenSymbol.USDC]: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
+        [TokenSymbol.AUSD]: '0x502E67D3fE9302A5e4Ec1CFCDdbD6F34F9B9484B',
+    },
     42220: {
         [TokenSymbol.USDm]: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
         [TokenSymbol.EURm]: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',

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

@@ -1,2 +1,3 @@
 export declare const RESERVE_ABI: any;
+export declare const RESERVE_V2_ABI: any;
 //# sourceMappingURL=reserve.d.ts.map

package/dist/core/abis/reserve.js

@@ -1,10 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESERVE_ABI = void 0;
+exports.RESERVE_V2_ABI = exports.RESERVE_ABI = void 0;
 const viem_1 = require("viem");
+// Legacy Reserve (Celo)
 exports.RESERVE_ABI = (0, viem_1.parseAbi)([
     'function getTokens() view returns (address[])',
     'function isToken(address) view returns (bool)',
     'function isCollateralAsset(address) view returns (bool)',
 ]);
+// ReserveV2 (Monad)
+exports.RESERVE_V2_ABI = (0, viem_1.parseAbi)([
+    'function getStableAssets() view returns (address[])',
+    'function getCollateralAssets() view returns (address[])',
+    'function isStableAsset(address) view returns (bool)',
+    'function isCollateralAsset(address) view returns (bool)',
+]);
 //# sourceMappingURL=reserve.js.map

package/dist/core/constants/addresses.d.ts

@@ -2,6 +2,11 @@ import { ChainId } from './chainId';
 import { ContractAddresses, ContractAddressMap } from '../types';
 export declare const addresses: ContractAddressMap;
 export type Identifier = keyof ContractAddresses;
+/**
+ * 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 declare function tryGetContractAddress(chainId: ChainId, contractName: Identifier): string | undefined;
 /**
  * Get the address of a contract for a given chain
  * @param chainId - The chain ID

package/dist/core/constants/addresses.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addresses = void 0;
+exports.tryGetContractAddress = tryGetContractAddress;
 exports.getContractAddress = getContractAddress;
 const chainId_1 = require("./chainId");
 exports.addresses = {
@@ -33,6 +34,22 @@ exports.addresses = {
         ReserveLiquidityStrategy: '0xa0fB8b16ce6AF3634fF9F3f4F40E49E1C1ae4f0B',
         CDPLiquidityStrategy: '0x4e78BD9565341EAbe99cDC024acB044d9BDcB985',
     },
+    [chainId_1.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_1.ChainId.MONAD]: {},
     [chainId_1.ChainId.CELO_SEPOLIA]: {
         // Oracles & Breakers
         BreakerBox: '0x578bD46003B9D3fd4c3C3f47c98B329562a6a1dE',
@@ -60,6 +77,17 @@ exports.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.
+ */
+function tryGetContractAddress(chainId, contractName) {
+    const addressesForChain = exports.addresses[chainId];
+    if (!addressesForChain) {
+        return undefined;
+    }
+    return addressesForChain[contractName];
+}
 /**
  * Get the address of a contract for a given chain
  * @param chainId - The chain ID
@@ -68,11 +96,7 @@ exports.addresses = {
  * @throws Error if the address is not found for the given chain
  */
 function getContractAddress(chainId, contractName) {
-    const addressesForChain = exports.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/core/constants/chainId.d.ts

@@ -1,5 +1,7 @@
 export declare enum ChainId {
     CELO = 42220,
-    CELO_SEPOLIA = 11142220
+    CELO_SEPOLIA = 11142220,
+    MONAD_TESTNET = 10143,
+    MONAD = 143
 }
 //# sourceMappingURL=chainId.d.ts.map

package/dist/core/constants/chainId.js

@@ -5,5 +5,7 @@ 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 || (exports.ChainId = ChainId = {}));
 //# sourceMappingURL=chainId.js.map

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

@@ -110,10 +110,8 @@ export interface FPMMPoolDetails extends Pool {
     reserve1: bigint;
     /** Block timestamp of last reserve update */
     blockTimestampLast: bigint;
-    /** Pricing and oracle data (null when unavailable — see pricingUnavailableReason) */
+    /** Pricing and oracle data (null when FX market is closed) */
     pricing: FPMMPricing | null;
-    /** Reason pricing data is unavailable, or null when pricing is present */
-    pricingUnavailableReason: string | null;
     /** Fee configuration */
     fees: FPMMFees;
     /** Rebalancing state */

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

@@ -0,0 +1,45 @@
+export interface ContractCallOptions {
+    address: string;
+    abi: string[] | unknown[];
+    functionName: string;
+    args?: unknown[];
+}
+/**
+ * Contract write options for building call parameters
+ *
+ * Configuration for building transaction call parameters for write operations.
+ * These parameters can be used by consumers to execute transactions themselves.
+ */
+export interface ContractWriteOptions extends ContractCallOptions {
+    /**
+     * Optional gas limit override
+     * If not provided, will be estimated automatically
+     */
+    gasLimit?: bigint;
+    /**
+     * Transaction value in wei
+     * For payable functions only
+     */
+    value?: bigint;
+}
+/**
+ * Call parameters for executing a contract transaction
+ *
+ * Contains all the data needed to execute a contract call.
+ * Consumers can use these parameters with their own wallet/signer to execute transactions.
+ */
+export interface CallParams {
+    /**
+     * Contract address to call
+     */
+    to: string;
+    /**
+     * Encoded function call data (hex string)
+     */
+    data: string;
+    /**
+     * Transaction value in wei (hex string with 0x prefix)
+     */
+    value: string;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/core/types/provider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=provider.js.map