[#CValidationInterface-UpdatedBlockTip]
= xref:CValidationInterface.adoc[CValidationInterface]::UpdatedBlockTip
:relfileprefix: ../
:mrdocs:

Notifies listeners when the block chain tip advances.

== Synopsis

Declared in `<validationinterface.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
void
UpdatedBlockTip(
    xref:CBlockIndex.adoc[CBlockIndex] const* pindexNew,
    xref:CBlockIndex.adoc[CBlockIndex] const* pindexFork,
    bool fInitialDownload);
----

== Description

When multiple blocks are connected at once, UpdatedBlockTip will be called on the final tip but may not be called on every intermediate tip. If the latter behavior is desired, subscribe to BlockConnected() instead.

Called on a background thread. Only called for the active chainstate.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *pindexNew*
| The new chain tip.
| *pindexFork*
| The last common block between the old and new tip, or nullptr.
| *fInitialDownload*
| Whether the node is still in initial block download.
|===


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