[#kernel-CCoinsStats]
= xref:kernel.adoc[kernel]::CCoinsStats
:relfileprefix: ../
:mrdocs:

Aggregate statistics computed over the UTXO set.

== Synopsis

Declared in `<kernel/coinstats.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
struct CCoinsStats;
----

== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:kernel/CCoinsStats/2constructor-04.adoc[`CCoinsStats`]         [.small]#[constructor]#
| Constructors
|===


== Data Members

[cols="1,4"]
|===
| Name| Description
| xref:kernel/CCoinsStats/coins_count.adoc[`coins_count`] 
| The number of coins contained.
| xref:kernel/CCoinsStats/hashBlock.adoc[`hashBlock`] 
| Hash of the block the statistics were computed at.
| xref:kernel/CCoinsStats/hashSerialized.adoc[`hashSerialized`] 
| Hash of the serialized UTXO set.
| xref:kernel/CCoinsStats/index_used.adoc[`index_used`] 
| Signals if the coinstatsindex was used to retrieve the statistics.
| xref:kernel/CCoinsStats/nBogoSize.adoc[`nBogoSize`] 
| Serialization‐agnostic size measure of the UTXO set.
| xref:kernel/CCoinsStats/nDiskSize.adoc[`nDiskSize`] 
| Size of the UTXO set on disk in bytes.
| xref:kernel/CCoinsStats/nHeight.adoc[`nHeight`] 
| Block height the statistics were computed at.
| xref:kernel/CCoinsStats/nTransactionOutputs.adoc[`nTransactionOutputs`] 
| Number of unspent transaction outputs.
| xref:kernel/CCoinsStats/nTransactions.adoc[`nTransactions`] 
| Number of transactions with unspent outputs.
| xref:kernel/CCoinsStats/total_amount.adoc[`total_amount`] 
| The total amount, or nullopt if an overflow occurred calculating it
| xref:kernel/CCoinsStats/total_coinbase_amount.adoc[`total_coinbase_amount`] 
| Total cumulative amount of coinbase outputs up to and including this block
| xref:kernel/CCoinsStats/total_new_outputs_ex_coinbase_amount.adoc[`total_new_outputs_ex_coinbase_amount`] 
| Total cumulative amount of outputs created up to and including this block
| xref:kernel/CCoinsStats/total_prevout_spent_amount.adoc[`total_prevout_spent_amount`] 
| Total cumulative amount of prevouts spent up to and including this block
| xref:kernel/CCoinsStats/total_subsidy.adoc[`total_subsidy`] 
| Total cumulative amount of block subsidies up to and including this block
| xref:kernel/CCoinsStats/total_unspendables_bip30.adoc[`total_unspendables_bip30`] 
| The two unspendable coinbase outputs total amount caused by BIP30
| xref:kernel/CCoinsStats/total_unspendables_genesis_block.adoc[`total_unspendables_genesis_block`] 
| The unspendable coinbase amount from the genesis block
| xref:kernel/CCoinsStats/total_unspendables_scripts.adoc[`total_unspendables_scripts`] 
| Total cumulative amount of outputs sent to unspendable scripts (OP_RETURN for example) up to and including this block
| xref:kernel/CCoinsStats/total_unspendables_unclaimed_rewards.adoc[`total_unspendables_unclaimed_rewards`] 
| Total cumulative amount of coins lost due to unclaimed miner rewards up to and including this block
|===


== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:kernel/ComputeUTXOStats.adoc[`ComputeUTXOStats`]
| Computes aggregate statistics over the UTXO set.
|===


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