Address Indexer

Overview

Meaning and scope

Address Indexer is a service that processes blockchain data into searchable records organized by address, transaction, token, block, or event. It is used to make address history and balances available without repeatedly scanning the raw chain. It differs from an address monitor, which focuses on detecting new changes rather than building a complete queryable history.

Mechanism and operation

The indexer reads blocks and logs, normalizes network-specific data, associates activity with addresses, stores checkpoints, and serves queries or events. Evidence for Address Indexer should preserve the input, configuration version, actor or service, decision, downstream reference, and final outcome. Important failure modes include reorganizations, parser defects, missed blocks, unsupported token behavior, duplicate ingestion, and stale checkpoints. The Address Indexer runbook should define who can retry, cancel, replay, reconcile, communicate, and approve an exception. Monitoring for Address Indexer should distinguish transport success, processing success, and the final external or financial result.

Practical payment example

A service indexes on-chain transfers by receiving address and handles short reorganizations before advancing a merchant’s balance.

Operational checks

Operational evidence should include network, last indexed block, block hash, lag, parser version, replay range, record counts, and reconciliation status. Address Indexer should be documented alongside Address Monitor, Account Query, and API Pagination. Testing Address Indexer should cover boundary values, dependency failure, restart recovery, and incompatible versions where they affect the workflow.

Distinctions and limits

Track canonical block hashes, support rollback and replay, validate continuity, version parsers, compare control totals, and expose indexing lag. Operational metrics for Address Indexer should use stable denominators and separate technical activity from successful business completion.

Related reading

Related definitions: Address Monitor, Account Query.