mirrors/bitcoin-bips
1
0
Fork 0
mirror of https://github.com/bitcoin/bips.git synced 2024-11-19 09:50:06 +01:00
Code Issues Projects Releases Wiki Activity

Add start time

Browse Source
This commit is contained in:
Pieter Wuille 2016-03-01 01:06:16 +01:00
parent 2b27bb5d27
commit 226bd097a9
1 changed files with 16 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
bip-0009.mediawiki
View File

@ -22,11 +22,12 @@ In addition, BIP 34 made the integer comparison (nVersion >= 2) a consensus rule
==Specification== ==Specification==
Each soft fork deployment is specified by the following parameters (further elaborated below): Each soft fork deployment is specified by the following per-chain parameters (further elaborated below):
# The '''bit''' determines which bit in the nVersion field of the block is to be used to signal the soft fork lock-in and activation. # The '''bit''' determines which bit in the nVersion field of the block is to be used to signal the soft fork lock-in and activation.
# The '''threshold''' specifies how many blocks within a single retarget period (2016 blocks) must have the bit set before we lock in the deployment. # The '''threshold''' specifies how many blocks within a single retarget period (2016 blocks) must have the bit set before we lock in the deployment.
# The '''timeout''' specifies a time at which the deployment is considered failed. If the median time of a block >= timeout and the soft fork has not yet locked in (including this block's bit state), the deployment is considered failed on all descendants of the block. # The '''starttime''' specifies a minimum median time past of a block at which the bit gains its meaning.
# The '''timeout''' specifies a time at which the deployment is considered failed. If the median time past of a block >= timeout and the soft fork has not yet locked in (including this block's bit state), the deployment is considered failed on all descendants of the block.
===Mechanism=== ===Mechanism===
@ -38,7 +39,7 @@ The highest 3 bits are set to 001, so the range of actually possible nVersion va
'''States''' '''States'''
With every softfork proposal we associate a state BState, which begins With every softfork proposal we associate a state BState, which begins
at ''defined'', and can be ''locked-in'', ''activated'', at ''defined'', and can be ''started'', ''locked-in'', ''activated'',
or ''failed''. Transitions are considered after each or ''failed''. Transitions are considered after each
retarget period. retarget period.
@ -46,10 +47,19 @@ retarget period.
Software which supports the change should begin by setting B in all blocks Software which supports the change should begin by setting B in all blocks
mined until it is resolved. mined until it is resolved.
if (BState != activated && BState != failed) { if (BState == started || BState == locked-in) {
SetBInBlock(); SetBInBlock();
} }
'''Start time'''
If a block's median time past is at least the starttime, and it is consider ''started''.
if (NextBlockHeight % 2016 == 0) {
if (BState == defined && GetMedianTimePast(nextblock) >= starttime) {
BState = started;
}
}
'''Success: Lock-in Threshold''' '''Success: Lock-in Threshold'''
If bit B is set in 1916 (1512 on testnet) or If bit B is set in 1916 (1512 on testnet) or
more of the 2016 blocks within a retarget period, it is considered more of the 2016 blocks within a retarget period, it is considered
@ -57,7 +67,7 @@ more of the 2016 blocks within a retarget period, it is considered
visible. visible.
if (NextBlockHeight % 2016 == 0) { if (NextBlockHeight % 2016 == 0) {
if (BState == defined && Previous2016BlocksCountB() >= 1916) { if (BState == started && Previous2016BlocksCountB() >= threshold) {
BState = locked-in; BState = locked-in;
BActiveHeight = NextBlockHeight + 2016; BActiveHeight = NextBlockHeight + 2016;
} }
@ -132,7 +142,7 @@ GetMedianTimePast() of a block following a retarget period is at or
past this timeout, miners should cease setting this bit. past this timeout, miners should cease setting this bit.
if (NextBlockHeight % 2016 == 0) { if (NextBlockHeight % 2016 == 0) {
if (BState == defined && GetMedianTimePast(nextblock) >= BFinalYear) { if (BState == started && GetMedianTimePast(nextblock) >= BFinalYear) {
BState = failed; BState = failed;
} }
} }