web3-tools-mcp 1.0.0 → 1.1.0

package/dist/tools/signatures.js

@@ -0,0 +1,93 @@
+import { keccak256, parseAbiItem, toBytes, toEventSignature, toFunctionSignature } from 'viem';
+import { z } from 'zod';
+import { createTool, formatResponse } from '../utils.js';
+const FunctionAbiSchema = z.object({
+    functionAbi: z.string().describe('Function ABI definition (e.g., "function transfer(address to, uint256 amount)")')
+});
+const EventAbiSchema = z.object({
+    eventAbi: z
+        .string()
+        .describe('Event ABI definition (e.g., "event Transfer(address indexed from, address indexed to, uint256 value)")')
+});
+const ErrorAbiSchema = z.object({
+    errorAbi: z
+        .string()
+        .describe('Error ABI definition (e.g., "error InsufficientBalance(uint256 available, uint256 required)")')
+});
+export default {
+    get_function_signature: createTool('Calculate Function Signatures', 'Generate 4-byte function selectors from ABI definitions. BATCH OPTIMIZED - use for transaction decoding.', z.object({
+        items: z
+            .array(FunctionAbiSchema)
+            .describe('Array of function ABI definitions. Batch multiple functions for efficiency.')
+    }), async (args) => {
+        try {
+            const results = args.items.map((item) => {
+                const abiItem = parseAbiItem(item.functionAbi);
+                const signature = toFunctionSignature(abiItem);
+                const hash = keccak256(toBytes(signature));
+                const selector = hash.slice(0, 10);
+                return {
+                    signature: selector,
+                    fullSignature: signature,
+                    functionName: abiItem.name,
+                    inputs: abiItem.inputs,
+                    outputs: abiItem.outputs || [],
+                    stateMutability: abiItem.stateMutability,
+                    originalAbi: item.functionAbi
+                };
+            });
+            return formatResponse(results);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse function ABI: ${error}`);
+        }
+    }),
+    get_event_signature: createTool('Calculate Event Signatures', 'Generate event topic0 hashes from ABI definitions. BATCH OPTIMIZED - use for log filtering setup.', z.object({
+        items: z.array(EventAbiSchema).describe('Array of event ABI definitions. Batch multiple events for optimal performance.')
+    }), async (args) => {
+        try {
+            const results = args.items.map((item) => {
+                const abiItem = parseAbiItem(item.eventAbi);
+                const signature = toEventSignature(abiItem);
+                const hash = keccak256(toBytes(signature));
+                return {
+                    signature: hash,
+                    topic0: hash,
+                    fullSignature: signature,
+                    eventName: abiItem.name,
+                    inputs: abiItem.inputs,
+                    anonymous: abiItem.anonymous || false,
+                    originalAbi: item.eventAbi
+                };
+            });
+            return formatResponse(results);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse event ABI: ${error}`);
+        }
+    }),
+    get_error_signature: createTool('Calculate Error Signatures', 'Generate 4-byte error selectors from ABI definitions. BATCH OPTIMIZED - use for revert reason decoding.', z.object({
+        items: z.array(ErrorAbiSchema).describe('Array of error ABI definitions. Batch related errors for efficiency.')
+    }), async (args) => {
+        try {
+            const results = args.items.map((item) => {
+                const abiItem = parseAbiItem(item.errorAbi);
+                const signature = `${abiItem.name}(${abiItem.inputs.map((input) => input.type).join(',')})`;
+                const hash = keccak256(toBytes(signature));
+                const selector = hash.slice(0, 10);
+                return {
+                    signature: selector,
+                    fullSignature: signature,
+                    errorName: abiItem.name,
+                    inputs: abiItem.inputs,
+                    originalAbi: item.errorAbi
+                };
+            });
+            return formatResponse(results);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse error ABI: ${error}`);
+        }
+    })
+};
+//# sourceMappingURL=signatures.js.map

package/dist/tools/signatures.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+import type { AbiParameter } from 'viem';
+export interface AbiError {
+    type: 'error';
+    name: string;
+    inputs: readonly AbiParameter[];
+}
+export interface Config {
+    etherscanApiKey?: string;
+    alchemyApiKey?: string;
+    infuraApiKey?: string;
+    customRpcUrls?: Record<string, string>;
+    hypersyncApiKey?: string;
+}
+export type ChainName = 'mainnet' | 'base' | 'arbitrum' | 'polygon' | 'optimism' | 'celo' | 'localhost';
+export interface ToolResult {
+    [x: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGxC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;CAChC;AAGD,MAAM,WAAW,MAAM;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAGD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,CAAA;AAGvG,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACpB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACb,CAAC,CAAA;CACH"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,22 @@
+import type { AbiParameter } from 'viem';
+import type { ToolResult } from './types.js';
+import { z } from 'zod';
+export declare function createTool<T extends z.ZodType>(title: string, description: string, schema: T, handler: (args: z.infer<T>) => Promise<ToolResult>): {
+    title: string;
+    description: string;
+    schema: T;
+    handler: (args: z.infer<T>) => Promise<ToolResult>;
+};
+export declare function convertBigIntToString(obj: unknown): unknown;
+export declare function convertArgumentsToTypes(args: (string | number | boolean | null)[], abiInputs: readonly AbiParameter[]): unknown[];
+export declare function convertEventArgsToTypes(eventArgs: Record<string, unknown>, abiInputs: readonly AbiParameter[]): Record<string, unknown>;
+export declare function formatResponse(data: unknown): ToolResult;
+export declare function parseCommandLineArgs(): {
+    etherscanApiKey?: string;
+    alchemyApiKey?: string;
+    infuraApiKey?: string;
+    customRpcUrls?: Record<string, string>;
+    hypersyncApiKey?: string;
+    showHelp?: boolean;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC5C,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC;;;;oBAAlC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC;EAQnD;AAGD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAe3D;AAGD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,EAC1C,SAAS,EAAE,SAAS,YAAY,EAAE,GACjC,OAAO,EAAE,CAiDX;AAGD,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,EAAE,SAAS,YAAY,EAAE,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2DzB;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAUxD;AAGD,wBAAgB,oBAAoB,IAAI;IACtC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CA2CA"}

package/dist/utils.js

@@ -0,0 +1,183 @@
+// Create tool helper
+export function createTool(title, description, schema, handler) {
+    return {
+        title,
+        description,
+        schema,
+        handler
+    };
+}
+// Convert BigInt values to strings for JSON serialization
+export function convertBigIntToString(obj) {
+    if (typeof obj === 'bigint') {
+        return obj.toString();
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(item => convertBigIntToString(item));
+    }
+    if (obj && typeof obj === 'object') {
+        const converted = {};
+        for (const [key, value] of Object.entries(obj)) {
+            converted[key] = convertBigIntToString(value);
+        }
+        return converted;
+    }
+    return obj;
+}
+// Convert arguments to appropriate types based on ABI
+export function convertArgumentsToTypes(args, abiInputs) {
+    return args.map((arg, index) => {
+        if (index >= abiInputs.length) {
+            throw new Error(`Too many arguments provided. Expected ${abiInputs.length}, got ${args.length}`);
+        }
+        const param = abiInputs[index];
+        if (!param?.type) {
+            throw new Error(`Missing type information for parameter at index ${index}`);
+        }
+        const paramType = param.type;
+        // Handle null values
+        if (arg === null) {
+            return null;
+        }
+        // Handle different parameter types
+        if (paramType === 'address') {
+            return String(arg);
+        }
+        if (paramType === 'bool') {
+            if (typeof arg === 'boolean')
+                return arg;
+            if (typeof arg === 'string')
+                return arg.toLowerCase() === 'true';
+            return Boolean(arg);
+        }
+        if (paramType.startsWith('uint') || paramType.startsWith('int')) {
+            if (typeof arg === 'number')
+                return BigInt(arg);
+            if (typeof arg === 'string')
+                return BigInt(arg);
+            throw new Error(`Invalid type for ${paramType}: ${typeof arg}`);
+        }
+        if (paramType === 'string') {
+            return String(arg);
+        }
+        if (paramType === 'bytes' || paramType.startsWith('bytes')) {
+            return String(arg);
+        }
+        // For other types, try to convert appropriately
+        if (typeof arg === 'string' && arg.startsWith('0x')) {
+            return arg; // Assume it's already properly formatted
+        }
+        return arg;
+    });
+}
+// Convert event arguments to appropriate types
+export function convertEventArgsToTypes(eventArgs, abiInputs) {
+    const converted = {};
+    for (const [argName, argValue] of Object.entries(eventArgs)) {
+        // Find the parameter definition for this argument name
+        const param = abiInputs.find(input => input.name === argName);
+        if (!param) {
+            throw new Error(`Parameter '${argName}' not found in event ABI`);
+        }
+        if (!param.type) {
+            throw new Error(`Missing type information for parameter '${argName}'`);
+        }
+        const paramType = param.type;
+        // Handle null/undefined values
+        if (argValue === null || argValue === undefined) {
+            converted[argName] = null;
+            continue;
+        }
+        // Handle different parameter types
+        if (paramType === 'address') {
+            converted[argName] = String(argValue);
+        }
+        else if (paramType === 'bool') {
+            if (typeof argValue === 'boolean') {
+                converted[argName] = argValue;
+            }
+            else if (typeof argValue === 'string') {
+                converted[argName] = argValue.toLowerCase() === 'true';
+            }
+            else {
+                converted[argName] = Boolean(argValue);
+            }
+        }
+        else if (paramType.startsWith('uint') || paramType.startsWith('int')) {
+            if (typeof argValue === 'number') {
+                converted[argName] = BigInt(argValue);
+            }
+            else if (typeof argValue === 'string') {
+                converted[argName] = BigInt(argValue);
+            }
+            else {
+                throw new Error(`Invalid type for ${paramType}: ${typeof argValue}`);
+            }
+        }
+        else if (paramType === 'string') {
+            converted[argName] = String(argValue);
+        }
+        else if (paramType === 'bytes' || paramType.startsWith('bytes')) {
+            converted[argName] = String(argValue);
+        }
+        else {
+            // For other types, handle arrays and try to convert appropriately
+            if (Array.isArray(argValue)) {
+                converted[argName] = argValue;
+            }
+            else if (typeof argValue === 'string' && argValue.startsWith('0x')) {
+                converted[argName] = argValue; // Assume it's already properly formatted
+            }
+            else {
+                converted[argName] = argValue;
+            }
+        }
+    }
+    return converted;
+}
+// Format response as tool result
+export function formatResponse(data) {
+    const serializable = convertBigIntToString(data);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(serializable, null, 2)
+            }
+        ]
+    };
+}
+// Parse command line arguments
+export function parseCommandLineArgs() {
+    const config = {};
+    function getArgValue(argName) {
+        const args = process.argv;
+        const index = args.findIndex(arg => arg === argName);
+        return index !== -1 && index + 1 < args.length ? args[index + 1] : undefined;
+    }
+    function hasArg(argName) {
+        return process.argv.includes(argName);
+    }
+    // Check for help flag
+    if (hasArg('--help') || hasArg('-h')) {
+        config.showHelp = true;
+        return config;
+    }
+    // Parse environment variables and command line arguments
+    config.etherscanApiKey = process.env.ETHERSCAN_API_KEY || getArgValue('--etherscan-api-key');
+    config.alchemyApiKey = process.env.ALCHEMY_API_KEY || getArgValue('--alchemy-api-key');
+    config.infuraApiKey = process.env.INFURA_API_KEY || getArgValue('--infura-api-key');
+    config.hypersyncApiKey = process.env.HYPERSYNC_API_KEY || getArgValue('--hypersync-api-key');
+    // Parse custom RPC URLs
+    const customRpcs = getArgValue('--custom-rpc');
+    if (customRpcs) {
+        try {
+            config.customRpcUrls = JSON.parse(customRpcs);
+        }
+        catch {
+            console.error('Invalid JSON for --custom-rpc:', customRpcs);
+        }
+    }
+    return config;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -1,28 +1,39 @@
 {
   "name": "web3-tools-mcp",
-  "version": "1.0.0",
-  "description": "MCP server for blockchain interactions using viem, etherscan and hypersync.",
+  "version": "1.1.0",
+  "description": "Model Context Protocol server for blockchain interactions using viem, Etherscan, and Hypersync",
+  "type": "module",
   "main": "dist/index.js",
-  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
   "bin": {
     "web3-tools-mcp": "dist/index.js"
   },
-  "type": "module",
   "files": [
-    "dist/**/*",
+    "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "src"
   ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "scripts": {
-    "start": "node dist/index.js",
-    "dev": "bun --watch index.ts",
-    "build": "bun build index.ts --outdir dist --target node --format esm && chmod +x dist/index.js",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "npm run clean && npm run build",
-    "type-check": "tsc --noEmit",
-    "lint": "bun run type-check"
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "prepare": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui"
   },
-  "keywords": ["mcp", "ethereum", "viem", "blockchain", "web3", "model-context-protocol", "ai"],
+  "keywords": [
+    "mcp",
+    "ethereum",
+    "viem",
+    "blockchain",
+    "web3",
+    "model-context-protocol",
+    "ai"
+  ],
   "author": "Benjamin Hajnal <hajnalbenjamin@gmail.com>",
   "license": "MIT",
   "repository": {
@@ -33,16 +44,17 @@
     "url": "https://github.com/hajnalben/web3-tools-mcp/issues"
   },
   "homepage": "https://github.com/hajnalben/web3-tools-mcp#readme",
-  "devDependencies": {
-    "@types/bun": "latest",
-    "@types/node": "^24.0.4"
-  },
-  "peerDependencies": {
-    "typescript": "^5"
-  },
   "dependencies": {
     "@envio-dev/hypersync-client": "^0.6.5",
-    "@modelcontextprotocol/sdk": "^1.13.1",
-    "viem": "^2.31.4"
+    "@modelcontextprotocol/sdk": "^1.20.1",
+    "viem": "^2.31.4",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.23",
+    "@vitest/ui": "^3.2.4",
+    "dotenv": "^17.2.3",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
   }
 }

package/src/client.ts

@@ -0,0 +1,160 @@
+import { http, createPublicClient } from 'viem'
+import { arbitrum, base, celo, localhost, mainnet, optimism, polygon } from 'viem/chains'
+import type { ChainName, Config } from './types.js'
+
+// Enhanced RPC configuration with API keys
+function getRpcUrl(chainName: string, config: Config): string {
+  // Check for custom RPC URLs first
+  if (config.customRpcUrls?.[chainName]) {
+    return config.customRpcUrls[chainName]
+  }
+
+  // Enhanced RPC URLs with API keys
+  const enhancedRpcs: Record<string, string> = {
+    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: 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: Partial<Record<ChainName, string>> = {
+  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'] as const
+
+// Client manager
+export class ClientManager {
+  private clients: Map<ChainName, unknown> = new Map()
+  private config: Config
+
+  constructor(config: Config) {
+    this.config = config
+  }
+
+  getClient(chainName: 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 as ReturnType<typeof createPublicClient>
+  }
+
+  getEtherscanDomain(chainName: ChainName): string {
+    const domains: Record<ChainName, string> = {
+      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: ClientManager | null = null
+
+export function initializeClientManager(config: Config): ClientManager {
+  clientManager = new ClientManager(config)
+  return clientManager
+}
+
+export function getClientManager(): ClientManager {
+  if (!clientManager) {
+    throw new Error('Client manager not initialized')
+  }
+  return clientManager
+}