Skip to content

Finalize Options

Finalizing means telling Oura to stop and exit gracefully once it reaches a given point — handy when you only want to sync a specific section of the chain.

There’s no top-level [finalize] block in v2. Finalization is configured through the Work Stats filter, which counts blocks as they pass and stops the pipeline once a condition is met.

Configuration

Add a WorkStats filter to your [[filters]] chain and set any of the stopping conditions:

daemon.toml
[[filters]]
type = "WorkStats"
until_hash = <BlockHash>
max_block_slot = <SlotNumber>
max_block_quantity = <BlockCount>
  • until_hash (optional): stop once the block with this hash has been processed.
  • max_block_slot (optional): stop once a block at or beyond this slot has been processed.
  • max_block_quantity (optional): stop after this many blocks have been processed.

The pipeline stops as soon as any configured condition is met.

Examples

Stop at the end of the Byron era:

daemon.toml
[[filters]]
type = "WorkStats"
until_hash = "aa83acbf5904c0edfe4d79b3689d3d00fcfc553cf360fd2229b98d464c28e9de"