web3-tools-mcp 1.0.1 → 1.2.0

package/dist/src/tools/balance.d.ts.map

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

package/dist/src/tools/balance.js

@@ -0,0 +1,146 @@
+import { formatEther, formatUnits, isAddress } from 'viem';
+import { z } from 'zod';
+import { getClientManager, SUPPORTED_CHAINS } from '../client.js';
+import { createTool, formatResponse } from '../utils.js';
+const BalanceQuerySchema = z.object({
+    chain: z.enum(SUPPORTED_CHAINS).describe('The blockchain network to use'),
+    address: z.string().describe('The address to check balance for'),
+    tokenAddress: z
+        .string()
+        .optional()
+        .describe('Token contract address (optional, if not provided returns native token balance)'),
+    blockNumber: z.string().optional().describe('Block number to query (optional, defaults to latest)'),
+    label: z.string().optional().describe('Optional label for batch results')
+});
+export default {
+    get_balance: createTool('Get Token Balances', 'Retrieve native and ERC20 token balances for multiple addresses. BATCH OPTIMIZED - use for portfolio tracking, wallet monitoring.', z.object({
+        queries: z.array(BalanceQuerySchema).describe('Array of balance queries. Omit tokenAddress for native balance, include for ERC20.')
+    }), async (args) => {
+        // Group by chain and blockNumber for efficient processing
+        const groupedQueries = new Map();
+        for (const item of args.queries) {
+            const key = `${item.chain}:${item.blockNumber || 'latest'}`;
+            if (!groupedQueries.has(key)) {
+                groupedQueries.set(key, []);
+            }
+            groupedQueries.get(key).push(item);
+        }
+        const allResults = [];
+        try {
+            // Process each group
+            for (const [key, queries] of groupedQueries) {
+                const [chain, blockNum] = key.split(':');
+                const clientManager = getClientManager();
+                const client = clientManager.getClient(chain);
+                const blockTag = blockNum === 'latest' ? 'latest' : BigInt(blockNum);
+                // Process all queries in this group
+                const results = await Promise.allSettled(queries.map(async (query) => {
+                    if (!isAddress(query.address)) {
+                        throw new Error(`Invalid address format: ${query.address}`);
+                    }
+                    const originalIndex = args.queries.indexOf(query);
+                    // Native token balance
+                    if (!query.tokenAddress) {
+                        const balance = await client.getBalance({
+                            address: query.address,
+                            blockNumber: blockTag === 'latest' ? undefined : blockTag
+                        });
+                        return {
+                            index: originalIndex,
+                            label: query.label,
+                            address: query.address,
+                            chain: query.chain,
+                            blockNumber: query.blockNumber || 'latest',
+                            success: true,
+                            balance,
+                            balanceFormatted: formatEther(balance)
+                        };
+                    }
+                    // ERC20 token balance
+                    if (!isAddress(query.tokenAddress)) {
+                        throw new Error(`Invalid token address format: ${query.tokenAddress}`);
+                    }
+                    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.address],
+                        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: originalIndex,
+                        label: query.label,
+                        address: query.address,
+                        tokenAddress: query.tokenAddress,
+                        chain: query.chain,
+                        blockNumber: query.blockNumber || 'latest',
+                        success: true,
+                        balance,
+                        balanceFormatted: formatUnits(balance, decimals),
+                        decimals
+                    };
+                }));
+                // Process results
+                results.forEach((result, idx) => {
+                    if (result.status === 'fulfilled') {
+                        allResults[result.value.index] = result.value;
+                    }
+                    else {
+                        const query = queries[idx];
+                        const originalIndex = args.queries.indexOf(query);
+                        allResults[originalIndex] = {
+                            index: originalIndex,
+                            label: query.label,
+                            address: query.address,
+                            tokenAddress: query.tokenAddress,
+                            chain: query.chain,
+                            blockNumber: query.blockNumber || 'latest',
+                            success: false,
+                            error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+                        };
+                    }
+                });
+            }
+            return formatResponse({
+                success: true,
+                totalQueries: args.queries.length,
+                successfulQueries: allResults.filter((r) => r.success).length,
+                failedQueries: allResults.filter((r) => !r.success).length,
+                results: allResults
+            });
+        }
+        catch (error) {
+            throw new Error(`Balance query failed: ${error}`);
+        }
+    })
+};
+//# sourceMappingURL=balance.js.map

package/dist/src/tools/balance.js.map

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

package/dist/src/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/src/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"}