BitShares Suez 7.0.2

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).

Platform	SHA256 Checksum
Microsoft Windows	6d13c3597cbffe1950fbe18e04f243b15ce3f36ec47c858c67cc7db4ee26762a
Mac	099d5f3b4068f2d95ec52bb6946987d6fb6897be8afbd608f520878918d249b8
Linux	f3e8f61cac53db5ef9d3ce6776445ca1b5c4156d91f498fdc11d8691d471bc81

Changes

The changes for 7.0.2 Bugfix Release are summarized below.

Node Performance and Stability

Description	Issue	Pull Request
Try to fix a sync issue	2798	2799

Release Contributors

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

BitShares Testnet test-7.0.4

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)).

Platform	SHA256 Checksum
Linux	19bd7d9391ca4872be03eb72d53ec253f5d7da55fc9a88c7ec431d63fae154b5
Microsoft Windows	9923a95eb9f9b11eb57df8c690e388c6b00b32b2424d5dc5affb3accd8a2fe57
macOS	f0fed3120770690bbb1337191eb45a20af67f935f229f6652eba1ff8e3970336

BitShares Suez 7.0.1

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).

Platform	SHA256 Checksum
Microsoft Windows	bb4aa86b0f743f7a46b575cb57deaba2012eaf7db76cd2f266eabad75e57ee94
Mac	f86cbc7616783efbfa585c575494a4caeef3089dc99558ca184de8825d03cab0
Linux	a1ebb6cf207561d0ea58e428c03281da6ca5fc5b52a3a6411e8c9a56d0f7b0d4

Changes

The changes for 7.0.1 Bugfix Release are summarized below.

Node Performance and Stability

Description	Issue	Pull Request
Improve node networking stability by better handling asio operation cancellation exceptions	-	FC-251, 2791

Release Contributors

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

BitShares Testnet test-7.0.3

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)).

Platform	SHA256 Checksum
Linux	c30f10981a40be51eb05e6262cf4257bb905206bed4ff147eb088dae23311b1e
Microsoft Windows	b3c4380ecfc56c17a655fb97be936cbe714b4f9ec65ed8d9403fefae6aeaa387
macOS	5637717be11cba44244dd76921f49e7c66d05106e9af67f5f8ada6c55666239a

BitShares Core 7.0.0 "Suez"

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).

Platform	SHA256 Checksum
Microsoft Windows	984401f1e46c0458e8991ec61719f4e7c1bd1d96a351c3013e01592efacbd75d
Mac	edfc685d6c9af6008fb35b3fed3e0368dbc256ab8fbaeb32118f58f558fc954c
Linux	4229c0ae8b64c7edd607c705815d79c4c925c4e0486c403a13eab7eef443fad6

Changes

The changes for 7.0.0 Protocol Release are summarized below.

Protocol

Description	Issue	Pull Request
Add Order-Sends-Take-Profit-Order (OSO) feature for market making	2535	2749, 2759, 2762
Add new operation to modify existing limit order (see notes about breaking changes)	1604	2743, 2776
Add credit deal auto-repayment feature	2595	2735, 2755, 2757, 2760
Add operation to update liquidity pools	2604	2720, 2754
Tighter peg when collateral price rises and settlement fund is not empty or settlement order exists (see notes about breaking changes)	2591	2721, 2727, 2748, 2768
Allow settling more than total debt amount in individual settlement fund when no sufficient price feeds	2587	2716, 2764

Node Functionality

Description	Issue	Pull Request
Add return value (what and how much is refunded) to virtual limit_order_cancel operation	-	2729
Update default values of market history plugin options	-	2702
Update seed nodes	-	2769

Node Performance and Stability

Description	Issue	Pull Request
Improve node networking stability by better handling asio operation cancellation exceptions	-	FC-249, 2775

Node Plugins

Description	Plugins	Issue	Pull Request
Support ElasticSearch 8 (see notes about deployment)	ElasticSearch Operations, ElasticSearch Objects	2706	2707, 2709
Add missing is_virtual field in account history in ES, and fix a related API	ElasticSearch Operations	-	2730

API

This release does not contain any API changes.

Command-Line Wallet (CLI)

