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.
Declared in <kernel/bitcoinkernel.h>
struct btck_NotificationInterfaceCallbacks;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.
| 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. |