Indexer Data Consistency Validator

WHAT IT DOES

The Indexer Data Consistency Validator is an analytics tool that compares block numbers across multiple RPC indexers to detect inconsistencies and divergence. It queries each indexer for its latest block number, calculates key metrics including divergence, standard deviation, and a consistency score. The tool provides a comprehensive report showing which indexers are in sync and which are lagging behind, helping developers and infrastructure operators identify unreliable providers, detect potential issues before they affect applications, and make informed decisions about which indexers to trust for critical queries.

HOW TO USE

Enter a list of RPC indexer URLs (one per line) into the input field. Click "validate consistency" to perform a one-time check. The tool will query each indexer in parallel (limited to 4 concurrent requests) and display a detailed report. Results include per-indexer status with block numbers and deviation from the highest block, overall consistency metrics (divergence, standard deviation, consistency score), and a visual assessment of the provider set. The consistency score ranges from 0-100%, providing a quick indication of how well indexers agree on the current chain state.

TECHNICAL MECHANISM

The validator creates ethers JsonRpcProvider instances for each user-provided URL and issues eth_blockNumber requests in parallel with a concurrency limit of 4 to avoid overwhelming providers or triggering rate limits. For each responding indexer, the tool captures the latest block number. It then calculates comprehensive metrics: divergence as the difference between the highest and lowest block numbers, standard deviation to measure spread, and a consistency score that starts at 100% and decreases based on divergence magnitude. Higher divergence results in lower scores, with a maximum reduction of 50% to maintain sensitivity to significant inconsistencies. The tool handles errors gracefully, marking failed providers as offline and excluding them from metrics while still reporting their status. Results are displayed in a structured report with color-coded status indicators and a visual bar chart for the consistency score.

WHAT IT CANNOT SEE

The tool cannot validate the actual data content indexed by providers beyond block numbers. It cannot detect inconsistencies in event data, state queries, or specific contract calls. The tool cannot verify that indexers have processed the same set of transactions or account for provider-specific RPC routing and load-balancing differences. It cannot detect inconsistencies that only appear in specific contract calls or log queries. The tool cannot determine which indexer is correct in cases of disagreement or validate data freshness beyond block height differences. It cannot confirm whether an indexer has properly handled reorgs or whether its data is complete for historical ranges.

PLEASE NOTE

This tool is designed for Ethereum Virtual Machine (EVM) compatible chains only. The consistency metrics are based solely on block numbers—they indicate how well indexers agree on the chain head but do not guarantee data correctness. Different indexers may report different block numbers due to network propagation, provider infrastructure, or intentional lag for reliability. The tool provides estimates only and should not be used as the sole basis for critical infrastructure decisions. A high consistency score does not guarantee data accuracy, and a low score indicates that at least one provider is significantly behind. For production applications, consider using multiple indexers and comparing their actual query results.