NotificationCallbacks

Swift-friendly wrapper for kernel notification callbacks.

final class NotificationCallbacks

Overview

Populate the closure properties you care about, then pass to setNotifications(_:). The kernel takes ownership of the callback state and releases it when the context is destroyed.

All callbacks are dispatched on kernel-internal threads.

Topics

Initializers

init(blockTip: ((SynchronizationState, BlockTreeEntrySnapshot, Double) -> Void)?, headerTip: ((SynchronizationState, Int64, Int64, Bool) -> Void)?, progress: ((String, Int32, Bool) -> Void)?, warningSet: ((Warning, String) -> Void)?, warningUnset: ((Warning) -> Void)?, flushError: ((String) -> Void)?, fatalError: ((String) -> Void)?)
Creates notification callbacks.

Instance Properties

let blockTip: ((SynchronizationState, BlockTreeEntrySnapshot, Double) -> Void)?
Called when the chain’s tip is updated.
let fatalError: ((String) -> Void)?
An unrecoverable system error encountered by the library.
let flushError: ((String) -> Void)?
An error encountered when flushing data to disk.
let headerTip: ((SynchronizationState, Int64, Int64, Bool) -> Void)?
Called when a new best block header is added.
let progress: ((String, Int32, Bool) -> Void)?
Reports on current block synchronization progress.
let warningSet: ((Warning, String) -> Void)?
A warning issued during validation.
let warningUnset: ((Warning) -> Void)?
A previous warning condition is no longer active.