Class

BlockTreeEntry

An entry in the block tree (block index) — a block the kernel has validated, whether on the active chain or on a side chain.

final class BlockTreeEntry

Mentioned In

Embedding BitcoinKernel on iOS without an xcframework

Overview

Obtained from bestEntry, blockTreeEntry(byHash:), or entry(atHeight:). Exposes height, hash, header, and walkable parent pointer (previous). Use contains(_:) to test whether an entry is on the active chain.

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. For storing entry data past the manager’s lifetime, promote to BlockTreeEntrySnapshot.

Topics

Instance Properties

var blockHash: BlockHash
The block’s hash as an owned BlockHash. Safe to store past this entry’s lifetime (the hash copy outlives it; the entry does not).
var blockHeader: BlockHeader
The 80-byte BlockHeader as an owned copy. Safe to store past this entry’s lifetime.
var height: Int32
The block’s height above genesis (0 for genesis).
var previous: BlockTreeEntry?
The parent block’s entry in the block tree, or nil for the genesis block.

Instance Methods

func equals(BlockTreeEntry) -> Bool
Whether two entries reference the same block.