Class

Chain

A view of the active blockchain — the unbroken sequence of blocks from genesis to the chainstate’s current tip.

final class Chain

Overview

Obtained via activeChain. Exposes height-indexed lookups (entry(atHeight:)) and active-chain membership testing (contains(_:)) — useful for distinguishing a block that’s on the current chain from one on a side chain, after a reorg.

A view type: its lifetime is tied to the ChainstateManager that produced it. Retains the manager to keep the C pointer valid; deinit performs no kernel destruction.

Topics

Instance Properties

var height: Int32
The height of the tip of the active chain (0 = genesis).

Instance Methods

func contains(BlockTreeEntry) -> Bool
Whether the active chain contains the given block tree entry — distinguishes blocks on the main chain from blocks on side chains.
func entry(atHeight: Int32) -> BlockTreeEntry?
Retrieves a block tree entry by its height on the active chain.