@mento-protocol/mento-sdk 2.0.0-beta.9 → 3.0.0-beta.10

package/dist/services/trading/TradingLimitsService.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TradingLimitsService = void 0;
+const types_1 = require("../../core/types");
+const abis_1 = require("../../core/abis");
+const constants_1 = require("../../core/constants");
+const tradingLimits_1 = require("../../utils/tradingLimits");
+/**
+ * Service for querying trading limits from the Mento protocol.
+ * Supports both FPMM pools (TradingLimitsV2) and Virtual pools (TradingLimitsV1).
+ */
+class TradingLimitsService {
+    constructor(publicClient, chainId) {
+        this.publicClient = publicClient;
+        this.chainId = chainId;
+    }
+    /**
+     * Get trading limits for a pool.
+     * Returns an array of TradingLimit objects for each configured limit.
+     *
+     * @param pool - The pool to get trading limits for
+     * @returns Array of TradingLimit objects with maxIn/maxOut/until
+     */
+    async getPoolTradingLimits(pool) {
+        if (pool.poolType === types_1.PoolType.FPMM) {
+            return this.getFPMMTradingLimits(pool);
+        }
+        else {
+            return this.getVirtualPoolTradingLimits(pool);
+        }
+    }
+    /**
+     * Get trading limits for an FPMM pool.
+     * FPMM pools use TradingLimitsV2 with fixed timeframes.
+     */
+    async getFPMMTradingLimits(pool) {
+        const limits = [];
+        // Get trading limits for both tokens
+        const [token0Limits, token1Limits] = await Promise.all([
+            this.getFPMMTokenLimits(pool.poolAddr, pool.token0),
+            this.getFPMMTokenLimits(pool.poolAddr, pool.token1),
+        ]);
+        limits.push(...token0Limits);
+        limits.push(...token1Limits);
+        return limits;
+    }
+    /**
+     * Get trading limits for a specific token in an FPMM pool.
+     */
+    async getFPMMTokenLimits(poolAddr, token) {
+        try {
+            const result = await this.publicClient.readContract({
+                address: poolAddr,
+                abi: abis_1.FPMM_ABI,
+                functionName: 'getTradingLimits',
+                args: [token],
+            });
+            // Result is a tuple: [config, state]
+            const [configTuple, stateTuple] = result;
+            const config = {
+                limit0: configTuple.limit0,
+                limit1: configTuple.limit1,
+                decimals: configTuple.decimals,
+            };
+            const state = {
+                lastUpdated0: Number(stateTuple.lastUpdated0),
+                lastUpdated1: Number(stateTuple.lastUpdated1),
+                netflow0: stateTuple.netflow0,
+                netflow1: stateTuple.netflow1,
+            };
+            if (!(0, tradingLimits_1.hasConfiguredLimitsV2)(config)) {
+                return [];
+            }
+            return (0, tradingLimits_1.calculateTradingLimitsV2)(config, state, token);
+        }
+        catch {
+            // Token may not have limits configured, or invalid token
+            return [];
+        }
+    }
+    /**
+     * Get trading limits for a Virtual pool.
+     * Virtual pools use TradingLimitsV1 via the Broker contract.
+     */
+    async getVirtualPoolTradingLimits(pool) {
+        if (!pool.exchangeId) {
+            console.warn(`Virtual pool ${pool.poolAddr} missing exchangeId - cannot query trading limits`);
+            return [];
+        }
+        const limits = [];
+        // Get trading limits for both tokens
+        const [token0Limits, token1Limits] = await Promise.all([
+            this.getVirtualPoolTokenLimits(pool.exchangeId, pool.token0),
+            this.getVirtualPoolTokenLimits(pool.exchangeId, pool.token1),
+        ]);
+        limits.push(...token0Limits);
+        limits.push(...token1Limits);
+        return limits;
+    }
+    /**
+     * 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 limitId = (0, tradingLimits_1.computeLimitId)(exchangeId, token);
+        try {
+            // Fetch config and state in parallel
+            const [configResult, stateResult] = await Promise.all([
+                this.publicClient.readContract({
+                    address: brokerAddr,
+                    abi: abis_1.BROKER_ABI,
+                    functionName: 'tradingLimitsConfig',
+                    args: [limitId],
+                }),
+                this.publicClient.readContract({
+                    address: brokerAddr,
+                    abi: abis_1.BROKER_ABI,
+                    functionName: 'tradingLimitsState',
+                    args: [limitId],
+                }),
+            ]);
+            // Parse config result
+            const configTuple = configResult;
+            const config = {
+                timestep0: Number(configTuple[0]),
+                timestep1: Number(configTuple[1]),
+                limit0: configTuple[2],
+                limit1: configTuple[3],
+                limitGlobal: configTuple[4],
+                flags: Number(configTuple[5]),
+            };
+            // Parse state result
+            const stateTuple = stateResult;
+            const state = {
+                lastUpdated0: Number(stateTuple[0]),
+                lastUpdated1: Number(stateTuple[1]),
+                netflow0: stateTuple[2],
+                netflow1: stateTuple[3],
+                netflowGlobal: stateTuple[4],
+            };
+            // Only return limits if configured
+            if (!(0, tradingLimits_1.hasConfiguredLimitsV1)(config)) {
+                return [];
+            }
+            // Get token decimals (V1 uses 0 decimals internally, but we track token decimals for display)
+            // For now, return 0 as the reference - consumers should query token decimals separately
+            const tokenDecimals = 0; // V1 stores values with 0 decimal precision
+            return (0, tradingLimits_1.calculateTradingLimitsV1)(config, state, token, tokenDecimals);
+        }
+        catch {
+            // Trading limits may not be configured for this token
+            return [];
+        }
+    }
+}
+exports.TradingLimitsService = TradingLimitsService;
+//# sourceMappingURL=TradingLimitsService.js.map

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

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

package/dist/services/trading/TradingService.d.ts

@@ -0,0 +1,110 @@
+import { PublicClient } from 'viem';
+import { Route, Pool, TradingLimit, PoolTradabilityStatus } from '../../core/types';
+import { RouteService } from '../routes';
+/**
+ * Service for checking trading status and circuit breaker state in the Mento protocol.
+ * Provides methods to query whether trading is enabled for specific rate feeds,
+ * token pairs, or routes. Also integrates trading limit checks.
+ */
+export declare class TradingService {
+    private publicClient;
+    private chainId;
+    private routeService;
+    private tradingLimitsService;
+    constructor(publicClient: PublicClient, chainId: number, routeService: RouteService);
+    /**
+     * Returns the current trading mode for a given rate feed.
+     *
+     * The BreakerBox uses a bitmask approach where 0 means bidirectional trading
+     * is enabled, and any non-zero value means trading is suspended.
+     *
+     * @param rateFeedId - The address of the rate feed
+     * @returns The raw trading mode value from BreakerBox (0 = enabled, non-zero = suspended)
+     *
+     * @example
+     * ```typescript
+     * const mode = await tradingService.getRateFeedTradingMode(rateFeedId)
+     * if (mode === TradingMode.BIDIRECTIONAL) {
+     *   console.log('Trading is enabled')
+     * }
+     * ```
+     */
+    getRateFeedTradingMode(rateFeedId: string): Promise<number>;
+    /**
+     * Checks if a trading pair is currently tradable.
+     * For multi-hop routes (e.g., CELO → USDm → USDT), checks that ALL
+     * intermediate rate feeds are in BIDIRECTIONAL mode.
+     *
+     * @param tokenIn - Input token address
+     * @param tokenOut - Output token address
+     * @returns true if the pair is tradable (all rate feeds BIDIRECTIONAL), false otherwise
+     * @throws {RouteNotFoundError} If no route exists between the token pair
+     *
+     * @example
+     * ```typescript
+     * const isTradable = await tradingService.isPairTradable(USDm, CELO)
+     * if (!isTradable) {
+     *   console.log('Trading is currently suspended for this pair')
+     * }
+     * ```
+     */
+    isPairTradable(tokenIn: string, tokenOut: string): Promise<boolean>;
+    /**
+     * Checks if a route is currently tradable.
+     * Verifies that all pools in the route's path have their rate feeds
+     * in BIDIRECTIONAL mode.
+     *
+     * @param route - The route to check
+     * @returns true if all pools in the route are tradable, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const route = await routeService.findRoute(tokenIn, tokenOut)
+     * const isRouteTradable = await tradingService.isRouteTradable(route)
+     * ```
+     */
+    isRouteTradable(route: Route): Promise<boolean>;
+    /**
+     * Get trading limits for a pool.
+     *
+     * @param pool - The pool to get trading limits for
+     * @returns Array of TradingLimit objects with maxIn/maxOut/until
+     *
+     * @example
+     * ```typescript
+     * const limits = await tradingService.getPoolTradingLimits(pool)
+     * limits.forEach(limit => {
+     *   console.log(`${limit.asset}: maxIn=${limit.maxIn}, maxOut=${limit.maxOut}`)
+     * })
+     * ```
+     */
+    getPoolTradingLimits(pool: Pool): Promise<TradingLimit[]>;
+    /**
+     * Get complete tradability status for a pool.
+     * Returns separate flags for circuit breaker and trading limits,
+     * allowing frontends to show different messages for each condition.
+     *
+     * @param pool - The pool to check
+     * @returns PoolTradabilityStatus with tradable, circuitBreakerOk, limitsOk, and limits
+     *
+     * @example
+     * ```typescript
+     * const status = await tradingService.getPoolTradabilityStatus(pool)
+     * if (!status.circuitBreakerOk) {
+     *   showModal("Trading temporarily suspended (circuit breaker)")
+     * } else if (!status.limitsOk) {
+     *   showModal("Trading limit reached", status.limits)
+     * }
+     * ```
+     */
+    getPoolTradabilityStatus(pool: Pool): Promise<PoolTradabilityStatus>;
+    /**
+     * Get the reference rate feed ID for a pool.
+     * Both FPMM and Virtual pools expose this via the referenceRateFeedID() view function.
+     *
+     * @param pool - The pool to get rate feed ID for
+     * @returns The rate feed ID address
+     */
+    getPoolRateFeedId(pool: Pool): Promise<string>;
+}
+//# sourceMappingURL=TradingService.d.ts.map

package/dist/services/trading/TradingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TradingService.d.ts","sourceRoot":"","sources":["../../../src/services/trading/TradingService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,EAEL,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,qBAAqB,EACtB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAKxC;;;;GAIG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,YAAY;IALtB,OAAO,CAAC,oBAAoB,CAAsB;gBAGxC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY;IAKpC;;;;;;;;;;;;;;;;OAgBG;IACG,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAajE;;;;;;;;;;;;;;;;;OAiBG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKzE;;;;;;;;;;;;;OAaG;IACG,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAcrD;;;;;;;;;;;;;OAaG;IACG,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI/D;;;;;;;;;;;;;;;;;OAiBG;IACG,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAqB1E;;;;;;OAMG;IACG,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CASrD"}

package/dist/services/trading/TradingService.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TradingService = void 0;
+const types_1 = require("../../core/types");
+const TradingLimitsService_1 = require("./TradingLimitsService");
+const abis_1 = require("../../core/abis");
+const constants_1 = require("../../core/constants");
+/**
+ * Service for checking trading status and circuit breaker state in the Mento protocol.
+ * Provides methods to query whether trading is enabled for specific rate feeds,
+ * token pairs, or routes. Also integrates trading limit checks.
+ */
+class TradingService {
+    constructor(publicClient, chainId, routeService) {
+        this.publicClient = publicClient;
+        this.chainId = chainId;
+        this.routeService = routeService;
+        this.tradingLimitsService = new TradingLimitsService_1.TradingLimitsService(publicClient, chainId);
+    }
+    /**
+     * Returns the current trading mode for a given rate feed.
+     *
+     * The BreakerBox uses a bitmask approach where 0 means bidirectional trading
+     * is enabled, and any non-zero value means trading is suspended.
+     *
+     * @param rateFeedId - The address of the rate feed
+     * @returns The raw trading mode value from BreakerBox (0 = enabled, non-zero = suspended)
+     *
+     * @example
+     * ```typescript
+     * const mode = await tradingService.getRateFeedTradingMode(rateFeedId)
+     * if (mode === TradingMode.BIDIRECTIONAL) {
+     *   console.log('Trading is enabled')
+     * }
+     * ```
+     */
+    async getRateFeedTradingMode(rateFeedId) {
+        const breakerBoxAddr = (0, constants_1.getContractAddress)(this.chainId, 'BreakerBox');
+        const mode = await this.publicClient.readContract({
+            address: breakerBoxAddr,
+            abi: abis_1.BREAKERBOX_ABI,
+            functionName: 'getRateFeedTradingMode',
+            args: [rateFeedId],
+        });
+        return Number(mode);
+    }
+    /**
+     * Checks if a trading pair is currently tradable.
+     * For multi-hop routes (e.g., CELO → USDm → USDT), checks that ALL
+     * intermediate rate feeds are in BIDIRECTIONAL mode.
+     *
+     * @param tokenIn - Input token address
+     * @param tokenOut - Output token address
+     * @returns true if the pair is tradable (all rate feeds BIDIRECTIONAL), false otherwise
+     * @throws {RouteNotFoundError} If no route exists between the token pair
+     *
+     * @example
+     * ```typescript
+     * const isTradable = await tradingService.isPairTradable(USDm, CELO)
+     * if (!isTradable) {
+     *   console.log('Trading is currently suspended for this pair')
+     * }
+     * ```
+     */
+    async isPairTradable(tokenIn, tokenOut) {
+        const route = await this.routeService.findRoute(tokenIn, tokenOut);
+        return this.isRouteTradable(route);
+    }
+    /**
+     * Checks if a route is currently tradable.
+     * Verifies that all pools in the route's path have their rate feeds
+     * in BIDIRECTIONAL mode.
+     *
+     * @param route - The route to check
+     * @returns true if all pools in the route are tradable, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const route = await routeService.findRoute(tokenIn, tokenOut)
+     * const isRouteTradable = await tradingService.isRouteTradable(route)
+     * ```
+     */
+    async isRouteTradable(route) {
+        // Get rate feed IDs for each pool in the path and check trading modes
+        const rateFeedChecks = await Promise.all(route.path.map(async (pool) => {
+            const rateFeedId = await this.getPoolRateFeedId(pool);
+            const tradingMode = await this.getRateFeedTradingMode(rateFeedId);
+            return (0, types_1.isTradingEnabled)(tradingMode);
+        }));
+        // All rate feeds must have trading enabled for the route to be tradable
+        return rateFeedChecks.every((isEnabled) => isEnabled);
+    }
+    /**
+     * Get trading limits for a pool.
+     *
+     * @param pool - The pool to get trading limits for
+     * @returns Array of TradingLimit objects with maxIn/maxOut/until
+     *
+     * @example
+     * ```typescript
+     * const limits = await tradingService.getPoolTradingLimits(pool)
+     * limits.forEach(limit => {
+     *   console.log(`${limit.asset}: maxIn=${limit.maxIn}, maxOut=${limit.maxOut}`)
+     * })
+     * ```
+     */
+    async getPoolTradingLimits(pool) {
+        return this.tradingLimitsService.getPoolTradingLimits(pool);
+    }
+    /**
+     * Get complete tradability status for a pool.
+     * Returns separate flags for circuit breaker and trading limits,
+     * allowing frontends to show different messages for each condition.
+     *
+     * @param pool - The pool to check
+     * @returns PoolTradabilityStatus with tradable, circuitBreakerOk, limitsOk, and limits
+     *
+     * @example
+     * ```typescript
+     * const status = await tradingService.getPoolTradabilityStatus(pool)
+     * if (!status.circuitBreakerOk) {
+     *   showModal("Trading temporarily suspended (circuit breaker)")
+     * } else if (!status.limitsOk) {
+     *   showModal("Trading limit reached", status.limits)
+     * }
+     * ```
+     */
+    async getPoolTradabilityStatus(pool) {
+        const [rateFeedId, limits] = await Promise.all([
+            this.getPoolRateFeedId(pool),
+            this.tradingLimitsService.getPoolTradingLimits(pool),
+        ]);
+        const tradingMode = await this.getRateFeedTradingMode(rateFeedId);
+        const circuitBreakerOk = (0, types_1.isTradingEnabled)(tradingMode);
+        // Limits are OK if no limits configured OR all limits have capacity
+        const limitsOk = limits.length === 0 || limits.every((l) => l.maxIn > 0n && l.maxOut > 0n);
+        return {
+            tradable: circuitBreakerOk && limitsOk,
+            circuitBreakerOk,
+            tradingMode,
+            limitsOk,
+            limits,
+        };
+    }
+    /**
+     * Get the reference rate feed ID for a pool.
+     * Both FPMM and Virtual pools expose this via the referenceRateFeedID() view function.
+     *
+     * @param pool - The pool to get rate feed ID for
+     * @returns The rate feed ID address
+     */
+    async getPoolRateFeedId(pool) {
+        const rateFeedId = await this.publicClient.readContract({
+            address: pool.poolAddr,
+            abi: abis_1.FPMM_ABI,
+            functionName: 'referenceRateFeedID',
+        });
+        return rateFeedId;
+    }
+}
+exports.TradingService = TradingService;
+//# sourceMappingURL=TradingService.js.map

package/dist/services/trading/TradingService.js.map

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

package/dist/services/trading/index.d.ts

@@ -0,0 +1,3 @@
+export * from './TradingService';
+export * from './TradingLimitsService';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/trading/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/trading/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}

