[#node-SubmitBlock]
= xref:node.adoc[node]::SubmitBlock
:relfileprefix: ../
:mrdocs:

Submit a block and capture the validation state via the BlockChecked callback. Returns whether the block was accepted as a new valid block.

== Synopsis

Declared in `<node/miner.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
bool
SubmitBlock(
    xref:ChainstateManager.adoc[ChainstateManager]& chainman,
    std::shared_ptr<CBlock const> const& block,
    std::string& reason,
    std::string& debug);
----

== Return Value

True if the block was accepted as a new valid block.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *chainman*
| The chainstate manager to submit the block to.
| *block*
| The block to submit.
| *reason*
| Output set to a short rejection reason on failure.
| *debug*
| Output set to a detailed rejection message on failure.
|===


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