@mento-protocol/mento-sdk 3.0.0-beta.1 → 3.0.0-beta.10

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

@@ -0,0 +1,91 @@
+/**
+ * Human-friendly representation of a trading limit.
+ * Used by frontends to display limit status and calculate remaining capacity.
+ */
+export interface TradingLimit {
+    /** Token address this limit applies to */
+    asset: string;
+    /** Maximum amount that can flow IN (raw value - V1: 0 decimals, V2: 15 decimals) */
+    maxIn: bigint;
+    /** Maximum amount that can flow OUT (raw value - V1: 0 decimals, V2: 15 decimals) */
+    maxOut: bigint;
+    /** Unix timestamp when this limit window resets */
+    until: number;
+    /** Token decimals for consumer scaling */
+    decimals: number;
+}
+/**
+ * Trading limits configuration for V1 (Broker/Virtual pools).
+ * Uses configurable timeframes and 0 decimal precision.
+ */
+export interface TradingLimitsConfigV1 {
+    /** Time window in seconds for L0 limit */
+    timestep0: number;
+    /** Time window in seconds for L1 limit */
+    timestep1: number;
+    /** L0 limit value (0 decimal precision) */
+    limit0: bigint;
+    /** L1 limit value (0 decimal precision) */
+    limit1: bigint;
+    /** Global limit value (0 decimal precision) */
+    limitGlobal: bigint;
+    /** Flags bitmap: bit 0=L0, bit 1=L1, bit 2=LG */
+    flags: number;
+}
+/**
+ * Trading limits state for V1 (Broker/Virtual pools).
+ */
+export interface TradingLimitsStateV1 {
+    /** Timestamp of last L0 window reset */
+    lastUpdated0: number;
+    /** Timestamp of last L1 window reset */
+    lastUpdated1: number;
+    /** Current netflow for L0 (0 decimal precision) */
+    netflow0: bigint;
+    /** Current netflow for L1 (0 decimal precision) */
+    netflow1: bigint;
+    /** Current global netflow (0 decimal precision) */
+    netflowGlobal: bigint;
+}
+/**
+ * Trading limits configuration for V2 (FPMM pools).
+ * Uses fixed timeframes (5 min for L0, 1 day for L1) and 15 decimal precision.
+ */
+export interface TradingLimitsConfigV2 {
+    /** L0 limit value (15 decimal precision) */
+    limit0: bigint;
+    /** L1 limit value (15 decimal precision) */
+    limit1: bigint;
+    /** Token decimals */
+    decimals: number;
+}
+/**
+ * Trading limits state for V2 (FPMM pools).
+ */
+export interface TradingLimitsStateV2 {
+    /** Timestamp of last L0 window reset */
+    lastUpdated0: number;
+    /** Timestamp of last L1 window reset */
+    lastUpdated1: number;
+    /** Current netflow for L0 (15 decimal precision) */
+    netflow0: bigint;
+    /** Current netflow for L1 (15 decimal precision) */
+    netflow1: bigint;
+}
+/**
+ * Combined tradability status for a pool.
+ * Separates circuit breaker and trading limits for distinct UI messaging.
+ */
+export interface PoolTradabilityStatus {
+    /** Overall tradability (circuitBreakerOk AND limitsOk) */
+    tradable: boolean;
+    /** Circuit breaker status - true if not tripped */
+    circuitBreakerOk: boolean;
+    /** Raw trading mode value (0 = BIDIRECTIONAL, non-zero = suspended) */
+    tradingMode: number;
+    /** Trading limits status - true if limits not exhausted */
+    limitsOk: boolean;
+    /** Detailed limit info for UI display */
+    limits: TradingLimit[];
+}
+//# sourceMappingURL=tradingLimits.d.ts.map

package/dist/core/types/tradingLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tradingLimits.d.ts","sourceRoot":"","sources":["../../../src/core/types/tradingLimits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAA;IACb,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAA;IAEjB,mDAAmD;IACnD,gBAAgB,EAAE,OAAO,CAAA;IACzB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAA;IAEnB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAA;IACjB,yCAAyC;IACzC,MAAM,EAAE,YAAY,EAAE,CAAA;CACvB"}

package/dist/core/types/tradingLimits.js

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

