Skip to content

Account History

Account History builds a per-account activity index from accepted blocks, transactions, receipts, and events. It provides historical queries that do not belong in Chain's consensus state.

Dependencies and inputs

The service connects to RabbitMQ and consumes accepted-block and irreversible-block broadcasts. In the official Compose topology it also depends on Chain and Block Store, which it uses to determine progress and retrieve stored blocks while catching up.

Its RPC interface provides paginated account-history lookup.

State and consistency

The selected release uses a fork-aware Koinos state database backed by RocksDB. The index can contain recent accepted history that is not yet irreversible and must follow the selected fork when Chain changes heads.

Account History is a derived view. It can be behind Chain, and it is not authoritative for a current balance, nonce, or contract state. Pagination over a moving head can also observe new history between requests.

If the service is unavailable, account-history queries fail while Chain and block validation can continue.

Versioned sources