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

package/dist/{constants → core/constants}/index.d.ts

@@ -1,8 +1,6 @@
 export * from './addresses';
 export * from './chainId';
-export * from './proposalState';
 export * from './contractNames';
-export * from './stableTokenMetadata';
 export * from './protocolAddresses';
 export * from './mentoAddresses';
 export * from './aaveConfig';

package/dist/core/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA"}

package/dist/{constants → core/constants}/index.js

@@ -16,9 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./addresses"), exports);
 __exportStar(require("./chainId"), exports);
-__exportStar(require("./proposalState"), exports);
 __exportStar(require("./contractNames"), exports);
-__exportStar(require("./stableTokenMetadata"), exports);
 __exportStar(require("./protocolAddresses"), exports);
 __exportStar(require("./mentoAddresses"), exports);
 __exportStar(require("./aaveConfig"), exports);

package/dist/core/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,4CAAyB;AACzB,kDAA+B;AAC/B,sDAAmC;AACnC,mDAAgC;AAChC,+CAA4B"}

package/dist/{constants → core/constants}/mentoAddresses.d.ts

@@ -1,5 +1,7 @@
 export declare const MENTO_ADDRESSES: {
     readonly PROTOCOL_MULTISIG: "0x87647780180b8f55980c7d3ffefe08a9b29e9ae1";
     readonly OPERATIONAL_WALLET: "0xDA7BFEF937F0944551a24b4C68B054bfA7127570";
+    readonly OPERATIONAL_WALLET_2: "0xD3D2e5c5Af667DA817b2D752d86c8f40c22137E1";
+    readonly REBALANCER_BOT: "0xaa8299FC6A685B5f9Ce9bdA8d0B3ea3D54731976";
 };
 //# sourceMappingURL=mentoAddresses.d.ts.map

package/dist/core/constants/mentoAddresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentoAddresses.d.ts","sourceRoot":"","sources":["../../../src/core/constants/mentoAddresses.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA"}

package/dist/{constants → core/constants}/mentoAddresses.js

@@ -4,5 +4,7 @@ exports.MENTO_ADDRESSES = void 0;
 exports.MENTO_ADDRESSES = {
     PROTOCOL_MULTISIG: '0x87647780180b8f55980c7d3ffefe08a9b29e9ae1',
     OPERATIONAL_WALLET: '0xDA7BFEF937F0944551a24b4C68B054bfA7127570',
+    OPERATIONAL_WALLET_2: '0xD3D2e5c5Af667DA817b2D752d86c8f40c22137E1',
+    REBALANCER_BOT: '0xaa8299FC6A685B5f9Ce9bdA8d0B3ea3D54731976',
 };
 //# sourceMappingURL=mentoAddresses.js.map

package/dist/core/constants/mentoAddresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentoAddresses.js","sourceRoot":"","sources":["../../../src/core/constants/mentoAddresses.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG;IAC7B,iBAAiB,EAAE,4CAA4C;IAC/D,kBAAkB,EAAE,4CAA4C;IAChE,oBAAoB,EAAE,4CAA4C;IAClE,cAAc,EAAE,4CAA4C;CACpD,CAAA"}

package/dist/core/constants/protocolAddresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolAddresses.d.ts","sourceRoot":"","sources":["../../../src/core/constants/protocolAddresses.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;CAGrB,CAAA"}

package/dist/core/constants/protocolAddresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolAddresses.js","sourceRoot":"","sources":["../../../src/core/constants/protocolAddresses.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG;IAChC,sBAAsB,EAAE,4CAA4C;IACpE,aAAa,EAAE,4CAA4C;CACnD,CAAA"}

package/dist/core/errors/base.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Base error class for all Mento SDK errors.
+ * Provides consistent error naming and proper prototype chain setup.
+ */
+export declare class MentoError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/core/errors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/core/errors/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAM5B"}

package/dist/core/errors/base.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MentoError = void 0;
+/**
+ * Base error class for all Mento SDK errors.
+ * Provides consistent error naming and proper prototype chain setup.
+ */
+class MentoError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+        // Maintains proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.MentoError = MentoError;
+//# sourceMappingURL=base.js.map

package/dist/core/errors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/core/errors/base.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;QACjC,yDAAyD;QACzD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACnD,CAAC;CACF;AAPD,gCAOC"}

package/dist/core/errors/index.d.ts

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

package/dist/core/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA"}

package/dist/{types → core/errors}/index.js

@@ -14,8 +14,6 @@ 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("./provider"), exports);
-__exportStar(require("./token"), exports);
-__exportStar(require("./exchange"), exports);
+__exportStar(require("./base"), exports);
+__exportStar(require("./router"), exports);
 //# sourceMappingURL=index.js.map

package/dist/core/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB;AACtB,2CAAwB"}

package/dist/core/errors/router.d.ts