package/dist/services/trading/index.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./TradingService"), exports);
+__exportStar(require("./TradingLimitsService"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/trading/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/trading/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC;AAChC,yDAAsC"}

package/dist/utils/chainConfig.d.ts

@@ -0,0 +1,16 @@
+import { type Chain } from 'viem/chains';
+/**
+ * Get the default RPC URL for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The default RPC URL for the chain
+ * @throws Error if chain ID is not supported
+ */
+export declare function getDefaultRpcUrl(chainId: number): string;
+/**
+ * Get the viem chain configuration for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The viem chain configuration
+ * @throws Error if chain ID is not supported
+ */
+export declare function getChainConfig(chainId: number): Chain;
+//# sourceMappingURL=chainConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chainConfig.d.ts","sourceRoot":"","sources":["../../src/utils/chainConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,KAAK,EAAE,MAAM,aAAa,CAAA;AA2B9C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASxD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CASrD"}

package/dist/utils/chainConfig.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultRpcUrl = getDefaultRpcUrl;
+exports.getChainConfig = getChainConfig;
+const chains_1 = require("viem/chains");
+const viem_1 = require("viem");
+const chainId_1 = require("../core/constants/chainId");
+// Celo Sepolia chain definition (not available in viem/chains yet)
+const celoSepolia = (0, viem_1.defineChain)({
+    id: 11142220,
+    name: 'Celo Sepolia',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'CELO',
+        symbol: 'CELO',
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://forno.celo-sepolia.celo-testnet.org'],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: 'Celo Explorer',
+            url: 'https://sepolia.celoscan.io',
+        },
+    },
+    testnet: true,
+});
+/**
+ * Get the default RPC URL for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The default RPC URL for the chain
+ * @throws Error if chain ID is not supported
+ */
+function getDefaultRpcUrl(chainId) {
+    switch (chainId) {
+        case chainId_1.ChainId.CELO:
+            return 'https://forno.celo.org';
+        case chainId_1.ChainId.CELO_SEPOLIA:
+            return 'https://forno.celo-sepolia.celo-testnet.org';
+        default:
+            throw new Error(`Unsupported chain ID: ${chainId}`);
+    }
+}
+/**
+ * Get the viem chain configuration for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The viem chain configuration
+ * @throws Error if chain ID is not supported
+ */
+function getChainConfig(chainId) {
+    switch (chainId) {
+        case chainId_1.ChainId.CELO:
+            return chains_1.celo;
+        case chainId_1.ChainId.CELO_SEPOLIA:
+            return celoSepolia;
+        default:
+            throw new Error(`Unsupported chain ID: ${chainId}`);
+    }
+}
+//# sourceMappingURL=chainConfig.js.map

