web3-tools-mcp 2.0.2 → 3.1.0

package/dist/tools/{contract-info.js → read/contract-info.js}

@@ -1,41 +1,63 @@
 import { isAddress } from 'viem';
 import { z } from 'zod';
-import { getClientManager, SUPPORTED_CHAINS } from '../client.js';
-import { createTool, formatResponse } from '../utils.js';
-const contractCache = new Map();
-// No TTL - contracts are immutable, cache never expires
+import { getClientManager, SUPPORTED_CHAINS } from '../../client.js';
+import { createTool, formatResponse, TtlCache } from '../../utils.js';
+// Source is immutable, but a proxy's implementation is not; an hour notices an upgrade.
+const contractCache = new TtlCache(100, 60 * 60 * 1000);
 // Helper to generate cache key
 function getCacheKey(chainId, address) {
     return `${chainId}:${address.toLowerCase()}`;
 }
+/** Etherscan's `result` for a query, or why there is none: it answers status "0" with the reason there. */
+export async function etherscan(chainId, params, etherscanApiKey) {
+    const response = await fetch(`https://api.etherscan.io/v2/api?chainid=${chainId}&${params}&apikey=${etherscanApiKey}`, {
+        signal: AbortSignal.timeout(15_000)
+    });
+    if (!response.ok)
+        throw new Error(`Etherscan API error: HTTP ${response.status}`);
+    const data = (await response.json());
+    if (data.status !== '1') {
+        throw new Error(`Etherscan API error: ${typeof data.result === 'string' ? data.result : data.message || 'request failed'}`);
+    }
+    return data.result;
+}
+/** Etherscan's SourceCode is one file, a `{{…}}`-wrapped standard JSON input, or a plain map of files. */
+function parseSourceFiles(info) {
+    const single = { [`${info.ContractName}.sol`]: info.SourceCode };
+    if (!info.SourceCode.startsWith('{'))
+        return single;
+    try {
+        const parsed = JSON.parse(info.SourceCode.startsWith('{{') ? info.SourceCode.slice(1, -1) : info.SourceCode);
+        const files = (parsed.sources ?? parsed);
+        return Object.fromEntries(Object.entries(files).map(([path, data]) => [path, typeof data === 'string' ? data : data.content || '']));
+    }
+    catch {
+        return single;
+    }
+}
+function fileStats(sourceFiles) {
+    return Object.entries(sourceFiles).map(([path, content]) => ({ path, lines: content.split('\n').length, size: content.length }));
+}
 // Shared helper to fetch contract info from Etherscan (with caching)
 async function fetchContractInfo(chainId, address, etherscanApiKey) {
-    // Check cache first
     const cacheKey = getCacheKey(chainId, address);
     const cached = contractCache.get(cacheKey);
-    if (cached?.rawInfo) {
+    if (cached)
         return cached.rawInfo;
-    }
-    // Fetch from Etherscan API
-    const sourceUrl = `https://api.etherscan.io/v2/api?chainid=${chainId}&module=contract&action=getsourcecode&address=${address}&apikey=${etherscanApiKey}`;
-    const sourceResponse = await fetch(sourceUrl);
-    const sourceData = (await sourceResponse.json());
-    if (sourceData.status !== '1' || !sourceData.result || sourceData.result.length === 0) {
-        throw new Error(`Etherscan API error: ${sourceData.message || 'No contract source found'}`);
-    }
-    const contractInfo = sourceData.result[0];
-    // Cache the raw info immediately
+    const result = await etherscan(chainId, `module=contract&action=getsourcecode&address=${address}`, etherscanApiKey);
+    const contractInfo = result[0];
+    if (!contractInfo)
+        throw new Error('Etherscan API error: No contract source found');
     const isProxy = contractInfo.Proxy === '1';
     contractCache.set(cacheKey, {
         rawInfo: contractInfo,
-        sourceFiles: {},
+        sourceFiles: contractInfo.SourceCode ? parseSourceFiles(contractInfo) : {},
         metadata: {
             contractName: contractInfo.ContractName,
             compilerVersion: contractInfo.CompilerVersion,
             isProxy,
             implementationAddress: isProxy ? contractInfo.Implementation : undefined
-        },
-        timestamp: Date.now()
+        }
     });
     return contractInfo;
 }
