getWalletTransactionCount
Retrieve the total number of transactions sent from a specific Ethereum address to monitor wallet activity and track transaction history.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | The Ethereum address to query | |
| provider | No | Optional. Either a network name or custom RPC URL. Use getAllNetworks to see available networks and their details, or getNetwork to get info about a specific network. You can use any network name returned by these tools as a provider value. | |
| chainId | No | 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. |
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." ) },