Release Notes

The BitShares Core software has been updated to the 5.1.0 Feature Release. The codename of the 5.x releases is "Splash". The Core software is used to build the validation nodes that perform consensus of all transactions on the BitShares blockchain. This release includes additions, improvements and bug fixes but does not include any changes to the consensus protocol.

Documentation for users may be be found at How BitShares Works.

Documentation for BitShares developers may be found at the BitShares Developer Portal.

• Who should upgrade
• Upgrade process
• Binaries for download
• Changes
• Release contributors

Who Should Upgrade?

Public API nodes should upgrade to support client software that attempt to use the new APIs.

Private API nodes may or may not upgrade depending on the use cases.

Pure validation nodes E.G. block producers and seed nodes are not required to upgrade.

Upgrade Process

Precautions

• A blockchain replay will automatically be performed after the validation node software is restarted. This typically takes a few hours on a modern CPU.

How to Upgrade from Source Code

Note:

• The code base requires a compiler that supports the C++ 14 standard
• The minimum supported boost version is 1.58, the maximum is 1.69
• The minimum supported CMake version is 3.2

Obtain the Source Code

The source code may be obtained by checking out the 5.1.0 tag. Download the source at:

• 5.1.0.zip
• 5.1.0.tar.gz

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:

• Ubuntu
• macOS
• Windows

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:5.1.0

Binaries for download

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.

Changes

The changes for 5.1.0 Feature Release are summarized below.

Node Functionality

Node Performance and Stability

Node Plug-ins

API

Please check the linked pull requests for more info and documentation.

Software Design

Build Process and Continuous Integration (CI)

Documentation

Unit Tests

Release Contributors

@abitmore (https://github.com/abitmore)
@bangzi1001 (https://github.com/bangzi1001)
@SemenMartynov (https://github.com/SemenMartynov)
@sinetek (https://github.com/sinetek)
@xiao93 (https://github.com/xiao93)
@xloem (https://github.com/xloem)