web3-tools-mcp 1.0.1 → 1.2.0

package/dist/src/client.d.ts.map

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

package/dist/src/client.js

@@ -0,0 +1,142 @@
+import { http, createPublicClient } from 'viem';
+import { arbitrum, base, celo, localhost, mainnet, optimism, polygon } from 'viem/chains';
+// Enhanced RPC configuration with API keys
+function getRpcUrl(chainName, config) {
+    // Check for custom RPC URLs first
+    if (config.customRpcUrls?.[chainName]) {
+        return config.customRpcUrls[chainName];
+    }
+    // Enhanced RPC URLs with API keys
+    const enhancedRpcs = {
+        mainnet: config.alchemyApiKey
+            ? `https://eth-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
+            : config.infuraApiKey
+                ? `https://mainnet.infura.io/v3/${config.infuraApiKey}`
+                : 'https://eth.llamarpc.com',
+        base: config.alchemyApiKey
+            ? `https://base-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
+            : 'https://base.llamarpc.com',
+        arbitrum: config.alchemyApiKey
+            ? `https://arb-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
+            : config.infuraApiKey
+                ? `https://arbitrum-mainnet.infura.io/v3/${config.infuraApiKey}`
+                : 'https://arb1.arbitrum.io/rpc',
+        polygon: config.alchemyApiKey
+            ? `https://polygon-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
+            : config.infuraApiKey
+                ? `https://polygon-mainnet.infura.io/v3/${config.infuraApiKey}`
+                : 'https://polygon-rpc.com/',
+        optimism: config.alchemyApiKey
+            ? `https://opt-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
+            : config.infuraApiKey
+                ? `https://optimism-mainnet.infura.io/v3/${config.infuraApiKey}`
+                : 'https://mainnet.optimism.io',
+        celo: 'https://celo.drpc.org',
+        localhost: 'http://localhost:8545'
+    };
+    return enhancedRpcs[chainName] ?? 'https://eth.llamarpc.com';
+}
+// Supported chains with their RPC endpoints (now dynamic)
+export const CHAINS = (config) => ({
+    mainnet: {
+        chain: mainnet,
+        get rpc() {
+            return getRpcUrl('mainnet', config);
+        }
+    },
+    base: {
+        chain: base,
+        get rpc() {
+            return getRpcUrl('base', config);
+        }
+    },
+    arbitrum: {
+        chain: arbitrum,
+        get rpc() {
+            return getRpcUrl('arbitrum', config);
+        }
+    },
+    polygon: {
+        chain: polygon,
+        get rpc() {
+            return getRpcUrl('polygon', config);
+        }
+    },
+    optimism: {
+        chain: optimism,
+        get rpc() {
+            return getRpcUrl('optimism', config);
+        }
+    },
+    celo: {
+        chain: celo,
+        get rpc() {
+            return getRpcUrl('celo', config);
+        }
+    },
+    localhost: {
+        chain: localhost,
+        get rpc() {
+            return getRpcUrl('localhost', config);
+        }
+    }
+});
+// Hypersync URLs for supported chains (localhost is not supported)
+export const HYPERSYNC_URLS = {
+    base: 'https://base.hypersync.xyz',
+    arbitrum: 'https://arbitrum.hypersync.xyz',
+    mainnet: 'https://eth.hypersync.xyz',
+    polygon: 'https://polygon.hypersync.xyz',
+    optimism: 'https://optimism.hypersync.xyz'
+    // celo and localhost are not supported by hypersync
+};
+export const SUPPORTED_CHAINS = ['mainnet', 'base', 'arbitrum', 'polygon', 'optimism', 'celo', 'localhost'];
+// Client manager
+export class ClientManager {
+    clients = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    getClient(chainName) {
+        if (!this.clients.has(chainName)) {
+            const chains = CHAINS(this.config);
+            const { chain, rpc } = chains[chainName];
+            const client = createPublicClient({
+                chain,
+                transport: http(rpc)
+            });
+            this.clients.set(chainName, client);
+        }
+        const client = this.clients.get(chainName);
+        if (!client) {
+            throw new Error(`Failed to create client for chain: ${chainName}`);
+        }
+        return client;
+    }
+    getEtherscanDomain(chainName) {
+        const domains = {
+            mainnet: 'etherscan.io',
+            base: 'basescan.org',
+            arbitrum: 'arbiscan.io',
+            polygon: 'polygonscan.com',
+            optimism: 'optimistic.etherscan.io',
+            celo: 'celoscan.io',
+            localhost: 'etherscan.io'
+        };
+        return domains[chainName] || 'etherscan.io';
+    }
+}
+// Export a global client manager instance
+let clientManager = null;
+export function initializeClientManager(config) {
+    clientManager = new ClientManager(config);
+    return clientManager;
+}
+export function getClientManager() {
+    if (!clientManager) {
+        throw new Error('Client manager not initialized');
+    }
+    return clientManager;
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/dist/src/index.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import packageJson from "../package.json" with { type: "json" };
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { initializeClientManager } from "./client.js";
+import { registerAllTools } from "./tools/index.js";
+import { parseCommandLineArgs } from "./utils.js";
+// Parse configuration
+const config = parseCommandLineArgs();
+// Show help if requested
+if (config.showHelp) {
+    console.log(`
+Web3 Tools MCP Server v${packageJson.version}
+${packageJson.description}
+
+USAGE:
+  npx web3-tools-mcp [OPTIONS]
+
+OPTIONS:
+  --help, -h                    Show this help message
+  --etherscan-api-key <key>     Etherscan API key (for contract ABI retrieval)
+  --alchemy-api-key <key>       Alchemy API key (for enhanced RPC)
+  --infura-api-key <key>        Infura API key (for alternative RPC)
+  --hypersync-api-key <key>     Hypersync API key (for fast event queries)
+  --custom-rpc <json>           Custom RPC URLs as JSON object
+                                Example: '{"mainnet":"https://...", "base":"https://..."}'
+
+ENVIRONMENT VARIABLES:
+  ETHERSCAN_API_KEY             Alternative to --etherscan-api-key
+  ALCHEMY_API_KEY               Alternative to --alchemy-api-key
+  INFURA_API_KEY                Alternative to --infura-api-key
+  HYPERSYNC_API_KEY             Alternative to --hypersync-api-key
+
+SUPPORTED CHAINS:
+  mainnet, base, arbitrum, polygon, optimism, celo, localhost
+
+EXAMPLES:
+  # Use with npx (recommended)
+  npx web3-tools-mcp --etherscan-api-key YOUR_KEY
+
+  # Use environment variables
+  export ETHERSCAN_API_KEY=your_key
+  npx web3-tools-mcp
+
+  # Use custom RPC
+  npx web3-tools-mcp --custom-rpc '{"mainnet":"https://my-rpc.com"}'
+
+DOCUMENTATION:
+  GitHub: ${packageJson.repository.url.replace('git+', '').replace('.git', '')}
+  Issues: ${packageJson.bugs.url}
+
+For MCP client configuration, see the README.md file.
+`);
+    process.exit(0);
+}
+// Log configuration info
+if (config.etherscanApiKey) {
+    console.error("[MCP] Etherscan API key configured");
+}
+if (config.alchemyApiKey) {
+    console.error("[MCP] Alchemy API key configured");
+}
+if (config.infuraApiKey) {
+    console.error("[MCP] Infura API key configured");
+}
+if (config.customRpcUrls) {
+    console.error("[MCP] Custom RPC URLs:", Object.keys(config.customRpcUrls));
+}
+// Initialize client manager
+initializeClientManager(config);
+// Create MCP server instance
+const server = new McpServer({
+    name: "web3-tools-mcp",
+    version: packageJson.version,
+});
+// Register all tools
+registerAllTools(server);
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Web3 Tools MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,WAAW,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,sBAAsB;AACtB,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;AAEtC,yBAAyB;AACzB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;IACpB,OAAO,CAAC,GAAG,CAAC;yBACW,WAAW,CAAC,OAAO;EAC1C,WAAW,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAmCb,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAClE,WAAW,CAAC,IAAI,CAAC,GAAG;;;CAG/B,CAAC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,yBAAyB;AACzB,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;IAC3B,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACtD,CAAC;AACD,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACpD,CAAC;AACD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACnD,CAAC;AACD,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,4BAA4B;AAC5B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAEhC,6BAA6B;AAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,WAAW,CAAC,OAAO;CAC7B,CAAC,CAAC;AAEH,qBAAqB;AACrB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAEzB,eAAe;AACf,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC1D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/tools/advanced.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+declare const _default: {
+    get_storage_at: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+            address: z.ZodString;
+            slot: z.ZodString;
+            abiType: z.ZodString;
+            blockNumber: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            slot: string;
+            abiType: string;
+            blockNumber?: string | undefined;
+        }, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            slot: string;
+            abiType: string;
+            blockNumber?: string | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            address: string;
+            slot: string;
+            abiType: string;
+            blockNumber?: string | undefined;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+    get_block_info: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+            blockNumber: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            blockNumber?: string | undefined;
+        }, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            blockNumber?: string | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            blockNumber?: string | undefined;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+    trace_transaction: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+            transactionHash: z.ZodString;
+            traceType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["trace", "vmTrace", "stateDiff"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            transactionHash: string;
+            traceType: "trace" | "vmTrace" | "stateDiff";
+        }, {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            transactionHash: string;
+            traceType?: "trace" | "vmTrace" | "stateDiff" | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+            transactionHash: string;
+            traceType: "trace" | "vmTrace" | "stateDiff";
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+};
+export default _default;
+//# sourceMappingURL=advanced.d.ts.map

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

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

