@mento-protocol/mento-sdk 1.10.2 → 2.0.0-beta.10

package/README.md

@@ -1,67 +1,133 @@
 # Mento SDK
 
-The official Mento Protocol SDK for interacting with Multi-Collateral Mento smart contracts on the Celo network.
+A TypeScript SDK for interacting with the Mento protocol. This SDK provides a simple interface to interact with Mento's smart contracts, supporting both Ethers.js and Viem providers.
 
 ## Installation
 
-```sh
-# Install with npm
-npm install @mento-protocol/mento-sdk
+```bash
+npm install @mento/sdk
+# or
+yarn add @mento/sdk
+# or
+pnpm add @mento/sdk
+```
+
+## Quick Start
+
+### Initialize with Viem
+
+```typescript
+import { createPublicClient, http } from 'viem'
+import { celo } from 'viem/chains'
+import { Mento } from '@mento/sdk'
+
+// Create Viem client
+const provider = createPublicClient({
+  chain: celo,
+  transport: http(),
+})
+
+// Initialize Mento SDK
+const mento = new Mento({ provider })
+
+// Use the SDK
+const stableTokens = await mento.stable.getStableTokens()
+console.log('Stable Tokens:', stableTokens)
+```
+
+### Initialize with Ethers.js
+
+```typescript
+import { JsonRpcProvider } from 'ethers'
+import { Mento } from '@mento/sdk'
+
+// Create Ethers provider
+const provider = new JsonRpcProvider('YOUR_RPC_URL')
+
+// Initialize Mento SDK
+const mento = new Mento({ provider })
+
+// Use the SDK
+const collateralAssets = await mento.collateral.getCollateralAssets()
+console.log('Collateral Assets:', collateralAssets)
+```
+
+## Development Setup
+
+### Project Setup
 
-# Or install with yarn
-yarn add @mento-protocol/mento-sdk
+1. Clone the repository
+
+```bash
+git clone git@github.com:mento-protocol/mento-sdk.git
+cd mento-sdk
+```
+
+2. Install dependencies
+
+```bash
+pnpm install
+```
+
+### Development Workflow
+
+#### Build
+
+```bash
+pnpm build
 ```
 
-## Learn more
+#### Running Tests
 
-You can find example usages of the SDK in the [mento-sdk-examples](https://github.com/mento-protocol/mento-sdk-examples) repository. For in-depth documentation and walk through explanations please see the [SDK section](https://docs.mento.org/mento/developers/mento-sdk) of the Mento docs.
+```bash
+# Run all tests
+pnpm test
+```
+
+### Project Structure
+
+```bash
+├── src/
+│   ├── abis/           # Contract ABIs
+│   ├── adapters/       # Provider adapters (Ethers, Viem)
+│   ├── constants/      # Constants and addresses
+│   ├── services/       # Core services
+│   ├── types/          # TypeScript type definitions
+|   ├── utils/          # Utility functions
+│   └── index.ts        # Main entry point
+├── tests/
+│   ├── unit/          # Unit tests
+│   └── integration/   # Integration tests
+```
 
-## Tradable Pairs Cache
+## Features
 
-Anytime we launch a new stable token, we need to update the tradable pairs cache.
+### Stable Tokens
 
-The `yarn cacheTradablePairs` script generates a TypeScript file containing a list of all tradable pairs on the Mento protocol. This file is used to cache the tradable pairs in the SDK and avoid costly re-fetching from the network.
+Query Mento stable tokens:
 
-```sh
-yarn cacheTradablePairs
+```typescript
+// Get all stable tokens
+const tokens = await mento.getStableTokens()
 ```
 