package/dist/core/types/tradingLimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tradingLimits.js","sourceRoot":"","sources":["../../../src/core/types/tradingLimits.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,24 @@
+/**
+ * Trading modes for rate feeds in the BreakerBox circuit breaker.
+ *
+ * The BreakerBox uses a bitmask approach where multiple breakers can
+ * contribute to the final trading mode. In practice:
+ * - 0 = Bidirectional (trading enabled)
+ * - Any non-zero value = Trading suspended
+ *
+ * For SDK consumers, use isTradingEnabled() helper to check if trading
+ * is allowed.
+ */
+export declare enum TradingMode {
+    /** Bidirectional trading is enabled (normal operation) */
+    BIDIRECTIONAL = 0,
+    /** Trading is suspended (circuit breaker tripped) - any non-zero value */
+    SUSPENDED = 1
+}
+/**
+ * Check if trading is enabled for a given trading mode.
+ * @param mode - The trading mode value from BreakerBox
+ * @returns true if trading is enabled (mode === 0)
+ */
+export declare function isTradingEnabled(mode: number): boolean;
+//# sourceMappingURL=tradingMode.d.ts.map

package/dist/core/types/tradingMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tradingMode.d.ts","sourceRoot":"","sources":["../../../src/core/types/tradingMode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,oBAAY,WAAW;IACrB,0DAA0D;IAC1D,aAAa,IAAI;IACjB,0EAA0E;IAC1E,SAAS,IAAI;CACd;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/core/types/tradingMode.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TradingMode = void 0;
+exports.isTradingEnabled = isTradingEnabled;
+/**
+ * Trading modes for rate feeds in the BreakerBox circuit breaker.
+ *
+ * The BreakerBox uses a bitmask approach where multiple breakers can
+ * contribute to the final trading mode. In practice:
+ * - 0 = Bidirectional (trading enabled)
+ * - Any non-zero value = Trading suspended
+ *
+ * For SDK consumers, use isTradingEnabled() helper to check if trading
+ * is allowed.
+ */
+var TradingMode;
+(function (TradingMode) {
+    /** Bidirectional trading is enabled (normal operation) */
+    TradingMode[TradingMode["BIDIRECTIONAL"] = 0] = "BIDIRECTIONAL";
+    /** Trading is suspended (circuit breaker tripped) - any non-zero value */
+    TradingMode[TradingMode["SUSPENDED"] = 1] = "SUSPENDED";
+})(TradingMode || (exports.TradingMode = TradingMode = {}));
+/**
+ * Check if trading is enabled for a given trading mode.
+ * @param mode - The trading mode value from BreakerBox
+ * @returns true if trading is enabled (mode === 0)
+ */
+function isTradingEnabled(mode) {
+    return mode === TradingMode.BIDIRECTIONAL;
+}
+//# sourceMappingURL=tradingMode.js.map

package/dist/core/types/tradingMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tradingMode.js","sourceRoot":"","sources":["../../../src/core/types/tradingMode.ts"],"names":[],"mappings":";;;AAuBA,4CAEC;AAzBD;;;;;;;;;;GAUG;AACH,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,0DAA0D;IAC1D,+DAAiB,CAAA;IACjB,0EAA0E;IAC1E,uDAAa,CAAA;AACf,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,KAAK,WAAW,CAAC,aAAa,CAAA;AAC3C,CAAC"}

package/dist/core/types/transaction.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=transaction.d.ts.map

package/dist/core/types/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../src/core/types/transaction.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;CACd"}

package/dist/core/types/transaction.js

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

