[#BlockValidationState]
= BlockValidationState
:mrdocs:

Validation state specialized for block‐level results.

== Synopsis

Declared in `<consensus/validation.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class BlockValidationState
    : public xref:ValidationState-04.adoc[ValidationState<BlockValidationResult>]
----

== Base Classes

[cols="1,4"]
|===
| Name| Description
| `xref:ValidationState-04.adoc[ValidationState<BlockValidationResult>]`
| Template for capturing information about block/transaction validation. This is instantiated by TxValidationState and BlockValidationState for validation information on transactions and blocks respectively.
|===

== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BlockValidationState/Error.adoc[`Error`] 
| Puts the state into the run‐time error mode.
| xref:BlockValidationState/GetDebugMessage.adoc[`GetDebugMessage`] 
| Returns the human‐readable debug message.
| xref:BlockValidationState/GetRejectReason.adoc[`GetRejectReason`] 
| Returns the short rejection reason.
| xref:BlockValidationState/GetResult.adoc[`GetResult`] 
| Returns the recorded result code.
| xref:BlockValidationState/Invalid.adoc[`Invalid`] 
| Marks the state invalid and records the reason and debug message.
| xref:BlockValidationState/IsError.adoc[`IsError`] 
| Returns true if the state was marked with a run‐time error.
| xref:BlockValidationState/IsInvalid.adoc[`IsInvalid`] 
| Returns true if the state was marked invalid by a consensus or policy rule.
| xref:BlockValidationState/IsValid.adoc[`IsValid`] 
| Returns true if no validation failure has been recorded.
| xref:BlockValidationState/ToString.adoc[`ToString`] 
| Formats the state as a human‐readable string.
|===


== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:TestBlockValidity.adoc[`TestBlockValidity`]
| Verify a block, including transactions.
|===


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