package/dist/src/tools/advanced.js

@@ -0,0 +1,234 @@
+import { decodeAbiParameters, isAddress, parseAbiParameters } from 'viem';
+import { z } from 'zod';
+import { getClientManager, SUPPORTED_CHAINS } from '../client.js';
+import { createTool, formatResponse } from '../utils.js';
+export default {
+    get_storage_at: createTool('Read Contract Storage', '⚠️ ADVANCED: Direct storage slot access with type decoding. Use for low-level contract inspection.', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('The blockchain network to use'),
+        address: z.string().describe('The contract address to inspect'),
+        slot: z.string().describe('Storage slot (hex string, e.g., "0x0")'),
+        abiType: z
+            .string()
+            .describe('ABI type for decoding (e.g., "uint256", "address", "bool", "bytes32")'),
+        blockNumber: z.string().optional().describe('Block number (optional, defaults to latest)')
+    }), async (args) => {
+        if (!isAddress(args.address)) {
+            throw new Error('Invalid address format');
+        }
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        const blockTag = args.blockNumber ? BigInt(args.blockNumber) : 'latest';
+        try {
+            const storageValue = await client.getStorageAt({
+                address: args.address,
+                slot: args.slot,
+                blockNumber: blockTag === 'latest' ? undefined : blockTag
+            });
+            if (!storageValue) {
+                throw new Error('No storage value found');
+            }
+            // Decode based on ABI type
+            let decodedValue;
+            let formattedValue;
+            try {
+                switch (args.abiType.toLowerCase()) {
+                    case 'uint256':
+                    case 'uint': {
+                        decodedValue = BigInt(storageValue);
+                        formattedValue = decodedValue.toString();
+                        break;
+                    }
+                    case 'int256':
+                    case 'int': {
+                        // Handle two's complement for negative numbers
+                        const uint256Value = BigInt(storageValue);
+                        const maxUint256 = BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff');
+                        decodedValue = uint256Value > maxUint256 / 2n ? uint256Value - maxUint256 - 1n : uint256Value;
+                        formattedValue = decodedValue.toString();
+                        break;
+                    }
+                    case 'address': {
+                        decodedValue = `0x${storageValue.slice(-40)}`;
+                        formattedValue = decodedValue;
+                        break;
+                    }
+                    case 'bool': {
+                        decodedValue = BigInt(storageValue) !== 0n;
+                        formattedValue = String(decodedValue);
+                        break;
+                    }
+                    case 'bytes32': {
+                        decodedValue = storageValue;
+                        formattedValue = storageValue;
+                        break;
+                    }
+                    default: {
+                        // Try to decode as ABI parameters
+                        try {
+                            const parsedTypes = parseAbiParameters([args.abiType]);
+                            if (parsedTypes.length > 0) {
+                                const decoded = decodeAbiParameters(parsedTypes, storageValue);
+                                decodedValue = decoded.length > 0 ? decoded[0] : null;
+                                formattedValue = decodedValue ? String(decodedValue) : 'No data';
+                            }
+                            else {
+                                decodedValue = null;
+                                formattedValue = 'Invalid ABI type';
+                            }
+                        }
+                        catch {
+                            decodedValue = null;
+                            formattedValue = 'Failed to decode with custom ABI type';
+                        }
+                        break;
+                    }
+                }
+            }
+            catch {
+                decodedValue = null;
+                formattedValue = 'Failed to decode';
+            }
+            return formatResponse({
+                rawValue: storageValue,
+                decodedValue,
+                formattedValue,
+                abiType: args.abiType,
+                slot: args.slot,
+                address: args.address,
+                chain: args.chain,
+                blockNumber: blockTag === 'latest' ? 'latest' : blockTag.toString()
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to get storage: ${error}`);
+        }
+    }),
+    get_block_info: createTool('Get Block Information', 'Retrieve block data including timestamps, hashes, and dates. Use for time-based analysis.', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('The blockchain network to use'),
+        blockNumber: z.string().optional().describe('Block number (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 block = await client.getBlock({
+                blockNumber: blockTag === 'latest' ? undefined : blockTag,
+                includeTransactions: false
+            });
+            const timestamp = Number(block.timestamp);
+            const date = new Date(timestamp * 1000);
+            return formatResponse({
+                blockNumber: block.number,
+                timestamp: block.timestamp,
+                timestampMs: timestamp * 1000,
+                dateIso: date.toISOString(),
+                dateReadable: date.toLocaleString(),
+                hash: block.hash,
+                parentHash: block.parentHash,
+                chain: args.chain
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to get block time: ${error}`);
+        }
+    }),
+    trace_transaction: createTool('Trace Transaction', '⚠️ INTENSIVE: Detailed transaction analysis including call traces and state changes. Use sparingly.', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('The blockchain network to use'),
+        transactionHash: z.string().describe('Transaction hash to trace (0x prefixed)'),
+        traceType: z
+            .enum(['trace', 'vmTrace', 'stateDiff'])
+            .optional()
+            .describe('Trace type: "trace" (call tree, recommended), "vmTrace" (VM execution), "stateDiff" (state changes)')
+            .default('trace')
+    }), async (args) => {
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        try {
+            // First get the transaction receipt to make sure it exists
+            const transaction = await client.getTransaction({ hash: args.transactionHash });
+            const receipt = await client.getTransactionReceipt({ hash: args.transactionHash });
+            let traceResult = null;
+            // Perform the requested trace type
+            switch (args.traceType) {
+                case 'trace':
+                    try {
+                        // Use debug_traceTransaction for call trace
+                        traceResult = await client.request({
+                            method: 'debug_traceTransaction',
+                            params: [args.transactionHash, { tracer: 'callTracer' }]
+                        });
+                    }
+                    catch (e) {
+                        traceResult = { error: e.message };
+                    }
+                    break;
+                case 'vmTrace':
+                    try {
+                        traceResult = await client.request({
+                            method: 'debug_traceTransaction',
+                            params: [args.transactionHash, { tracer: 'prestateTracer' }]
+                        });
+                    }
+                    catch (e) {
+                        traceResult = { error: e.message };
+                    }
+                    break;
+                case 'stateDiff':
+                    try {
+                        traceResult = await client.request({
+                            method: 'debug_traceTransaction',
+                            params: [args.transactionHash, { tracer: 'stateDiffTracer' }]
+                        });
+                    }
+                    catch (e) {
+                        traceResult = { error: e.message };
+                    }
+                    break;
+                default:
+                    traceResult = {
+                        type: 'CALL',
+                        from: transaction.from,
+                        to: transaction.to,
+                        value: transaction.value?.toString() || '0',
+                        gas: transaction.gas?.toString() || '0',
+                        gasUsed: receipt.gasUsed?.toString() || '0',
+                        input: transaction.input,
+                        output: '0x',
+                        error: receipt.status === 'success' ? null : 'Transaction failed'
+                    };
+            }
+            const result = {
+                success: true,
+                chain: args.chain,
+                transactionHash: args.transactionHash,
+                traceType: args.traceType,
+                transaction: {
+                    blockNumber: transaction.blockNumber?.toString(),
+                    from: transaction.from,
+                    to: transaction.to,
+                    value: transaction.value?.toString() || '0',
+                    gas: transaction.gas?.toString() || '0',
+                    gasPrice: transaction.gasPrice?.toString() || '0',
+                    nonce: transaction.nonce?.toString() || '0',
+                    input: transaction.input
+                },
+                receipt: {
+                    status: receipt.status,
+                    gasUsed: receipt.gasUsed?.toString() || '0',
+                    effectiveGasPrice: receipt.effectiveGasPrice?.toString() || '0',
+                    logs: receipt.logs.map(log => ({
+                        address: log.address,
+                        topics: log.topics,
+                        data: log.data
+                    }))
+                },
+                trace: traceResult
+            };
+            return formatResponse(result);
+        }
+        catch (error) {
+            throw new Error(`Transaction trace failed: ${error}`);
+        }
+    })
+};
+//# sourceMappingURL=advanced.js.map

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

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

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

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+declare const _default: {
+    get_balance: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            queries: z.ZodArray<z.ZodObject<{
+                chain: z.ZodEnum<["mainnet", "base", "arbitrum", "polygon", "optimism", "celo", "localhost"]>;
+                address: z.ZodString;
+                tokenAddress: z.ZodOptional<z.ZodString>;
+                blockNumber: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+                address: string;
+                blockNumber?: string | undefined;
+                tokenAddress?: string | undefined;
+                label?: string | undefined;
+            }, {
+                chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+                address: string;
+                blockNumber?: string | undefined;
+                tokenAddress?: string | undefined;
+                label?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            queries: {
+                chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+                address: string;
+                blockNumber?: string | undefined;
+                tokenAddress?: string | undefined;
+                label?: string | undefined;
+            }[];
+        }, {
+            queries: {
+                chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+                address: string;
+                blockNumber?: string | undefined;
+                tokenAddress?: string | undefined;
+                label?: string | undefined;
+            }[];
+        }>;
+        handler: (args: {
+            queries: {
+                chain: "mainnet" | "base" | "arbitrum" | "polygon" | "optimism" | "celo" | "localhost";
+                address: string;
+                blockNumber?: string | undefined;
+                tokenAddress?: string | undefined;
+                label?: string | undefined;
+            }[];
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+};
+export default _default;
+//# sourceMappingURL=balance.d.ts.map