package/dist/core/types/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../src/core/types/transaction.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 import { ContractAddresses } from './core/types';
-import { TokenService } from '@services/tokens';
-import { PoolService } from '@services/pools';
-import { RouteService } from '@services/routes';
-import { QuoteService } from '@services/quotes';
-import { SwapService } from '@services/swap';
+import { TokenService } from './services/tokens';
+import { PoolService } from './services/pools';
+import { RouteService } from './services/routes';
+import { QuoteService } from './services/quotes';
+import { SwapService } from './services/swap';
+import { TradingService } from './services/trading';
 /**
  * @class Mento
  * @description The main class for the Mento SDK. Initializes a viem PublicClient internally
@@ -23,13 +24,22 @@ import { SwapService } from '@services/swap';
  *              const pools = await mento.pools.getPools();
  *
  *              // Find a route between tokens
- *              const route = await mento.routes.findRoute(cUSD, CELO);
+ *              const route = await mento.routes.findRoute(USDm, CELO);
  *
  *              // Get a quote for a swap
- *              const amountOut = await mento.quotes.getAmountOut(cUSD, CELO, amountIn);
+ *              const amountOut = await mento.quotes.getAmountOut(USDm, CELO, amountIn);
  *
  *              // Build swap parameters
- *              const swapDetails = await mento.swap.buildSwapParams(cUSD, CELO, amountIn, { slippageTolerance: 0.5 });
+ *              const swapDetails = await mento.swap.buildSwapParams(USDm, CELO, amountIn, { slippageTolerance: 0.5 });
+ *
+ *              // Check if a pair is tradable (circuit breaker check)
+ *              const isTradable = await mento.trading.isPairTradable(USDm, CELO);
+ *
+ *              // Get trading limits for a pool
+ *              const limits = await mento.trading.getPoolTradingLimits(pool);
+ *
+ *              // Get full tradability status (circuit breaker + limits)
+ *              const status = await mento.trading.getPoolTradabilityStatus(pool);
  */
 export declare class Mento {
     private chainId;
@@ -38,6 +48,7 @@ export declare class Mento {
     routes: RouteService;
     quotes: QuoteService;
     swap: SwapService;
+    trading: TradingService;
     private constructor();
     /**
      * Create a new Mento SDK instance
@@ -57,4 +68,5 @@ export * from './core/constants';
 export * from './core/types';
 export * from './core/abis';
 export * from './services';
+export * from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAIhD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,KAAK;IAEd,OAAO,CAAC,OAAO;IACR,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,WAAW;IAN1B,OAAO;IASP;;;;;OAKG;WACiB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAoB5E;;;;OAIG;IACI,kBAAkB,CAAC,YAAY,EAAE,MAAM,iBAAiB,GAAG,MAAM;CAGzE;AAED,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAIhD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,KAAK;IAEd,OAAO,CAAC,OAAO;IACR,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,cAAc;IAPhC,OAAO;IAUP;;;;;OAKG;WACiB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAqB5E;;;;OAIG;IACI,kBAAkB,CAAC,YAAY,EAAE,MAAM,iBAAiB,GAAG,MAAM;CAGzE;AAED,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -18,11 +18,12 @@ exports.Mento = void 0;
 const viem_1 = require("viem");
 const addresses_1 = require("./core/constants/addresses");
 const chainConfig_1 = require("./utils/chainConfig");
-const tokens_1 = require("@services/tokens");
-const pools_1 = require("@services/pools");
-const routes_1 = require("@services/routes");
-const quotes_1 = require("@services/quotes");
-const swap_1 = require("@services/swap");
+const tokens_1 = require("./services/tokens");
+const pools_1 = require("./services/pools");
+const routes_1 = require("./services/routes");
+const quotes_1 = require("./services/quotes");
+const swap_1 = require("./services/swap");
+const trading_1 = require("./services/trading");
 /**
  * @class Mento
  * @description The main class for the Mento SDK. Initializes a viem PublicClient internally
@@ -42,22 +43,32 @@ const swap_1 = require("@services/swap");
  *              const pools = await mento.pools.getPools();
  *
  *              // Find a route between tokens
- *              const route = await mento.routes.findRoute(cUSD, CELO);
+ *              const route = await mento.routes.findRoute(USDm, CELO);
  *
  *              // Get a quote for a swap
- *              const amountOut = await mento.quotes.getAmountOut(cUSD, CELO, amountIn);
+ *              const amountOut = await mento.quotes.getAmountOut(USDm, CELO, amountIn);
  *
  *              // Build swap parameters
- *              const swapDetails = await mento.swap.buildSwapParams(cUSD, CELO, amountIn, { slippageTolerance: 0.5 });
+ *              const swapDetails = await mento.swap.buildSwapParams(USDm, CELO, amountIn, { slippageTolerance: 0.5 });
+ *
+ *              // Check if a pair is tradable (circuit breaker check)
+ *              const isTradable = await mento.trading.isPairTradable(USDm, CELO);
+ *
+ *              // Get trading limits for a pool
+ *              const limits = await mento.trading.getPoolTradingLimits(pool);
+ *
+ *              // Get full tradability status (circuit breaker + limits)
+ *              const status = await mento.trading.getPoolTradabilityStatus(pool);
  */
 class Mento {
-    constructor(chainId, tokens, pools, routes, quotes, swap) {
+    constructor(chainId, tokens, pools, routes, quotes, swap, trading) {
         this.chainId = chainId;
         this.tokens = tokens;
         this.pools = pools;
         this.routes = routes;
         this.quotes = quotes;
         this.swap = swap;
+        this.trading = trading;
     }
     /**
      * Create a new Mento SDK instance
@@ -78,8 +89,9 @@ class Mento {
         const routeService = new routes_1.RouteService(publicClient, chainId, poolService);
         const quoteService = new quotes_1.QuoteService(publicClient, chainId, routeService);
         const swapService = new swap_1.SwapService(publicClient, chainId, routeService, quoteService);
+        const tradingService = new trading_1.TradingService(publicClient, chainId, routeService);
         // Return new mento
-        return new Mento(chainId, tokenService, poolService, routeService, quoteService, swapService);
+        return new Mento(chainId, tokenService, poolService, routeService, quoteService, swapService, tradingService);
     }
     /**
      * Get the address of a contract for the current chain
@@ -95,4 +107,5 @@ __exportStar(require("./core/constants"), exports);
 __exportStar(require("./core/types"), exports);
 __exportStar(require("./core/abis"), exports);
 __exportStar(require("./services"), exports);
+__exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+BAAkE;AAGlE,0DAA+D;AAC/D,qDAAsE;AACtE,6CAA+C;AAC/C,2CAA6C;AAC7C,6CAA+C;AAC/C,6CAA+C;AAC/C,yCAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAa,KAAK;IAChB,YACU,OAAe,EAChB,MAAoB,EACpB,KAAkB,EAClB,MAAoB,EACpB,MAAoB,EACpB,IAAiB;QALhB,YAAO,GAAP,OAAO,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAc;QACpB,UAAK,GAAL,KAAK,CAAa;QAClB,WAAM,GAAN,MAAM,CAAc;QACpB,WAAM,GAAN,MAAM,CAAc;QACpB,SAAI,GAAJ,IAAI,CAAa;IACvB,CAAC;IAEJ;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,MAAe;QACzD,gDAAgD;QAChD,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,MAAM,IAAI,IAAA,8BAAgB,EAAC,OAAO,CAAC,CAAC,CAAA;QAE3D,2BAA2B;QAC3B,MAAM,YAAY,GAAG,IAAA,yBAAkB,EAAC;YACtC,KAAK,EAAE,IAAA,4BAAc,EAAC,OAAO,CAAC;YAC9B,SAAS;SACV,CAAC,CAAA;QAEF,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC5D,MAAM,WAAW,GAAG,IAAI,mBAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC1D,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;QACzE,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QAC1E,MAAM,WAAW,GAAG,IAAI,kBAAW,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAA;QAEtF,mBAAmB;QACnB,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAA;IAC/F,CAAC;IAED;;;;OAIG;IACI,kBAAkB,CAAC,YAAqC;QAC7D,OAAO,IAAA,8BAAkB,EAAC,IAAI,CAAC,OAAkB,EAAE,YAAY,CAAC,CAAA;IAClE,CAAC;CACF;AA5CD,sBA4CC;AAED,mDAAgC;AAChC,+CAA4B;AAC5B,8CAA2B;AAC3B,6CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+BAAkE;AAGlE,0DAA+D;AAC/D,qDAAsE;AACtE,8CAAgD;AAChD,4CAA8C;AAC9C,8CAAgD;AAChD,8CAAgD;AAChD,0CAA6C;AAC7C,gDAAmD;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAa,KAAK;IAChB,YACU,OAAe,EAChB,MAAoB,EACpB,KAAkB,EAClB,MAAoB,EACpB,MAAoB,EACpB,IAAiB,EACjB,OAAuB;QANtB,YAAO,GAAP,OAAO,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAc;QACpB,UAAK,GAAL,KAAK,CAAa;QAClB,WAAM,GAAN,MAAM,CAAc;QACpB,WAAM,GAAN,MAAM,CAAc;QACpB,SAAI,GAAJ,IAAI,CAAa;QACjB,YAAO,GAAP,OAAO,CAAgB;IAC7B,CAAC;IAEJ;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,MAAe;QACzD,gDAAgD;QAChD,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,MAAM,IAAI,IAAA,8BAAgB,EAAC,OAAO,CAAC,CAAC,CAAA;QAE3D,2BAA2B;QAC3B,MAAM,YAAY,GAAG,IAAA,yBAAkB,EAAC;YACtC,KAAK,EAAE,IAAA,4BAAc,EAAC,OAAO,CAAC;YAC9B,SAAS;SACV,CAAC,CAAA;QAEF,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC5D,MAAM,WAAW,GAAG,IAAI,mBAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC1D,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;QACzE,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QAC1E,MAAM,WAAW,GAAG,IAAI,kBAAW,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAA;QACtF,MAAM,cAAc,GAAG,IAAI,wBAAc,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QAE9E,mBAAmB;QACnB,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,CAAC,CAAA;IAC/G,CAAC;IAED;;;;OAIG;IACI,kBAAkB,CAAC,YAAqC;QAC7D,OAAO,IAAA,8BAAkB,EAAC,IAAI,CAAC,OAAkB,EAAE,YAAY,CAAC,CAAA;IAClE,CAAC;CACF;AA9CD,sBA8CC;AAED,mDAAgC;AAChC,+CAA4B;AAC5B,8CAA2B;AAC3B,6CAA0B;AAC1B,0CAAuB"}

package/dist/services/index.d.ts

@@ -4,4 +4,5 @@ export * from './pools';
 export * from './routes';
 export * from './quotes';
 export * from './swap';
+export * from './trading';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA"}

package/dist/services/index.js

@@ -20,4 +20,5 @@ __exportStar(require("./pools"), exports);
 __exportStar(require("./routes"), exports);
 __exportStar(require("./quotes"), exports);
 __exportStar(require("./swap"), exports);
+__exportStar(require("./trading"), exports);
 //# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAgD;AAChD,kDAA+B;AAC/B,0CAAuB;AACvB,2CAAwB;AACxB,2CAAwB;AACxB,yCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAgD;AAChD,kDAA+B;AAC/B,0CAAuB;AACvB,2CAAwB;AACxB,2CAAwB;AACxB,yCAAsB;AACtB,4CAAyB"}

package/dist/services/pools/PoolService.d.ts

@@ -1,4 +1,4 @@
-import { Pool } from '../../core/types';
+import { Pool, PoolDetails } from '../../core/types';
 import { PublicClient } from 'viem';
 /**
  * Service for discovering liquidity pools in the Mento protocol.
@@ -14,7 +14,7 @@ export declare class PoolService {
      * Results are cached in memory for the service instance lifetime
      *
      * @returns Array of all pools available in the protocol
-     * @throws {Error} If RPC call fails or pools are unavailable
+     * @throws {Error} If no pools can be discovered from any factory
      *
      * @example
      * ```typescript
@@ -24,14 +24,26 @@ export declare class PoolService {
      */
     getPools(): Promise<Pool[]>;
     /**
-     * Fetches all FPMM pools from the FPMM Factory
-     */
-    private fetchFPMMPools;
-    /**
-     * Fetches all Virtual pools by discovering them from BiPoolManager exchanges.
-     * VirtualPoolFactory doesn't have an enumeration method,
-     * so we have to derive pools from BiPoolManager.
+     * Fetches enriched on-chain details for a specific pool by address.
+     * Resolves the pool type from the discovery cache, then fetches
+     * pool-type-specific data (pricing, fees, rebalancing for FPMM; reserves and spread for Virtual).
+     *
+     * @param poolAddr - The deployed pool contract address
+     * @returns Enriched pool details (FPMMPoolDetails or VirtualPoolDetails)
+     * @throws {Error} If the pool address is not found in any known factory
+     * @throws {Error} If on-chain calls fail
+     *
+     * @example
+     * ```typescript
+     * const details = await poolService.getPoolDetails('0x...')
+     * if (details.poolType === 'FPMM') {
+     *   console.log(details.pricing.oraclePrice)
+     *   console.log(details.rebalancing.inBand)
+     * } else {
+     *   console.log(details.spreadPercent)
+     * }
+     * ```
      */
-    private fetchVirtualPools;
+    getPoolDetails(poolAddr: string): Promise<PoolDetails>;
 }
 //# sourceMappingURL=PoolService.d.ts.map

package/dist/services/pools/PoolService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PoolService.d.ts","sourceRoot":"","sources":["../../../src/services/pools/PoolService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAY,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAW,MAAM,MAAM,CAAA;AAK5C;;;GAGG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,YAAY;IAAgB,OAAO,CAAC,OAAO;IAF/D,OAAO,CAAC,UAAU,CAAsB;gBAEpB,YAAY,EAAE,YAAY,EAAU,OAAO,EAAE,MAAM;IAEvE;;;;;;;;;;;;OAYG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAoBjC;;OAEG;YACW,cAAc;IAkD5B;;;;OAIG;YACW,iBAAiB;CAmEhC"}
+{"version":3,"file":"PoolService.d.ts","sourceRoot":"","sources":["../../../src/services/pools/PoolService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAY,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAInC;;;GAGG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,YAAY;IAAgB,OAAO,CAAC,OAAO;IAF/D,OAAO,CAAC,UAAU,CAAsB;gBAEpB,YAAY,EAAE,YAAY,EAAU,OAAO,EAAE,MAAM;IAEvE;;;;;;;;;;;;OAYG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAgCjC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAc7D"}

package/dist/services/pools/PoolService.js

@@ -1,11 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PoolService = void 0;
-const constants_1 = require("../../core/constants");
 const types_1 = require("../../core/types");
-const abis_1 = require("../../core/abis");
-const sortUtils_1 = require("../../utils/sortUtils");
-// TODO: Update to enrich pools with more data as needed. Use optional flag to include more data.
+const poolDiscovery_1 = require("./poolDiscovery");
+const poolDetails_1 = require("./poolDetails");
 /**
  * Service for discovering liquidity pools in the Mento protocol.
  * Aggregates pools from multiple factory contracts (FPMM and VirtualPool).
@@ -21,7 +19,7 @@ class PoolService {
      * Results are cached in memory for the service instance lifetime
      *
      * @returns Array of all pools available in the protocol
-     * @throws {Error} If RPC call fails or pools are unavailable
+     * @throws {Error} If no pools can be discovered from any factory
      *
      * @example
      * ```typescript
@@ -37,120 +35,56 @@ class PoolService {
         //       for dynamic factory discovery. For now we will use
         //       the hardcoded factory addresses for the chain for v1.
         const pools = [];
-        const fpmmPools = await this.fetchFPMMPools();
-        pools.push(...fpmmPools);
-        const virtualPools = await this.fetchVirtualPools();
-        pools.push(...virtualPools);
-        this.poolsCache = pools;
-        return pools;
-    }
-    /**
-     * Fetches all FPMM pools from the FPMM Factory
-     */
-    async fetchFPMMPools() {
-        const fpmmFactoryAddress = (0, constants_1.getContractAddress)(this.chainId, 'FPMMFactory');
-        if (!fpmmFactoryAddress) {
-            console.warn('FPMM Factory address not found for this chain');
-            return [];
+        try {
+            const fpmmPools = await (0, poolDiscovery_1.fetchFPMMPools)(this.publicClient, this.chainId);
+            pools.push(...fpmmPools);
         }
+        catch { }
         try {
-            // Get all deployed FPMM pool addresses
-            const poolAddresses = (await this.publicClient.readContract({
-                address: fpmmFactoryAddress,
-                abi: abis_1.FPMM_FACTORY_ABI,
-                functionName: 'deployedFPMMAddresses',
-            }));
-            if (poolAddresses.length === 0) {
-                return [];
-            }
-            const poolDataPromises = poolAddresses.map(async (poolAddress) => {
-                const [token0, token1] = await Promise.all([
-                    this.publicClient.readContract({
-                        address: poolAddress,
-                        abi: abis_1.FPMM_ABI,
-                        functionName: 'token0',
-                    }),
-                    this.publicClient.readContract({
-                        address: poolAddress,
-                        abi: abis_1.FPMM_ABI,
-                        functionName: 'token1',
-                    }),
-                ]);
-                return {
-                    factoryAddr: fpmmFactoryAddress,
-                    poolAddr: poolAddress,
-                    token0: token0,
-                    token1: token1,
-                    poolType: types_1.PoolType.FPMM,
-                };
-            });
-            return await Promise.all(poolDataPromises);
+            const virtualPools = await (0, poolDiscovery_1.fetchVirtualPools)(this.publicClient, this.chainId);
+            pools.push(...virtualPools);
         }
-        catch (error) {
-            console.error('Failed to fetch FPMM pools:', error);
-            throw new Error(`Failed to fetch FPMM pools: ${error.message}`);
+        catch { }
+        // Only throw if NO pools were discovered from any factory
+        if (pools.length === 0) {
+            throw new Error('Failed to discover any pools from any factory. ' +
+                'All pool factory queries failed. Check network connectivity and RPC endpoint.');
         }
+        this.poolsCache = pools;
+        return pools;
     }
     /**
-     * Fetches all Virtual pools by discovering them from BiPoolManager exchanges.
-     * VirtualPoolFactory doesn't have an enumeration method,
-     * so we have to derive pools from BiPoolManager.
+     * Fetches enriched on-chain details for a specific pool by address.
+     * Resolves the pool type from the discovery cache, then fetches
+     * pool-type-specific data (pricing, fees, rebalancing for FPMM; reserves and spread for Virtual).
+     *
+     * @param poolAddr - The deployed pool contract address
+     * @returns Enriched pool details (FPMMPoolDetails or VirtualPoolDetails)
+     * @throws {Error} If the pool address is not found in any known factory
+     * @throws {Error} If on-chain calls fail
+     *
+     * @example
+     * ```typescript
+     * const details = await poolService.getPoolDetails('0x...')
+     * if (details.poolType === 'FPMM') {
+     *   console.log(details.pricing.oraclePrice)
+     *   console.log(details.rebalancing.inBand)
+     * } else {
+     *   console.log(details.spreadPercent)
+     * }
+     * ```
      */
-    async fetchVirtualPools() {
-        const virtualPoolFactoryAddress = (0, constants_1.getContractAddress)(this.chainId, 'VirtualPoolFactory');
-        const biPoolManagerAddress = (0, constants_1.getContractAddress)(this.chainId, 'BiPoolManager');
-        if (!virtualPoolFactoryAddress || !biPoolManagerAddress) {
-            console.warn('VirtualPoolFactory or BiPoolManager address not found for this chain');
-            return [];
+    async getPoolDetails(poolAddr) {
+        const pools = await this.getPools();
+        const pool = pools.find((p) => p.poolAddr.toLowerCase() === poolAddr.toLowerCase());
+        if (!pool) {
+            throw new Error(`Pool not found: ${poolAddr}. ` + 'Ensure the address is a valid pool discovered by getPools().');
         }
-        try {
-            // TODO: When new virtual pool factory is deployed
-            //       we can simplify this by using VirtualPoolFactory.getAllPools() returns(address[])
-            // Get all exchanges from BiPoolManager
-            const exchangesData = (await this.publicClient.readContract({
-                address: biPoolManagerAddress,
-                abi: abis_1.BIPOOL_MANAGER_ABI,
-                functionName: 'getExchanges',
-            }));
-            if (exchangesData.length === 0) {
-                return [];
-            }
-            // For each exchange, check if a virtual pool exists, and if so, return the pool address.
-            const poolPromises = exchangesData.map(async (exchange) => {
-                if (exchange.assets.length !== 2) {
-                    console.warn(`Skipping invalid exchange ${exchange.exchangeId}: expected 2 assets`);
-                    return null;
-                }
-                const [token0, token1] = (0, sortUtils_1.sortTokenAddresses)(exchange.assets[0], exchange.assets[1]);
-                const poolAddress = (await this.publicClient.readContract({
-                    address: virtualPoolFactoryAddress,
-                    abi: abis_1.VIRTUAL_POOL_FACTORY_ABI,
-                    functionName: 'getOrPrecomputeProxyAddress',
-                    args: [token0, token1],
-                }));
-                const isDeployed = (await this.publicClient.readContract({
-                    address: virtualPoolFactoryAddress,
-                    abi: abis_1.VIRTUAL_POOL_FACTORY_ABI,
-                    functionName: 'isPool',
-                    args: [poolAddress],
-                }));
-                if (!isDeployed) {
-                    return null;
-                }
-                return {
-                    factoryAddr: virtualPoolFactoryAddress,
-                    poolAddr: poolAddress,
-                    token0: token0,
-                    token1: token1,
-                    poolType: types_1.PoolType.Virtual,
-                };
-            });
-            const results = await Promise.all(poolPromises);
-            return results.filter((pool) => pool !== null);
+        if (pool.poolType === types_1.PoolType.FPMM) {
+            return (0, poolDetails_1.fetchFPMMPoolDetails)(this.publicClient, this.chainId, pool);
         }
-        catch (error) {
-            console.error('Failed to fetch Virtual pools:', error);
-            throw new Error(`Failed to fetch Virtual pools: ${error.message}`);
+        else {
+            return (0, poolDetails_1.fetchVirtualPoolDetails)(this.publicClient, pool);
         }
     }
 }