The BitShares Core software has been updated to the 7.0.2 Bugfix Release. The codename of the 7.x releases is "Suez". The BitShares Core software is used to build the validation nodes that perform consensus of all transactions on the BitShares blockchain. This release includes improvements 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
• How to upgrade
• Binaries for download
• Changes
• Release contributors

Who Should Upgrade

Note: This version is experimental, and every older version has its known issues. Please do your own research to determine which version suits your needs.

Please check the release notes of the 7.0.0 version for more info about the BitShares Suez update.

How To Upgrade

Precautions

• Blockchain replay is not needed and will not occur automatically when upgrading to this version.

How to Upgrade with Docker

The pre-built Docker image can be found on the BitShares Core Docker page and can be downloaded with the following command.

docker pull bitshares/bitshares-core:7.0

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.74
• The minimum supported CMake version is 3.2
• For Ubuntu users, it is recommended to build in Ubuntu 20.04 LTS (Focal Fossa).
  • Ubuntu 18.04 LTS (Bionic Beaver) and earlier versions are no longer supported.
  • Ubuntu 22.04 LTS (Jammy Jellyfish) is not yet supported.

Obtain the Source Code

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

• 7.0.2.zip
• 7.0.2.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.

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 built using Gitian. Please check the README of Gitian if you want to verify and/or contribute.
• Starting from version 7.0.0, pre-built Linux binaries will not run on Ubuntu 18.04 LTS (Bionic).

Changes

The changes for 7.0.2 Bugfix Release are summarized below.

Node Performance and Stability

Release Contributors

