web3-tools-mcp 1.0.0 → 1.1.0

package/dist/tools/batch.d.ts

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+declare const _default: {
+    batch_contract_calls: {
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+            calls: z.ZodArray<z.ZodObject<{
+                contractAddress: z.ZodString;
+                functionAbi: z.ZodString;
+                args: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+                label: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                contractAddress: string;
+                functionAbi: string;
+                args?: (string | number | boolean | null)[] | undefined;
+                label?: string | undefined;
+            }, {
+                contractAddress: string;
+                functionAbi: string;
+                args?: (string | number | boolean | null)[] | undefined;
+                label?: string | undefined;
+            }>, "many">;
+            blockNumber: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            calls: {
+                contractAddress: string;
+                functionAbi: string;
+                args?: (string | number | boolean | null)[] | undefined;
+                label?: string | undefined;
+            }[];
+            blockNumber?: string | undefined;
+        }, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            calls: {
+                contractAddress: string;
+                functionAbi: string;
+                args?: (string | number | boolean | null)[] | undefined;
+                label?: string | undefined;
+            }[];
+            blockNumber?: string | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            calls: {
+                contractAddress: string;
+                functionAbi: string;
+                args?: (string | number | boolean | null)[] | undefined;
+                label?: string | undefined;
+            }[];
+            blockNumber?: string | undefined;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+    batch_token_balances: {
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+            queries: z.ZodArray<z.ZodObject<{
+                tokenAddress: z.ZodString;
+                holderAddress: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                tokenAddress: string;
+                holderAddress: string;
+                label?: string | undefined;
+            }, {
+                tokenAddress: string;
+                holderAddress: string;
+                label?: string | undefined;
+            }>, "many">;
+            blockNumber: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            queries: {
+                tokenAddress: string;
+                holderAddress: string;
+                label?: string | undefined;
+            }[];
+            blockNumber?: string | undefined;
+        }, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            queries: {
+                tokenAddress: string;
+                holderAddress: string;
+                label?: string | undefined;
+            }[];
+            blockNumber?: string | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            queries: {
+                tokenAddress: string;
+                holderAddress: string;
+                label?: string | undefined;
+            }[];
+            blockNumber?: string | undefined;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+    batch_native_balances: {
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+            addresses: z.ZodArray<z.ZodString, "many">;
+            blockNumber: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            addresses: string[];
+            blockNumber?: string | undefined;
+        }, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            addresses: string[];
+            blockNumber?: string | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            addresses: string[];
+            blockNumber?: string | undefined;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+};
+export default _default;
+//# sourceMappingURL=batch.d.ts.map

package/dist/tools/batch.d.ts.map

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

package/dist/tools/batch.js