package/dist/utils/chainConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainConfig.js","sourceRoot":"","sources":["../../src/utils/chainConfig.ts"],"names":[],"mappings":";;AAiCA,4CASC;AAQD,wCASC;AA3DD,wCAA8C;AAC9C,+BAAkC;AAClC,uDAAmD;AAEnD,mEAAmE;AACnE,MAAM,WAAW,GAAG,IAAA,kBAAW,EAAC;IAC9B,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,cAAc;IACpB,cAAc,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,MAAM;KACf;IACD,OAAO,EAAE;QACP,OAAO,EAAE;YACP,IAAI,EAAE,CAAC,6CAA6C,CAAC;SACtD;KACF;IACD,cAAc,EAAE;QACd,OAAO,EAAE;YACP,IAAI,EAAE,eAAe;YACrB,GAAG,EAAE,6BAA6B;SACnC;KACF;IACD,OAAO,EAAE,IAAI;CACd,CAAC,CAAA;AAEF;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,iBAAO,CAAC,IAAI;YACf,OAAO,wBAAwB,CAAA;QACjC,KAAK,iBAAO,CAAC,YAAY;YACvB,OAAO,6CAA6C,CAAA;QACtD;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAA;IACvD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC5C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,iBAAO,CAAC,IAAI;YACf,OAAO,aAAI,CAAA;QACb,KAAK,iBAAO,CAAC,YAAY;YACvB,OAAO,WAAW,CAAA;QACpB;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAA;IACvD,CAAC;AACH,CAAC"}

