You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/bnb-smart-chain/developers/json_rpc/bsc-api-list.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -93,6 +93,8 @@ These methods allow you to handle block finality using a straightforward API.
93
93
-`-1` represents at least `len(currentValidators) * 1/2`
94
94
-`-2` represents at least `len(currentValidators) * 2/3`
95
95
-`-3` represents at least `len(currentValidators)`
96
+
* Using `-1`, `-2`, or `-3` provides a convenient way to select the desired security level according to your application and the corresponding waiting time. When one of these values is used as the parameter, the returned block is increasingly less likely to be reverted. **Historically, blocks returned by `eth_getFinalizedHeader` with `-1`, `-2`, or `-3` on BSC have never been reverted.**
97
+
* If the highest security level is required, you can choose `-3`.
96
98
* This function calculates `probabilisticFinalizedHeight` as the highest height of the block verified by `verifiedValidatorNum` validators and then returns the block header with a height equal to `max(fastFinalizedHeight, probabilisticFinalizedHeight)`.
97
99
* The height of the returned block header is guaranteed to increase monotonically.
-`-1` represents at least `len(currentValidators) * 1/2`
106
108
-`-2` represents at least `len(currentValidators) * 2/3`
107
109
-`-3` represents at least `len(currentValidators)`
110
+
* Using `-1`, `-2`, or `-3` provides a convenient way to select the desired security level according to your application and the corresponding waiting time. When one of these values is used as the parameter, the returned block is increasingly less likely to be reverted. **Historically, blocks returned by `eth_getFinalizedHeader` with `-1`, `-2`, or `-3` on BSC have never been reverted.**
111
+
* If the highest security level is required, you can choose `-3`.
108
112
* This function calculates `probabilisticFinalizedHeight` as the highest height of the block verified by `verifiedValidatorNum` validators and then returns the block header with a height equal to `max(fastFinalizedHeight, probabilisticFinalizedHeight)`.
109
113
* If `fullTx` is true, the block includes all transactions; otherwise, only transaction hashes are included.
110
114
* The height of the returned block is guaranteed to be monotonically increasing.
0 commit comments