Module zebra_consensus::checkpoint

source ยท
Expand description

Checkpoint-based block verification.

Checkpoint-based verification uses a list of checkpoint hashes to speed up the initial chain sync for Zebra. This list is distributed with Zebra.

The checkpoint verifier queues pending blocks. Once there is a chain from the previous checkpoint to a target checkpoint, it verifies all the blocks in that chain, and sends accepted blocks to the state service as finalized chain state, skipping the majority of contextual verification checks.

Verification starts at the first checkpoint, which is the genesis block for the configured network.

Re-exportsยง

Modulesยง

  • list ๐Ÿ”’
    Checkpoint lists for checkpoint-based block verification
  • types ๐Ÿ”’
    Supporting types for checkpoint-based block verification

Structsยง

Enumsยง

Constantsยง

  • We limit the memory usage and download contention for each checkpoint, based on the cumulative size of the serialized blocks in the chain.
  • We limit the maximum number of blocks in each checkpoint. Each block uses a constant amount of memory for the supporting data structures and futures.
  • The maximum number of queued blocks at any one height.

Functionsยง

Type Aliasesยง

  • QueuedBlockList ๐Ÿ”’
    A list of unverified blocks at a particular height.