@mento-protocol/mento-sdk 3.0.0-beta.2 → 3.0.0-beta.21

package/dist/utils/routes.js

@@ -1,49 +1,8 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCachedRoutes = getCachedRoutes;
-/**
- * Gets cached routes for a specific chain ID
- * @param chainId - The chain ID to get cached routes for
- * @returns Promise resolving to the cached routes or undefined if not available
- */
-async function getCachedRoutes(chainId) {
-    try {
-        switch (chainId) {
-            case 42220:
-                // @ts-ignore - Cache files are generated by scripts and may not exist yet
-                return await Promise.resolve().then(() => __importStar(require('../cache/routes.42220'))).then((module) => module.routes42220);
-            case 11142220:
-                // @ts-ignore - Cache files are generated by scripts and may not exist yet
-                return await Promise.resolve().then(() => __importStar(require('../cache/routes.11142220'))).then((module) => module.routes11142220);
-            default:
-                return undefined;
-        }
-    }
-    catch {
-        return undefined;
-    }
-}
+exports.cachedRoutes = exports.getCachedRoutes = void 0;
+// Re-export from consolidated cache
+var routes_1 = require("../cache/routes");
+Object.defineProperty(exports, "getCachedRoutes", { enumerable: true, get: function () { return routes_1.getCachedRoutes; } });
+Object.defineProperty(exports, "cachedRoutes", { enumerable: true, get: function () { return routes_1.cachedRoutes; } });
 //# sourceMappingURL=routes.js.map

package/dist/utils/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/utils/routes.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAUA,0CAqBC;AA1BD;;;;GAIG;AACI,KAAK,UAAU,eAAe,CACnC,OAAe;IAEf,IAAI,CAAC;QACH,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,KAAK;gBACR,0EAA0E;gBAC1E,OAAO,MAAM,kDAAO,uBAAuB,IAAE,IAAI,CAC/C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAC/B,CAAA;YACH,KAAK,QAAQ;gBACX,0EAA0E;gBAC1E,OAAO,MAAM,kDAAO,0BAA0B,IAAE,IAAI,CAClD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAClC,CAAA;YACH;gBACE,OAAO,SAAS,CAAA;QACpB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/utils/routes.ts"],"names":[],"mappings":";;;AAAA,oCAAoC;AACpC,0CAA+D;AAAtD,yGAAA,eAAe,OAAA;AAAE,sGAAA,YAAY,OAAA"}

package/dist/utils/tokens.d.ts

@@ -1,78 +1,2 @@
-import type { Token } from '../core/types';
-/**
- * Enum of all token symbols across all supported chains
- */
-export declare enum TokenSymbol {
-    AUDm = "AUDm",
-    BRLm = "BRLm",
-    CADm = "CADm",
-    CELO = "CELO",
-    CHFm = "CHFm",
-    COPm = "COPm",
-    EURm = "EURm",
-    GBPm = "GBPm",
-    GHSm = "GHSm",
-    JPYm = "JPYm",
-    KESm = "KESm",
-    NGNm = "NGNm",
-    PHPm = "PHPm",
-    PUSO = "PUSO",
-    USDC = "USDC",
-    USDm = "USDm",
-    USD_ = "USD\u20AE",
-    XOFm = "XOFm",
-    ZARm = "ZARm",
-    axlEUROC = "axlEUROC",
-    axlUSDC = "axlUSDC",
-    cAUD = "cAUD",
-    cCAD = "cCAD",
-    cCHF = "cCHF",
-    cCOP = "cCOP",
-    cEUR = "cEUR",
-    cGBP = "cGBP",
-    cGHS = "cGHS",
-    cJPY = "cJPY",
-    cKES = "cKES",
-    cNGN = "cNGN",
-    cREAL = "cREAL",
-    cUSD = "cUSD",
-    cZAR = "cZAR",
-    eXOF = "eXOF"
-}
-/**
- * Get cached tokens for a specific chain ID
- * @param chainId - The chain ID to get tokens for
- * @returns Promise resolving to the cached tokens array, or undefined if not available
- */
-export declare function getCachedTokens(chainId: number): Promise<readonly Token[] | undefined>;
-/**
- * Get cached tokens synchronously for a specific chain ID
- * @param chainId - The chain ID to get tokens for
- * @returns The cached tokens array
- * @throws Error if tokens are not available for the chain
- */
-export declare function getCachedTokensSync(chainId: number): readonly Token[];
-/**
- * Mapping of token addresses by chain ID and token symbol
- * Useful for quickly looking up a token address by its symbol on a specific chain
- */
-export declare const TOKEN_ADDRESSES_BY_CHAIN: {
-    [chainId: number]: {
-        [tokenSymbol in TokenSymbol]?: string;
-    };
-};
-/**
- * Get token address by chain ID and symbol
- * @param chainId - The chain ID
- * @param symbol - The token symbol
- * @returns The token address or undefined if not found
- */
-export declare function getTokenAddress(chainId: number, symbol: TokenSymbol): string | undefined;
-/**
- * Find a token by its symbol on a specific chain
- * @param chainId - The chain ID
- * @param symbol - The token symbol
- * @returns The token object or undefined if not found
- */
-export declare function findTokenBySymbol(chainId: number, symbol: TokenSymbol): Token | undefined;
+export { TokenSymbol, cachedTokens, getCachedTokens, getCachedTokensSync, getTokenAddress, findTokenBySymbol, TOKEN_ADDRESSES_BY_CHAIN, } from '../cache/tokens';
 //# sourceMappingURL=tokens.d.ts.map

