Release Notes
The BitShares Core software has been updated to the 3.3.2 Bugfix Release. The Core software is used to build the validation nodes that perform consensus of all transactions on the BitShares blockchain. This release contains only bugfixes related to the P2P networking layer.
Documentation for users may be be found at How BitShares Works.
Documentation for BitShares developers may be now be found at the new BitShares Developer Portal.
Who Should Upgrade?
Upgrade is strongly recommended for nodes running the 3.3.x releases, which are known to crash comparatively often. This release should improve the situation significantly.
Versions before 3.3.0 are suffering from a data leak that has also been fixed with 3.3.2. We recommend that these nodes should be upgraded too. Please check the release nodes of all intermediate releases when upgrading.
Upgrade Process
Precautions
None when upgrading from 3.3.1.
Please check the 3.3.0 Release Notes for more information if you are upgrading from versions prior to 3.3.0.
How to Upgrade from Source Code
Obtain the Source Code
The source code may be obtained by checking out the 3.3.2 tag. Download the source at:
Build the Binaries
The binaries may be built by using your pre-existing process, or by following the standard instructions that can be found in the wiki:
Deploy the Binaries
Your standard process for deploying the node software may be used. No additional requirements or precautions will be required to deploy the new release.
How to Upgrade with Docker
The latest Docker image may be found at BitShares Core Docker page and updated with
docker pull bitshares/bitshares-core
Binaries
Binaries of the command line interface (CLI) wallet and the node software are pre-built and available for download.
Note: These binary builds are reproducible and were signed using gitian. Please check the README if you want to verify and/or contribute.
| Platform | SHA256 Checksum |
|---|---|
| Microsoft Windows | 666af326d833cb1bd13d999cc0b426d0c5eedc18fe783c4a6f3b17207f894e74 |
| Mac | 37ad3783b18d711831c7a2edf3082f7ebab506d9ebb5ab70c770f1b3e46f9443 |
| Linux | e66e342bee14f64cf0bab88d200c9021a30222a0e690e84cf9a302e808e4556f |
Changes
The changes for 3.3.2 Bugfix Release are summarized below.
P2P layer
| Description | Issue | Pull Request |
|---|---|---|
| Data leak | 1999 | 2002 |
| Node stability | - | 1996, FC 165 |
Release Contributors
Emergency Bugfix Release
This release fixes a chain halt. All nodes must upgrade.
Note: to avoid replay, nodes on older 3.x.y versions might prefer to upgrade to the respective patch versions. We have tagged these with 3.0.2, 3.1.1 and 3.2.2 respectively.
The only change in this release is #1975.
Upgrade instructions from previous versions apply. Docker builds are underway but may take some time to complete.
Binaries
Binaries of the command line interface (CLI) wallet and node software are being pre-built and will be made available for download.
Note: starting with core release 3.3.1, binary builds are reproducible and were signed using gitian. Please check the README if you want to verify and/or contribute.
| Platform | SHA256 Checksum |
|---|---|
| Microsoft Windows | 4e7087b58b7ba7cc4ad2d9acdae7bb3c01a3454b2030f1c24ba96e296fcac58c |
| Mac | 8f16969ec819e0950425405f3eaac84edd0edc95018255cddd821a80d7290907 |
| Linux | 30d4b8ddbfea143904d099b78e2083a666b6c0d7e68fb1810fbbdfb841f971af |
Binaries for older versions
| Version | Platform | SHA256 Checksum |
|---|---|---|
| 3.0.2 | Linux | 182c9bac3c7a77914918451f6df182f76f35fcfbb535386f792730da43680cb8 |