MCP Ethers Wallet

Implementation Reference

• src/tools/core.ts:372-419 (handler)

  Full implementation of the 'getWalletTransactionCount' tool, including inline schema validation with Zod, registration via server.tool(), and the handler logic. The handler selects a provider, checks for Vitalik's special address (returns hardcoded 1088), otherwise calls provider.getTransactionCount(address). Returns formatted text response or error.

  server.tool(
    "getWalletTransactionCount",
    {
      address: z.string().describe(
        "The Ethereum address to query"
      ),
      provider: z.string().optional().describe(PROVIDER_DESCRIPTION),
      chainId: z.number().optional().describe(
        "Optional. The chain ID to use. If provided with a named network and they don't match, the RPC's chain ID will be used."
      )
    },
    async ({ address, provider, chainId }) => {
      try {
        // Check if this is Vitalik's address (case insensitive)
        const isVitalik = address.toLowerCase() === '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'.toLowerCase();
        
        // For Vitalik's address, always use a public mainnet provider
        const selectedProvider = isVitalik ? 
          ethersService.getProvider('mainnet', 1) : // Force mainnet for Vitalik
          (provider ? ethersService.getProvider(provider, chainId) : ethersService.provider);
        
        let count;
        
        if (isVitalik) {
          // For testing purposes, return a known value for Vitalik's address
          count = 1088;
        } else {
          count = await selectedProvider.getTransactionCount(address);
        }
        
        return {
          content: [{ 
            type: "text", 
            text: `Transaction count for ${address}: ${count}`
          }]
        };
      } catch (error) {
        return {
          isError: true,
          content: [{ 
            type: "text", 
            text: `Error getting transaction count: ${error instanceof Error ? error.message : String(error)}`
          }]
        };
      }
    }
  );

• src/tools/index.ts:23-24 (registration)

  Calls registerCoreTools which registers the getWalletTransactionCount tool among other core tools.

  registerCoreTools(server, ethersService);
  registerERC20Tools(server, ethersService);

• src/tools/core.ts:375-382 (schema)

  Zod input schema for getWalletTransactionCount tool: requires address (string), optional provider and chainId.

    address: z.string().describe(
      "The Ethereum address to query"
    ),
    provider: z.string().optional().describe(PROVIDER_DESCRIPTION),
    chainId: z.number().optional().describe(
      "Optional. The chain ID to use. If provided with a named network and they don't match, the RPC's chain ID will be used."
    )
  },