A struct for holding the kernel notification callbacks. The user data pointer may be used to point to user‐defined structures to make processing the notifications easier.

Synopsis

Declared in <kernel/bitcoinkernel.h>

struct btck_NotificationInterfaceCallbacks;

Description

If user_data_destroy is provided, the kernel will automatically call this callback to clean up user_data when the notification interface object is destroyed. If user_data_destroy is NULL, it is the user's responsibility to ensure that the user_data outlives the kernel objects. Notifications can occur even as kernel objects are deleted, so care has to be taken to ensure safe unwinding.

Data Members

Name

Description

block_tip

The chain's tip was updated to the provided block entry.

fatal_error

An unrecoverable system error encountered by the library.

flush_error

An error encountered when flushing data to disk.

header_tip

A new best block header was added.

progress

Reports on current block synchronization progress.

user_data

Holds a user‐defined opaque structure that is passed to the notification callbacks. If user_data_destroy is also defined ownership of the user_data is passed to the created context options and subsequently context.

user_data_destroy

Frees the provided user data structure.

warning_set

A warning issued by the kernel library during validation.

warning_unset

A previous condition leading to the issuance of a warning is no longer given.

Created with MrDocs