package/dist/utils/costUtils.d.ts

@@ -0,0 +1,12 @@
+import { Pool } from '../core/types';
+import type { PublicClient } from 'viem';
+/**
+ * Calculate cost percentage for a pool based on its type
+ * Returns cost as a percentage (e.g., 0.5 = 0.5%)
+ *
+ * @param pool - The pool to calculate cost for
+ * @param publicClient - Viem public client for RPC calls
+ * @returns Cost percentage for the pool
+ */
+export declare function getPoolCostPercent(pool: Pool, publicClient: PublicClient): Promise<number>;
+//# sourceMappingURL=costUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"costUtils.d.ts","sourceRoot":"","sources":["../../src/utils/costUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,IAAI,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGxC;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhG"}

package/dist/utils/costUtils.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPoolCostPercent = getPoolCostPercent;
+const types_1 = require("../core/types");
+const abis_1 = require("../core/abis");
+const virtualPool_1 = require("../core/abis/virtualPool");
+/**
+ * Calculate cost percentage for a pool based on its type
+ * Returns cost as a percentage (e.g., 0.5 = 0.5%)
+ *
+ * @param pool - The pool to calculate cost for
+ * @param publicClient - Viem public client for RPC calls
+ * @returns Cost percentage for the pool
+ */
+async function getPoolCostPercent(pool, publicClient) {
+    if (pool.poolType === types_1.PoolType.FPMM) {
+        return getFPMMCostPercent(pool.poolAddr, publicClient);
+    }
+    else if (pool.poolType === types_1.PoolType.Virtual) {
+        return getVirtualPoolCostPercent(pool.poolAddr, publicClient);
+    }
+    else {
+        throw new Error('Invalid pool type');
+    }
+}
+/**
+ * Calculate cost for FPMM pools
+ * FPMM pools use lpFee + protocolFee in basis points (10000 = 100%)
+ */
+async function getFPMMCostPercent(poolAddress, publicClient) {
+    const [lpFee, protocolFee] = await Promise.all([
+        publicClient.readContract({
+            address: poolAddress,
+            abi: abis_1.FPMM_ABI,
+            functionName: 'lpFee',
+        }),
+        publicClient.readContract({
+            address: poolAddress,
+            abi: abis_1.FPMM_ABI,
+            functionName: 'protocolFee',
+        }),
+    ]);
+    // Convert from basis points to percentage, rounded to 8dp for precision
+    const totalBasisPoints = Number(lpFee) + Number(protocolFee);
+    return Math.round((totalBasisPoints / 100) * 1e8) / 1e8;
+}
+/**
+ * Calculate cost for Virtual pools
+ */
+async function getVirtualPoolCostPercent(poolAddress, publicClient) {
+    const protocolFee = await publicClient.readContract({
+        address: poolAddress,
+        abi: virtualPool_1.VIRTUAL_POOL_ABI,
+        functionName: 'protocolFee',
+    });
+    // Convert from basis points to percentage, rounded to 8dp for precision
+    return Math.round((Number(protocolFee) / 100) * 1e8) / 1e8;
+}
+//# sourceMappingURL=costUtils.js.map

