From 50f7ed7b098d0fa9415a66ee0cd846ac55c066f7 Mon Sep 17 00:00:00 2001 From: qybdyx Date: Wed, 4 Jun 2025 10:22:01 +0800 Subject: [PATCH 1/3] bsc-api-list.md: update verifiedValidatorNum doc --- .../developers/json_rpc/bsc-api-list.md | 27 ++++++++++--------- 1 file changed, 14 insertions(+), 13 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 58f16997f9..50cf411d14 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,13 +7,13 @@ Finality is a crucial aspect of blockchain security, ensuring that once a block ### Probabilistic Finality and Economic Finality -BNB Smart Chain (BSC) implements a dual-layer finality mechanism combining **Economic Finality** and **Probabilistic Finality** to ensure transaction security and network efficiency. +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 (Fast Finality) -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: +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** +- Block n achieves economic finality by block n+2 - 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 @@ -22,19 +22,20 @@ This significantly improves user experience through faster and more reliable tra #### 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. +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 +##### Network Parameters +- TurnLength: 8 (consecutive blocks per validator) +- ValidatorSize: 21 (total active validators) +- Block Time: ~1.5 seconds -**Finality Requirements:** -- **Majority (>1/2) validator confirmations**: 88 blocks (11 × 8) ≈ **132 seconds** -- **Supermajority (>2/3) validator confirmations**: 120 blocks (15 × 8) ≈ **180 seconds** +##### Finality Requirements +- 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) +##### Formula +`Required Blocks = n × TurnLength` +- Where n = 11 (majority) or 15 (supermajority) This dual-layer approach ensures network security and finality guarantees even when Fast Finality encounters issues. From b234a4fc35ed769ccb1d4747782457dfb4ecd3e8 Mon Sep 17 00:00:00 2001 From: qybdyx Date: Wed, 4 Jun 2025 10:38:14 +0800 Subject: [PATCH 2/3] bsc-api-list.md: update ff doc --- docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md | 6 ++++-- 1 file changed, 4 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 50cf411d14..97f5542b1f 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 @@ -24,12 +24,14 @@ This significantly improves user experience through faster and more reliable tra 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 +Network Parameters: + - TurnLength: 8 (consecutive blocks per validator) - ValidatorSize: 21 (total active validators) - Block Time: ~1.5 seconds -##### Finality Requirements +Finality Requirements: + - Majority (>1/2) validator confirmations: 88 blocks (11 × 8) ≈ 132 seconds - Supermajority (>2/3) validator confirmations: 120 blocks (15 × 8) ≈ 180 seconds From 707eb332e3121db4f950419d4e3e9a6fec4cb41c Mon Sep 17 00:00:00 2001 From: qybdyx Date: Wed, 4 Jun 2025 10:44:28 +0800 Subject: [PATCH 3/3] bsc-api-list.md: update ff doc --- docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md | 4 ---- 1 file changed, 4 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 97f5542b1f..49767d1a73 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 @@ -35,10 +35,6 @@ Finality Requirements: - 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) - This dual-layer approach ensures network security and finality guarantees even when Fast Finality encounters issues. ### Economic Finality API