@@ -0,0 +1,243 @@
+import { formatEther, formatUnits, isAddress, parseAbiItem } from 'viem';
+import { z } from 'zod';
+import { getClientManager, SUPPORTED_CHAINS } from '../client.js';
+import { convertArgumentsToTypes, createTool, formatResponse } from '../utils.js';
+export default {
+    batch_contract_calls: createTool('Execute multiple contract calls in a single batch operation - Efficient for multiple onchain queries. PREFERRED over multiple individual calls when you need related data from multiple contracts or functions.', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('The blockchain network to use'),
+        calls: z
+            .array(z.object({
+            contractAddress: z.string().describe('The contract address to call'),
+            functionAbi: z.string().describe('Function ABI definition'),
+            args: z
+                .array(z.union([z.string(), z.number(), z.boolean(), z.null()]))
+                .optional()
+                .describe('Function arguments'),
+            label: z.string().optional().describe('Optional label to identify this call in results')
+        }))
+            .describe('Array of contract calls to execute'),
+        blockNumber: z.string().optional().describe('Block number to query (optional, defaults to latest)')
+    }), async (args) => {
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        const blockTag = args.blockNumber ? BigInt(args.blockNumber) : 'latest';
+        try {
+            // Prepare multicall contracts
+            const multicallContracts = args.calls.map((call, index) => {
+                if (!isAddress(call.contractAddress)) {
+                    throw new Error(`Invalid contract address at index ${index}: ${call.contractAddress}`);
+                }
+                const abiItem = parseAbiItem(call.functionAbi);
+                // Validate that this is a view/pure function
+                if (abiItem.stateMutability !== 'view' && abiItem.stateMutability !== 'pure') {
+                    throw new Error(`Only view and pure functions can be called (index ${index})`);
+                }
+                // Convert arguments to appropriate types
+                const convertedArgs = convertArgumentsToTypes(call.args || [], abiItem.inputs);
+                return {
+                    address: call.contractAddress,
+                    abi: [abiItem],
+                    functionName: abiItem.name,
+                    args: convertedArgs
+                };
+            });
+            // Execute multicall
+            const multicallResults = await client.multicall({
+                contracts: multicallContracts,
+                blockNumber: blockTag === 'latest' ? undefined : blockTag
+            });
+            // Process results
+            const processedResults = multicallResults.map((result, index) => {
+                const call = args.calls[index];
+                if (!call) {
+                    return {
+                        index,
+                        label: `Call ${index}`,
+                        contractAddress: 'unknown',
+                        functionName: 'unknown',
+                        success: false,
+                        error: 'Call configuration missing'
+                    };
+                }
+                const abiItem = parseAbiItem(call.functionAbi);
+                if (result.status === 'success') {
+                    return {
+                        index,
+                        label: call.label || `Call ${index}`,
+                        contractAddress: call.contractAddress,
+                        functionName: abiItem.name,
+                        success: true,
+                        result: result.result
+                    };
+                }
+                return {
+                    index,
+                    label: call.label || `Call ${index}`,
+                    contractAddress: call.contractAddress,
+                    functionName: abiItem.name,
+                    success: false,
+                    error: result.error instanceof Error ? result.error.message : String(result.error)
+                };
+            });
+            return formatResponse({
+                success: true,
+                chain: args.chain,
+                blockNumber: blockTag === 'latest' ? 'latest' : blockTag.toString(),
+                totalCalls: args.calls.length,
+                successfulCalls: processedResults.filter(r => r.success).length,
+                failedCalls: processedResults.filter(r => !r.success).length,
+                results: processedResults
+            });
+        }
+        catch (error) {
+            throw new Error(`Batch contract calls failed: ${error}`);
+        }
+    }),
+    batch_token_balances: createTool('Get multiple token balances for multiple addresses in a single call - Efficient for portfolio tracking', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('The blockchain network to use'),
+        queries: z
+            .array(z.object({
+            tokenAddress: z.string().describe('Token contract address'),
+            holderAddress: z.string().describe('Address to check balance for'),
+            label: z.string().optional().describe('Optional label to identify this query in results')
+        }))
+            .describe('Array of balance queries'),
+        blockNumber: z.string().optional().describe('Block number to query (optional, defaults to latest)')
+    }), async (args) => {
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        const blockTag = args.blockNumber ? BigInt(args.blockNumber) : 'latest';
+        try {
+            const results = await Promise.allSettled(args.queries.map(async (query, index) => {
+                if (!isAddress(query.tokenAddress) || !isAddress(query.holderAddress)) {
+                    throw new Error(`Invalid address format at index ${index}`);
+                }
+                // Get balance
+                const balance = await client.readContract({
+                    address: query.tokenAddress,
+                    abi: [
+                        {
+                            name: 'balanceOf',
+                            type: 'function',
+                            stateMutability: 'view',
+                            inputs: [{ name: 'account', type: 'address' }],
+                            outputs: [{ name: '', type: 'uint256' }]
+                        }
+                    ],
+                    functionName: 'balanceOf',
+                    args: [query.holderAddress],
+                    blockNumber: blockTag === 'latest' ? undefined : blockTag
+                });
+                // Try to get decimals
+                let decimals = 18;
+                try {
+                    decimals = (await client.readContract({
+                        address: query.tokenAddress,
+                        abi: [
+                            {
+                                name: 'decimals',
+                                type: 'function',
+                                stateMutability: 'view',
+                                inputs: [],
+                                outputs: [{ name: '', type: 'uint8' }]
+                            }
+                        ],
+                        functionName: 'decimals',
+                        blockNumber: blockTag === 'latest' ? undefined : blockTag
+                    }));
+                }
+                catch {
+                    // Use default decimals if call fails
+                }
+                return {
+                    index,
+                    label: query.label || `Query ${index}`,
+                    tokenAddress: query.tokenAddress,
+                    holderAddress: query.holderAddress,
+                    success: true,
+                    balance,
+                    balanceFormatted: formatUnits(balance, decimals),
+                    decimals
+                };
+            }));
+            const processedResults = results.map((result, index) => {
+                if (result.status === 'fulfilled') {
+                    return result.value;
+                }
+                return {
+                    index,
+                    label: args.queries[index]?.label || `Query ${index}`,
+                    tokenAddress: args.queries[index]?.tokenAddress || 'unknown',
+                    holderAddress: args.queries[index]?.holderAddress || 'unknown',
+                    success: false,
+                    error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+                };
+            });
+            return formatResponse({
+                success: true,
+                chain: args.chain,
+                blockNumber: blockTag === 'latest' ? 'latest' : blockTag.toString(),
+                totalQueries: args.queries.length,
+                successfulQueries: processedResults.filter(r => r.success).length,
+                failedQueries: processedResults.filter(r => !r.success).length,
+                results: processedResults
+            });
+        }
+        catch (error) {
+            throw new Error(`Batch token balances failed: ${error}`);
+        }
+    }),
+    batch_native_balances: createTool('Get native token balances for multiple addresses in a single call - Efficient for wallet monitoring', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('The blockchain network to use'),
+        addresses: z
+            .array(z.string().describe('Address to check balance for'))
+            .describe('Array of addresses to check balances for'),
+        blockNumber: z.string().optional().describe('Block number to query (optional, defaults to latest)')
+    }), async (args) => {
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        const blockTag = args.blockNumber ? BigInt(args.blockNumber) : 'latest';
+        try {
+            const results = await Promise.allSettled(args.addresses.map(async (address, index) => {
+                if (!isAddress(address)) {
+                    throw new Error(`Invalid address format at index ${index}: ${address}`);
+                }
+                const balance = await client.getBalance({
+                    address: address,
+                    blockNumber: blockTag === 'latest' ? undefined : blockTag
+                });
+                return {
+                    index,
+                    address,
+                    success: true,
+                    balance,
+                    balanceFormatted: formatEther(balance)
+                };
+            }));
+            const processedResults = results.map((result, index) => {
+                if (result.status === 'fulfilled') {
+                    return result.value;
+                }
+                return {
+                    index,
+                    address: args.addresses[index] || 'unknown',
+                    success: false,
+                    error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+                };
+            });
+            return formatResponse({
+                success: true,
+                chain: args.chain,
+                blockNumber: blockTag === 'latest' ? 'latest' : blockTag.toString(),
+                totalAddresses: args.addresses.length,
+                successfulQueries: processedResults.filter(r => r.success).length,
+                failedQueries: processedResults.filter(r => !r.success).length,
+                results: processedResults
+            });
+        }
+        catch (error) {
+            throw new Error(`Batch native balances failed: ${error}`);
+        }
+    })
+};
+//# sourceMappingURL=batch.js.map