package/dist/utils/costUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costUtils.js","sourceRoot":"","sources":["../../src/utils/costUtils.ts"],"names":[],"mappings":";;AAaA,gDAQC;AArBD,yCAA8C;AAC9C,uCAAuC;AAEvC,0DAA2D;AAE3D;;;;;;;GAOG;AACI,KAAK,UAAU,kBAAkB,CAAC,IAAU,EAAE,YAA0B;IAC7E,IAAI,IAAI,CAAC,QAAQ,KAAK,gBAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IACxD,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,gBAAQ,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,yBAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IAC/D,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;IACtC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAAC,WAAmB,EAAE,YAA0B;IAC/E,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,WAA4B;YACrC,GAAG,EAAE,eAAQ;YACb,YAAY,EAAE,OAAO;SACtB,CAAoB;QACrB,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,WAA4B;YACrC,GAAG,EAAE,eAAQ;YACb,YAAY,EAAE,aAAa;SAC5B,CAAoB;KACtB,CAAC,CAAA;IAEF,wEAAwE;IACxE,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;IAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,gBAAgB,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAA;AACzD,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,yBAAyB,CAAC,WAAmB,EAAE,YAA0B;IACtF,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;QAClD,OAAO,EAAE,WAA4B;QACrC,GAAG,EAAE,8BAAgB;QACrB,YAAY,EAAE,aAAa;KAC5B,CAAC,CAAA;IAEF,wEAAwE;IACxE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAA;AAC5D,CAAC"}

package/dist/utils/index.d.ts

@@ -1,2 +1,9 @@
 export * from './retry';
+export * from './chainConfig';
+export * from './routes';
+export * from './sortUtils';
+export * from './pathEncoder';
+export * from './tokens';
+export * from './rateFeed';
+export * from './tradingLimits';
 //# sourceMappingURL=index.d.ts.map