Multi-Source Indexer Reconciliation Tool

WHAT IT DOES

The Multi-Source Indexer Reconciliation Tool is an analytics tool that reconciles block numbers across multiple RPC indexers to determine a consensus block height. It queries each indexer for its latest block number, analyzes the distribution, and identifies which providers agree and which are outliers. The tool calculates a recommended consensus block based on a user-configurable threshold, helping developers and infrastructure operators determine the most reliable block height when indexers disagree. This is essential for applications that rely on accurate chain state, multi-provider redundancy strategies, and identifying failing or misconfigured indexers.

HOW TO USE

Enter a list of RPC indexer URLs (one per line) into the input field. Set the consensus threshold percentage (default 70%), which determines how much agreement is required for consensus. Click "reconcile indexers" to perform a one-time reconciliation. The tool queries all providers in parallel, computes the consensus block, and displays a comprehensive report. Results include per-indexer status with block numbers and deviation from consensus, overall consensus strength metrics, divergence statistics, and a recommended consensus block height with confidence assessment.

TECHNICAL MECHANISM

The tool creates ethers JsonRpcProvider instances for each user-provided URL and issues eth_blockNumber requests in parallel with a concurrency limit of 4 to avoid rate limiting. For each responding indexer, it captures the latest block number. The reconciliation algorithm computes the mean and standard deviation of all reported block numbers. It then identifies the consensus block by finding the block number with the most agreement within a tolerance window determined by the user threshold. Specifically, it selects the median block number from providers whose block numbers fall within the deviation tolerance. Outliers are identified as providers whose block numbers deviate by more than two standard deviations from the mean. The tool calculates consensus strength as the percentage of providers that agree on the consensus block, and assesses reliability based on this percentage. Results are displayed with color-coded status indicators and a visual bar chart for consensus strength.

WHAT IT CANNOT SEE

The tool cannot reconcile actual data content differences beyond block numbers. It cannot determine which indexer has correct data when block numbers agree but the actual data differs. The tool cannot verify that all indexers have processed the same set of transactions. It cannot account for provider-specific caching, load-balancing, or infrastructure differences that may affect reported block numbers. The tool cannot detect inconsistencies in historical log queries or state reads. It cannot reconcile differences in event indexing across providers or validate the accuracy of any individual provider's data without an external reference.

PLEASE NOTE

This tool is designed for Ethereum Virtual Machine (EVM) compatible chains only. The consensus mechanism relies solely on block numbers—consensus on block height does not guarantee consensus on actual data content. The consensus threshold is configurable but should be set based on the number of providers and the acceptable level of divergence for your use case. The tool provides estimates only and should not be used as the sole basis for critical infrastructure decisions. Different providers may have different update frequencies, and reported block numbers may vary due to network propagation. For production applications, combine this tool with data-level validation across providers.