package/dist/utils/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C;;GAEG;AACH,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,cAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC,CASvC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,EAAE,CAWrE;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE;IACrC,CAAC,OAAO,EAAE,MAAM,GAAG;SAAG,WAAW,IAAI,WAAW,CAAC,CAAC,EAAE,MAAM;KAAE,CAAA;CA8C7D,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,KAAK,GAAG,SAAS,CAOnB"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iBAAiB,CAAA"}

package/dist/utils/tokens.js

@@ -1,181 +1,13 @@
 "use strict";
-// This file is auto-generated. Do not edit manually.
-// Generated on 2025-12-16T13:10:22.828Z
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOKEN_ADDRESSES_BY_CHAIN = exports.TokenSymbol = void 0;
-exports.getCachedTokens = getCachedTokens;
-exports.getCachedTokensSync = getCachedTokensSync;
-exports.getTokenAddress = getTokenAddress;
-exports.findTokenBySymbol = findTokenBySymbol;
-/**
- * Enum of all token symbols across all supported chains
- */
-var TokenSymbol;
-(function (TokenSymbol) {
-    TokenSymbol["AUDm"] = "AUDm";
-    TokenSymbol["BRLm"] = "BRLm";
-    TokenSymbol["CADm"] = "CADm";
-    TokenSymbol["CELO"] = "CELO";
-    TokenSymbol["CHFm"] = "CHFm";
-    TokenSymbol["COPm"] = "COPm";
-    TokenSymbol["EURm"] = "EURm";
-    TokenSymbol["GBPm"] = "GBPm";
-    TokenSymbol["GHSm"] = "GHSm";
-    TokenSymbol["JPYm"] = "JPYm";
-    TokenSymbol["KESm"] = "KESm";
-    TokenSymbol["NGNm"] = "NGNm";
-    TokenSymbol["PHPm"] = "PHPm";
-    TokenSymbol["PUSO"] = "PUSO";
-    TokenSymbol["USDC"] = "USDC";
-    TokenSymbol["USDm"] = "USDm";
-    TokenSymbol["USD_"] = "USD\u20AE";
-    TokenSymbol["XOFm"] = "XOFm";
-    TokenSymbol["ZARm"] = "ZARm";
-    TokenSymbol["axlEUROC"] = "axlEUROC";
-    TokenSymbol["axlUSDC"] = "axlUSDC";
-    TokenSymbol["cAUD"] = "cAUD";
-    TokenSymbol["cCAD"] = "cCAD";
-    TokenSymbol["cCHF"] = "cCHF";
-    TokenSymbol["cCOP"] = "cCOP";
-    TokenSymbol["cEUR"] = "cEUR";
-    TokenSymbol["cGBP"] = "cGBP";
-    TokenSymbol["cGHS"] = "cGHS";
-    TokenSymbol["cJPY"] = "cJPY";
-    TokenSymbol["cKES"] = "cKES";
-    TokenSymbol["cNGN"] = "cNGN";
-    TokenSymbol["cREAL"] = "cREAL";
-    TokenSymbol["cUSD"] = "cUSD";
-    TokenSymbol["cZAR"] = "cZAR";
-    TokenSymbol["eXOF"] = "eXOF";
-})(TokenSymbol || (exports.TokenSymbol = TokenSymbol = {}));
-/**
- * Get cached tokens for a specific chain ID
- * @param chainId - The chain ID to get tokens for
- * @returns Promise resolving to the cached tokens array, or undefined if not available
- */
-async function getCachedTokens(chainId) {
-    switch (chainId) {
-        case 42220:
-            return await Promise.resolve().then(() => __importStar(require('../cache/tokens.42220'))).then((module) => module.tokens42220);
-        case 11142220:
-            return await Promise.resolve().then(() => __importStar(require('../cache/tokens.11142220'))).then((module) => module.tokens11142220);
-        default:
-            return undefined;
-    }
-}
-/**
- * Get cached tokens synchronously for a specific chain ID
- * @param chainId - The chain ID to get tokens for
- * @returns The cached tokens array
- * @throws Error if tokens are not available for the chain
- */
-function getCachedTokensSync(chainId) {
-    switch (chainId) {
-        case 42220:
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
-            return require('../cache/tokens.42220').tokens42220;
-        case 11142220:
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
-            return require('../cache/tokens.11142220').tokens11142220;
-        default:
-            throw new Error(`No cached tokens available for chain ${chainId}`);
-    }
-}
-/**
- * Mapping of token addresses by chain ID and token symbol
- * Useful for quickly looking up a token address by its symbol on a specific chain
- */
-exports.TOKEN_ADDRESSES_BY_CHAIN = {
-    42220: {
-        [TokenSymbol.cUSD]: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
-        [TokenSymbol.cEUR]: '0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73',
-        [TokenSymbol.cREAL]: '0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787',
-        [TokenSymbol.eXOF]: '0x73F93dcc49cB8A239e2032663e9475dd5ef29A08',
-        [TokenSymbol.cKES]: '0x456a3D042C0DbD3db53D5489e98dFb038553B0d0',
-        [TokenSymbol.PUSO]: '0x105d4A9306D2E55a71d2Eb95B81553AE1dC20d7B',
-        [TokenSymbol.cCOP]: '0x8A567e2aE79CA692Bd748aB832081C45de4041eA',
-        [TokenSymbol.cGHS]: '0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313',
-        [TokenSymbol.cGBP]: '0xCCF663b1fF11028f0b19058d0f7B674004a40746',
-        [TokenSymbol.cZAR]: '0x4c35853A3B4e647fD266f4de678dCc8fEC410BF6',
-        [TokenSymbol.cCAD]: '0xff4Ab19391af240c311c54200a492233052B6325',
-        [TokenSymbol.cAUD]: '0x7175504C455076F15c04A2F90a8e352281F492F9',
-        [TokenSymbol.cCHF]: '0xb55a79F398E759E43C95b979163f30eC87Ee131D',
-        [TokenSymbol.cNGN]: '0xE2702Bd97ee33c88c8f6f92DA3B733608aa76F71',
-        [TokenSymbol.cJPY]: '0xc45eCF20f3CD864B32D9794d6f76814aE8892e20',
-        [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
-        [TokenSymbol.axlEUROC]: '0x061cc5a2C863E0C1Cb404006D559dB18A34C762d',
-        [TokenSymbol.USDC]: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
-        [TokenSymbol.axlUSDC]: '0xEB466342C4d449BC9f53A865D5Cb90586f405215',
-        [TokenSymbol.USD_]: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
-    },
-    11142220: {
-        [TokenSymbol.USDm]: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
-        [TokenSymbol.EURm]: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
-        [TokenSymbol.BRLm]: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
-        [TokenSymbol.XOFm]: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
-        [TokenSymbol.KESm]: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
-        [TokenSymbol.PHPm]: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
-        [TokenSymbol.COPm]: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
-        [TokenSymbol.GHSm]: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
-        [TokenSymbol.GBPm]: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
-        [TokenSymbol.ZARm]: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
-        [TokenSymbol.CADm]: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
-        [TokenSymbol.AUDm]: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
-        [TokenSymbol.CHFm]: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
-        [TokenSymbol.JPYm]: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
-        [TokenSymbol.NGNm]: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
-        [TokenSymbol.axlUSDC]: '0x6285De9DA7C1d329C0451628638908915002d9d1',
-        [TokenSymbol.CELO]: '0x471EcE3750Da237f93B8E339c536989b8978a438',
-        [TokenSymbol.axlEUROC]: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
-        [TokenSymbol.USD_]: '0xd077A400968890Eacc75cdc901F0356c943e4fDb',
-        [TokenSymbol.USDC]: '0x01C5C0122039549AD1493B8220cABEdD739BC44E',
-    },
-};
-/**
- * Get token address by chain ID and symbol
- * @param chainId - The chain ID
- * @param symbol - The token symbol
- * @returns The token address or undefined if not found
- */
-function getTokenAddress(chainId, symbol) {
-    return exports.TOKEN_ADDRESSES_BY_CHAIN[chainId]?.[symbol];
-}
-/**
- * Find a token by its symbol on a specific chain
- * @param chainId - The chain ID
- * @param symbol - The token symbol
- * @returns The token object or undefined if not found
- */
-function findTokenBySymbol(chainId, symbol) {
-    try {
-        const tokens = getCachedTokensSync(chainId);
-        return tokens.find((t) => t.symbol === symbol);
-    }
-    catch {
-        return undefined;
-    }
-}
+exports.TOKEN_ADDRESSES_BY_CHAIN = exports.findTokenBySymbol = exports.getTokenAddress = exports.getCachedTokensSync = exports.getCachedTokens = exports.cachedTokens = exports.TokenSymbol = void 0;
+// Re-export from consolidated cache
+var tokens_1 = require("../cache/tokens");
+Object.defineProperty(exports, "TokenSymbol", { enumerable: true, get: function () { return tokens_1.TokenSymbol; } });
+Object.defineProperty(exports, "cachedTokens", { enumerable: true, get: function () { return tokens_1.cachedTokens; } });
+Object.defineProperty(exports, "getCachedTokens", { enumerable: true, get: function () { return tokens_1.getCachedTokens; } });
+Object.defineProperty(exports, "getCachedTokensSync", { enumerable: true, get: function () { return tokens_1.getCachedTokensSync; } });
+Object.defineProperty(exports, "getTokenAddress", { enumerable: true, get: function () { return tokens_1.getTokenAddress; } });
+Object.defineProperty(exports, "findTokenBySymbol", { enumerable: true, get: function () { return tokens_1.findTokenBySymbol; } });
+Object.defineProperty(exports, "TOKEN_ADDRESSES_BY_CHAIN", { enumerable: true, get: function () { return tokens_1.TOKEN_ADDRESSES_BY_CHAIN; } });
 //# sourceMappingURL=tokens.js.map

package/dist/utils/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":";;;AAAA,oCAAoC;AACpC,0CAQwB;AAPtB,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA;AACZ,yGAAA,eAAe,OAAA;AACf,6GAAA,mBAAmB,OAAA;AACnB,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AACjB,kHAAA,wBAAwB,OAAA"}

package/dist/utils/tradingLimits.d.ts

@@ -0,0 +1,41 @@
+import type { TradingLimit, TradingLimitsConfigV1, TradingLimitsStateV1, TradingLimitsConfigV2, TradingLimitsStateV2 } from '../core/types';
+/**
+ * Compute limit ID for Broker (V1) trading limits.
+ * limitId = exchangeId XOR bytes32(uint256(uint160(token)))
+ *
+ * @param exchangeId - The exchange ID (bytes32)
+ * @param token - The token address
+ * @returns The limit ID as hex string
+ */
+export declare function computeLimitId(exchangeId: string, token: string): `0x${string}`;
+/**
+ * Calculate trading limits from V1 config and state (Broker/Virtual pools).
+ * Returns human-friendly TradingLimit objects with maxIn/maxOut/until.
+ *
+ * @param config - V1 trading limits configuration
+ * @param state - V1 trading limits state
+ * @param asset - Token address
+ * @param tokenDecimals - Token decimals for consumer reference
+ * @returns Array of TradingLimit objects
+ */
+export declare function calculateTradingLimitsV1(config: TradingLimitsConfigV1, state: TradingLimitsStateV1, asset: string, tokenDecimals: number): TradingLimit[];
+/**
+ * Calculate trading limits from V2 config and state (FPMM pools).
+ * V2 uses fixed timeframes: 5 min for L0, 1 day for L1.
+ * Values are stored with 15 decimals precision.
+ *
+ * @param config - V2 trading limits configuration
+ * @param state - V2 trading limits state
+ * @param asset - Token address
+ * @returns Array of TradingLimit objects
+ */
+export declare function calculateTradingLimitsV2(config: TradingLimitsConfigV2, state: TradingLimitsStateV2, asset: string): TradingLimit[];
+/**
+ * Check if any trading limits are configured (flags > 0 for V1, or limit0/limit1 > 0 for V2)
+ */
+export declare function hasConfiguredLimitsV1(config: TradingLimitsConfigV1): boolean;
+/**
+ * Check if any trading limits are configured for V2
+ */
+export declare function hasConfiguredLimitsV2(config: TradingLimitsConfigV2): boolean;
+//# sourceMappingURL=tradingLimits.d.ts.map

package/dist/utils/tradingLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tradingLimits.d.ts","sourceRoot":"","sources":["../../src/utils/tradingLimits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,eAAe,CAAA;AActB;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAa/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,YAAY,EAAE,CAiEhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,MAAM,GACZ,YAAY,EAAE,CAmDhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAE5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAE5E"}

package/dist/utils/tradingLimits.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeLimitId = computeLimitId;
+exports.calculateTradingLimitsV1 = calculateTradingLimitsV1;
+exports.calculateTradingLimitsV2 = calculateTradingLimitsV2;
+exports.hasConfiguredLimitsV1 = hasConfiguredLimitsV1;
+exports.hasConfiguredLimitsV2 = hasConfiguredLimitsV2;
+const viem_1 = require("viem");
+/** V2 trading limits use 15 decimals internally */
+const V2_INTERNAL_DECIMALS = 15;
+/** V2 L0 window is fixed at 5 minutes */
+const V2_L0_TIMESTEP = 5 * 60; // 300 seconds
+/** V2 L1 window is fixed at 1 day */
+const V2_L1_TIMESTEP = 24 * 60 * 60; // 86400 seconds
+/** Far future timestamp for global limits (year 2030) */
+const TIMESTAMP_FAR_FUTURE = 1893456000;
+/**
+ * Compute limit ID for Broker (V1) trading limits.
+ * limitId = exchangeId XOR bytes32(uint256(uint160(token)))
+ *
+ * @param exchangeId - The exchange ID (bytes32)
+ * @param token - The token address
+ * @returns The limit ID as hex string
+ */
+function computeLimitId(exchangeId, token) {
+    // Pad token address to 32 bytes (left-padded with zeros)
+    const tokenBytes32 = (0, viem_1.pad)(token, { size: 32 });
+    // Convert both to BigInt for XOR operation
+    const exchangeIdBigInt = (0, viem_1.hexToBigInt)(exchangeId);
+    const tokenBigInt = (0, viem_1.hexToBigInt)(tokenBytes32);
+    // XOR operation
+    const limitIdBigInt = exchangeIdBigInt ^ tokenBigInt;
+    // Convert back to hex with proper padding
+    return (0, viem_1.pad)((0, viem_1.numberToHex)(limitIdBigInt), { size: 32 });
+}
+/**
+ * Calculate trading limits from V1 config and state (Broker/Virtual pools).
+ * Returns human-friendly TradingLimit objects with maxIn/maxOut/until.
+ *
+ * @param config - V1 trading limits configuration
+ * @param state - V1 trading limits state
+ * @param asset - Token address
+ * @param tokenDecimals - Token decimals for consumer reference
+ * @returns Array of TradingLimit objects
+ */
+function calculateTradingLimitsV1(config, state, asset, tokenDecimals) {
+    const nowEpoch = Math.floor(Date.now() / 1000);
+    const limits = [];
+    // Check if L0 is enabled (bit 0 of flags)
+    const isL0Enabled = (config.flags & 0x01) !== 0;
+    // Check if L1 is enabled (bit 1 of flags)
+    const isL1Enabled = (config.flags & 0x02) !== 0;
+    // Check if LG is enabled (bit 2 of flags)
+    const isLGEnabled = (config.flags & 0x04) !== 0;
+    // Reset netflows if time windows have passed
+    const isL0Outdated = isL0Enabled && nowEpoch > state.lastUpdated0 + config.timestep0;
+    const isL1Outdated = isL1Enabled && nowEpoch > state.lastUpdated1 + config.timestep1;
+    const effectiveNetflow0 = isL0Outdated ? 0n : state.netflow0;
+    const effectiveNetflow1 = isL1Outdated ? 0n : state.netflow1;
+    const effectiveLastUpdated0 = isL0Outdated ? nowEpoch : state.lastUpdated0;
+    const effectiveLastUpdated1 = isL1Outdated ? nowEpoch : state.lastUpdated1;
+    // Add L0 limit if configured
+    if (isL0Enabled && config.limit0 > 0n) {
+        limits.push({
+            asset,
+            maxIn: config.limit0 - effectiveNetflow0,
+            maxOut: config.limit0 + effectiveNetflow0,
+            until: effectiveLastUpdated0 + config.timestep0,
+            decimals: tokenDecimals,
+        });
+    }
+    // Add L1 limit if configured
+    if (isL1Enabled && config.limit1 > 0n) {
+        limits.push({
+            asset,
+            maxIn: config.limit1 - effectiveNetflow1,
+            maxOut: config.limit1 + effectiveNetflow1,
+            until: effectiveLastUpdated1 + config.timestep1,
+            decimals: tokenDecimals,
+        });
+    }
+    // Add LG (global) limit if configured
+    if (isLGEnabled && config.limitGlobal > 0n) {
+        limits.push({
+            asset,
+            maxIn: config.limitGlobal - state.netflowGlobal,
+            maxOut: config.limitGlobal + state.netflowGlobal,
+            until: TIMESTAMP_FAR_FUTURE,
+            decimals: tokenDecimals,
+        });
+    }
+    // Apply cascading restrictions: limits with larger timeframes restrict smaller ones
+    // e.g., if maxIn is 0 in LG, it should also be 0 in L1 and L0
+    for (let i = limits.length - 1; i > 0; i--) {
+        if (limits[i - 1].maxIn > limits[i].maxIn) {
+            limits[i - 1] = { ...limits[i - 1], maxIn: limits[i].maxIn };
+        }
+        if (limits[i - 1].maxOut > limits[i].maxOut) {
+            limits[i - 1] = { ...limits[i - 1], maxOut: limits[i].maxOut };
+        }
+    }
+    return limits;
+}
+/**
+ * Calculate trading limits from V2 config and state (FPMM pools).
+ * V2 uses fixed timeframes: 5 min for L0, 1 day for L1.
+ * Values are stored with 15 decimals precision.
+ *
+ * @param config - V2 trading limits configuration
+ * @param state - V2 trading limits state
+ * @param asset - Token address
+ * @returns Array of TradingLimit objects
+ */
+function calculateTradingLimitsV2(config, state, asset) {
+    const nowEpoch = Math.floor(Date.now() / 1000);
+    const limits = [];
+    // Check if L0 is configured (limit0 > 0)
+    const isL0Enabled = config.limit0 > 0n;
+    // Check if L1 is configured (limit1 > 0)
+    const isL1Enabled = config.limit1 > 0n;
+    // Reset netflows if time windows have passed
+    const isL0Outdated = isL0Enabled && nowEpoch > state.lastUpdated0 + V2_L0_TIMESTEP;
+    const isL1Outdated = isL1Enabled && nowEpoch > state.lastUpdated1 + V2_L1_TIMESTEP;
+    const effectiveNetflow0 = isL0Outdated ? 0n : state.netflow0;
+    const effectiveNetflow1 = isL1Outdated ? 0n : state.netflow1;
+    const effectiveLastUpdated0 = isL0Outdated ? nowEpoch : state.lastUpdated0;
+    const effectiveLastUpdated1 = isL1Outdated ? nowEpoch : state.lastUpdated1;
+    // Add L0 limit if configured
+    if (isL0Enabled) {
+        limits.push({
+            asset,
+            maxIn: config.limit0 - effectiveNetflow0,
+            maxOut: config.limit0 + effectiveNetflow0,
+            until: effectiveLastUpdated0 + V2_L0_TIMESTEP,
+            decimals: V2_INTERNAL_DECIMALS, // V2 returns 15 decimal values
+        });
+    }
+    // Add L1 limit if configured
+    if (isL1Enabled) {
+        limits.push({
+            asset,
+            maxIn: config.limit1 - effectiveNetflow1,
+            maxOut: config.limit1 + effectiveNetflow1,
+            until: effectiveLastUpdated1 + V2_L1_TIMESTEP,
+            decimals: V2_INTERNAL_DECIMALS, // V2 returns 15 decimal values
+        });
+    }
+    // Apply cascading restrictions
+    for (let i = limits.length - 1; i > 0; i--) {
+        if (limits[i - 1].maxIn > limits[i].maxIn) {
+            limits[i - 1] = { ...limits[i - 1], maxIn: limits[i].maxIn };
+        }
+        if (limits[i - 1].maxOut > limits[i].maxOut) {
+            limits[i - 1] = { ...limits[i - 1], maxOut: limits[i].maxOut };
+        }
+    }
+    return limits;
+}
+/**
+ * Check if any trading limits are configured (flags > 0 for V1, or limit0/limit1 > 0 for V2)
+ */
+function hasConfiguredLimitsV1(config) {
+    return config.flags > 0;
+}
+/**
+ * Check if any trading limits are configured for V2
+ */
+function hasConfiguredLimitsV2(config) {
+    return config.limit0 > 0n || config.limit1 > 0n;
+}
+//# sourceMappingURL=tradingLimits.js.map

package/dist/utils/tradingLimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tradingLimits.js","sourceRoot":"","sources":["../../src/utils/tradingLimits.ts"],"names":[],"mappings":"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"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Validates an Ethereum address format using viem's isAddress utility
+ *
+ * @param address - The address string to validate
+ * @param paramName - Optional parameter name for better error messages
+ * @returns True if valid (type guard for `0x${string}`)
+ * @throws Error if address is invalid
+ *
+ * @example
+ * ```typescript
+ * validateAddress('0x765DE816845861e75A25fCA122bb6898B8B1282a')
+ * // Returns true
+ *
+ * validateAddress('invalid', 'tokenIn')
+ * // Throws: "Invalid address for tokenIn: invalid"
+ * ```
+ */
+export declare function validateAddress(address: string, paramName?: string): address is `0x${string}`;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,IAAI,KAAK,MAAM,EAAE,CAe7F"}

package/dist/utils/validation.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAddress = validateAddress;
+const viem_1 = require("viem");
+/**
+ * Validates an Ethereum address format using viem's isAddress utility
+ *
+ * @param address - The address string to validate
+ * @param paramName - Optional parameter name for better error messages
+ * @returns True if valid (type guard for `0x${string}`)
+ * @throws Error if address is invalid
+ *
+ * @example
+ * ```typescript
+ * validateAddress('0x765DE816845861e75A25fCA122bb6898B8B1282a')
+ * // Returns true
+ *
+ * validateAddress('invalid', 'tokenIn')
+ * // Throws: "Invalid address for tokenIn: invalid"
+ * ```
+ */
+function validateAddress(address, paramName) {
+    if (typeof address !== 'string') {
+        const param = paramName ? ` for ${paramName}` : '';
+        throw new Error(`Address${param} must be a string, got ${typeof address}`);
+    }
+    // Use viem's isAddress with strict: false to allow both checksummed and non-checksummed addresses
+    if (!(0, viem_1.isAddress)(address, { strict: false })) {
+        const param = paramName ? ` for ${paramName}` : '';
+        throw new Error(`Invalid address${param}: ${address}. Expected 0x followed by 40 hex characters`);
+    }
+    return true;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":";;AAmBA,0CAeC;AAlCD,+BAAgC;AAEhC;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAAC,OAAe,EAAE,SAAkB;IACjE,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAClD,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,0BAA0B,OAAO,OAAO,EAAE,CAAC,CAAA;IAC5E,CAAC;IAED,kGAAkG;IAClG,IAAI,CAAC,IAAA,gBAAS,EAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAClD,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,KAAK,OAAO,6CAA6C,CACjF,CAAA;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}