@mento-protocol/mento-sdk 2.0.0-beta.8 → 3.0.0-beta.1

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/core/errors/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("./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,39 @@
+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;
+};
+/**
+ * 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;CAChB,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/{types → core/types}/index.d.ts

@@ -1,5 +1,6 @@
 export * from './contractAddresses';
 export * from './provider';
 export * from './token';
-export * from './exchange';
+export * from './route';
+export * from './pool';
 //# 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,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA"}

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

@@ -17,5 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./contractAddresses"), exports);
 __exportStar(require("./provider"), exports);
 __exportStar(require("./token"), exports);
-__exportStar(require("./exchange"), exports);
+__exportStar(require("./route"), exports);
+__exportStar(require("./pool"), 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,6CAA0B;AAC1B,0CAAuB;AACvB,0CAAuB;AACvB,yCAAsB"}

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

@@ -0,0 +1,35 @@
+/**
+ * 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}`;
+}
+//# 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":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,gEAAgE;IAChE,IAAI,SAAS;IACb,gEAAgE;IAChE,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAA;CACxB"}

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":"AAEA,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/provider.js

@@ -0,0 +1,4 @@
+"use strict";
+// TODO: Review and rename this file to something more descriptive
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=provider.js.map

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

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

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

@@ -0,0 +1,62 @@
+import { Pool } from './pool';
+import { Token } 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., 'cEUR-cUSD' not 'cUSD-cEUR')
+     * 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: [Token, Token];
+    /**
+     * 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,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B;;;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,KAAK,EAAE,KAAK,CAAC,CAAA;IAEtB;;;;;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/provider.js → core/types/route.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=provider.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,14 @@
-import { ISupplyCalculator } from '../services';
-export interface BaseToken {
-    name: string;
-    symbol: string;
+import { ISupplyCalculator } from '../../services';
+export interface Token {
     address: string;
-    decimals: number;
+    symbol: string;
+    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,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;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":""}

package/dist/index.d.ts

@@ -1,67 +1,60 @@
-import type { PublicClient } from 'viem';
-import type { Provider as EthersV6Provider } from 'ethers';
-import type { providers as EthersV5Providers } from 'ethers-v5';
-import { CollateralAsset, ContractAddresses, StableToken } from './types';
-export type SupportedProvider = EthersV6Provider | PublicClient | EthersV5Providers.Provider;
-export interface MentoConfig {
-    /** Provider can be one of:
-     * - Ethers v6 Provider (from 'ethers')
-     * - Ethers v5 Provider (from 'ethers-v5')
-     * - Viem PublicClient (from 'viem')
-     */
-    provider: SupportedProvider;
-}
+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';
 /**
  * @class Mento
- * @description The main class for the Mento SDK. It initializes the provider and services,
+ * @description The main class for the Mento SDK. Initializes a viem PublicClient internally
  *              and provides a public API for interacting with the Mento Protocol.
  * @dev         example usage:
- *              // Ethers v6
- *              const mento = await Mento.create({
- *                provider: new ethers.JsonRpcProvider("https://forno.celo.org")
- *              });
- *
- *              // Ethers v5
- *              const mento = await Mento.create({
- *                provider: new ethersV5.providers.JsonRpcProvider("https://forno.celo.org")
- *              });
- *
- *              // Viem
- *              const mento = await Mento.create({
- *                provider: createPublicClient({
- *                  transport: http("https://forno.celo.org")
- *                })
- *              });
+ *              const mento = await Mento.create(ChainId.CELO);
+ *              // or with custom RPC URL
+ *              const mento = await Mento.create(ChainId.CELO, 'https://custom-rpc-url.com');
  *
  *              // Get all stable tokens
- *              const stableTokens = await mento.getStableTokens();
+ *              const stableTokens = await mento.tokens.getStableTokens();
  *
  *              // Get all collateral assets
- *              const collateralAssets = await mento.getCollateralAssets();
+ *              const collateralAssets = await mento.tokens.getCollateralAssets();
+ *
+ *              // Get all pools
+ *              const pools = await mento.pools.getPools();
+ *
+ *              // Find a route between tokens
+ *              const route = await mento.routes.findRoute(cUSD, CELO);
+ *
+ *              // Get a quote for a swap
+ *              const amountOut = await mento.quotes.getAmountOut(cUSD, CELO, amountIn);
+ *
+ *              // Build swap parameters
+ *              const swapDetails = await mento.swap.buildSwapParams(cUSD, CELO, amountIn, { slippageTolerance: 0.5 });
  */
 export declare class Mento {
-    private provider;
-    private stableTokenService;
-    private collateralAssetService;
+    private chainId;
+    tokens: TokenService;
+    pools: PoolService;
+    routes: RouteService;
+    quotes: QuoteService;
+    swap: SwapService;
     private constructor();
-    static create(config: MentoConfig): Promise<Mento>;
-    getStableTokens(): Promise<StableToken[]>;
     /**
-     * Get all collateral assets that are available on the current chain.
-     * @returns An array of collateral assets
+     * Create a new Mento SDK instance
+     * @param chainId - The chain ID (e.g., ChainId.CELO, ChainId.CELO_SEPOLIA)
+     * @param rpcUrl - Optional RPC URL. If not provided, uses default for the chain
+     * @returns A new Mento instance
      */
-    getCollateralAssets(): Promise<CollateralAsset[]>;
+    static create(chainId: number, rpcUrl?: string): Promise<Mento>;
     /**
      * Get the address of a contract for the current chain
      * @param contractName - The contract name
      * @returns The contract address
      */
-    getContractAddress(contractName: keyof ContractAddresses): Promise<string>;
+    getContractAddress(contractName: keyof ContractAddresses): string;
 }
-export * from './constants';
-export * from './types';
-export * from './adapters';
+export * from './core/constants';
+export * from './core/types';
+export * from './core/abis';
 export * from './services';
-export * from './abis';
-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":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAG/D,OAAO,EACL,eAAe,EACf,iBAAiB,EAEjB,WAAW,EACZ,MAAM,SAAS,CAAA;AAKhB,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,YAAY,GACZ,iBAAiB,CAAC,QAAQ,CAAA;AAE9B,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,QAAQ,EAAE,iBAAiB,CAAA;CAC5B;AAgCD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,sBAAsB,CAAwB;IAEtD,OAAO;WAUa,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IAsBlD,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAItD;;;OAGG;IACU,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9D;;;;OAIG;IACU,kBAAkB,CAC7B,YAAY,EAAE,MAAM,iBAAiB,GACpC,OAAO,CAAC,MAAM,CAAC;CAInB;AAED,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,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,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"}