@nirholas/bnbchain-mcp 1.0.0

package/build/evm/modules/lending/tools.js

@@ -0,0 +1,334 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLendingTools = registerLendingTools;
+const viem_1 = require("viem");
+const zod_1 = require("zod");
+const clients_js_1 = require("@/evm/services/clients.js");
+const helper_js_1 = require("@/utils/helper.js");
+const types_js_1 = require("../common/types.js");
+// Aave V3 Pool ABI (subset)
+const AAVE_POOL_ABI = [
+    {
+        name: "getUserAccountData",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "user", type: "address" }],
+        outputs: [
+            { name: "totalCollateralBase", type: "uint256" },
+            { name: "totalDebtBase", type: "uint256" },
+            { name: "availableBorrowsBase", type: "uint256" },
+            { name: "currentLiquidationThreshold", type: "uint256" },
+            { name: "ltv", type: "uint256" },
+            { name: "healthFactor", type: "uint256" }
+        ]
+    },
+    {
+        name: "getReserveData",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "asset", type: "address" }],
+        outputs: [
+            { name: "configuration", type: "tuple" },
+            { name: "liquidityIndex", type: "uint128" },
+            { name: "currentLiquidityRate", type: "uint128" },
+            { name: "variableBorrowIndex", type: "uint128" },
+            { name: "currentVariableBorrowRate", type: "uint128" },
+            { name: "currentStableBorrowRate", type: "uint128" },
+            { name: "lastUpdateTimestamp", type: "uint40" },
+            { name: "id", type: "uint16" },
+            { name: "aTokenAddress", type: "address" },
+            { name: "stableDebtTokenAddress", type: "address" },
+            { name: "variableDebtTokenAddress", type: "address" },
+            { name: "interestRateStrategyAddress", type: "address" },
+            { name: "accruedToTreasury", type: "uint128" },
+            { name: "unbacked", type: "uint128" },
+            { name: "isolationModeTotalDebt", type: "uint128" }
+        ]
+    }
+];
+// Compound V3 Comet ABI (subset)
+const COMPOUND_COMET_ABI = [
+    {
+        name: "balanceOf",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }]
+    },
+    {
+        name: "borrowBalanceOf",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }]
+    },
+    {
+        name: "getSupplyRate",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "utilization", type: "uint64" }],
+        outputs: [{ name: "", type: "uint64" }]
+    },
+    {
+        name: "getBorrowRate",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "utilization", type: "uint64" }],
+        outputs: [{ name: "", type: "uint64" }]
+    },
+    {
+        name: "getUtilization",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "uint64" }]
+    }
+];
+// Lending protocol addresses
+const LENDING_PROTOCOLS = {
+    1: {
+        "Aave V3": { pool: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2", type: "aave" },
+        "Compound V3 USDC": { pool: "0xc3d688B66703497DAA19211EEdff47f25384cdc3", type: "compound" }
+    },
+    137: {
+        "Aave V3": { pool: "0x794a61358D6845594F94dc1DB02A252b5b4814aD", type: "aave" }
+    },
+    42161: {
+        "Aave V3": { pool: "0x794a61358D6845594F94dc1DB02A252b5b4814aD", type: "aave" }
+    },
+    8453: {
+        "Aave V3": { pool: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5", type: "aave" }
+    }
+};
+function registerLendingTools(server) {
+    // Get lending position
+    server.tool("get_lending_position", "Get a user's lending/borrowing position on a protocol", {
+        network: types_js_1.defaultNetworkParam,
+        protocol: zod_1.z.string().describe("Lending protocol name"),
+        userAddress: zod_1.z.string().describe("User address to check")
+    }, async ({ network, protocol, userAddress }) => {
+        try {
+            const publicClient = (0, clients_js_1.getPublicClient)(network);
+            const chainId = await publicClient.getChainId();
+            const protocolConfig = LENDING_PROTOCOLS[chainId]?.[protocol];
+            if (!protocolConfig) {
+                return helper_js_1.mcpToolRes.error(new Error(`Protocol ${protocol} not found on this network`), "getting lending position");
+            }
+            if (protocolConfig.type === "aave") {
+                const data = await publicClient.readContract({
+                    address: protocolConfig.pool,
+                    abi: AAVE_POOL_ABI,
+                    functionName: "getUserAccountData",
+                    args: [userAddress]
+                });
+                const [totalCollateral, totalDebt, availableBorrows, liquidationThreshold, ltv, healthFactor] = data;
+                return helper_js_1.mcpToolRes.success({
+                    network,
+                    protocol,
+                    userAddress,
+                    position: {
+                        totalCollateralUSD: (0, viem_1.formatUnits)(totalCollateral, 8),
+                        totalDebtUSD: (0, viem_1.formatUnits)(totalDebt, 8),
+                        availableBorrowsUSD: (0, viem_1.formatUnits)(availableBorrows, 8),
+                        liquidationThreshold: (Number(liquidationThreshold) / 100).toFixed(2) + "%",
+                        ltv: (Number(ltv) / 100).toFixed(2) + "%",
+                        healthFactor: (0, viem_1.formatUnits)(healthFactor, 18)
+                    },
+                    healthStatus: Number(healthFactor) >= 1e18
+                        ? healthFactor > 2n * BigInt(1e18) ? "safe" : "moderate"
+                        : "at risk"
+                });
+            }
+            if (protocolConfig.type === "compound") {
+                const [supplyBalance, borrowBalance] = await Promise.all([
+                    publicClient.readContract({
+                        address: protocolConfig.pool,
+                        abi: COMPOUND_COMET_ABI,
+                        functionName: "balanceOf",
+                        args: [userAddress]
+                    }),
+                    publicClient.readContract({
+                        address: protocolConfig.pool,
+                        abi: COMPOUND_COMET_ABI,
+                        functionName: "borrowBalanceOf",
+                        args: [userAddress]
+                    })
+                ]);
+                return helper_js_1.mcpToolRes.success({
+                    network,
+                    protocol,
+                    userAddress,
+                    position: {
+                        supplyBalance: supplyBalance.toString(),
+                        supplyFormatted: (0, viem_1.formatUnits)(supplyBalance, 6), // USDC
+                        borrowBalance: borrowBalance.toString(),
+                        borrowFormatted: (0, viem_1.formatUnits)(borrowBalance, 6)
+                    }
+                });
+            }
+            return helper_js_1.mcpToolRes.error(new Error("Unknown protocol type"), "getting lending position");
+        }
+        catch (error) {
+            return helper_js_1.mcpToolRes.error(error, "getting lending position");
+        }
+    });
+    // Get market rates
+    server.tool("get_lending_rates", "Get current supply and borrow rates for a lending market", {
+        network: types_js_1.defaultNetworkParam,
+        protocol: zod_1.z.string().describe("Lending protocol name"),
+        asset: zod_1.z.string().optional().describe("Asset address (for Aave)")
+    }, async ({ network, protocol, asset }) => {
+        try {
+            const publicClient = (0, clients_js_1.getPublicClient)(network);
+            const chainId = await publicClient.getChainId();
+            const protocolConfig = LENDING_PROTOCOLS[chainId]?.[protocol];
+            if (!protocolConfig) {
+                return helper_js_1.mcpToolRes.error(new Error(`Protocol ${protocol} not found`), "getting lending rates");
+            }
+            if (protocolConfig.type === "aave" && asset) {
+                const reserveData = await publicClient.readContract({
+                    address: protocolConfig.pool,
+                    abi: AAVE_POOL_ABI,
+                    functionName: "getReserveData",
+                    args: [asset]
+                });
+                // Rates are in RAY (27 decimals), convert to APY percentage
+                const liquidityRate = reserveData[2];
+                const variableBorrowRate = reserveData[4];
+                const supplyAPY = (Number(liquidityRate) / 1e27 * 100).toFixed(2);
+                const borrowAPY = (Number(variableBorrowRate) / 1e27 * 100).toFixed(2);
+                return helper_js_1.mcpToolRes.success({
+                    network,
+                    protocol,
+                    asset,
+                    rates: {
+                        supplyAPY: supplyAPY + "%",
+                        variableBorrowAPY: borrowAPY + "%",
+                        aTokenAddress: reserveData[8]
+                    }
+                });
+            }
+            if (protocolConfig.type === "compound") {
+                const utilization = await publicClient.readContract({
+                    address: protocolConfig.pool,
+                    abi: COMPOUND_COMET_ABI,
+                    functionName: "getUtilization"
+                });
+                const [supplyRate, borrowRate] = await Promise.all([
+                    publicClient.readContract({
+                        address: protocolConfig.pool,
+                        abi: COMPOUND_COMET_ABI,
+                        functionName: "getSupplyRate",
+                        args: [utilization]
+                    }),
+                    publicClient.readContract({
+                        address: protocolConfig.pool,
+                        abi: COMPOUND_COMET_ABI,
+                        functionName: "getBorrowRate",
+                        args: [utilization]
+                    })
+                ]);
+                // Convert per-second rates to APY
+                const secondsPerYear = 31536000n;
+                const supplyAPY = (Number(supplyRate * secondsPerYear) / 1e18 * 100).toFixed(2);
+                const borrowAPY = (Number(borrowRate * secondsPerYear) / 1e18 * 100).toFixed(2);
+                return helper_js_1.mcpToolRes.success({
+                    network,
+                    protocol,
+                    rates: {
+                        supplyAPY: supplyAPY + "%",
+                        borrowAPY: borrowAPY + "%",
+                        utilization: (Number(utilization) / 1e18 * 100).toFixed(2) + "%"
+                    }
+                });
+            }
+            return helper_js_1.mcpToolRes.error(new Error("Could not fetch rates"), "getting lending rates");
+        }
+        catch (error) {
+            return helper_js_1.mcpToolRes.error(error, "getting lending rates");
+        }
+    });
+    // Get supported lending protocols
+    server.tool("get_lending_protocols", "Get list of supported lending protocols on a network", {
+        network: types_js_1.defaultNetworkParam
+    }, async ({ network }) => {
+        try {
+            const publicClient = (0, clients_js_1.getPublicClient)(network);
+            const chainId = await publicClient.getChainId();
+            const protocols = LENDING_PROTOCOLS[chainId] || {};
+            return helper_js_1.mcpToolRes.success({
+                network,
+                chainId,
+                protocols: Object.entries(protocols).map(([name, config]) => ({
+                    name,
+                    pool: config.pool,
+                    type: config.type
+                })),
+                note: Object.keys(protocols).length === 0
+                    ? "No lending protocols configured for this network"
+                    : "Use get_lending_position or get_lending_rates for details"
+            });
+        }
+        catch (error) {
+            return helper_js_1.mcpToolRes.error(error, "getting lending protocols");
+        }
+    });
+    // Calculate health factor
+    server.tool("calculate_health_factor", "Calculate health factor after a potential action", {
+        currentCollateral: zod_1.z.string().describe("Current collateral in USD"),
+        currentDebt: zod_1.z.string().describe("Current debt in USD"),
+        liquidationThreshold: zod_1.z.string().describe("Liquidation threshold (e.g., '0.85')"),
+        action: zod_1.z.enum(["supply", "borrow", "withdraw", "repay"]).describe("Action type"),
+        amount: zod_1.z.string().describe("Action amount in USD")
+    }, async ({ currentCollateral, currentDebt, liquidationThreshold, action, amount }) => {
+        try {
+            let newCollateral = parseFloat(currentCollateral);
+            let newDebt = parseFloat(currentDebt);
+            const threshold = parseFloat(liquidationThreshold);
+            const actionAmount = parseFloat(amount);
+            switch (action) {
+                case "supply":
+                    newCollateral += actionAmount;
+                    break;
+                case "borrow":
+                    newDebt += actionAmount;
+                    break;
+                case "withdraw":
+                    newCollateral -= actionAmount;
+                    break;
+                case "repay":
+                    newDebt -= actionAmount;
+                    break;
+            }
+            const newHealthFactor = newDebt > 0
+                ? (newCollateral * threshold) / newDebt
+                : Infinity;
+            return helper_js_1.mcpToolRes.success({
+                before: {
+                    collateral: currentCollateral,
+                    debt: currentDebt,
+                    healthFactor: parseFloat(currentDebt) > 0
+                        ? ((parseFloat(currentCollateral) * threshold) / parseFloat(currentDebt)).toFixed(4)
+                        : "∞"
+                },
+                action,
+                amount,
+                after: {
+                    collateral: newCollateral.toString(),
+                    debt: newDebt.toString(),
+                    healthFactor: newHealthFactor === Infinity ? "∞" : newHealthFactor.toFixed(4)
+                },
+                safe: newHealthFactor > 1.5,
+                warning: newHealthFactor > 1 && newHealthFactor <= 1.5
+                    ? "Health factor is low - consider adding collateral"
+                    : newHealthFactor <= 1
+                        ? "DANGER: Position would be at liquidation risk"
+                        : null
+            });
+        }
+        catch (error) {
+            return helper_js_1.mcpToolRes.error(error, "calculating health factor");
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/build/evm/modules/lending/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../src/evm/modules/lending/tools.ts"],"names":[],"mappings":"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"}

package/build/evm/modules/mev/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMEV(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/build/evm/modules/mev/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/evm/modules/mev/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAInE,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,QAG5C"}

package/build/evm/modules/mev/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMEV = registerMEV;
+const tools_js_1 = require("./tools.js");
+const prompts_js_1 = require("./prompts.js");
+function registerMEV(server) {
+    (0, tools_js_1.registerMEVTools)(server);
+    (0, prompts_js_1.registerMEVPrompts)(server);
+}
+//# sourceMappingURL=index.js.map

package/build/evm/modules/mev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/evm/modules/mev/index.ts"],"names":[],"mappings":";;AAUA,kCAGC;AAND,yCAA6C;AAC7C,6CAAiD;AAEjD,SAAgB,WAAW,CAAC,MAAiB;IAC3C,IAAA,2BAAgB,EAAC,MAAM,CAAC,CAAA;IACxB,IAAA,+BAAkB,EAAC,MAAM,CAAC,CAAA;AAC5B,CAAC"}

package/build/evm/modules/mev/prompts.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMEVPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/build/evm/modules/mev/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../src/evm/modules/mev/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA4QnD"}

package/build/evm/modules/mev/prompts.js

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMEVPrompts = registerMEVPrompts;
+function registerMEVPrompts(server) {
+    server.prompt("protect_swap_from_mev", "Guide through executing a swap with MEV protection", {
+        tokenIn: { description: "Token to swap from", required: true },
+        tokenOut: { description: "Token to swap to", required: true },
+        amount: { description: "Amount to swap", required: true },
+        network: { description: "Network for the swap", required: true }
+    }, ({ tokenIn, tokenOut, amount, network }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Help me execute an MEV-protected swap on ${network}.
+
+Swap Details:
+- From: ${amount} ${tokenIn}
+- To: ${tokenOut}
+
+## MEV Protection Process
+
+### 1. Analyze MEV Risk
+Use check_mev_exposure to analyze the swap transaction:
+- Identify potential sandwich attack risk
+- Assess slippage requirements
+- Determine optimal protection strategy
+
+### 2. Choose Protection Method
+Options:
+- **Flashbots Protect**: Send directly to block builders
+- **MEV Blocker**: Aggregate across multiple builders
+- **Private RPC**: Network-specific protection
+
+### 3. Execute Protected Swap
+Use send_private_transaction with:
+- DEX router address
+- Encoded swap data
+- Appropriate gas settings
+
+### 4. Monitor Execution
+- Verify transaction was included
+- Check execution price vs quote
+- Confirm no MEV extraction occurred
+
+## Checklist
+- [ ] MEV risk analyzed
+- [ ] Protection provider selected
+- [ ] Slippage set appropriately
+- [ ] Transaction sent privately
+- [ ] Execution verified`
+                }
+            }
+        ]
+    }));
+    server.prompt("analyze_mev_risk", "Analyze MEV risk for a planned transaction", {
+        transactionType: { description: "Type of transaction (swap, liquidation, arbitrage)", required: true },
+        value: { description: "Approximate value in ETH/USD", required: true }
+    }, ({ transactionType, value }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Analyze MEV risk for a ${transactionType} transaction worth ${value}.
+
+## MEV Risk Analysis
+
+### Transaction Type: ${transactionType}
+### Approximate Value: ${value}
+
+### Risk Factors to Check
+1. **Visibility Risk**
+   - Public mempool exposure
+   - Time in mempool
+   - Block inclusion predictability
+
+2. **Value Extraction Risk**
+   - Sandwich attack potential
+   - Frontrunning profit margin
+   - Backrunning opportunities
+
+3. **Market Impact**
+   - Price impact of transaction
+   - Liquidity depth
+   - Volatility considerations
+
+### Analysis Steps
+1. Use check_mev_exposure with transaction details
+2. Review identified risks and severity
+3. Determine appropriate protection level
+
+### Protection Recommendations
+Based on ${transactionType} type:
+${transactionType === "swap" ? `
+- Use private transaction submission
+- Set tight slippage (0.1-0.5%)
+- Consider splitting large swaps
+- Use limit orders if available
+` : transactionType === "liquidation" ? `
+- Flashbots bundle submission essential
+- Race condition expected - optimize gas
+- Consider building with MEV searchers
+- Time-sensitive execution
+` : `
+- Evaluate profitability after gas
+- Private submission critical
+- Bundle multiple operations if possible
+- Monitor for competing bots
+`}`
+                }
+            }
+        ]
+    }));
+    server.prompt("simulate_transaction_bundle", "Simulate a bundle of transactions before execution", {
+        bundleDescription: { description: "Description of what the bundle should accomplish", required: true }
+    }, ({ bundleDescription }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Help me simulate a transaction bundle: ${bundleDescription}
+
+## Bundle Simulation Guide
+
+### 1. Define Bundle Transactions
+List all transactions in order:
+- Transaction 1: [describe]
+- Transaction 2: [describe]
+- etc.
+
+### 2. Prepare Transaction Data
+For each transaction, specify:
+- Target contract address
+- Function to call
+- Parameters
+- Value (if any)
+
+### 3. Simulate Bundle
+Use simulate_bundle with:
+- Array of transaction objects
+- Target block number (optional)
+
+### 4. Analyze Results
+Review simulation output:
+- All transactions successful?
+- Total gas cost
+- Return values
+- Any reverts?
+
+### 5. Optimize Bundle
+If issues found:
+- Reorder transactions
+- Adjust gas limits
+- Fix failing transactions
+- Re-simulate
+
+### Simulation Report Template
+| # | To | Function | Success | Gas | Notes |
+|---|-----|----------|---------|-----|-------|
+| 1 | ... | ...      | ✅/❌   | ... | ...   |
+
+**Total Gas**: [sum]
+**Estimated Cost**: [ETH amount]
+**Bundle Status**: Ready / Needs Work`
+                }
+            }
+        ]
+    }));
+    server.prompt("mev_protection_setup", "Set up MEV protection for a wallet/dApp", {
+        network: { description: "Target network", required: true },
+        useCase: { description: "Primary use case (trading, liquidations, arbitrage)", required: true }
+    }, ({ network, useCase }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Set up MEV protection for ${useCase} on ${network}.
+
+## MEV Protection Setup Guide
+
+### 1. Check Available Protection
+Use get_mev_protection_info for ${network}:
+- Available providers
+- Chain-specific options
+- Built-in protections
+
+### 2. Choose Protection Strategy
+
+For **${useCase}**:
+${useCase === "trading" ? `
+**Recommended: Flashbots Protect / MEV Blocker**
+- Automatic protection for all swaps
+- No code changes needed
+- Configure wallet to use protect RPC
+
+Setup Steps:
+1. Add protected RPC to wallet
+2. All transactions route through protection
+3. No mempool visibility
+` : useCase === "liquidations" ? `
+**Recommended: Flashbots Bundle API**
+- Atomic execution guarantee
+- Competitive submission
+- Block builder integration
+
+Setup Steps:
+1. Build transaction bundle
+2. Sign with Flashbots reputation key
+3. Submit to multiple builders
+4. Monitor for inclusion
+` : `
+**Recommended: Private Transaction + Bundle**
+- Combine multiple operations
+- Protect entire strategy
+- Optimize for atomicity
+
+Setup Steps:
+1. Structure operations as bundle
+2. Simulate for profitability
+3. Submit privately
+4. Monitor execution
+`}
+
+### 3. Configure RPC Endpoints
+
+For ${network}:
+| Provider | URL | Best For |
+|----------|-----|----------|
+| Flashbots | https://rpc.flashbots.net | General protection |
+| MEV Blocker | https://rpc.mevblocker.io | Multi-builder |
+
+### 4. Test Protection
+- Send small test transaction
+- Verify private submission
+- Check block inclusion
+
+### 5. Monitor & Optimize
+- Track execution quality
+- Compare with public mempool
+- Adjust strategy as needed`
+                }
+            }
+        ]
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/build/evm/modules/mev/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../../src/evm/modules/mev/prompts.ts"],"names":[],"mappings":";;AAQA,gDA4QC;AA5QD,SAAgB,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,MAAM,CACX,uBAAuB,EACvB,oDAAoD,EACpD;QACE,OAAO,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC9D,QAAQ,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7D,MAAM,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzD,OAAO,EAAE,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,EAAE;KACjE,EACD,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3C,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,4CAA4C,OAAO;;;UAG3D,MAAM,IAAI,OAAO;QACnB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAgCS;iBACd;aACF;SACF;KACF,CAAC,CACH,CAAA;IAED,MAAM,CAAC,MAAM,CACX,kBAAkB,EAClB,4CAA4C,EAC5C;QACE,eAAe,EAAE,EAAE,WAAW,EAAE,oDAAoD,EAAE,QAAQ,EAAE,IAAI,EAAE;QACtG,KAAK,EAAE,EAAE,WAAW,EAAE,8BAA8B,EAAE,QAAQ,EAAE,IAAI,EAAE;KACvE,EACD,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/B,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,0BAA0B,eAAe,sBAAsB,KAAK;;;;wBAI9D,eAAe;yBACd,KAAK;;;;;;;;;;;;;;;;;;;;;;;;WAwBnB,eAAe;EACxB,eAAe,KAAK,MAAM,CAAC,CAAC,CAAC;;;;;CAK9B,CAAC,CAAC,CAAC,eAAe,KAAK,aAAa,CAAC,CAAC,CAAC;;;;;CAKvC,CAAC,CAAC,CAAC;;;;;CAKH,EAAE;iBACQ;aACF;SACF;KACF,CAAC,CACH,CAAA;IAED,MAAM,CAAC,MAAM,CACX,6BAA6B,EAC7B,oDAAoD,EACpD;QACE,iBAAiB,EAAE,EAAE,WAAW,EAAE,kDAAkD,EAAE,QAAQ,EAAE,IAAI,EAAE;KACvG,EACD,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1B,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,0CAA0C,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA2CvC;iBAC3B;aACF;SACF;KACF,CAAC,CACH,CAAA;IAED,MAAM,CAAC,MAAM,CACX,sBAAsB,EACtB,yCAAyC,EACzC;QACE,OAAO,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1D,OAAO,EAAE,EAAE,WAAW,EAAE,qDAAqD,EAAE,QAAQ,EAAE,IAAI,EAAE;KAChG,EACD,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACzB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,6BAA6B,OAAO,OAAO,OAAO;;;;;kCAKlC,OAAO;;;;;;;QAOjC,OAAO;EACb,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC;;;;;;;;;;CAUzB,CAAC,CAAC,CAAC,OAAO,KAAK,cAAc,CAAC,CAAC,CAAC;;;;;;;;;;;CAWhC,CAAC,CAAC,CAAC;;;;;;;;;;;CAWH;;;;MAIK,OAAO;;;;;;;;;;;;;;4BAce;iBACjB;aACF;SACF;KACF,CAAC,CACH,CAAA;AACH,CAAC"}

package/build/evm/modules/mev/tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMEVTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/build/evm/modules/mev/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/evm/modules/mev/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AA6FnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAgejD"}