[#NextEmptyBlockIndex]
= NextEmptyBlockIndex
:mrdocs:

Return an empty block index on top of the tip, with height, time and nBits set

== Synopsis

Declared in `<rpc/server_util.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
NextEmptyBlockIndex(
    xref:CBlockIndex.adoc[CBlockIndex]& tip,
    xref:Consensus/Params.adoc[Consensus::Params] const& consensusParams,
    xref:CBlockIndex.adoc[CBlockIndex]& next_index);
----

== Return Value

an empty block index on top of the tip, with height, time and nBits set

== Parameters

[cols="1,4"]
|===
| Name| Description
| *tip*
| The current chain tip to build on top of.
| *consensusParams*
| Consensus parameters used to set the new block's fields.
| *next_index*
| Output block index initialized to sit on top of `tip.`
|===


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