package/dist/tools/batch.js.map

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

package/dist/tools/contract-info.d.ts

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+declare const _default: {
+    get_contract_abi: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+            address: z.ZodString;
+            include: z.ZodOptional<z.ZodArray<z.ZodEnum<["abi", "implementationAbi", "metadata", "compilation", "creation", "stats"]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            include?: ("abi" | "implementationAbi" | "metadata" | "compilation" | "creation" | "stats")[] | undefined;
+        }, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            include?: ("abi" | "implementationAbi" | "metadata" | "compilation" | "creation" | "stats")[] | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            include?: ("abi" | "implementationAbi" | "metadata" | "compilation" | "creation" | "stats")[] | undefined;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+    get_contract_source_code: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+            address: z.ZodString;
+            includeImplementation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            includeSource: z.ZodDefault<z.ZodOptional<z.ZodEnum<["full", "summary", "none"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            includeImplementation: boolean;
+            includeSource: "full" | "summary" | "none";
+        }, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            includeImplementation?: boolean | undefined;
+            includeSource?: "full" | "summary" | "none" | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            includeImplementation: boolean;
+            includeSource: "full" | "summary" | "none";
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+    get_contract_source_file: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+            address: z.ZodString;
+            filePath: z.ZodOptional<z.ZodString>;
+            useImplementation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            useImplementation: boolean;
+            filePath?: string | undefined;
+        }, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            filePath?: string | undefined;
+            useImplementation?: boolean | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            useImplementation: boolean;
+            filePath?: string | undefined;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+};
+export default _default;
+//# sourceMappingURL=contract-info.d.ts.map

package/dist/tools/contract-info.d.ts.map

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