[#ChainstateManager-BlocksAheadOfTip]
= xref:ChainstateManager.adoc[ChainstateManager]::BlocksAheadOfTip
:relfileprefix: ../
:mrdocs:

Returns how many blocks the best header is ahead of the current tip, or nullopt if the best header does not extend the tip.

== Synopsis

Declared in `<validation.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[locks_excluded(0x7f9513c48718), locks_excluded(0x7f9502de9eb8), locks_excluded(0x7f950b21c688), locks_excluded(0x7f9514bf6678)]]
std::optional<int>
BlocksAheadOfTip() const;
----

== Return Value

The number of blocks the best header is ahead of the tip, or std::nullopt.


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