From b1e5fb0df743f666c070559ce9f7144244984a7c Mon Sep 17 00:00:00 2001 From: Roland Tyler Date: Tue, 5 Jul 2022 12:15:15 -0400 Subject: [PATCH] Clarify BFT validator requirements --- .../configure/consensus-protocols/ibft.md | 4 ++-- .../configure/consensus-protocols/qbft.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/configure-and-manage/configure/consensus-protocols/ibft.md b/docs/configure-and-manage/configure/consensus-protocols/ibft.md index 2c38c13c..a7a73e5d 100644 --- a/docs/configure-and-manage/configure/consensus-protocols/ibft.md +++ b/docs/configure-and-manage/configure/consensus-protocols/ibft.md @@ -14,14 +14,14 @@ You can [create a private network using IBFT](../../../tutorials/private-network In IBFT networks, approved accounts known as validators validate transactions and blocks. Validators take turns to create the next block. -Before inserting a block onto the chain, a super-majority (greater than 66%) of validators must first sign the block. +Before inserting a block onto the chain, a super-majority (greater than or equal to 2/3) of validators must first sign the block. Existing validators propose and vote to [add or remove validators](#add-and-remove-validators). Adding or removing a validator requires a majority vote (greater than 50%) of validators. !!! important - Configure your network to ensure you never lose 1/3 or more of your validators. + Configure your network to ensure you never lose more than 1/3 of your validators. If more than 1/3 of validators stop participating, new blocks are no longer created, and the network stalls. It may take significant time to recover once nodes are restarted. diff --git a/docs/configure-and-manage/configure/consensus-protocols/qbft.md b/docs/configure-and-manage/configure/consensus-protocols/qbft.md index a91b0bed..2a9050ef 100644 --- a/docs/configure-and-manage/configure/consensus-protocols/qbft.md +++ b/docs/configure-and-manage/configure/consensus-protocols/qbft.md @@ -10,14 +10,14 @@ You can [create a private network using QBFT](../../../tutorials/private-network In QBFT networks, approved accounts known as validators validate transactions and blocks. Validators take turns to create the next block. -Before inserting a block onto the chain, a super-majority (greater than 66%) of validators must first sign the block. +Before inserting a block onto the chain, a super-majority (greater than or equal to 2/3) of validators must first sign the block. Existing validators propose and vote to [add or remove validators](#add-and-remove-validators). Adding or removing a validator requires a majority vote (greater than 50%) of validators. !!! important - Configure your network to ensure you never lose 1/3 or more of your validators. + Configure your network to ensure you never lose more than 1/3 of your validators. If more than 1/3 of validators stop participating, new blocks are no longer created, and the network stalls. It may take significant time to recover once nodes are restarted.