-## Token Graph Visualization
-
-Current token connectivity on Celo Mainnet (last updated: 2025-06-19):
-
-```mermaid
-graph TD
-    USDT["USD₮"]
-    USDC --- cUSD
-    USDT --- cUSD
-    CELO --- cEUR
-    CELO --- cREAL
-    USDC --- cREAL
-    USDC --- cEUR
-    axlUSDC --- cUSD
-    CELO --- cUSD
-    PUSO --- cUSD
-    cJPY --- cUSD
-    cCOP --- cUSD
-    cGBP --- cUSD
-    cUSD --- cZAR
-    cCAD --- cUSD
-    cAUD --- cUSD
-    cCHF --- cUSD
-    axlUSDC --- cEUR
-    axlUSDC --- cREAL
-    axlEUROC --- cEUR
-    cKES --- cUSD
-    cGHS --- cUSD
-    cNGN --- cUSD
-    CELO --- eXOF
-    axlEUROC --- eXOF
+### Collateral Assets
+
+Retrieve collateral assets:
 
+```typescript
+// Get all collateral assets
+const assets = await mento.getCollateralAssets()
 ```
 
-**Network Stats:** 20 tokens, 24 direct trading pairs
+## Contributing
+
+Contributions are welcome! Please read our contributing guidelines for details.
+
+## License
+
+MIT
+
+---
 
-> 💡 This graph shows direct trading pairs only. The SDK automatically finds optimal routes including multi-hop paths.
->
-> To regenerate: `yarn getTokenGraph`
+For more detailed documentation and examples, visit our [documentation site](https://docs.mento.org).

package/dist/abis/bipoolmanager.d.ts

@@ -0,0 +1,15 @@
+export declare const BIPOOL_MANAGER_ABI: {
+    name: string;
+    type: string;
+    stateMutability: string;
+    inputs: never[];
+    outputs: {
+        name: string;
+        type: string;
+        components: {
+            name: string;
+            type: string;
+        }[];
+    }[];
+}[];
+//# sourceMappingURL=bipoolmanager.d.ts.map

package/dist/abis/bipoolmanager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bipoolmanager.d.ts","sourceRoot":"","sources":["../../src/abis/bipoolmanager.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;GAqB9B,CAAC"}

package/dist/abis/bipoolmanager.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BIPOOL_MANAGER_ABI = void 0;
+exports.BIPOOL_MANAGER_ABI = [
+    {
+        name: "getExchanges",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{
+                name: "exchanges",
+                type: "tuple[]",
+                components: [
+                    {
+                        name: "exchangeId",
+                        type: "bytes32",
+                    },
+                    {
+                        name: "assets",
+                        type: "address[]",
+                    },
+                ],
+            }],
+    },
+];
+//# sourceMappingURL=bipoolmanager.js.map

package/dist/abis/bipoolmanager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bipoolmanager.js","sourceRoot":"","sources":["../../src/abis/bipoolmanager.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG;IACjC;QACC,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC;gBACT,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE;oBACX;wBACC,IAAI,EAAE,YAAY;wBAClB,IAAI,EAAE,SAAS;qBACf;oBACD;wBACC,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,WAAW;qBACjB;iBACD;aACD,CAAC;KACF;CACD,CAAC"}

package/dist/abis/broker.d.ts

@@ -0,0 +1,2 @@
+export declare const BROKER_ABI: string[];
+//# sourceMappingURL=broker.d.ts.map

package/dist/abis/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/abis/broker.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,UAGtB,CAAA"}

package/dist/abis/broker.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BROKER_ABI = void 0;
+exports.BROKER_ABI = [
+    'function tradingLimitsConfig(bytes32) view returns (uint32 timestep0, uint32 timestep1, int48 limit0, int48 limit1, int48 limitGlobal, uint8 flags)',
+    'function tradingLimitsState(bytes32) view returns (uint32 lastUpdated0, uint32 lastUpdated1, int48 netflow0, int48 netflow1, int48 netflowGlobal)',
+];
+//# sourceMappingURL=broker.js.map

package/dist/abis/broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../src/abis/broker.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,qJAAqJ;IACrJ,mJAAmJ;CACpJ,CAAA"}

package/dist/abis/erc20.d.ts

@@ -0,0 +1,2 @@
+export declare const ERC20_ABI: string[];
+//# sourceMappingURL=erc20.d.ts.map

package/dist/abis/erc20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.d.ts","sourceRoot":"","sources":["../../src/abis/erc20.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,UAMrB,CAAA"}

package/dist/abis/erc20.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERC20_ABI = void 0;
+exports.ERC20_ABI = [
+    'function name() view returns (string)',
+    'function symbol() view returns (string)',
+    'function decimals() view returns (uint8)',
+    'function totalSupply() view returns (uint256)',
+    'function balanceOf(address) view returns (uint256)',
+];
+//# sourceMappingURL=erc20.js.map

package/dist/abis/erc20.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.js","sourceRoot":"","sources":["../../src/abis/erc20.ts"],"names":[],"mappings":";;;AAAa,QAAA,SAAS,GAAG;IACvB,uCAAuC;IACvC,yCAAyC;IACzC,0CAA0C;IAC1C,+CAA+C;IAC/C,oDAAoD;CACrD,CAAA"}

package/dist/abis/index.d.ts

@@ -0,0 +1,5 @@
+export * from './erc20';
+export * from './reserve';
+export * from './bipoolmanager';
+export * from './uniswapV3';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abis/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA"}

package/dist/{cjs/constants → abis}/index.js

@@ -14,5 +14,8 @@ 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("./addresses"), exports);
-__exportStar(require("./tradablePairs"), exports);
+__exportStar(require("./erc20"), exports);
+__exportStar(require("./reserve"), exports);
+__exportStar(require("./bipoolmanager"), exports);
+__exportStar(require("./uniswapV3"), exports);
+//# sourceMappingURL=index.js.map

package/dist/abis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/abis/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,4CAAyB;AACzB,kDAA+B;AAC/B,8CAA2B"}

package/dist/abis/pricingmodule.d.ts

@@ -0,0 +1,2 @@
+export declare const PRICING_MODULE_ABI: string[];
+//# sourceMappingURL=pricingmodule.d.ts.map

package/dist/abis/pricingmodule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricingmodule.d.ts","sourceRoot":"","sources":["../../src/abis/pricingmodule.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,UAA4C,CAAA"}

package/dist/abis/pricingmodule.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRICING_MODULE_ABI = void 0;
+exports.PRICING_MODULE_ABI = ['function name() view returns (string)'];
+//# sourceMappingURL=pricingmodule.js.map

package/dist/abis/pricingmodule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricingmodule.js","sourceRoot":"","sources":["../../src/abis/pricingmodule.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG,CAAC,uCAAuC,CAAC,CAAA"}

package/dist/abis/reserve.d.ts

@@ -0,0 +1,2 @@
+export declare const RESERVE_ABI: string[];
+//# sourceMappingURL=reserve.d.ts.map

package/dist/abis/reserve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserve.d.ts","sourceRoot":"","sources":["../../src/abis/reserve.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,UAIvB,CAAC"}

package/dist/abis/reserve.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESERVE_ABI = void 0;
+exports.RESERVE_ABI = [
+    "function getTokens() view returns (address[])",
+    "function isToken(address) view returns (bool)",
+    "function isCollateralAsset(address) view returns (bool)",
+];
+//# sourceMappingURL=reserve.js.map

package/dist/abis/reserve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserve.js","sourceRoot":"","sources":["../../src/abis/reserve.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IAC1B,+CAA+C;IAC/C,+CAA+C;IAC/C,yDAAyD;CACzD,CAAC"}

package/dist/abis/uniswapV3.d.ts

@@ -0,0 +1,4 @@
+export declare const UNIV3_POSITION_MANAGER_ABI: string[];
+export declare const UNIV3_FACTORY_ABI: string[];
+export declare const UNIV3_POOL_ABI: string[];
+//# sourceMappingURL=uniswapV3.d.ts.map

package/dist/abis/uniswapV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswapV3.d.ts","sourceRoot":"","sources":["../../src/abis/uniswapV3.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,UAItC,CAAA;AAED,eAAO,MAAM,iBAAiB,UAE7B,CAAA;AACD,eAAO,MAAM,cAAc,UAE1B,CAAA"}

package/dist/abis/uniswapV3.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNIV3_POOL_ABI = exports.UNIV3_FACTORY_ABI = exports.UNIV3_POSITION_MANAGER_ABI = void 0;
+exports.UNIV3_POSITION_MANAGER_ABI = [
+    'function balanceOf(address) view returns (uint256)',
+    'function tokenOfOwnerByIndex(address, uint256) view returns (uint256)',
+    'function positions(uint256) view returns (uint96, address, address, address, uint24, int24, int24, uint128, uint256, uint256, uint128, uint128)',
+];
+exports.UNIV3_FACTORY_ABI = [
+    'function getPool(address, address, uint24) view returns (address)',
+];
+exports.UNIV3_POOL_ABI = [
+    'function slot0() view returns (uint160, int24, uint160, int24, uint16, uint16)',
+];
+//# sourceMappingURL=uniswapV3.js.map

package/dist/abis/uniswapV3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswapV3.js","sourceRoot":"","sources":["../../src/abis/uniswapV3.ts"],"names":[],"mappings":";;;AAAa,QAAA,0BAA0B,GAAG;IACxC,oDAAoD;IACpD,uEAAuE;IACvE,iJAAiJ;CAClJ,CAAA;AAEY,QAAA,iBAAiB,GAAG;IAC/B,mEAAmE;CACpE,CAAA;AACY,QAAA,cAAc,GAAG;IAC5B,gFAAgF;CACjF,CAAA"}

package/dist/adapters/implementations/ethersAdapter.d.ts

@@ -0,0 +1,9 @@
+import { Provider as EthersProvider } from 'ethers';
+import { ContractCallOptions, ProviderAdapter } from '../../types';
+export declare class EthersAdapter implements ProviderAdapter {
+    private provider;
+    constructor(provider: EthersProvider);
+    readContract(options: ContractCallOptions): Promise<unknown>;
+    getChainId(): Promise<number>;
+}
+//# sourceMappingURL=ethersAdapter.d.ts.map

package/dist/adapters/implementations/ethersAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethersAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/implementations/ethersAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,QAAQ,IAAI,cAAc,EAAE,MAAM,QAAQ,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElE,qBAAa,aAAc,YAAW,eAAe;IACvC,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAEtC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAIpC"}

package/dist/adapters/implementations/ethersAdapter.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EthersAdapter = void 0;
+const ethers_1 = require("ethers");
+class EthersAdapter {
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async readContract(options) {
+        const contract = new ethers_1.Contract(options.address, options.abi, this.provider);
+        return await contract[options.functionName](...(options.args || []));
+    }
+    async getChainId() {
+        const network = await this.provider.getNetwork();
+        return Number(network.chainId);
+    }
+}
+exports.EthersAdapter = EthersAdapter;
+//# sourceMappingURL=ethersAdapter.js.map

package/dist/adapters/implementations/ethersAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethersAdapter.js","sourceRoot":"","sources":["../../../src/adapters/implementations/ethersAdapter.ts"],"names":[],"mappings":";;;AAAA,mCAAwE;AAGxE,MAAa,aAAa;IACxB,YAAoB,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEhD,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC7C,MAAM,QAAQ,GAAG,IAAI,iBAAQ,CAC3B,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,GAA2B,EACnC,IAAI,CAAC,QAAQ,CACd,CAAA;QACD,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAA;IACtE,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAA;QAChD,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC;CACF;AAhBD,sCAgBC"}

package/dist/adapters/implementations/ethersV5Adapter.d.ts

@@ -0,0 +1,9 @@
+import { providers } from 'ethers-v5';
+import { ContractCallOptions, ProviderAdapter } from '../../types';
+export declare class EthersV5Adapter implements ProviderAdapter {
+    private provider;
+    constructor(provider: providers.Provider);
+    readContract(options: ContractCallOptions): Promise<unknown>;
+    getChainId(): Promise<number>;
+}
+//# sourceMappingURL=ethersV5Adapter.d.ts.map

package/dist/adapters/implementations/ethersV5Adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethersV5Adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/implementations/ethersV5Adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,SAAS,EAAqB,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElE,qBAAa,eAAgB,YAAW,eAAe;IACzC,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,SAAS,CAAC,QAAQ;IAE1C,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAIpC"}

package/dist/adapters/implementations/ethersV5Adapter.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EthersV5Adapter = void 0;
+const ethers_v5_1 = require("ethers-v5");
+class EthersV5Adapter {
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async readContract(options) {
+        const contract = new ethers_v5_1.Contract(options.address, options.abi, this.provider);
+        return await contract[options.functionName](...(options.args || []));
+    }
+    async getChainId() {
+        const network = await this.provider.getNetwork();
+        return Number(network.chainId);
+    }
+}
+exports.EthersV5Adapter = EthersV5Adapter;
+//# sourceMappingURL=ethersV5Adapter.js.map

package/dist/adapters/implementations/ethersV5Adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethersV5Adapter.js","sourceRoot":"","sources":["../../../src/adapters/implementations/ethersV5Adapter.ts"],"names":[],"mappings":";;;AAAA,yCAAkE;AAGlE,MAAa,eAAe;IAC1B,YAAoB,QAA4B;QAA5B,aAAQ,GAAR,QAAQ,CAAoB;IAAG,CAAC;IAEpD,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC7C,MAAM,QAAQ,GAAG,IAAI,oBAAQ,CAC3B,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,GAAmC,EAC3C,IAAI,CAAC,QAAQ,CACd,CAAA;QACD,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAA;IACtE,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAA;QAChD,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC;CACF;AAhBD,0CAgBC"}

package/dist/adapters/implementations/viemAdapter.d.ts

@@ -0,0 +1,9 @@
+import { type PublicClient } from 'viem';
+import type { ContractCallOptions, ProviderAdapter } from '../../types';
+export declare class ViemAdapter implements ProviderAdapter {
+    private client;
+    constructor(client: PublicClient);
+    readContract(options: ContractCallOptions): Promise<unknown>;
+    getChainId(): Promise<number>;
+}
+//# sourceMappingURL=viemAdapter.d.ts.map

package/dist/adapters/implementations/viemAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viemAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/implementations/viemAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,MAAM,CAAA;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEvE,qBAAa,WAAY,YAAW,eAAe;IACrC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAElC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAe5D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAGpC"}

package/dist/adapters/implementations/viemAdapter.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViemAdapter = void 0;
+const viem_1 = require("viem");
+class ViemAdapter {
+    constructor(client) {
+        this.client = client;
+    }
+    async readContract(options) {
+        // Check if the abi is a string array(human readable format) or an array of objects(the normal format)
+        const abi = Array.isArray(options.abi) && typeof options.abi[0] === 'string'
+            ? (0, viem_1.parseAbi)(options.abi)
+            : options.abi;
+        return await this.client.readContract({
+            address: options.address,
+            abi: abi,
+            functionName: options.functionName,
+            args: options.args,
+        });
+    }
+    async getChainId() {
+        return await this.client.getChainId();
+    }
+}
+exports.ViemAdapter = ViemAdapter;
+//# sourceMappingURL=viemAdapter.js.map

package/dist/adapters/implementations/viemAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viemAdapter.js","sourceRoot":"","sources":["../../../src/adapters/implementations/viemAdapter.ts"],"names":[],"mappings":";;;AAAA,+BAAkD;AAGlD,MAAa,WAAW;IACtB,YAAoB,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAE5C,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC7C,sGAAsG;QACtG,MAAM,GAAG,GACP,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ;YAC9D,CAAC,CAAC,IAAA,eAAQ,EAAC,OAAO,CAAC,GAAe,CAAC;YACnC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA;QAEjB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YACpC,OAAO,EAAE,OAAO,CAAC,OAAwB;YACzC,GAAG,EAAE,GAAG;YACR,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;IACvC,CAAC;CACF;AArBD,kCAqBC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,5 @@
+import { EthersV5AdapterProxy } from './proxies/ethersV5AdapterProxy';
+import { EthersAdapterProxy } from './proxies/ethersAdapterProxy';
+import { ViemAdapterProxy } from './proxies/viemAdapterProxy';
+export { EthersV5AdapterProxy as EthersV5Adapter, EthersAdapterProxy as EthersAdapter, ViemAdapterProxy as ViemAdapter, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAE7D,OAAO,EACL,oBAAoB,IAAI,eAAe,EACvC,kBAAkB,IAAI,aAAa,EACnC,gBAAgB,IAAI,WAAW,GAChC,CAAA"}

package/dist/adapters/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViemAdapter = exports.EthersAdapter = exports.EthersV5Adapter = void 0;
+const ethersV5AdapterProxy_1 = require("./proxies/ethersV5AdapterProxy");
+Object.defineProperty(exports, "EthersV5Adapter", { enumerable: true, get: function () { return ethersV5AdapterProxy_1.EthersV5AdapterProxy; } });
+const ethersAdapterProxy_1 = require("./proxies/ethersAdapterProxy");
+Object.defineProperty(exports, "EthersAdapter", { enumerable: true, get: function () { return ethersAdapterProxy_1.EthersAdapterProxy; } });
+const viemAdapterProxy_1 = require("./proxies/viemAdapterProxy");
+Object.defineProperty(exports, "ViemAdapter", { enumerable: true, get: function () { return viemAdapterProxy_1.ViemAdapterProxy; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";;;AAAA,yEAAqE;AAK3C,gGALjB,2CAAoB,OAKY;AAJzC,qEAAiE;AAKzC,8FALf,uCAAkB,OAKU;AAJrC,iEAA6D;AAKvC,4FALb,mCAAgB,OAKQ"}

package/dist/adapters/proxies/ethersAdapterProxy.d.ts

@@ -0,0 +1,25 @@
+import { ProviderAdapter } from '../../types';
+import type { Provider as EthersV6Provider } from 'ethers';
+/**
+ * Proxy class that implements lazy loading for ethers provider adapter.
+ *
+ * This is an implementation of the Virtual Proxy pattern, which provides
+ * a placeholder for the EthersAdapter and controls its initialization.
+ * The actual adapter is only loaded when needed, allowing for:
+ * - Lazy loading of the ethers dependency
+ * - Better error handling for missing dependencies
+ * - Same interface as the real adapter (ProviderAdapter)
+ *
+ * For more information about the proxy pattern implementation,
+ * see the README.md in this directory:
+ * ./adapters/proxies/README.md
+ */
+export declare class EthersAdapterProxy implements ProviderAdapter {
+    private adapter;
+    private initPromise;
+    constructor(provider: EthersV6Provider);
+    private initialize;
+    readContract(...args: Parameters<ProviderAdapter['readContract']>): Promise<unknown>;
+    getChainId(): Promise<number>;
+}
+//# sourceMappingURL=ethersAdapterProxy.d.ts.map

package/dist/adapters/proxies/ethersAdapterProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethersAdapterProxy.d.ts","sourceRoot":"","sources":["../../../src/adapters/proxies/ethersAdapterProxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAE1D;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAAe;gBAEtB,QAAQ,EAAE,gBAAgB;YAIxB,UAAU;IAWlB,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;IAUjE,UAAU;CASjB"}

package/dist/adapters/proxies/ethersAdapterProxy.js

@@ -0,0 +1,71 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EthersAdapterProxy = void 0;
+/**
+ * Proxy class that implements lazy loading for ethers provider adapter.
+ *
+ * This is an implementation of the Virtual Proxy pattern, which provides
+ * a placeholder for the EthersAdapter and controls its initialization.
+ * The actual adapter is only loaded when needed, allowing for:
+ * - Lazy loading of the ethers dependency
+ * - Better error handling for missing dependencies
+ * - Same interface as the real adapter (ProviderAdapter)
+ *
+ * For more information about the proxy pattern implementation,
+ * see the README.md in this directory:
+ * ./adapters/proxies/README.md
+ */
+class EthersAdapterProxy {
+    constructor(provider) {
+        this.adapter = null;
+        this.initPromise = this.initialize(provider);
+    }
+    async initialize(provider) {
+        try {
+            const { EthersAdapter } = await Promise.resolve().then(() => __importStar(require('../implementations/ethersAdapter')));
+            this.adapter = new EthersAdapter(provider);
+        }
+        catch (error) {
+            throw new Error('ethers v6 is not installed. Please install ethers@6 to use this adapter');
+        }
+    }
+    async readContract(...args) {
+        await this.initPromise;
+        if (!this.adapter) {
+            throw new Error('Adapter not initialized. Are you missing ethers v6 dependency?');
+        }
+        return this.adapter.readContract(...args);
+    }
+    async getChainId() {
+        await this.initPromise;
+        if (!this.adapter) {
+            throw new Error('Adapter not initialized. Are you missing ethers v6 dependency?');
+        }
+        return this.adapter.getChainId();
+    }
+}
+exports.EthersAdapterProxy = EthersAdapterProxy;
+//# sourceMappingURL=ethersAdapterProxy.js.map

package/dist/adapters/proxies/ethersAdapterProxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethersAdapterProxy.js","sourceRoot":"","sources":["../../../src/adapters/proxies/ethersAdapterProxy.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAGA;;;;;;;;;;;;;GAaG;AACH,MAAa,kBAAkB;IAI7B,YAAY,QAA0B;QAH9B,YAAO,GAA2B,IAAI,CAAA;QAI5C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC9C,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,QAA0B;QACjD,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,wDAAa,kCAAkC,GAAC,CAAA;YAC1E,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAA;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAG,IAAiD;QACrE,MAAM,IAAI,CAAC,WAAW,CAAA;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAA;QACH,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAA;IAC3C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,WAAW,CAAA;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAA;QACH,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAA;IAClC,CAAC;CACF;AAtCD,gDAsCC"}