@@ -0,0 +1,8 @@
+import { MentoError } from './base';
+/**
+ * Error thrown when no tradable route exists between two tokens.
+ */
+export declare class RouteNotFoundError extends MentoError {
+    constructor(tokenIn: string, tokenOut: string);
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/core/errors/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/errors/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAEnC;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAK9C"}

package/dist/core/errors/router.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteNotFoundError = void 0;
+const base_1 = require("./base");
+/**
+ * Error thrown when no tradable route exists between two tokens.
+ */
+class RouteNotFoundError extends base_1.MentoError {
+    constructor(tokenIn, tokenOut) {
+        super(`No route found for tokens ${tokenIn} and ${tokenOut}. They may not have a tradable path.`);
+    }
+}
+exports.RouteNotFoundError = RouteNotFoundError;
+//# sourceMappingURL=router.js.map

package/dist/core/errors/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/core/errors/router.ts"],"names":[],"mappings":";;;AAAA,iCAAmC;AAEnC;;GAEG;AACH,MAAa,kBAAmB,SAAQ,iBAAU;IAChD,YAAY,OAAe,EAAE,QAAgB;QAC3C,KAAK,CACH,6BAA6B,OAAO,QAAQ,QAAQ,sCAAsC,CAC3F,CAAA;IACH,CAAC;CACF;AAND,gDAMC"}

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

@@ -0,0 +1,41 @@
+import type { ChainId } from '../constants/chainId';
+/**
+ * All possible contract identifiers across all chains.
+ * Not all chains have all contracts deployed.
+ */
+export type ContractAddresses = {
+    FPMMFactory?: string;
+    VirtualPoolFactory?: string;
+    BreakerBox?: string;
+    MedianDeltaBreaker?: string;
+    SortedOracles?: string;
+    ValueDeltaBreaker?: string;
+    BiPoolManager?: string;
+    Broker?: string;
+    ConstantProductPricingModule?: string;
+    ConstantSumPricingModule?: string;
+    MentoRouter?: string;
+    Reserve?: string;
+    Airgrab?: string;
+    Emission?: string;
+    GovernanceFactory?: string;
+    Locking?: string;
+    MentoGovernor?: string;
+    MentoToken?: string;
+    TimelockController?: string;
+    StableToken?: string;
+    StableTokenEUR?: string;
+    StableTokenBRL?: string;
+    StableTokenXOF?: string;
+    Router?: string;
+    ReserveLiquidityStrategy?: string;
+    CDPLiquidityStrategy?: string;
+};
+/**
+ * Map of chain IDs to their contract addresses.
+ * Each chain may have a different subset of contracts deployed.
+ */
+export type ContractAddressMap = {
+    [key in ChainId]: ContractAddresses;
+};
+//# sourceMappingURL=contractAddresses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contractAddresses.d.ts","sourceRoot":"","sources":["../../../src/core/types/contractAddresses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAG3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAG1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4BAA4B,CAAC,EAAE,MAAM,CAAA;IACrC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAG3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;KAC9B,GAAG,IAAI,OAAO,GAAG,iBAAiB;CACpC,CAAA"}

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

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

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

@@ -0,0 +1,8 @@
+export * from './contractAddresses';
+export * from './transaction';
+export * from './token';
+export * from './route';
+export * from './pool';
+export * from './tradingMode';
+export * from './tradingLimits';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA"}

package/dist/core/types/index.js

@@ -0,0 +1,24 @@
+"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);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAmC;AACnC,gDAA6B;AAC7B,0CAAuB;AACvB,0CAAuB;AACvB,yCAAsB;AACtB,gDAA6B;AAC7B,kDAA+B"}

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

@@ -0,0 +1,145 @@
+/**
+ * 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 */
+    inBand: boolean;
+    /** The active liquidity strategy address for this pool, or null if none */
+    liquidityStrategy: string | null;
+}
+/**
+ * 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) */
+    decimals0: bigint;
+    /** Scaling factor for token1 (10^tokenDecimals) */
+    decimals1: 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 */
+    pricing: FPMMPricing;
+    /** 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) */
+    decimals0: bigint;
+    /** Scaling factor for token1 (10^tokenDecimals) */
+    decimals1: 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.d.ts.map

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

package/dist/core/types/pool.js

@@ -0,0 +1,14 @@
+"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/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../../src/core/types/pool.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,gEAAgE;IAChE,yBAAa,CAAA;IACb,gEAAgE;IAChE,+BAAmB,CAAA;AACrB,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/core/types/provider.ts"],"names":[],"mappings":"AACA,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/{types → core/types}/provider.js.map

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

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

@@ -0,0 +1,62 @@
+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/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/core/types/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AAE3C;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,EAAE,EAAE,OAAO,CAAA;IAEX;;;OAGG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;IAEhC;;;;;OAKG;IACH,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C;;;OAGG;IACH,QAAQ,EAAE;QACR;;;;WAIG;QACH,gBAAgB,EAAE,MAAM,CAAA;QAExB;;;WAGG;QACH,IAAI,EAAE,KAAK,CAAC;YACV;;eAEG;YACH,WAAW,EAAE,MAAM,CAAA;YAEnB;;eAEG;YACH,WAAW,EAAE,MAAM,CAAA;SACpB,CAAC,CAAA;KACH,CAAA;CACF"}

package/dist/{types/exchange.js → core/types/route.js}

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

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

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

package/dist/{types → core/types}/token.d.ts

@@ -1,14 +1,24 @@
-import { ISupplyCalculator } from '../services';
-export interface BaseToken {
-    name: string;
-    symbol: string;
+import { ISupplyCalculator } from '../../services';
+/**
+ * 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 BaseToken {
+export interface StableToken extends Token {
     totalSupply: string;
 }
-export type CollateralAsset = BaseToken;
+export type CollateralAsset = Token;
 /**
  * A supply adjustment is a calculator that is used to adjust the supply of a token.
  * It takes the address of the token and will return the amount that should be removed

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

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/core/types/token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,KAAM,SAAQ,UAAU;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,KAAK,CAAA;AAEnC;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,iBAAiB,CAAA;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,gBAAgB,EAAE,CAAA;CACnD"}

package/dist/{types → core/types}/token.js.map

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