@@ -49,7 +71,7 @@ export default {
             .describe('Optional: specify which data to include. Options: "abi" (contract ABI), "implementationAbi" (proxy implementation ABI), "metadata" (name, verification), "compilation" (compiler, optimization), "creation" (creator, tx), "stats" (function/event counts). Defaults to ["abi", "metadata"] for minimal context usage.')
     }), async (args) => {
         const clientManager = getClientManager();
-        const config = clientManager.config;
+        const config = clientManager.getConfig();
         if (!config.etherscanApiKey) {
             throw new Error('Etherscan API key is required for contract information retrieval. Use --etherscan-api-key or set ETHERSCAN_API_KEY environment variable.');
         }
@@ -122,21 +144,13 @@ export default {
         // Try to get creation info if requested
         if (includeSet.has('creation')) {
             try {
-                const creationUrl = `https://api.etherscan.io/v2/api?chainid=${chainId}&module=contract&action=getcontractcreation&contractaddresses=${args.address}&apikey=${config.etherscanApiKey}`;
-                const creationResponse = await fetch(creationUrl);
-                const creationData = (await creationResponse.json());
-                if (creationData.status === '1' && creationData.result && creationData.result.length > 0) {
-                    const result = creationData.result[0];
-                    if (result) {
-                        abiResult.creationInfo = {
-                            creator: result.contractCreator,
-                            transactionHash: result.txHash
-                        };
-                    }
+                const [creation] = await etherscan(chainId, `module=contract&action=getcontractcreation&contractaddresses=${args.address}`, config.etherscanApiKey);
+                if (creation) {
+                    abiResult.creationInfo = { creator: creation.contractCreator, transactionHash: creation.txHash };
                 }
             }
-            catch {
-                // Creation info is optional
+            catch (error) {
+                abiResult.creationError = error.message;
             }
         }
         // If it's a proxy and implementation ABI is requested, try to get it
@@ -168,13 +182,6 @@ export default {
                 // Implementation ABI fetch failed, continue without it
             }
         }
-        // Update cache with ABI (rawInfo already cached by fetchContractInfo)
-        const cacheKey = getCacheKey(chainId, args.address);
-        const existing = contractCache.get(cacheKey);
-        contractCache.set(cacheKey, {
-            ...existing,
-            abi
-        });
         return formatResponse(abiResult);
     }),
     get_contract_source_code: createTool('Get Contract Source Code', 'Retrieve verified contract source code from Etherscan. PROXY AWARE - automatically fetches implementation source for proxies.', z.object({
@@ -192,7 +199,7 @@ export default {
             .describe('Source code inclusion level: "full" (complete source), "summary" (file list with stats only), "none" (metadata only). Default: summary')
     }), async (args) => {
         const clientManager = getClientManager();
-        const config = clientManager.config;
+        const config = clientManager.getConfig();
         if (!config.etherscanApiKey) {
             throw new Error('Etherscan API key is required. Use --etherscan-api-key or set ETHERSCAN_API_KEY environment variable.');
         }
@@ -218,41 +225,8 @@ export default {
                 etherscanUrl: clientManager.explorerUrl(args.chain, `/address/${args.address}`)
             });
         }
-        // Parse source code
-        let sourceFiles = {};
-        let sourceCodeString = contractInfo.SourceCode;
-        // Handle multi-file sources (wrapped in {{ }} or [ ])
-        if (sourceCodeString.startsWith('{{') || sourceCodeString.startsWith('[')) {
-            try {
-                // Remove outer braces/brackets if present
-                if (sourceCodeString.startsWith('{{')) {
-                    sourceCodeString = sourceCodeString.slice(1, -1);
-                }
-                const parsed = JSON.parse(sourceCodeString);
-                if (parsed.sources) {
-                    // Standard JSON format
-                    sourceFiles = Object.fromEntries(Object.entries(parsed.sources).map(([path, data]) => [path, data.content || '']));
-                }
-                else if (typeof parsed === 'object') {
-                    // Simple object format
-                    sourceFiles = parsed;
-                }
-            }
-            catch {
-                // If parsing fails, treat as single file
-                sourceFiles = { [`${contractInfo.ContractName}.sol`]: sourceCodeString };
-            }
-        }
-        else {
-            // Single file source
-            sourceFiles = { [`${contractInfo.ContractName}.sol`]: sourceCodeString };
-        }
-        // Calculate file stats for summary mode
-        const fileStats = Object.entries(sourceFiles).map(([path, content]) => ({
-            path,
-            lines: content.split('\n').length,
-            size: content.length
-        }));
+        const sourceFiles = parseSourceFiles(contractInfo);
+        const files = fileStats(sourceFiles);
         const result = {
             success: true,
             chain: args.chain,
@@ -268,7 +242,7 @@ export default {
             licenseType: contractInfo.LicenseType,
             constructorArguments: contractInfo.ConstructorArguments,
             fileCount: Object.keys(sourceFiles).length,
-            totalLines: fileStats.reduce((sum, stat) => sum + stat.lines, 0),
+            totalLines: files.reduce((sum, stat) => sum + stat.lines, 0),
             etherscanUrl: clientManager.explorerUrl(args.chain, `/address/${args.address}#code`)
         };
         // Add source based on includeSource parameter
@@ -276,7 +250,7 @@ export default {
             result.sourceFiles = sourceFiles;
         }
         else if (args.includeSource === 'summary') {
-            result.files = fileStats;
+            result.files = files;
         }
         // 'none' mode: no source files added
         // If proxy and implementation requested, fetch implementation source
@@ -284,35 +258,8 @@ export default {
             try {
                 const implInfo = await fetchContractInfo(chainId, contractInfo.Implementation, config.etherscanApiKey);
                 if (implInfo && implInfo.SourceCode !== '') {
-                    // Parse implementation source code
-                    let implSourceFiles = {};
-                    let implSourceCodeString = implInfo.SourceCode;
-                    if (implSourceCodeString.startsWith('{{') || implSourceCodeString.startsWith('[')) {
-                        try {
-                            if (implSourceCodeString.startsWith('{{')) {
-                                implSourceCodeString = implSourceCodeString.slice(1, -1);
-                            }
-                            const parsed = JSON.parse(implSourceCodeString);
-                            if (parsed.sources) {
-                                implSourceFiles = Object.fromEntries(Object.entries(parsed.sources).map(([path, data]) => [path, data.content || '']));
-                            }
-                            else if (typeof parsed === 'object') {
-                                implSourceFiles = parsed;
-                            }
-                        }
-                        catch {
-                            implSourceFiles = { [`${implInfo.ContractName}.sol`]: implSourceCodeString };
-                        }
-                    }
-                    else {
-                        implSourceFiles = { [`${implInfo.ContractName}.sol`]: implSourceCodeString };
-                    }
-                    // Calculate implementation file stats
-                    const implFileStats = Object.entries(implSourceFiles).map(([path, content]) => ({
-                        path,
-                        lines: content.split('\n').length,
-                        size: content.length
-                    }));
+                    const implSourceFiles = parseSourceFiles(implInfo);
+                    const implFileStats = fileStats(implSourceFiles);
                     const implResult = {
                         address: contractInfo.Implementation,
                         contractName: implInfo.ContractName,
@@ -333,15 +280,6 @@ export default {
                         implResult.files = implFileStats;
                     }
                     result.implementation = implResult;
-                    // Update cache with implementation source (rawInfo already cached by fetchContractInfo)
-                    if (contractInfo.Implementation) {
-                        const implCacheKey = getCacheKey(chainId, contractInfo.Implementation);
-                        const existingImpl = contractCache.get(implCacheKey);
-                        contractCache.set(implCacheKey, {
-                            ...existingImpl,
-                            sourceFiles: implSourceFiles
-                        });
-                    }
                 }
             }
             catch (error) {
@@ -352,13 +290,6 @@ export default {
         else if (isProxy && contractInfo.Implementation) {
             result.implementationAddress = contractInfo.Implementation;
         }
-        // Update cache with main contract source (rawInfo already cached by fetchContractInfo)
-        const cacheKey = getCacheKey(chainId, args.address);
-        const existing = contractCache.get(cacheKey);
-        contractCache.set(cacheKey, {
-            ...existing,
-            sourceFiles
-        });
         return formatResponse(result);
     }),
     get_contract_source_file: createTool('Get Specific Contract Source File', 'Retrieve a specific source file from a cached contract. Use get_contract_source_code first to cache the contract.', z.object({

package/dist/tools/read/contract-info.js.map

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

package/dist/tools/{contract.d.ts → read/contract.d.ts}

@@ -5,21 +5,21 @@ declare const _default: {
         description: string;
         schema: z.ZodObject<{
             calls: z.ZodArray<z.ZodObject<{
-                chain: z.ZodEnum<["arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+                chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
                 contractAddress: z.ZodString;
                 functionAbi: z.ZodString;
                 args: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
                 blockNumber: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
-                chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+                chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
                 contractAddress: string;
                 functionAbi: string;
                 blockNumber?: string | undefined;
                 args?: (string | number | boolean | null)[] | undefined;
                 label?: string | undefined;
             }, {
-                chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+                chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
                 contractAddress: string;
                 functionAbi: string;
                 blockNumber?: string | undefined;
@@ -28,7 +28,7 @@ declare const _default: {
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             calls: {
-                chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+                chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
                 contractAddress: string;
                 functionAbi: string;
                 blockNumber?: string | undefined;
@@ -37,7 +37,7 @@ declare const _default: {
             }[];
         }, {
             calls: {
-                chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+                chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
                 contractAddress: string;
                 functionAbi: string;
                 blockNumber?: string | undefined;
@@ -47,32 +47,34 @@ declare const _default: {
         }>;
         handler: (args: {
             calls: {
-                chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+                chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
                 contractAddress: string;
                 functionAbi: string;
                 blockNumber?: string | undefined;
                 args?: (string | number | boolean | null)[] | undefined;
                 label?: string | undefined;
             }[];
-        }) => Promise<import("../types.js").ToolResult>;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
     };
     is_contract: {
         title: string;
         description: string;
         schema: z.ZodObject<{
-            chain: z.ZodEnum<["arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
             address: z.ZodString;
         }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             address: string;
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
         }, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             address: string;
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
         }>;
         handler: (args: {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             address: string;
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
-        }) => Promise<import("../types.js").ToolResult>;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
     };
 };
 export default _default;

package/dist/tools/read/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/tools/read/contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBvB,wBA4IC"}

package/dist/tools/{contract.js → read/contract.js}

@@ -1,7 +1,7 @@
 import { isAddress, parseAbiItem } from 'viem';
 import { z } from 'zod';
-import { getClientManager, SUPPORTED_CHAINS } from '../client.js';
-import { convertArgumentsToTypes, createTool, formatResponse } from '../utils.js';
+import { getClientManager, SUPPORTED_CHAINS } from '../../client.js';
+import { convertArgumentsToTypes, createTool, formatResponse, MAX_BATCH } from '../../utils.js';
 const ContractCallSchema = z.object({
     chain: z.enum(SUPPORTED_CHAINS).describe('Blockchain network (mainnet, base, arbitrum, polygon, optimism, celo, localhost)'),
     contractAddress: z.string().describe('Contract address to call (must be valid checksummed address)'),
@@ -19,6 +19,7 @@ export default {
     read_contract: createTool('Read Contract', 'Read state from contracts by calling view/pure functions. Nothing is sent on-chain and no wallet is involved. BATCH OPTIMIZED - use for reading contract state, token metadata.', z.object({
         calls: z
             .array(ContractCallSchema)
+            .max(MAX_BATCH)
             .describe('Array of contract function calls. Automatically batched by chain/block for optimal performance.')
     }), async (args) => {
         // Group by chain and blockNumber for efficient multicall

package/dist/tools/read/contract.js.map

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

package/dist/tools/read/ens.d.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+declare const _default: {
+    resolve_ens_name: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodDefault<z.ZodEnum<["mainnet", "linea", "base"]>>;
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "linea";
+            name: string;
+        }, {
+            name: string;
+            chain?: "mainnet" | "base" | "linea" | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "linea";
+            name: string;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
+    };
+    reverse_resolve_ens: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodDefault<z.ZodEnum<["mainnet", "linea", "base"]>>;
+            address: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "linea";
+            address: string;
+        }, {
+            address: string;
+            chain?: "mainnet" | "base" | "linea" | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "linea";
+            address: string;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
+    };
+    get_ens_text_record: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodDefault<z.ZodEnum<["mainnet", "linea", "base"]>>;
+            name: z.ZodString;
+            key: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "linea";
+            key: string;
+            name: string;
+        }, {
+            key: string;
+            name: string;
+            chain?: "mainnet" | "base" | "linea" | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "linea";
+            key: string;
+            name: string;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
+    };
+    get_ens_avatar: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodDefault<z.ZodEnum<["mainnet", "linea", "base"]>>;
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "linea";
+            name: string;
+        }, {
+            name: string;
+            chain?: "mainnet" | "base" | "linea" | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "linea";
+            name: string;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
+    };
+    batch_resolve_ens_names: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodDefault<z.ZodEnum<["mainnet", "linea", "base"]>>;
+            names: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "linea";
+            names: string[];
+        }, {
+            names: string[];
+            chain?: "mainnet" | "base" | "linea" | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "linea";
+            names: string[];
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
+    };
+};
+export default _default;
+//# sourceMappingURL=ens.d.ts.map

package/dist/tools/read/ens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ens.d.ts","sourceRoot":"","sources":["../../../src/tools/read/ens.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2LvB,wBAiPC"}