Releases: bnb-chain/bsc
v1.3.1-beta
We will use version control suffix like: "-alpha", "-beta" to show the status of the release.
For this release: v1.3.1-beta, it means this release is basically fine but validators or node operators would better use it cautiously.
Description
Release v1.3.1-beta is another maintenance release, it mainly has these changes:
- 1.Support PBSS
- 2.Performance Improvement, it reduced the validation cost dramatically.
- 3.Dependency upgrade, especially upgrade Golang from v1.19 to v1.20 and several other dependencies.
About PBSS
PBSS stands for: Path-Based-Storage-Scheme, which is used to optimize the MPT trie tree access, to improve its efficiency and also brings the inline state prune. You could refer this post on how it works: Geth Path-Based Storage Model and Newly Inline State Prune
Currently, PBSS is disabled by default, use this new flag to enable it: --state.scheme path
Important
Before use PBSS, you need to make sure your MPT storage in levelDB are already in PBSS format. There are 2 options to get the PBSS storage:
- 1.Full sync from genesis with the flag:
--state.scheme path. // Not recommend, could take 3 months to catch up the latest block. - 2.Use the converting tool, refer: #1882. // Recommend, could take ~3 days to complete the MPT convert from HashBased to PBSS.
Another thing worth to note is that in the high-pressure situation of the BSC validator scenario, the nodebuffer disk writing of PBSS will become a performance bottleneck. We have optimized this and made the disk writing operation become asynchronous in the background by using asynnodebuffer.
Compatibility
PBSS will have a new MPT storage scheme, although it is still based the Key/Value database, like LevelDB. HashBased storage could not use PBSS and vice versa.
Changelog
FEATURE
- #1881 feat: active pbss
- #1882 cmd/geth: add hbss to pbss convert tool
- #1916 feat: cherry-pick pbss patch commits from eth repo in v1.13.2
- #1939 dependency: go version to 1.20 and some dependencies in go.mod
- #1955 eth, trie/triedb/pathdb: pbss patches
- #1962 cherry pick pbss patches from go-ethereum
BUGFIX
- #1923 consensus/parlia: fix nextForkHash in Extra filed of block header
- #1950 fix: 2 APIs of get receipt related
- #1951 txpool: fix a potential crash issue in shutdown;
- #1963 fix: revert trie commited flag after delete statedb mpt cache
IMPROVEMENT
- #1948 performance: commitTire concurrently
- #1949 code: remove accountTrieCache and storageTrieCache
- #1954 trie: keep trie prefetch during validation phase
Assets
| Assets | Sha256 Checksum |
|---|---|
| mainnet.zip | a7e17cbd8533a5735bca57a03fd7519687a6de6f7484e99bcbf1d50721200716 |
| testnet.zip | b26fe88ccb52f540a95cbf749503130f6dd38eb8d361b7ef87aaf9ee2d473ed9 |
| geth_linux | e946aba5a84351081c4c1bff25e374a5b17c89f1437383b0fe989f0498ba1c77 |
| geth_mac | 3b3f020716f9b2b2a1967a9e5f4a181ce79c2c5d7bebee08dcd0b0513d144de8 |
| geth_windows | 03ccd2728a1810e6e4fb1a4237d507ba622337b65d16414a1b4c504f328a9cf9 |
| geth_linux_arm64 | 72f69b0e6b79cd5ca97d7b791dd985b2ee4f5db13b359360070649cfda998344 |
v1.2.13
Release v1.2.13 is a maintenance release.
It is based on v1.2.12 with only 2 PRs: one is for performance enhancement, the other one is to fix 2 RPC APIs.
It does not contain the large code changes of v1.3.0, so it could be more reliable.
v1.2.13 has great performance improvement to calculate the root hash of some big contracts. Validator and full node operators are suggested to upgrade to this version.
Changelog
IMPROVEMENT
- #1954 performance: keep trie prefetch during validation phase
BUGFIX
Assets
| Assets | Sha256 Checksum |
|---|---|
| mainnet.zip | a7e17cbd8533a5735bca57a03fd7519687a6de6f7484e99bcbf1d50721200716 |
| testnet.zip | b26fe88ccb52f540a95cbf749503130f6dd38eb8d361b7ef87aaf9ee2d473ed9 |
| geth_linux | 25d8dc6a863409446f1183af18b337859976d6578f98354e3b81c2027fcd2b4d |
| geth_mac | 311563a18be604187f94b993b3a6d7074eb4f9255739861148492fa494a8dd26 |
| geth_windows | d5a8fd49087701103d48a837dd23aea1d5d9e586788b9402c325bec20899053b |
| geth_linux_arm64 | 53c0c3e883b84619e9a87666587e023bbc0a8981c67c50e0e9ffd07bcb2d1b36 |
v1.3.0
Attention
Do not use this version on critical business!!!
This is a maintenance release with huge code changes for upstream catch up.
Although many tests have been done before release, there could still have many potential bugs and need more time to verify its reliability.
It's better to use this version cautiously and it is not recommended to use it on critical business. User can help try it out on some none critical environment and would be appreciated to report issues that you found.
We have already found some performance decline in this release and we will improve it in the following releases.
Usage Changes
** OptionUltraLightFraction & Noverify are no longer supported and should be removed from config.toml
** Options of [Eth.Ethash] are no longer supported and should be removed from config.toml
** Validators need to specify the etherbase address by add this argument on node start up: --miner.etherbase <your coinbase addr>
Changelog
RPC
- internal/ethapi: add debug_getRawReceipts RPC method (#24773)
- node, rpc: add ReadHeaderTimeout config option (#25338)
- rpc: check that "version" is "2.0" in request objects (#25570)
- rpc: support injecting HTTP headers through context (#26023)
- rpc: websocket should respect the "HTTP_PROXY" by default (#27264)
- rpc: change BlockNumber constant values to match ethclient (#27219)
- eth: make debug_StorageRangeAt take a block hash or number (#27328)
- eth,core: add api debug_getTrieFlushInterval (#27303)
- rpc: add limit for batch request items and response size (#26681)
- core/types: support yParity field in JSON transactions (#27744)
- eth/filters: send rpctransactions in pending-subscription (#26126)
Flag
- cmd/geth: rename --whitelist to --eth.requiredblocks (#24505)
- cmd: migrate to urfave/cli/v2 (#24751)
- cmd/utils: print warning when --metrics.port set without --metrics.ad…
- cmd/devp2p: add --extaddr flag (#26312)
- core,eth: adddebug_setTrieFlushInterval to change trie flush frequ
- miner, cmd, eth: require explicit etherbase address (#26413)
- cmd/geth: Add[--log.format] cli param (#27001)
- cmd/geth: rename --vmodule to --log.vmodule (#27071)
- params, trie: add verkle fork management + upgrade go-verkle (#27464)
GraphQL
- graphql: fee history fields (#24452)
- graphql: add rawReceipt field to transaction type (#24738)
- graphql: add raw fields to block and tx (#24816)
- graphql: return correct logs for tx (#25612)
- graphql: add query timeout (#26116)
- graphql, node, rpc: improve HTTP write timeout handling (#25457)
- graphql: implement withdrawals (EIP-4895) (#27072)
Client
- ethclient: add CallContractAtHash (#24355)
- ethclient: add PeerCount method (#24849)
- ethereum, ethclient: add FeeHistory support (#25403)
- eth/filters, ethclient/gethclient: add fullTx option to pending tx fi…
- ethclient: include withdrawals in ethclient block responses (#26778)
Tracer
- eth/tracers/js: drop duktape engine (#24934)
- eth/tracers: add support for block overrides in debug_traceCall (#24871)
- eth/tracers: add onlyTopCall option to callTracer (#25430)
- eth/tracers: remove revertReasonTracer, add revert reason to callTracer
- eth/tracers: add diffMode to prestateTracer (#25422)
- eth/tracers: add multiplexing tracer (#26086)
- core/vm: set tracer-observable value of a delegatecall to match parent
value - eth/tracers: add native flatCallTracer (aka parity style tracer) (#26…
- eth/tracers/native: set created address to nil in case of failure (#2…
- eth/tracers: report correct gasLimit in call tracers (#27029)
- eth/tracers: addtxHashfield on txTraceResult (#27183)
- eth/tracers: add ReturnData in the tracer's response (#27704)
Command
- cmd/geth: inspect snapshot dangling storage (#24643)
- core/state/snapshot: detect and clean up dangling storage snapshot in generation
- internal/ethapi: add db operations to api (#24739)
- cmd/geth: adddb check-state-contentto verify integrity of trie nodes (#24840)
- ethdb/remotedb, cmd: add support for remote (readonly) databases
- cmd/abigen: accept combined-json via stdin (#24960)
- cmd/geth: extend traverseRawState command (#24954)
- cmd/geth, core/state/snapshot: rework journal loading, implement account-check (#24765)
- cmd/geth: add a verkle subcommand (#25718)
- cmd/geth, cmd/utils: geth attach with custom headers (#25829)
- core/rawdb: refactor db inspector for extending multiple ancient storage
- cmd/clef: addlist-accountsandlist-walletsto CLI (#26080)
- [cmd/clef: add importraw feature to clef (#26058)](17744639dafc...
v1.2.12
Description
Release v1.2.12 is a maintenance release for BSC mainnet and testnet.
It mainly support BootNodes on BSC mainnet, it would be easier for user to sync with the BSC network. User no longer need to setup the StaticNodes in config.toml any more, just leave empty and make sure delete the BootstrapNodes field in config.toml, may check the mainnet.zip of this release.
And it also fixed three bugs to make the node more reliable, not critical bugs, pls check the change log for detail.
You may refer this post on how to use BootNodes: https://forum.bnbchain.org/t/try-bootnodes-after-bsc-release-v1-2-12/1998
Changelog
FEATURE
- #1852 discov: add hardcoded bootnodes
BUGFIX
- #1844 crypto: Update BLST to v0.3.11
- #1854 fetcher: no import blocks before or equal to the finalized height
- #1855 eth/tracers: trace system tx should add intrinsicGas
IMPROVEMENT
Assets
| Assets | Sha256 Checksum |
|---|---|
| mainnet.zip | 4fc78d0a1f2e15764ed2ec72ada5cb3d0e0f2d59fdf873fedd8f5057be8198f1 |
| testnet.zip | b26fe88ccb52f540a95cbf749503130f6dd38eb8d361b7ef87aaf9ee2d473ed9 |
| geth_linux | fc51b3c67893effa5236cf707495286257bdfa98a024b166c3c540d3b83bb0c7 |
| geth_mac | 2d6b016ee594a4b6b891821221ed4a117a95276fee50f9963862b6cf2728954f |
| geth_windows | 07f32d1ef3e591273818eb129b4880a3769949dc323b2d43b852b4467e8f149b |
| geth_linux_arm64 | 870daa20e25c088748d6f290fb1244ae4bf0a86d9b22707507bf9f63cfd5e914 |
v1.2.11
This is another maintenance release for BSC mainnet and testnet.
It mainly fixed a sync bug, for peers that are lagging behind too much blocks(>90,000), it may not be able to sync.
And it also provides a new option to disable attestation: --disablevoteattestation on some special cases and the option --disablebscprotocol was abandoned.
Changelog
FEATURE
- #1797 client: add FinalizedHeader/Block to use the fast finality
- #1805 vote: remove DisableBscProtocol and add flag to skip votes assmebling
BUGFIX
- #1829 fix: lagging nodes failed to sync
Assets
| Assets | Sha256 Checksum |
|---|---|
| mainnet.zip | 4fc78d0a1f2e15764ed2ec72ada5cb3d0e0f2d59fdf873fedd8f5057be8198f1 |
| testnet.zip | b26fe88ccb52f540a95cbf749503130f6dd38eb8d361b7ef87aaf9ee2d473ed9 |
| geth_linux | 5829efd0f866ec2726c260f4c840bcfecb9faff36257a0ff62b0f5a50346a75d |
| geth_mac | 3f22170b5e2f3eefcea45f7709c800a291c294bd7e38656aac7254629db83cdb |
| geth_windows | 480b7a3bc48712d34424cef8dddd1a95a0e16793fea762579b7fdb136cef3c53 |
| geth_linux_arm64 | 714a0160dc17963343002eb9dfa8a3ea9b31db63aac534899d88deec3ad9c221 |
v1.2.10
Description
Release v1.2.10 is a maintenance release for BSC mainnet and testnet.
It fixed one bug for bootnode and two bugs for FastFinality feature. And it did some enhancement to FastFinality feature, like less log, attestation check, new RPC API and a tool to decode the BlockHeader.extra.
Validators are encouraged to use this version, other full node operators can skip this version if they have already upgraded to v1.2.9
Changelog
FEATURE
- #1780 log: reduce logs when receiving too much votes from a peer
- #1788 metrics: add txpool config into metrics server
- #1789 rpc: add GetFinalizedHeader/Block to simplify using the fast finality feature
- #1791 finality: add more check to ensure result of assembleVoteAttestation
- #1795 tool: add a tool extradump to parse extra data after luban
BUGFIX
- #1773 discov: do not filter out bootnodes
- #1778 vote: backup validator sync votes from corresponding mining validator
- #1784 fix: exclude same votes when doing malicious voting check
Assets
| Assets | Sha256 Checksum |
|---|---|
| mainnet.zip | 4fc78d0a1f2e15764ed2ec72ada5cb3d0e0f2d59fdf873fedd8f5057be8198f1 |
| testnet.zip | b26fe88ccb52f540a95cbf749503130f6dd38eb8d361b7ef87aaf9ee2d473ed9 |
| geth_linux | 01c226683d0aa6ff1523d159c4c7bc8edfa8b382b97d7cd9909ac82c5581fc3a |
| geth_mac | b5432157db60a2360e1b5453c9c77a516ee484bca005ac02fa0fd4f05780a91f |
| geth_windows | 2f7a011118c394079d1c389b50561c780eb876fafe3d6900d3b4cd4c7234bfdb |
| geth_linux_arm64 | ab3a07fc9153116a26d802c63e411d58adc2b681d50069b854f89dc6b1088465 |
v1.2.9
Attention
Important: For validators, please follow the steps to setup your vote key to enable fast finality: How To Set Up The Vote Key
Description
It is a hard-fork release for BSC mainnet.
It sets up the hard fork height for both Plato and Hertz(Berlin,London).
The two hard forks have been running on Testnet for a while and their hard fork height are close, so we decide to put them within a single release to save the upgrade effort.
For the detail changes of the two hard fork, pls refer: https://forum.bnbchain.org/t/bnb-chain-upgrades-mainnet/936
The validators and full node operators on mainnet should switch their software version to v1.2.9 before Aug-10th-2023.
Plato
The mainnet is expected to have a scheduled hardfork upgrade named Plato at block height 30,720,096. The current block generation speed forecasts this to occur around Aug-10th-2023.
The Plato hardfork includes 1 BEPs:
- BEP-126: Introduce Fast Finality Mechanism, the 2nd part.
Hertz
The mainnet is expected to have 3 scheduled hardfork upgrades named (Hertz, London, Berlin) at same block height 31,302,048. The current block generation speed forecasts this to occur around Aug-30th-2023.
The Hertz hardfork will port some of London&Berlin upgrades from Ethereum to BSC for compatiblity. But due to the difference between the 2 networks, there would inevitably has difference in implementation, especially the difference in EIP-1559, the BaseFee will be zero on BSC, so this hard fork will neither introduce new burn mechanism nor the concept of GasTip. In short words, it only provides the interface, but actually no change to the current BSC Gas mechanism.
Here is the list of Hertz upgrade:
-
Berlin Upgrades Ported:
a.BEP-225: Implement EIP-2565 ModExp Gas Cost
b.BEP-229: Implement EIP-2718 Typed Transaction Envelope
c.BEP-230: Implement EIP-2929 Gas cost increases for state access opcodes
d.BEP-231: Implement EIP-2930: Optional access lists -
London Upgrades Ported:
a.BEP-227: Implement EIP-3198: BASEFEE opcode
b.BEP-226: Implement EIP-1559 with base fee of 0
c.BEP-228: Implement EIP-3541: Prevent deploying contracts starting with 0xEF
d.BEP-212: Implement EIP-3529: Reduction in Refunds
There are many changes with these BEPs, DApp developers & users needs to make sure they clearly understand these changes and the potential impact to their business.
- New transaction types are supported, i.e. AccessList & DynamicFee(1559), by BEP-229, BEP-231, BEP-226
- The gas metering mechanism has been changed, by BEP-225, BEP-230, BEP-212;
- New EVM opcode(BASEFEE) is supported, by BEP-227
- Prevent deploying contracts starting with 0xEF, by BEP-228
Change Log
FEATURE
- #1735 log: added option to rotate logs based on number of hours with a maximum of 24
- #1727 discov: increase bucket size for bootnodes
- #1739 eth/tracers: add multiplexing tracer
- #1775 upgrade: several hardfork block height on mainnet: Plato, Hertz(Berlin, London)
BUGFIX
- #1741 fix: defend ddos voting attack with other mini fix according to audit
IMPROVEMENT
- #1725 log: uncomment some trace log
Assets
| Assets | Sha256 Checksum |
|---|---|
| mainnet.zip | 4fc78d0a1f2e15764ed2ec72ada5cb3d0e0f2d59fdf873fedd8f5057be8198f1 |
| testnet.zip | b26fe88ccb52f540a95cbf749503130f6dd38eb8d361b7ef87aaf9ee2d473ed9 |
| geth_linux | fbbf6e6f0abef96cd2cf230afaef1656929e2ee2b78adc901e0dfbecd254b0fc |
| geth_mac | c8837921878b13efe933cf6033609da82f2bd3796cc613e005a2f50c7c9f1e47 |
| geth_windows | a19a6863b4158f1797a5eef24bc59f5b0cbe4943f7d35530c4b9b4c2bb187aa5 |
| geth_linux_arm64 | 6eda77dc7422b79581d14d65e4647a1913818f919fd94dba9feffd5232f3df25 |
v1.2.8
v1.2.8 is a maintenance release, it mainly fixes a potential deadlock on FastFinality VotePool and provides 2 other features(FastFinality & Web3 API related).
Changelog
FEATURE
- #1626 eth/filters, ethclient/gethclient: add fullTx option to pending tx filter
- #1726 feat: support password flag when handling bls keys
BUGFIX
- #1734 fix: avoid to block the chain when failed to send votes
Assets
| Assets | Sha256 Checksum |
|---|---|
| mainnet.zip | 4fc78d0a1f2e15764ed2ec72ada5cb3d0e0f2d59fdf873fedd8f5057be8198f1 |
| testnet.zip | b26fe88ccb52f540a95cbf749503130f6dd38eb8d361b7ef87aaf9ee2d473ed9 |
| geth_linux | 903f2dc9a4621de36c24eebdad0e152443dc01838c60b5fa0ce4160e0465ed2e |
| geth_mac | 8d03b99de532359fe3d695eaa4b6fce3baa35ea158499e990a72e9480cde1164 |
| geth_windows | 51ce63c885452bf5899bcbaacd33437592a4dcd891d71da8bf665e7c37c453ad |
| geth_linux_arm64 | 4555afd19eb298d082859bd4c58caa4beedfa8b4f4ac6ac0fa27f8b4a23815e6 |
v1.2.7
Attention
- SELFDESTRUCT will no longer be refunded
- There are 3 hard forks, node operators need to set them up at the same fork height, i.e.
BerlinBlock = 31103030,LondonBlock = 31103030,HertzBlock = 31103030
Description
v1.2.7 is a hard-fork release for BSC testnet.
The testnet is expected to have 3 scheduled hardfork upgrades named Hertz, London, Berlin) at same block height 31,103,030. The current block generation speed forecasts this to occur around 29th Jun 2023.
The validators and full node operators on testnet should switch their software version to v1.2.7 before 29th Jun 2023.
The Hertz hardfork will port some of London&Berlin upgrades from Ethereum to BSC for compatiblity. But due to the difference between the 2 networks, there would inevitably has difference in implementation, especially the difference in EIP-1559, the BaseFee will be zero on BSC, so this hard fork will neither introduce new burn mechanism nor the concept of GasTip. In short words, it only provides the interface, but actually no change to the current BSC Gas mechanism.
Here is the list of Hertz upgrade:
-
Berlin Upgrades Ported:
a.BEP-225: Implement EIP-2565 ModExp Gas Cost
b.BEP-229: Implement EIP-2718 Typed Transaction Envelope
c.BEP-230: Implement EIP-2929 Gas cost increases for state access opcodes
d.BEP-231: Implement EIP-2930: Optional access lists -
London Upgrades Ported:
a.BEP-227: Implement EIP-3198: BASEFEE opcode
b.BEP-226: Implement EIP-1559 with base fee of 0
c.BEP-228: Implement EIP-3541: Prevent deploying contracts starting with 0xEF
d.BEP-212: Implement EIP-3529: Reduction in Refunds
There are many changes with these BEPs, DApp developers & users needs to make sure they clearly understand these changes and the potential impact to their business.
- New transaction types are supported, i.e. AccessList & DynamicFee(1559), by BEP-229, BEP-231, BEP-226
- The gas metering mechanism has been changed, by BEP-225, BEP-230, BEP-212;
- New EVM opcode(BASEFEE) is supported, by BEP-227
- Prevent deploying contracts starting with 0xEF, by BEP-228
Changelog
FEATURE
- #1697 upgrade: block height of Hertz(London&Berlin) on testnet
- #1686 eip3529tests: refactor tests
- #1676 EIP-3529 (BEP-212) Unit tests for Parlia Config
- #1660 feat: add a tool for submitting evidence of maliciousvoting
- #1623 P2P: try to limit the connection number per IP address
- #1608 feature: Enable Berlin EIPs
- #1597 feature: add malicious vote monitor
- #1422 core: port several London EIPs on BSC
- #1717 feat: support creating a bls keystore from a specified private key
- #1720 metrics: add counter for voting status of whole network
IMPROVEMENT
- #1662 consensus, core/rawdb, miner: downgrade logs
- #1654 config: use default fork config if not specified in config.toml
- #1642 readme: update the disk requirement to 2.5TB
- #1621 upgrade: avoid to modify RialtoGenesisHash when testing in rialtoNet
BUGFIX
- #1682 fix: set the signer of parlia to the most permissive one
- #1681 fix: not double GasLimit of block upon London upgrade
- #1679 fix: check integer overflow when decode crosschain payload
- #1671 fix: voting can only be enabled when mining
- #1663 fix: ungraceful shutdown caused by malicious Vote Monitor
- #1651 fix: remove naturally finality
- #1641 fix: support getFilterChanges after NewFinalizedHeaderFilter
- #1645 lightclient: fix validator set change
Assets
| Assets | Sha256 Checksum |
|---|---|
| mainnet.zip | 13563cb06b18accd4b3b9df43ca94ffcef56992c56dc479c9bfe4a74ab72caba |
| testnet.zip | 9a81824dfdfae976edceee646691fb8ed262f4d5adbff74f444770da5e2793e5 |
| geth_linux | 798ffe167895d2998e2e4a482a5c0364032fa917f53b6e8446f3f2ccad00ce4e |
| geth_mac | bf0d477989790aa137155146e072c02e928bd1526ee1b5ed8721b10e9ed6f79e |
| geth_windows | c2015fafbd83dc5b1c1374fce1b667bcb20c52aefea299c9ba2dcadde9d152b5 |
| geth_linux_arm64 | a7e3a7db7ffa4eb464ae850305ba9f5b9a44277ea34c1cefe33034c454332a29 |
v1.2.6
Abandoned.
It will be replaced by v1.2.7, since it missed a desired change.