Hardhat Console

WHAT IT DOES

Hardhat Console is an interactive developer console that connects directly to your Hardhat node or any EVM-compatible chain. It provides raw JSON-RPC access for debugging contracts, inspecting blockchain state, and executing transactions on your local development network. The tool supports all standard RPC methods including eth_call, eth_sendTransaction, eth_getBalance, eth_blockNumber, and eth_getLogs with automatic chunking for large log queries. It connects through the BotSurf wallet bridge, allowing you to sign transactions from your development wallet directly in the console.

HOW TO USE

Install the app through the BotSurf interface. Click Connect to link your wallet. Select your target network—localhost (Hardhat default 31337), Sepolia, Goerli, Mainnet, or a custom RPC URL. Enter any JSON-RPC command in the console input field, such as "eth_blockNumber" to get the current block, "eth_getBalance 0x..." to check an address balance, or "eth_sendTransaction {...}" to execute a transaction. Results appear in the output log with timestamps. The console supports raw method calls—type the method name followed by space-separated parameters. For complex objects like transaction filters, use JSON format.

LOG SCAN CHUNKING AND AUTO-BACKOFF ENGINE

Unlike simple RPC wrappers that fail on large eth_getLogs requests, this tool implements an intelligent chunking engine that automatically adapts to provider limitations. Public RPC endpoints vary widely in their maximum block range per request—some accept 10,000 blocks, others only 2,000, and some reject any query covering more than a specific time window. The engine breaks large log queries into smaller chunks, starting with a configurable chunk size (default 10,000 blocks). If a chunk fails with a "limit exceeded" or "range too large" error, the engine halves the chunk size and retries the same range, continuing until the request succeeds. This ensures that log scans complete even when providers are restrictive, without requiring manual range adjustments. The engine also handles the edge case where even a single-block request fails, surfacing the error clearly to the user.

WHAT IT CANNOT SEE

The console only works with the network configured in the selector—it cannot automatically detect your wallet's chain or switch networks without explicit user action. It cannot deploy or interact with mainnet contracts without careful RPC configuration and manual transaction signing. The tool does not provide contract ABI parsing or decoded function signatures; all responses are raw RPC results. It cannot execute transactions without a connected wallet and sufficient native currency for gas. The console is a development tool and does not include safety checks for production transactions—always verify commands before execution.

PLEASE NOTE

This tool requires the BotSurf interface and an EVM-compatible wallet. It is designed for local development and testing on Hardhat networks. Using it on mainnet or production networks carries real financial risk—double-check every transaction before signing. The tool does not store or transmit any data; all state is local to your session.