[#kernel-Notifications-blockTip]
= xref:kernel.adoc[kernel]::xref:kernel/Notifications.adoc[Notifications]::blockTip
:relfileprefix: ../../
:mrdocs:

Notifies that the active chain tip has advanced to a new block.

== Synopsis

Declared in `<kernel/notifications_interface.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[nodiscard]]
virtual
xref:kernel/InterruptResult.adoc[InterruptResult]
blockTip(
    xref:SynchronizationState.adoc[SynchronizationState] state,
    xref:CBlockIndex.adoc[CBlockIndex] const& index,
    double verification_progress);
----

== Return Value

An interrupt result requesting that the operation stop, or empty to continue.

[NOTE]
====
The return value https://en.cppreference.com/cpp/language/attributes/nodiscard[should not be discarded^].
====
== Parameters

[cols="1,4"]
|===
| Name| Description
| *state*
| Current synchronization state of the node.
| *index*
| Block index of the new chain tip.
| *verification_progress*
| Estimated verification progress, from 0 to 1.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#