Skip to content

Commit bc9fa66

Browse files
authored
docs: Several more suggestions (#3751)
1 parent 0c960a5 commit bc9fa66

File tree

1 file changed

+29
-29
lines changed

1 file changed

+29
-29
lines changed

doc/release-notes.md

+29-29
Original file line numberDiff line numberDiff line change
@@ -39,15 +39,15 @@ Downgrade warning
3939

4040
### Downgrade to a version < 0.14.0.3
4141

42-
Downgrading to a version smaller than 0.14.0.3 is not supported anymore due to
42+
Downgrading to a version older than 0.14.0.3 is no longer supported due to
4343
changes in the "evodb" database format. If you need to use an older version,
44-
you have to perform a reindex or re-sync the whole chain.
44+
you must either reindex or re-sync the whole chain.
4545

4646
### Downgrade of masternodes to < 0.16
4747

48-
Starting with this release, masternodes will verify protocol versions of other
49-
masternodes. This will cause PoSe punishment/banning of out of date masternodes,
50-
so it is not recommended to downgrade masternodes.
48+
Starting with this release, masternodes will verify the protocol version of other
49+
masternodes. This will result in PoSe punishment/banning for outdated masternodes,
50+
so downgrading is not recommended.
5151

5252
Notable changes
5353
===============
@@ -60,12 +60,12 @@ formation of masternodes and was voted in by the network. The resulting allocati
6060
will split all non-proposal block rewards 40% toward miners and 60% toward
6161
masternodes in the end-state once the transition period is complete.
6262

63-
The reallocation will take place gradually over 4.5 years with a total of 18
64-
reallocation periods between the start and end-state to avoid market volatility
65-
and transition toward the new allocation with minimal network disruption.
63+
The reallocation will take place over 4.5 years with a total of 18 reallocation
64+
periods between the start and end state. The transition is being made gradually
65+
to avoid market volatility and minimize network disruption.
6666

6767
Note that this is a hardfork which must be activated by miners. To do this they
68-
should start creating blocks signalling bit 5 in `version` field of the block header.
68+
should start creating blocks signalling bit 5 in the `version` field of the block header.
6969

7070
### Reallocation periods
7171

@@ -100,36 +100,36 @@ Dynamic Activation Thresholds
100100
-----------------------------
101101
In Dash we have used lower thresholds (80% vs 95% in BTC) to activate upgrades
102102
via a BIP9-like mechanism for quite some time. While it's preferable to have as much
103-
of the network hashrate to signal update readiness as possible, this can result in
103+
of the network hashrate signal update readiness as possible, this can result in
104104
quite lengthy upgrades if one large non-upgraded entity stalls
105105
all progress. Simply lowering thresholds even further can result in network
106-
upgrades being too fast which can potentially cause some chaos. This version
106+
upgrades occurring too quickly and potentially introducing network instability. This version
107107
implements BIP9-like dynamic activation thresholds which drop from some initial
108108
level to a minimally acceptable one over time at an increasing rate. This provides
109109
a safe non-blocking way of activating proposals.
110110

111-
This mechanism applies to the Block Reward Reallocation proposal mentioned above
112-
for which the threshold will begin at an 80% level and decay down to 60% over the
113-
course of 10 periods.
111+
This mechanism applies to the Block Reward Reallocation proposal mentioned above.
112+
Its initial threshold is 80% and it will decrease to a minimum of 60% over the
113+
course of 10 periods. Each period is 4032 blocks (approximately one week).
114114

115115
Concentrated Recovery
116116
---------------------
117117
In the current system, signature shares are propagated to all LLMQ members
118-
until one of them has collected enough shares to recover the signature. Until
119-
this recovered signature is propagated in the LLMQ, all members will keep
120-
propagating shares and verifying each one. This causes significant load on the
121-
LLMQ, resulting in decreased throughput, which will be avoided with the new system.
118+
until one of them has collected enough shares to recover the signature. All
119+
members keep propagating and verifying each share until this recovered signature
120+
is propagated in the LLMQ. This causes significant load on the LLMQ and results
121+
in decreased throughput.
122122

123123
This new system initially sends all shares to a single deterministically selected node,
124124
so that this node can recover the signature and propagate the recovered signature.
125125
This way only the recovered signature needs to be propagated and verified by all
126-
members. Each member, after sending their share to this node, waits for some
126+
members. After sending their share to this node, each member waits for a
127127
timeout and then sends their share to another deterministically selected member.
128128
This process is repeated until a recovered signature is finally created and propagated.
129129

130130
This timeout begins at two seconds and increases exponentially up to ten seconds
131-
(ie. `2,4,8,10,10`) for each node that times out. This is in order to minimize the time
132-
taken to generate a signature in the case that the recovery node is down, while also
131+
(i.e. `2,4,8,10,10`) for each node that times out. This is to minimize the time
132+
taken to generate a signature if the recovery node is down, while also
133133
minimizing the traffic generated when the network is under stress.
134134

135135
The new system is activated with the newly added `SPORK_21_QUORUM_ALL_CONNECTED`
@@ -138,14 +138,14 @@ Recovery for every LLMQ and `1` excludes `400_60` and `400_85` quorums.
138138

139139
Increased number of masternode connections
140140
------------------------------------------
141-
To implement "Concentrated Recovery", it is now required that all members of a LLMQ
142-
connect to all other members of the same LLMQ. This significantly increases general
143-
connection count for masternodes. These intra-quorum connections are less resource
144-
demanding than normal p2p connections as they only exchange LLMQ/masternode related
145-
messages, but the hardware and network requirements will still be higher than before.
146-
147-
This change will at first only be activated for the smaller LLMQs (50 members) and
148-
then may later be activated for larger quorums (400 members).
141+
To implement "Concentrated Recovery", it is now necessary for all members of a LLMQ
142+
to connect to all other members of the same LLMQ. This significantly increases the general
143+
connection count for masternodes. Although these intra-quorum connections are less resource
144+
intensive than normal p2p connections (as they only exchange LLMQ/masternode related
145+
messages), masternode hardware and network requirements will still be higher than before.
146+
147+
Initially this change will only be activated for the smaller LLMQs (50 members).
148+
Eventually it may be activated for larger quorums (400 members).
149149

150150
This is also controlled via `SPORK_21_QUORUM_ALL_CONNECTED`.
151151

0 commit comments

Comments
 (0)