@mento-protocol/mento-sdk 3.0.0-beta.3 → 3.0.0-beta.31

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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mento-protocol/mento-sdk",
   "description": "Official SDK for interacting with the Mento Protocol",
-  "version": "3.0.0-beta.3",
+  "version": "3.0.0-beta.31",
   "license": "MIT",
   "author": "Mento Labs",
   "keywords": [
@@ -22,9 +22,11 @@
   "scripts": {
     "build": "pnpm clean && tsc --project ./tsconfig.json",
     "clean": "rm -rf ./dist",
-    "lint": "eslint --config ./.eslintrc.json src/**/*.ts",
+    "lint": "eslint --config ./.eslintrc.json src/**/*.ts tests/**/*.ts",
     "prettier": "prettier --config ./.prettierrc.json --write **/*.{json,md,js,ts,yml}",
     "test": "jest --verbose",
+    "test:unit": "jest --verbose --testPathPattern='tests/unit'",
+    "test:integration": "jest --verbose --testPathPattern='tests/integration'",
     "coverage": "jest --coverage",
     "cacheRoutes": "ts-node scripts/cacheRoutes/index.ts",
     "cacheTokens": "ts-node scripts/cacheTokens/index.ts"
@@ -51,12 +53,10 @@
     "ts-node": "^10.9.1",
     "tsconfig-paths": "^4.2.0",
     "typescript": "5.6.3",
-    "yargs-parser": "^21.1.1"
+    "yargs-parser": "^21.1.1",
+    "dotenv": "^16.4.5"
   },
   "dependencies": {
-    "@mento-protocol/mento-core-ts": "^0.2.0",
-    "bignumber.js": "^9.1.2",
-    "dotenv": "^16.4.5",
     "viem": "^2.21.44"
   }
 }

package/dist/cache/routes.42220.d.ts

@@ -1,3 +0,0 @@
-import type { RouteWithCost } from '../core/types';
-export declare const routes42220: RouteWithCost[];
-//# sourceMappingURL=routes.42220.d.ts.map

package/dist/cache/routes.42220.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"routes.42220.d.ts","sourceRoot":"","sources":["../../src/cache/routes.42220.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,eAAO,MAAM,WAAW,EAAE,aAAa,EAyGtC,CAAA"}

package/dist/cache/routes.42220.js