Description	Issue	Pull Request
Improve performance of account history wallet APIs by using the block_time field in operation_history_object	2643	2644
Fix "gethelp command in CLI wallet built with Ubuntu 20 lacks docs for command parameters"	2770	2771

Software Design

Description	Issue	Pull Request
Improve safe<T>	2147	FC-248, 2739
Fix Network Mapper Tool	-	2718
Fix code smells	-	2703, [2705](https://github.com/bitshares/bitshares-c...

BitShares Testnet test-7.0.2

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)).

Platform	SHA256 Checksum
Linux	4eacdb31675f7d5d259165b6cb24f6cae76bac35d9c8d4c48a317645284cf40c
Microsoft Windows	5d73fd46c142503505e0d9e911b85ef50f9c0fe6496a051a260a3b0946e65637
macOS	20735e6f148d6f2445523ea42fe3b7710a734b00707a2f70f93eb6827b7ca73f

BitShares Testnet test-7.0.1

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)).

Platform	SHA256 Checksum
Linux	220cb408e74007ffc7c6e76c510a3fd6d291ef4c5c99b8bf3d2da6e273683d59
Microsoft Windows	ea9dfa2a4c92ddabfac3b7b000f3fc9af51e99712cfbf7e5ba56232082cc2c14
macOS	adadf687687b31ab9bb72d3c741fbd977ed3ba2625b9845171600c4eef9dea04

BitShares Testnet test-7.0.0

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)).

Platform	SHA256 Checksum
Linux	d92328fc8c6c448215437216e3d24ccf52f388be73120d9b9c2d4d184b225d3e
Microsoft Windows	8330912f52f9482e4207e99df83777227fe79bf513810b63b392417e85c69375
macOS	34aafb9dfdefffb84d2d4d5f7d075a6888a20d5bd456e9006e17189153fa749f

BitShares Mekong 6.1.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).

Platform	SHA256 Checksum
Linux	36e24b86b5493981b6774cc7f58194a3f0f31eea6b1b40aeda4f989b5bd324e1
macOS	7796e05314c78e155e67081f8157cfb476901af7cf038bf96465792c1cc6a83f
Windows	4e9d7387dc29846bdcb5715adfd43f67817ef317439b2029a5e42c1305a59893

Changes

The changes for 6.1.0 Feature Release are summarized below.

Node Functionality

Description	Issue	Pull Request
Improve P2P security, add new node startup options	659	FC-244, 1764 (main), 2640
Add creation block number and timestamp for accounts and assets	2586	2639
Show more detailed error messages about static_variant static_cast<size_t>(tag) < count()	2578	FC-243, 2579
Update seed nodes	-	2590, 2592, 2684, 2685

Node Performance and Stability

Description	Issue	Pull Request
Suppress p2p logging about liquidity pool "Unable to exchange at expected price"	2543	2625
Update p2p call statistics collector log level to debug	-	2694

Node Plugins

Description	Plugins	Issue	Pull Request
Fix "Specifying types in bulk requests is deprecated" (with breaking changes)	ElasticSearch Operations, ElasticSearch Objects	2240	1997
Fix data deletion in es_objects plugin, update program options (with breaking changes)	ElasticSearch Objects	2464	2570 (main), 2623
Store some data in ES as objects instead of just as strings	ElasticSearch Operations, ElasticSearch Objects	1400, 2380, 2680	2565 (main), 2681
Store budget records in ES	ElasticSearch Objects	2298	2573
Add fee payer to account history in ElasticSearch database	ElasticSearch Operations	2583	2624
Add block_time and is_virtual fields to operation_history_object	Account History, ElasticSearch Operations	487	[2642](https://github.com/bitshares/bi...

BitShares Testnet test-6.1.2

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.

Platform	SHA256 Checksum
Linux	c7c4fe8fa8b363eb87d7c4603ef27f133d3501f216a7499c39974d2b609d86de
macOS	40683423be49a1bf269c79e758008f6cf1a1c6561c47f07f0d055337a181a3d6
Microsoft Windows	e82981f970e4e402145b44ae280ccec53e6f286b0a1301018a6e8410c8d7510d