From 226bd097a9d5e03a9cdb1b3b00c79cd017c8983a Mon Sep 17 00:00:00 2001
From: Pieter Wuille <pieter.wuille@gmail.com>
Date: Tue, 1 Mar 2016 01:06:16 +0100
Subject: Add start time

---
 bip-0009.mediawiki | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

(limited to 'bip-0009.mediawiki')

diff --git a/bip-0009.mediawiki b/bip-0009.mediawiki
index ff91ffd..052c9da 100644
--- a/bip-0009.mediawiki
+++ b/bip-0009.mediawiki
@@ -22,11 +22,12 @@ In addition, BIP 34 made the integer comparison (nVersion >= 2) a consensus rule
 
 ==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 '''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===
 
@@ -38,7 +39,7 @@ The highest 3 bits are set to 001, so the range of actually possible nVersion va
 
 '''States'''
 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
 retarget period.
 
@@ -46,10 +47,19 @@ retarget period.
 Software which supports the change should begin by setting B in all blocks
 mined until it is resolved.
 
-    if (BState != activated && BState != failed) {
+    if (BState == started || BState == locked-in) {
         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'''
 If bit B is set in 1916 (1512 on testnet) or
 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.
 
     if (NextBlockHeight % 2016 == 0) {
-        if (BState == defined && Previous2016BlocksCountB() >= 1916) {
+        if (BState == started && Previous2016BlocksCountB() >= threshold) {
             BState = locked-in;
             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.
 
     if (NextBlockHeight % 2016 == 0) {
-        if (BState == defined && GetMedianTimePast(nextblock) >= BFinalYear) {
+        if (BState == started && GetMedianTimePast(nextblock) >= BFinalYear) {
              BState = failed;
         }
     }
-- 
cgit v1.2.3