@mento-protocol/mento-sdk 3.2.2-beta1 → 3.2.3

package/dist/core/types/index.js

@@ -1,26 +0,0 @@
-"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("./contractAddresses"), exports);
-__exportStar(require("./transaction"), exports);
-__exportStar(require("./token"), exports);
-__exportStar(require("./route"), exports);
-__exportStar(require("./pool"), exports);
-__exportStar(require("./tradingMode"), exports);
-__exportStar(require("./tradingLimits"), exports);
-__exportStar(require("./liquidity"), exports);
-__exportStar(require("./borrow"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1,194 +0,0 @@
-import { CallParams } from './transaction';
-import { LiquidityStrategyDirection } from './pool';
-import { RouterRoute } from '../../utils/pathEncoder';
-export interface LiquidityOptions {
-    slippageTolerance: number;
-    deadline: bigint;
-}
-export interface AddLiquidityQuote {
-    amountA: bigint;
-    amountB: bigint;
-    liquidity: bigint;
-}
-export interface RemoveLiquidityQuote {
-    amount0: bigint;
-    amount1: bigint;
-}
-export interface AddLiquidityDetails {
-    params: CallParams;
-    poolAddress: string;
-    token0: string;
-    token1: string;
-    tokenA: string;
-    tokenB: string;
-    amountADesired: bigint;
-    amountBDesired: bigint;
-    amountAMin: bigint;
-    amountBMin: bigint;
-    estimatedMinLiquidity: bigint;
-    deadline: bigint;
-}
-export interface RemoveLiquidityDetails {
-    params: CallParams;
-    poolAddress: string;
-    token0: string;
-    token1: string;
-    liquidity: bigint;
-    amount0Min: bigint;
-    amount1Min: bigint;
-    expectedAmount0: bigint;
-    expectedAmount1: bigint;
-    deadline: bigint;
-}
-export interface TokenApproval {
-    token: string;
-    amount: bigint;
-    params: CallParams;
-}
-export interface AddLiquidityTransaction {
-    approvalA: TokenApproval | null;
-    approvalB: TokenApproval | null;
-    addLiquidity: AddLiquidityDetails;
-}
-export interface RemoveLiquidityTransaction {
-    approval: TokenApproval | null;
-    removeLiquidity: RemoveLiquidityDetails;
-}
-export interface LPTokenBalance {
-    poolAddress: string;
-    balance: bigint;
-    token0: string;
-    token1: string;
-    totalSupply: bigint;
-    sharePercent: number;
-}
-export interface ZapParams {
-    tokenA: string;
-    tokenB: string;
-    factory: string;
-    amountOutMinA: bigint;
-    amountOutMinB: bigint;
-    amountAMin: bigint;
-    amountBMin: bigint;
-}
-export interface ZapInQuote {
-    amountOutFromA: bigint;
-    amountOutFromB: bigint;
-    amountAMin: bigint;
-    amountBMin: bigint;
-    estimatedMinLiquidity: bigint;
-}
-export interface ZapOutQuote {
-    amountOutFromA: bigint;
-    amountOutFromB: bigint;
-    amountAMin: bigint;
-    amountBMin: bigint;
-    estimatedMinTokenOut: bigint;
-}
-export interface ZapInDetails {
-    params: CallParams;
-    poolAddress: string;
-    tokenIn: string;
-    amountIn: bigint;
-    amountInA: bigint;
-    amountInB: bigint;
-    routesA: RouterRoute[];
-    routesB: RouterRoute[];
-    zapParams: ZapParams;
-    estimatedMinLiquidity: bigint;
-}
-export interface ZapOutDetails {
-    params: CallParams;
-    poolAddress: string;
-    tokenOut: string;
-    liquidity: bigint;
-    routesA: RouterRoute[];
-    routesB: RouterRoute[];
-    zapParams: ZapParams;
-    estimatedMinTokenOut: bigint;
-}
-export interface ZapInTransaction {
-    approval: TokenApproval | null;
-    zapIn: ZapInDetails;
-}
-export interface ZapOutTransaction {
-    approval: TokenApproval | null;
-    zapOut: ZapOutDetails;
-}
-export interface RebalanceDetails {
-    params: CallParams;
-    poolAddress: string;
-    strategyAddress: string;
-    inputToken: string;
-    outputToken: string;
-    amountRequired: bigint;
-    expectedAmountTransferred: bigint;
-    expectedProtocolIncentive: bigint;
-    expectedLiquiditySourceIncentive: bigint;
-    approvalToken: string;
-    approvalSpender: string;
-    approvalAmount: bigint;
-    direction: LiquidityStrategyDirection;
-}
-export interface RebalanceTransaction {
-    approval: TokenApproval | null;
-    rebalance: RebalanceDetails;
-}
-export interface PreparedZapIn {
-    routesA: RouterRoute[];
-    routesB: RouterRoute[];
-    quote: ZapInQuote;
-    approval?: TokenApproval | null;
-    details: ZapInDetails;
-}
-export interface PreparedZapOut {
-    routesA: RouterRoute[];
-    routesB: RouterRoute[];
-    quote: ZapOutQuote;
-    approval?: TokenApproval | null;
-    details: ZapOutDetails;
-}
-/** Input for adding liquidity (without approval handling) */
-export interface AddLiquidityInput {
-    poolAddress: string;
-    tokenA: string;
-    amountA: bigint;
-    tokenB: string;
-    amountB: bigint;
-    recipient: string;
-    options: LiquidityOptions;
-}
-/** Input for removing liquidity (without approval handling) */
-export interface RemoveLiquidityInput {
-    poolAddress: string;
-    liquidity: bigint;
-    recipient: string;
-    options: LiquidityOptions;
-}
-/** Input for zap in (without approval handling) */
-export interface ZapInInput {
-    poolAddress: string;
-    tokenIn: string;
-    amountIn: bigint;
-    amountInSplit: number;
-    recipient: string;
-    options: LiquidityOptions;
-}
-export interface PrepareZapInInput extends ZapInInput {
-    owner?: string;
-}
-/** Input for zap out (without approval handling) */
-export interface ZapOutInput {
-    poolAddress: string;
-    tokenOut: string;
-    liquidity: bigint;
-    recipient: string;
-    options: LiquidityOptions;
-}
-export interface PrepareZapOutInput extends ZapOutInput {
-    owner?: string;
-}
-export interface RebalanceInput {
-    poolAddress: string;
-}
-//# sourceMappingURL=liquidity.d.ts.map

package/dist/core/types/liquidity.js

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

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

@@ -1,208 +0,0 @@
-/**
- * Types of liquidity pools supported in the Mento protocol
- */
-export declare enum PoolType {
-    /** FPMM (Fixed Product Market Maker) pools - v3 native pools */
-    FPMM = "FPMM",
-    /** Virtual pools - wrapper around v2 BiPoolManager exchanges */
-    Virtual = "Virtual"
-}
-/**
- * Represents a liquidity pool between two tokens in the Mento protocol
- */
-export interface Pool {
-    /**
-     * The address of the factory contract that was used to deploy this pool
-     */
-    factoryAddr: string;
-    /**
-     * The deployed pool contract address (serves as unique identifier)
-     */
-    poolAddr: string;
-    /**
-     * The address of the first token in the pool
-     */
-    token0: string;
-    /**
-     * The address of the second token in the pool
-     */
-    token1: string;
-    /**
-     * The type of pool (FPMM or Virtual)
-     */
-    poolType: `${PoolType}`;
-    /**
-     * The exchange ID from BiPoolManager (Virtual pools only).
-     */
-    exchangeId?: string;
-}
-/**
- * Pricing and oracle data for an FPMM pool
- */
-export interface FPMMPricing {
-    /** Raw oracle price numerator from contract */
-    oraclePriceNum: bigint;
-    /** Raw oracle price denominator from contract */
-    oraclePriceDen: bigint;
-    /** Oracle price as a decimal number (num / den) */
-    oraclePrice: number;
-    /** Raw reserve/pool price numerator from contract */
-    reservePriceNum: bigint;
-    /** Raw reserve/pool price denominator from contract */
-    reservePriceDen: bigint;
-    /** Reserve/pool price as a decimal number (num / den) */
-    reservePrice: number;
-    /** Price difference in basis points (raw from contract) */
-    priceDifferenceBps: bigint;
-    /** Price difference as a percentage (bps / 100, e.g. 12 bps → 0.12%) */
-    priceDifferencePercent: number;
-    /** Whether the reserve/pool price is above the oracle price */
-    reservePriceAboveOraclePrice: boolean;
-}
-/**
- * Fee configuration for an FPMM pool
- */
-export interface FPMMFees {
-    /** LP fee in basis points (raw) */
-    lpFeeBps: bigint;
-    /** LP fee as a percentage (e.g. 0.25 = 0.25%) */
-    lpFeePercent: number;
-    /** Protocol fee in basis points (raw) */
-    protocolFeeBps: bigint;
-    /** Protocol fee as a percentage */
-    protocolFeePercent: number;
-    /** Total fee (lpFee + protocolFee) as a percentage */
-    totalFeePercent: number;
-}
-/**
- * Rebalancing state and configuration for an FPMM pool
- */
-export interface FPMMRebalancing {
-    /** Rebalance incentive in basis points (raw) */
-    rebalanceIncentiveBps: bigint;
-    /** Rebalance incentive as a percentage */
-    rebalanceIncentivePercent: number;
-    /** Threshold above oracle price in basis points (raw) */
-    rebalanceThresholdAboveBps: bigint;
-    /** Threshold above as a percentage */
-    rebalanceThresholdAbovePercent: number;
-    /** Threshold below oracle price in basis points (raw) */
-    rebalanceThresholdBelowBps: bigint;
-    /** Threshold below as a percentage */
-    rebalanceThresholdBelowPercent: number;
-    /** Whether the current price is within rebalancing thresholds (null when pricing unavailable) */
-    inBand: boolean | null;
-    /** The registered Open Liquidity Strategy address for this pool, or null if none */
-    liquidityStrategy: string | null;
-}
-export type LiquidityStrategyDirection = 'Expand' | 'Contract';
-export interface LiquidityStrategyRebalanceIncentives {
-    liquiditySourceIncentiveExpansion: bigint;
-    protocolIncentiveExpansion: bigint;
-    liquiditySourceIncentiveContraction: bigint;
-    protocolIncentiveContraction: bigint;
-}
-export interface LiquidityStrategyPoolConfig {
-    isToken0Debt: boolean;
-    lastRebalance: number;
-    rebalanceCooldown: number;
-    protocolFeeRecipient: string;
-    liquiditySourceIncentiveExpansion: bigint;
-    protocolIncentiveExpansion: bigint;
-    liquiditySourceIncentiveContraction: bigint;
-    protocolIncentiveContraction: bigint;
-}
-export interface LiquidityStrategyContext {
-    pool: string;
-    reserves: {
-        reserveNum: bigint;
-        reserveDen: bigint;
-    };
-    prices: {
-        oracleNum: bigint;
-        oracleDen: bigint;
-        poolPriceAbove: boolean;
-        rebalanceThreshold: number;
-    };
-    token0: string;
-    token1: string;
-    token0Dec: bigint;
-    token1Dec: bigint;
-    isToken0Debt: boolean;
-    incentives: LiquidityStrategyRebalanceIncentives;
-}
-export interface LiquidityStrategyAction {
-    dir: LiquidityStrategyDirection;
-    amount0Out: bigint;
-    amount1Out: bigint;
-    amountOwedToPool: bigint;
-}
-export interface PoolRebalanceTokenAmount {
-    token: string;
-    amount: bigint;
-}
-export interface PoolRebalancePreview {
-    poolAddress: string;
-    strategyAddress: string;
-    direction: LiquidityStrategyDirection;
-    config: LiquidityStrategyPoolConfig;
-    context: LiquidityStrategyContext;
-    action: LiquidityStrategyAction;
-    inputToken: string;
-    outputToken: string;
-    amountRequired: PoolRebalanceTokenAmount;
-    amountTransferred: PoolRebalanceTokenAmount;
-    protocolIncentive: PoolRebalanceTokenAmount;
-    liquiditySourceIncentive: PoolRebalanceTokenAmount;
-    approvalToken: string;
-    approvalSpender: string;
-    approvalAmount: bigint;
-}
-/**
- * Enriched details for an FPMM pool including pricing, fees, and rebalancing state
- */
-export interface FPMMPoolDetails extends Pool {
-    poolType: 'FPMM';
-    /** Scaling factor for token0 (10^tokenDecimals) */
-    scalingFactor0: bigint;
-    /** Scaling factor for token1 (10^tokenDecimals) */
-    scalingFactor1: bigint;
-    /** Reserve of token0 (raw) */
-    reserve0: bigint;
-    /** Reserve of token1 (raw) */
-    reserve1: bigint;
-    /** Block timestamp of last reserve update */
-    blockTimestampLast: bigint;
-    /** Pricing and oracle data (null when FX market is closed) */
-    pricing: FPMMPricing | null;
-    /** Fee configuration */
-    fees: FPMMFees;
-    /** Rebalancing state */
-    rebalancing: FPMMRebalancing;
-}
-/**
- * Enriched details for a Virtual pool including reserves and spread
- */
-export interface VirtualPoolDetails extends Pool {
-    poolType: 'Virtual';
-    /** Scaling factor for token0 (10^tokenDecimals) */
-    scalingFactor0: bigint;
-    /** Scaling factor for token1 (10^tokenDecimals) */
-    scalingFactor1: bigint;
-    /** Reserve (bucket) of token0 (raw) */
-    reserve0: bigint;
-    /** Reserve (bucket) of token1 (raw) */
-    reserve1: bigint;
-    /** Block timestamp of last reserve update */
-    blockTimestampLast: bigint;
-    /** Spread/fee in basis points (raw) */
-    spreadBps: bigint;
-    /** Spread as a percentage (e.g. 0.5 = 0.5%) */
-    spreadPercent: number;
-}
-/**
- * Discriminated union of enriched pool details.
- * Use `poolType` to narrow the type.
- */
-export type PoolDetails = FPMMPoolDetails | VirtualPoolDetails;
-//# sourceMappingURL=pool.d.ts.map

package/dist/core/types/pool.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PoolType = void 0;
-/**
- * Types of liquidity pools supported in the Mento protocol
- */
-var PoolType;
-(function (PoolType) {
-    /** FPMM (Fixed Product Market Maker) pools - v3 native pools */
-    PoolType["FPMM"] = "FPMM";
-    /** Virtual pools - wrapper around v2 BiPoolManager exchanges */
-    PoolType["Virtual"] = "Virtual";
-})(PoolType || (exports.PoolType = PoolType = {}));
-//# sourceMappingURL=pool.js.map

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

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

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

@@ -1,62 +0,0 @@
-import { Pool } from './pool';
-import { RouteToken } from './token';
-/**
- * Route identifier: sorted symbols joined with hyphen
- * Represents the two endpoint tokens regardless of the path taken
- */
-export type RouteID = `${string}-${string}`;
-/**
- * Represents a tradable route between two tokens, including the pool path needed to execute the trade
- */
-export interface Route {
-    /**
-     * Canonical identifier: sorted symbols joined with hyphen
-     * Always uses alphabetical order (e.g., 'EURm-USDm' not 'USDm-EURm')
-     * Ensures consistent identification regardless of query direction
-     */
-    id: RouteID;
-    /**
-     * The two tokens being traded, in alphabetical order by symbol
-     * Always [symbolA, symbolB] where symbolA < symbolB alphabetically
-     */
-    tokens: [RouteToken, RouteToken];
-    /**
-     * Array of exchange hops needed to execute the trade
-     * Length 1: Direct route (single pool)
-     * Length 2: Two-hop route via intermediate token through two pools
-     * Order matters for execution
-     */
-    path: Array<Pool>;
-}
-/**
- * Extended route with cost data for route optimization
- */
-export interface RouteWithCost extends Route {
-    /**
-     * Cost data for this route
-     * Used to select optimal route when multiple options exist
-     */
-    costData: {
-        /**
-         * Total cost percentage for this route
-         * Lower is better (more cost-efficient)
-         * Example: 0.3 means 0.3% cost
-         */
-        totalCostPercent: number;
-        /**
-         * Per-hop cost breakdown
-         * Used for detailed cost analysis and debugging
-         */
-        hops: Array<{
-            /**
-             * Pool Address for this hop
-             */
-            poolAddress: string;
-            /**
-             * Cost percentage for this specific hop
-             */
-            costPercent: number;
-        }>;
-    };
-}
-//# sourceMappingURL=route.d.ts.map

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

@@ -1,21 +0,0 @@
-/**
- * Minimal token info for routing purposes.
- * Contains only the fields needed to identify and route between tokens.
- */
-export interface RouteToken {
-    address: string;
-    symbol: string;
-}
-/**
- * Full token info for consumer-facing operations.
- * Extends RouteToken with display and transaction fields.
- */
-export interface Token extends RouteToken {
-    name: string;
-    decimals: number;
-}
-export interface StableToken extends Token {
-    totalSupply: string;
-}
-export type CollateralAsset = Token;
-//# sourceMappingURL=token.d.ts.map

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

@@ -1,91 +0,0 @@
-/**
- * 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.js

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

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

@@ -1,24 +0,0 @@
-/**
- * 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