@@ -1,112 +0,0 @@
-"use strict";
-// This file is auto-generated. Do not edit manually.
-// Generated on 2025-12-17T12:12:43.212Z
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.routes42220 = void 0;
-exports.routes42220 = [
-    {
-        "id": "KESm-USDm",
-        "tokens": [
-            {
-                "address": "0x456a3D042C0DbD3db53D5489e98dFb038553B0d0",
-                "symbol": "KESm"
-            },
-            {
-                "address": "0x765DE816845861e75A25fCA122bb6898B8B1282a",
-                "symbol": "USDm"
-            }
-        ],
-        "path": [
-            {
-                "factoryAddr": "0x65A67cb93a3e035C32f131e911A0d6b46a5f3Bd0",
-                "poolAddr": "0x5c3919258a040D203260880401E3201a82d224c4",
-                "token0": "0x456a3D042C0DbD3db53D5489e98dFb038553B0d0",
-                "token1": "0x765DE816845861e75A25fCA122bb6898B8B1282a",
-                "poolType": "FPMM"
-            }
-        ],
-        "costData": {
-            "totalCostPercent": 0.3,
-            "hops": [
-                {
-                    "poolAddress": "0x5c3919258a040D203260880401E3201a82d224c4",
-                    "costPercent": 0.3
-                }
-            ]
-        }
-    },
-    {
-        "id": "GHSm-USDm",
-        "tokens": [
-            {
-                "address": "0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313",
-                "symbol": "GHSm"
-            },
-            {
-                "address": "0x765DE816845861e75A25fCA122bb6898B8B1282a",
-                "symbol": "USDm"
-            }
-        ],
-        "path": [
-            {
-                "factoryAddr": "0x6CE2dFC48b2688075A804835757a734e3316E0a2",
-                "poolAddr": "0x21243E9F64815D86Eeb38d80a212295a39634e70",
-                "token0": "0x765DE816845861e75A25fCA122bb6898B8B1282a",
-                "token1": "0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313",
-                "poolType": "Virtual"
-            }
-        ],
-        "costData": {
-            "totalCostPercent": 1,
-            "hops": [
-                {
-                    "poolAddress": "0x21243E9F64815D86Eeb38d80a212295a39634e70",
-                    "costPercent": 1
-                }
-            ]
-        }
-    },
-    {
-        "id": "GHSm-KESm",
-        "tokens": [
-            {
-                "address": "0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313",
-                "symbol": "GHSm"
-            },
-            {
-                "address": "0x456a3D042C0DbD3db53D5489e98dFb038553B0d0",
-                "symbol": "KESm"
-            }
-        ],
-        "path": [
-            {
-                "factoryAddr": "0x65A67cb93a3e035C32f131e911A0d6b46a5f3Bd0",
-                "poolAddr": "0x5c3919258a040D203260880401E3201a82d224c4",
-                "token0": "0x456a3D042C0DbD3db53D5489e98dFb038553B0d0",
-                "token1": "0x765DE816845861e75A25fCA122bb6898B8B1282a",
-                "poolType": "FPMM"
-            },
-            {
-                "factoryAddr": "0x6CE2dFC48b2688075A804835757a734e3316E0a2",
-                "poolAddr": "0x21243E9F64815D86Eeb38d80a212295a39634e70",
-                "token0": "0x765DE816845861e75A25fCA122bb6898B8B1282a",
-                "token1": "0xfAeA5F3404bbA20D3cc2f8C4B0A888F55a3c7313",
-                "poolType": "Virtual"
-            }
-        ],
-        "costData": {
-            "totalCostPercent": 1.297,
-            "hops": [
-                {
-                    "poolAddress": "0x5c3919258a040D203260880401E3201a82d224c4",
-                    "costPercent": 0.3
-                },
-                {
-                    "poolAddress": "0x21243E9F64815D86Eeb38d80a212295a39634e70",
-                    "costPercent": 1
-                }
-            ]
-        }
-    }
-];
-//# sourceMappingURL=routes.42220.js.map

package/dist/cache/routes.42220.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"routes.42220.js","sourceRoot":"","sources":["../../src/cache/routes.42220.ts"],"names":[],"mappings":";AAAA,qDAAqD;AACrD,wCAAwC;;;AAI3B,QAAA,WAAW,GAAoB;IAC1C;QACE,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE;YACR;gBACE,SAAS,EAAE,4CAA4C;gBACvD,QAAQ,EAAE,MAAM;aACjB;YACD;gBACE,SAAS,EAAE,4CAA4C;gBACvD,QAAQ,EAAE,MAAM;aACjB;SACF;QACD,MAAM,EAAE;YACN;gBACE,aAAa,EAAE,4CAA4C;gBAC3D,UAAU,EAAE,4CAA4C;gBACxD,QAAQ,EAAE,4CAA4C;gBACtD,QAAQ,EAAE,4CAA4C;gBACtD,UAAU,EAAE,MAAM;aACnB;SACF;QACD,UAAU,EAAE;YACV,kBAAkB,EAAE,GAAG;YACvB,MAAM,EAAE;gBACN;oBACE,aAAa,EAAE,4CAA4C;oBAC3D,aAAa,EAAE,GAAG;iBACnB;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE;YACR;gBACE,SAAS,EAAE,4CAA4C;gBACvD,QAAQ,EAAE,MAAM;aACjB;YACD;gBACE,SAAS,EAAE,4CAA4C;gBACvD,QAAQ,EAAE,MAAM;aACjB;SACF;QACD,MAAM,EAAE;YACN;gBACE,aAAa,EAAE,4CAA4C;gBAC3D,UAAU,EAAE,4CAA4C;gBACxD,QAAQ,EAAE,4CAA4C;gBACtD,QAAQ,EAAE,4CAA4C;gBACtD,UAAU,EAAE,SAAS;aACtB;SACF;QACD,UAAU,EAAE;YACV,kBAAkB,EAAE,CAAC;YACrB,MAAM,EAAE;gBACN;oBACE,aAAa,EAAE,4CAA4C;oBAC3D,aAAa,EAAE,CAAC;iBACjB;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE;YACR;gBACE,SAAS,EAAE,4CAA4C;gBACvD,QAAQ,EAAE,MAAM;aACjB;YACD;gBACE,SAAS,EAAE,4CAA4C;gBACvD,QAAQ,EAAE,MAAM;aACjB;SACF;QACD,MAAM,EAAE;YACN;gBACE,aAAa,EAAE,4CAA4C;gBAC3D,UAAU,EAAE,4CAA4C;gBACxD,QAAQ,EAAE,4CAA4C;gBACtD,QAAQ,EAAE,4CAA4C;gBACtD,UAAU,EAAE,MAAM;aACnB;YACD;gBACE,aAAa,EAAE,4CAA4C;gBAC3D,UAAU,EAAE,4CAA4C;gBACxD,QAAQ,EAAE,4CAA4C;gBACtD,QAAQ,EAAE,4CAA4C;gBACtD,UAAU,EAAE,SAAS;aACtB;SACF;QACD,UAAU,EAAE;YACV,kBAAkB,EAAE,KAAK;YACzB,MAAM,EAAE;gBACN;oBACE,aAAa,EAAE,4CAA4C;oBAC3D,aAAa,EAAE,GAAG;iBACnB;gBACD;oBACE,aAAa,EAAE,4CAA4C;oBAC3D,aAAa,EAAE,CAAC;iBACjB;aACF;SACF;KACF;CACF,CAAA"}

