Choose a finality level
Leani labels every block with the level it has reached. Waiting for a higher level costs time and buys certainty, so pick the lowest one your application can act on.
| Level | An Ethereum block | A rollup block |
|---|---|---|
unattested |
At least two peers served the header and it passes Leani’s header rules, ~2–5 s | Delivered, not yet signed |
attested |
The sync committee signed it, ~15 s | The chain’s sequencer signed it, ~1 s |
confirmed |
Ethereum’s Fast Confirmation Rule confirmed it, as the consensus nodes you name report, ~15 s | Not available |
finalized |
Casper FFG finality, ~13–19 min | Its batch is in a finalized Ethereum block, 15–30 min |
settled |
Not applicable | Ethereum accepted a claim covering it, 5–7 days |
Coverage, finality, and reorgs has each level’s exact rule and what can undo it.
Ask for a level
A processor publishes from the level its publish names. Lower blocks stay in
its state, unpublished, until they rise:
[[processors]]# id, instance, version ...publish = "confirmed"The CLI takes the same names:
leani subscribe blocks --finality confirmedA consumer that reads from unattested gets every rise as its own operation
(attested, confirmed, finalized, settled) and an undo when a block
leaves the chain, as in Follow a rollup.
confirmed: Ethereum’s fast confirmation
finalized takes 13–19 minutes. confirmed arrives with attested, a slot
or two after the block, and holds unless the rule’s assumptions fail: more
than a quarter of stake adversarial, or attestations delayed past their slot.
Under worse conditions the rule stalls instead of confirming.
Leani does not compute the rule. It reads fast_confirmation events from the
consensus nodes that [confirmation] names, and counts an event only for a
block this node verified as attested with at least 384 of 512 sync-committee
signers:
[confirmation]endpoints = ["https://lodestar-mainnet.chainsafe.io/"]minimum_agreement = 1Compact Ethereum Mainnet configurations name that public node. For
production, run your own consensus node with Fast Confirmation enabled and
name it here. An advanced configuration without the section, or any with
endpoints = [], has no confirmed level and refuses publish = "confirmed".
While the section is configured, JSON-RPC safe names the newest confirmed
block.
confirmed never prunes, compacts, or ends anything: only finalized does.
It exists on Ethereum only. A rollup block goes from attested to
finalized. Its batch usually reaches a confirmed Ethereum block within
minutes, which Finality, live shows as a milestone, but Leani
reports no level for it.
Built by Smart-Byte · Legal notice (Impressum) · Privacy