@abitmore (https://github.com/abitmore)

Note: This pre-release is for the BitShares public test network (Testnet) but NOT the BitShares Mainnet.

Note: Blockchain replay will not occur if upgrading from test-7.0.2 or a later version, otherwise a blockchain replay will be performed automatically when the node starts for the first time.

Note: This version is experimental, and every older version has its known issues. Please do your own research to determine which version suits your needs.

Change(s):

• Try to fix a sync issue #2799

Please check the release notes of BitShares-Core version 7.0.0 "Suez" for more info.

Docker image: docker pull bitshares/bitshares-core:test-7.0.

Pre-built Linux binaries, Windows binaries and macOS binaries are available for download (built with BitShares-Gitian (version test-7.0.4)).

The BitShares Core software has been updated to the 7.0.1 Bugfix Release. The codename of the 7.x releases is "Suez". The BitShares Core software is used to build the validation nodes that perform consensus of all transactions on the BitShares blockchain. This release includes improvements 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
• How to upgrade
• Binaries for download
• Changes
• Release contributors

Who Should Upgrade

It is recommended that all nodes be upgraded to benefit from the stability improvements introduced in this release, although it is not required.

Please check the release notes of the 7.0.0 version for more info about the BitShares Suez update.

How To Upgrade

Precautions

• Blockchain replay is not needed and will not occur automatically when upgrading to this version.

How to Upgrade with Docker

The pre-built Docker image can be found on the BitShares Core Docker page and can be downloaded with the following command.

docker pull bitshares/bitshares-core:7.0

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.74
• The minimum supported CMake version is 3.2
• For Ubuntu users, it is recommended to build in Ubuntu 20.04 LTS (Focal Fossa).
  • Ubuntu 18.04 LTS (Bionic Beaver) and earlier versions are no longer supported.
  • Ubuntu 22.04 LTS (Jammy Jellyfish) is not yet supported.

Obtain the Source Code

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

• 7.0.1.zip
• 7.0.1.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.

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 built using Gitian. Please check the README of Gitian if you want to verify and/or contribute.
• Starting from version 7.0.0, pre-built Linux binaries will not run on Ubuntu 18.04 LTS (Bionic).

Changes

The changes for 7.0.1 Bugfix Release are summarized below.

Node Performance and Stability

Release Contributors

@abitmore (https://github.com/abitmore)

Note: this pre-release is for the BitShares public test network (Testnet) but NOT the BitShares Mainnet.

Note: blockchain replay will not occur if upgrading from test-7.0.2, otherwise a blockchain replay will be performed automatically when the node starts for the first time.

Changes:

• Improve node networking stability by better handling asio operation cancellation exceptions #2791

Please check the release notes of BitShares-Core version 7.0.0 "Suez" for more info.

Docker image: docker pull bitshares/bitshares-core:test-7.0.

Pre-built Linux binaries, Windows binaries and macOS binaries are available for download (built with BitShares-Gitian (version test-7.0.3)).

The BitShares Core software has been updated to the 7.0.0 Protocol Release. The codename of the 7.x releases is "Suez". The BitShares 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 changes to the consensus protocol.

The scheduled protocol upgrade (hard fork) time is Thursday, November 16, 2023 14:00:00 UTC (2023-11-16T14:00:00Z).

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
• How to upgrade
• Binaries for download
• Changes
• Release contributors

Who Should Upgrade

All nodes need to be upgraded to handle the protocol upgrade (hard fork).

Command-line wallets need to be upgraded to connect to upgraded nodes.

How To Upgrade

Precautions

• All validation nodes must complete their upgrade prior to Protocol Activation (hard fork).
• A blockchain replay will be performed automatically when the validation node software starts for the first time. This typically takes few hours on a modern CPU.
• This release contains breaking changes regarding limit orders and individual settlement fund that may break existing client applications. Please check the Protocol Changes section before upgrade.
• There were some breaking changes in the 6.1.0 release (the previous version). If you are upgrading from an earlier version, please see the 6.1.0 release notes for more information.

How to Upgrade with Docker

The pre-built Docker image can be found on the BitShares Core Docker page and can be downloaded with the following command.

docker pull bitshares/bitshares-core:7.0

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.74
• The minimum supported CMake version is 3.2
• For Ubuntu users, it is recommended to build in Ubuntu 20.04 LTS (Focal Fossa).
  • Ubuntu 18.04 LTS (Bionic Beaver) and earlier versions are no longer supported.
  • Ubuntu 22.04 LTS (Jammy Jellyfish) is not yet supported.

Obtain the Source Code

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

• 7.0.0.zip
• 7.0.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.

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 built using Gitian. Please check the README of Gitian if you want to verify and/or contribute.
• Starting from version 7.0.0, pre-built Linux binaries will not run on Ubuntu 18.04 LTS (Bionic).

Changes

The changes for 7.0.0 Protocol Release are summarized below.

Protocol

Node Functionality

Node Performance and Stability

Node Plugins

API

This release does not contain any API changes.

Command-Line Wallet (CLI)

Software Design

Note: this pre-release is for the BitShares public test network (Testnet) but NOT the BitShares Mainnet.

A blockchain replay will be performed automatically when the node starts for the first time.

Changes:

• Improve node networking stability by better handling asio operation cancellation exceptions #2775
• Record filled amount in limit orders #2776

Please check the draft release notes of BitShares-Core version 7.0.0 "Suez" for more info.

Docker image: docker pull bitshares/bitshares-core:test-7.0.

Pre-built Linux binaries, Windows binaries and macOS binaries are available for download (built with BitShares-Gitian (version test-7.0.2)).

Note: this pre-release is for the BitShares public test network (Testnet) but NOT the BitShares Mainnet.

Change list:

• Update project brief and version in Doxyfile #2767
• Fix Doxygen warnings #2768
• Update xbts testnet seed node port number #2769
• Fix gethelp command in CLI wallet #2771

Please check the draft release notes of BitShares-Core version 7.0.0 "Suez" for more info.

Docker image: docker pull bitshares/bitshares-core:test-7.0.

Pre-built Linux binaries, Windows binaries and macOS binaries are available for download (built with BitShares-Gitian (version test-7.0.1)).

Note: this pre-release is for the BitShares public test network (Testnet) but NOT the BitShares Mainnet.

The activation time of the 7.0 protocol on the BitShares Public Testnet is set to Tuesday, July 11, 2023 13:30:00 UTC, or the ISO-8601 format 2023-07-11T13:30:00Z.

All Testnet nodes need to be upgraded before the planned activation time.

Please check the draft release notes of BitShares-Core version 7.0.0 "Suez" for more info.

Docker image: docker pull bitshares/bitshares-core:test-7.0.

Pre-built Linux binaries, Windows binaries and macOS binaries are available for download (built with BitShares-Gitian (version test-7.0.0)).

The BitShares Core software has been updated to the 6.1.0 Feature Release. The codename of the 6.x releases is "Mekong". The Core software is used to build the validation nodes that perform consensus of all transactions on the BitShares blockchain, and a command-line wallet tool to interact with nodes. This release includes improvements 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
• How to upgrade
• Binaries for download
• Changes
• Release contributors

Who Should Upgrade

It is recommended that all nodes and all command-line wallets be upgraded, although it is not required.

All nodes will benefit from the P2P network security improvements.

API nodes will benefit from the new APIs.

Docker image users will benefit from security updates and reduced Docker image size.

Command-line wallet users will benefit from command-line wallet improvements.

ElasticSearch nodes will benefit from new data, new program options and bug fixes.

Account history plugin users will benefit from new program options.

How To Upgrade

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.
• This release contains breaking changes about the elasticsearch plugin and the es_objects plugin. For nodes with one of those 2 plugins enabled, please check the Node Plugins section before upgrade.
• Due to the changes in PR 2648 and PR 2642, nodes with the account_history plugin enabled will have increased memory usage and higher spikes by default. It is a trade-off for better serving certain APIs. Node operators can set the min-blocks-to-keep and the max-ops-per-acc-by-min-blocks startup options to different values to achieve different behaviors.
• Docker users please refer to the following section for breaking changes regarding Docker.

How to Upgrade with Docker

The pre-built Docker image can be found on the BitShares Core Docker page and can be downloaded with the following command.

docker pull bitshares/bitshares-core:6.1

or

docker pull bitshares/bitshares-core:6.1.0

Note:

• Starting from this release, when we add a new image to Docker Hub with a major.minor.patch version tag, we also add or update the corresponding major.minor version tag. Therefore, users using the major.minor version tag will always get the latest patch for that version.
• Starting from this release, the bitsharesentry.sh file is set to the default ENTRYPOINT but no longer to the default CMD, which may affect your deployment.
• By default, the Docker container will run with the bitshares user with UID 10000 and GID 10001 (instead of root), and all existing files in the data directory will be updated to be owned by bitshares:bitshares (from root) on startup.

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.74
• The minimum supported CMake version is 3.2
• For Ubuntu users, it is recommended to build in Ubuntu 20.04 LTS (Focal Fossa). Ubuntu 16.04 LTS (Xenial Xerus) may still work, but it is no longer tested.

Obtain the Source Code

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

• 6.1.0.zip
• 6.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 and the command-line wallet software may be used. No additional requirements or precautions will be required to deploy the new release.

Binaries for download

Binaries of the node software and the command-line wallet software are pre-built and available for download.

Note:

• These binary builds are reproducible and were built using Gitian. Please check the README of Gitian if you want to verify and/or contribute.
• Starting from version 6.0.0, pre-built Linux binaries will not run on Ubuntu 16.04 LTS (Xenial).

Changes

The changes for 6.1.0 Feature Release are summarized below.

Node Functionality

Node Performance and Stability

Node Plugins

Note: this pre-release is for the BitShares Public Testing Network (Testnet) but NOT the BitShares Mainnet.

All Testnet nodes and command-line wallets are recommended to be upgraded, although not required.

Change list:

• Fix a logging issue by @abitmore in #2688

Full Changelog: test-6.1.1...test-6.1.2

Please check the draft release notes of BitShares Mekong 6.1.0 for more info.

Docker image: docker pull bitshares/bitshares-core:test-6.1 (note: bitshares/bitshares-core:test-6.1.2 is also available if you want to pin to a specific patch version).

Linux, Windows and macOS binary files pre-built with BitShares-Gitian version test-6.1.2 are available for download.