package/dist/cache/tokens.11142220.d.ts

@@ -1,3 +0,0 @@
-import type { Token } from '../core/types';
-export declare const tokens11142220: readonly Token[];
-//# sourceMappingURL=tokens.11142220.d.ts.map

package/dist/cache/tokens.11142220.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tokens.11142220.d.ts","sourceRoot":"","sources":["../../src/cache/tokens.11142220.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,eAAO,MAAM,cAAc,EAAE,SAAS,KAAK,EAyHjC,CAAA"}

package/dist/cache/tokens.11142220.js

@@ -1,129 +0,0 @@
-"use strict";
-// This file is auto-generated. Do not edit manually.
-// Generated on 2025-12-10T10:40:44.226Z
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tokens11142220 = void 0;
-const tokens_1 = require("../utils/tokens");
-exports.tokens11142220 = [
-    {
-        address: '0xdE9e4C3ce781b4bA68120d6261cbad65ce0aB00b',
-        symbol: tokens_1.TokenSymbol.USDm,
-        name: 'Mento Dollar',
-        decimals: 18,
-    },
-    {
-        address: '0xA99dC247d6b7B2E3ab48a1fEE101b83cD6aCd82a',
-        symbol: tokens_1.TokenSymbol.EURm,
-        name: 'Mento Euro',
-        decimals: 18,
-    },
-    {
-        address: '0x2294298942fdc79417DE9E0D740A4957E0e7783a',
-        symbol: tokens_1.TokenSymbol.BRLm,
-        name: 'Mento Brazilian Real',
-        decimals: 18,
-    },
-    {
-        address: '0x5505b70207aE3B826c1A7607F19F3Bf73444A082',
-        symbol: tokens_1.TokenSymbol.XOFm,
-        name: 'Mento West African CFA franc',
-        decimals: 18,
-    },
-    {
-        address: '0xC7e4635651E3e3Af82b61d3E23c159438daE3BbF',
-        symbol: tokens_1.TokenSymbol.KESm,
-        name: 'Mento Kenyan Shilling',
-        decimals: 18,
-    },
-    {
-        address: '0x0352976d940a2C3FBa0C3623198947Ee1d17869E',
-        symbol: tokens_1.TokenSymbol.PHPm,
-        name: 'Mento Philippine Peso',
-        decimals: 18,
-    },
-    {
-        address: '0x5F8d55c3627d2dc0a2B4afa798f877242F382F67',
-        symbol: tokens_1.TokenSymbol.COPm,
-        name: 'Mento Colombian Peso',
-        decimals: 18,
-    },
-    {
-        address: '0x5e94B8C872bD47BC4255E60ECBF44D5E66e7401C',
-        symbol: tokens_1.TokenSymbol.GHSm,
-        name: 'Mento Ghanaian Cedi',
-        decimals: 18,
-    },
-    {
-        address: '0x85F5181Abdbf0e1814Fc4358582Ae07b8eBA3aF3',
-        symbol: tokens_1.TokenSymbol.GBPm,
-        name: 'Mento British Pound',
-        decimals: 18,
-    },
-    {
-        address: '0x10CCfB235b0E1Ed394bACE4560C3ed016697687e',
-        symbol: tokens_1.TokenSymbol.ZARm,
-        name: 'Mento South African Rand',
-        decimals: 18,
-    },
-    {
-        address: '0xF151c9a13b78C84f93f50B8b3bC689fedc134F60',
-        symbol: tokens_1.TokenSymbol.CADm,
-        name: 'Mento Canadian Dollar',
-        decimals: 18,
-    },
-    {
-        address: '0x5873Faeb42F3563dcD77F0fbbdA818E6d6DA3139',
-        symbol: tokens_1.TokenSymbol.AUDm,
-        name: 'Mento Australian Dollar',
-        decimals: 18,
-    },
-    {
-        address: '0x284E9b7B623eAE866914b7FA0eB720C2Bb3C2980',
-        symbol: tokens_1.TokenSymbol.CHFm,
-        name: 'Mento Swiss Franc',
-        decimals: 18,
-    },
-    {
-        address: '0x85Bee67D435A39f7467a8a9DE34a5B73D25Df426',
-        symbol: tokens_1.TokenSymbol.JPYm,
-        name: 'Mento Japanese Yen',
-        decimals: 18,
-    },
-    {
-        address: '0x3d5ae86F34E2a82771496D140daFAEf3789dF888',
-        symbol: tokens_1.TokenSymbol.NGNm,
-        name: 'Mento Nigerian Naira',
-        decimals: 18,
-    },
-    {
-        address: '0x6285De9DA7C1d329C0451628638908915002d9d1',
-        symbol: tokens_1.TokenSymbol.axlUSDC,
-        name: 'Mento Mock axlUSDC',
-        decimals: 18,
-    },
-    {
-        address: '0x471EcE3750Da237f93B8E339c536989b8978a438',
-        symbol: tokens_1.TokenSymbol.CELO,
-        name: 'Celo native asset',
-        decimals: 18,
-    },
-    {
-        address: '0x9883d788d40F1C7595a780ed881Ea833C7743B4B',
-        symbol: tokens_1.TokenSymbol.axlEUROC,
-        name: 'Mento Mock axlEUROC',
-        decimals: 18,
-    },
-    {
-        address: '0xd077A400968890Eacc75cdc901F0356c943e4fDb',
-        symbol: tokens_1.TokenSymbol.USD_,
-        name: 'Tether USD',
-        decimals: 6,
-    },
-    {
-        address: '0x01C5C0122039549AD1493B8220cABEdD739BC44E',
-        symbol: tokens_1.TokenSymbol.USDC,
-        name: 'USDC',
-        decimals: 6,
-    }
-];
-//# sourceMappingURL=tokens.11142220.js.map

package/dist/cache/tokens.11142220.js.map

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

package/dist/cache/tokens.42220.d.ts

@@ -1,3 +0,0 @@
-import type { Token } from '../core/types';
-export declare const tokens42220: readonly Token[];
-//# sourceMappingURL=tokens.42220.d.ts.map

package/dist/cache/tokens.42220.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tokens.42220.d.ts","sourceRoot":"","sources":["../../src/cache/tokens.42220.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,eAAO,MAAM,WAAW,EAAE,SAAS,KAAK,EAyH9B,CAAA"}