zecfoundation
/
zebra
mirror of https://github.com/ZcashFoundation/zebra.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update docs for coinbase maturity for NU5 (#2248)

This commit is contained in:
teor 2021-06-04 22:57:41 +10:00 committed by GitHub
parent b18c32f30f
commit 7b33278708
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
zebra-state/src/constants.rs
View File

@ -2,15 +2,27 @@
/// The maturity threshold for transparent coinbase outputs. /// The maturity threshold for transparent coinbase outputs.
/// ///
/// A transaction MUST NOT spend a transparent output of a coinbase transaction /// This threshold uses the relevant chain for the block being verified by the
/// non-finalized state.
///
/// For the best chain, coinbase spends are only allowed from blocks at or below
/// the finalized tip. For other chains, coinbase spends can use outputs from
/// early non-finalized blocks, or finalized blocks. But if that chain becomes
/// the best chain, all non-finalized blocks past the [`MAX_BLOCK_REORG_HEIGHT`]
/// will be finalized. This includes all mature coinbase outputs.
///
/// "A transaction MUST NOT spend a transparent output of a coinbase transaction
/// from a block less than 100 blocks prior to the spend. Note that transparent /// from a block less than 100 blocks prior to the spend. Note that transparent
/// outputs of coinbase transactions include Founders' Reward outputs. /// outputs of coinbase transactions include Founders' Reward outputs and
/// transparent Funding Stream outputs."
/// [7.1](https://zips.z.cash/protocol/nu5.pdf#txnencodingandconsensus)
pub const MIN_TRANSPARENT_COINBASE_MATURITY: u32 = 100; pub const MIN_TRANSPARENT_COINBASE_MATURITY: u32 = 100;
/// The maximum chain reorganisation height. /// The maximum chain reorganisation height.
/// ///
/// Allowing reorganisations past this height could allow double-spends of /// This threshold determines the maximum length of the best non-finalized chain.
/// coinbase transactions. ///
/// Larger reorganisations would allow double-spends of coinbase transactions.
pub const MAX_BLOCK_REORG_HEIGHT: u32 = MIN_TRANSPARENT_COINBASE_MATURITY - 1; pub const MAX_BLOCK_REORG_HEIGHT: u32 = MIN_TRANSPARENT_COINBASE_MATURITY - 1;
/// The database format version, incremented each time the database format changes. /// The database format version, incremented each time the database format changes.