From 9408adace68073a4559b5ca865a30f76b379fdd0 Mon Sep 17 00:00:00 2001 From: qybdyx Date: Tue, 3 Jun 2025 14:49:42 +0800 Subject: [PATCH 1/4] bsc-api-list.md: update fast finality --- .../developers/json_rpc/bsc-api-list.md | 31 +++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-) diff --git a/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md b/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md index eb2668637c..0edca1b46c 100644 --- a/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md +++ b/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md @@ -7,9 +7,36 @@ Finality is a crucial aspect of blockchain security, ensuring that once a block ### Probabilistic Finality and Economic Finality -In probabilistic finality, the deeper a block is buried in the chain, the lower the likelihood of it being reverted. The more blocks follow a particular block, the more likely the chain containing that block will be the longest. **Typically, BSC users should wait for at least 11 or 15 different validators to seal a block. If validators are allowed to produce multiple consecutive blocks, the number of blocks required to achieve probabilistic finality is approximately 11\*n or 15\*n, where "n" is the number of consecutive blocks produced.** +BNB Smart Chain (BSC) implements a dual-layer finality mechanism combining **Economic Finality** and **Probabilistic Finality** to ensure transaction security and network efficiency. -Economic Finality refers to the high cost associated with reverting a block. In proof-of-stake systems that use a slashing mechanism (such as Casper FFG, Tendermint, or BSC Fast Finality), if validators violate the voting rules, part or all of their stake can be forfeited. This economic penalty makes it extremely expensive to undermine finality. Generally, block n achieves economic finality by block n+2, meaning that BSC Fast Finality reduces the confirmation time to two blocks in most cases. This improves the user experience by making transaction confirmation faster and more reliable. +#### Economic Finality (Fast Finality) + +The **Fast Finality** feature, introduced through **BEP-520**, enables Economic Finality using a slashing mechanism similar to Casper FFG and Tendermint. Key characteristics: + +- **Block n achieves economic finality by block n+2** +- Transaction finality time: **~3.75 seconds** (reduced from 7.5 seconds) +- Economic penalties make block reversal extremely expensive +- Validators violating voting rules forfeit part or all of their staked assets + +This significantly improves user experience through faster and more reliable transaction confirmations. + +#### Probabilistic Finality (Fallback Mechanism) + +When Fast Finality is unavailable, BSC falls back to **Probabilistic Finality**. Security increases as more blocks are added - the deeper a block is buried, the lower the probability of reversal. + +**Network Parameters:** +- **TurnLength**: 8 (consecutive blocks per validator) +- **ValidatorSize**: 21 (total active validators) +- **Block Time**: ~1.5 seconds + +**Finality Requirements:** +- **>1/2 validator confirmations**: 88 blocks (11 × 8) ≈ **132 seconds** +- **>2/3 validator confirmations**: 120 blocks (15 × 8) ≈ **180 seconds** + +**Formula**: `Required Blocks = n × TurnLength` +- Where **n** = 11 (majority) or 15 (supermajority consensus) + +This dual-layer approach ensures network security and finality guarantees even when Fast Finality encounters issues. ### Economic Finality API From f5c85e0c6f571ce53bcc2fc0e3d07fcdc64ba6eb Mon Sep 17 00:00:00 2001 From: qybdyx Date: Tue, 3 Jun 2025 16:09:56 +0800 Subject: [PATCH 2/4] bsc-api-list.md: update --- docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md b/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md index 0edca1b46c..8ecc8e7f3b 100644 --- a/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md +++ b/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md @@ -11,12 +11,12 @@ BNB Smart Chain (BSC) implements a dual-layer finality mechanism combining **Eco #### Economic Finality (Fast Finality) -The **Fast Finality** feature, introduced through **BEP-520**, enables Economic Finality using a slashing mechanism similar to Casper FFG and Tendermint. Key characteristics: +The **Fast Finality** feature, introduced through **BEP-126**, enables Economic Finality using a slashing mechanism similar to Casper FFG and Tendermint. Key characteristics: - **Block n achieves economic finality by block n+2** - Transaction finality time: **~3.75 seconds** (reduced from 7.5 seconds) - Economic penalties make block reversal extremely expensive -- Validators violating voting rules forfeit part or all of their staked assets +- Validators violating voting rules forfeit part of their staked assets This significantly improves user experience through faster and more reliable transaction confirmations. From bc71776238b6013818da028ee33d1a0c7f49b527 Mon Sep 17 00:00:00 2001 From: Eric <45141191+zlacfzy@users.noreply.github.com> Date: Tue, 3 Jun 2025 19:44:27 +0800 Subject: [PATCH 3/4] Update docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md Co-authored-by: zzzckck <152148891+zzzckck@users.noreply.github.com> --- docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md b/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md index 8ecc8e7f3b..6ae466eac1 100644 --- a/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md +++ b/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md @@ -14,7 +14,7 @@ BNB Smart Chain (BSC) implements a dual-layer finality mechanism combining **Eco The **Fast Finality** feature, introduced through **BEP-126**, enables Economic Finality using a slashing mechanism similar to Casper FFG and Tendermint. Key characteristics: - **Block n achieves economic finality by block n+2** -- Transaction finality time: **~3.75 seconds** (reduced from 7.5 seconds) +- Transaction finality time: **~3.75 seconds** (with 1.5 seconds block time) - Economic penalties make block reversal extremely expensive - Validators violating voting rules forfeit part of their staked assets From f580a128258693b49a3254a8fc3a15b9203ced82 Mon Sep 17 00:00:00 2001 From: qybdyx Date: Tue, 3 Jun 2025 19:48:49 +0800 Subject: [PATCH 4/4] bsc-api-list.md: fix comments --- docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md b/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md index 6ae466eac1..58f16997f9 100644 --- a/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md +++ b/docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md @@ -11,7 +11,7 @@ BNB Smart Chain (BSC) implements a dual-layer finality mechanism combining **Eco #### Economic Finality (Fast Finality) -The **Fast Finality** feature, introduced through **BEP-126**, enables Economic Finality using a slashing mechanism similar to Casper FFG and Tendermint. Key characteristics: +The **Fast Finality** feature, introduced through **[BEP-126](https://github.com/bnb-chain/BEPs/blob/master/BEPs/BEP126.md)**, enables Economic Finality using a slashing mechanism similar to Casper FFG and Tendermint. Key characteristics: - **Block n achieves economic finality by block n+2** - Transaction finality time: **~3.75 seconds** (with 1.5 seconds block time) @@ -30,8 +30,8 @@ When Fast Finality is unavailable, BSC falls back to **Probabilistic Finality**. - **Block Time**: ~1.5 seconds **Finality Requirements:** -- **>1/2 validator confirmations**: 88 blocks (11 × 8) ≈ **132 seconds** -- **>2/3 validator confirmations**: 120 blocks (15 × 8) ≈ **180 seconds** +- **Majority (>1/2) validator confirmations**: 88 blocks (11 × 8) ≈ **132 seconds** +- **Supermajority (>2/3) validator confirmations**: 120 blocks (15 × 8) ≈ **180 seconds** **Formula**: `Required Blocks = n × TurnLength` - Where **n** = 11 (majority) or 15 (supermajority consensus)