BitShares Blockchain node and command-line wallet
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.
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.
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
Note:
The source code may be obtained by checking out the 7.0.2 tag. Download the source at:
The binaries may be built by using your pre-existing process, or by following the standard instructions that can be found in the wiki:
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 of the command-line interface (CLI) wallet and the node software are pre-built and available for download.
Note:
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 |
The changes for 7.0.2 Bugfix Release are summarized below.
Description | Issue | Pull Request |
---|---|---|
Try to fix a sync issue | 2798 | 2799 |
@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):
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 |
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.
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.
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
Note:
The source code may be obtained by checking out the 7.0.1 tag. Download the source at:
The binaries may be built by using your pre-existing process, or by following the standard instructions that can be found in the wiki:
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 of the command-line interface (CLI) wallet and the node software are pre-built and available for download.
Note:
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 |
The changes for 7.0.1 Bugfix Release are summarized below.
Description | Issue | Pull Request |
---|---|---|
Improve node networking stability by better handling asio operation cancellation exceptions | - | FC-251, 2791 |
@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:
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 |
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.
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.
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.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
Note:
The source code may be obtained by checking out the 7.0.0 tag. Download the source at:
The binaries may be built by using your pre-existing process, or by following the standard instructions that can be found in the wiki:
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 of the command-line interface (CLI) wallet and the node software are pre-built and available for download.
Note:
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 |
The changes for 7.0.0 Protocol Release are summarized below.
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 |
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 |
Description | Issue | Pull Request |
---|---|---|
Improve node networking stability by better handling asio operation cancellation exceptions | - | FC-249, 2775 |
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 |
This release does not contain any API changes.
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 |
Description | Issue | Pull Request |
---|---|---|
Improve safe<T> |
2147 | FC-248, 2739 |
Fix Network Mapper Tool | - | 2718 |
Fix code smells | - | 2703, 2705, 2745, 2747 |
Description | Issue | Pull Request |
---|---|---|
Use gcovr to process code coverage data |
- | 2739, 2742, FC-248 |
Set a timeout for running unit tests in Github Actions | - | 2732 |
Remove SonarCloud cache and threads configuration as it is now by default | 2738 | 2736, 2737, FC-248 |
Stop supporting Ubuntu 18.04 LTS | 2670 | 2707, FC-248, Gitian-72 |
Update dependency versions used in Github Actions | - | 2724, 2752, 2775, 2779 |
Bump docker/build-push-action from 3 to 4 | - | 2722, 2726 |
Description | Issue | Pull Request |
---|---|---|
Fix Doxygen warnings | - | 2780 |
Update project links, version and description in sonar-project.properties | - | 2714, 2715, 2740 |
Update license year | - | 2731 |
Update project brief and version in Doxyfile | - | 2767 |
@abitmore (https://github.com/abitmore) @litepresence (https://github.com/litepresence) @mpaladin (https://github.com/mpaladin) @nathanielhourt (https://github.com/nathanielhourt) @technologiespro (https://github.com/technologiespro)
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:
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 |
Note: this pre-release is for the BitShares public test network (Testnet) but NOT the BitShares Mainnet.
Change list:
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 |
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 |
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.
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.
elasticsearch
plugin and the es_objects
plugin. For nodes with one of those 2 plugins enabled, please check the Node Plugins section before upgrade.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.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:
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.bitsharesentry.sh
file is set to the default ENTRYPOINT
but no longer to the default CMD
, which may affect your deployment.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.Note:
The source code may be obtained by checking out the 6.1.0 tag. Download the source at:
The binaries may be built by using your pre-existing process, or by following the standard instructions that can be found in the wiki:
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 of the node software and the command-line wallet software are pre-built and available for download.
Note:
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 |
The changes for 6.1.0 Feature Release are summarized below.
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 |
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 |
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 |
Add option to account history plugin to keep operations that happened in last X blocks in memory | Account History | 2268 | 2648 |
Update api_helper_indexes plugin to support database_api::get_next_object_id API |
API Helper Indexes | 2649 | 2653 |
Limit recursion depth when adapting objects for ES | ElasticSearch Operations | 2577 | 2609 |
Update default es-objects-max-mapping-depth to 10 |
ElasticSearch Objects | 2612 | 2616 |
Add logging about sending bulk data in replay mode | ElasticSearch Objects | - | 2636 |
Fix "413 request too large" error | ElasticSearch Operations, ElasticSearch Objects | 2682 | 2683, 2688 |
Please check the linked pull requests for more info and documentation.
Description | Issue | Pull Request |
---|---|---|
Add history_api::get_block_operation_history API |
243 | 1899 |
Add api-limit-get-market-history and api-limit-get-full-accounts-subscribe node startup options |
- | 2613 |
Update database_api::get_margin_positions API to only return the first page (use database_api::get_call_orders_by_account API to get more data) |
- | 2613 |
Add login_api::get_info API to return data defined by a new api-node-info node startup option |
626 | 2617 |
Add login_api::get_config API to return configured API limits |
626 | 2617 |
Add login_api::get_available_api_sets API |
1689 | 2617 |
Add login_api::logout API |
- | 2617 |
Fix some issues related to login_api |
2614 | 2617 (main), 2679 |
Add creation block number and timestamp for accounts and assets | 2586 | 2639 |
Add block_time and is_virtual fields to operation_history_object |
487 | 2642 |
Add history_api::get_account_history_by_time API |
2647 | 2650 |
Add history_api::get_block_operations_by_time API |
2498 | 2651 |
Add database_api::get_next_object_id API |
2649 | 2653 |
Extend custom_operations_api::get_storage_info API with pagination and optional parameter support, add api-limit-get-storage-info node startup option |
2139 | 2620 |
Extend get_order_book API to return limit order owners and other info |
2637 | 2638 |
Extend get_block_header and get_block_header_batch APIs to optionally return witness signatures |
2588 | 2641, 2652 (main) |
Use configured limit as API page size if omitted | 2619 | 2622 |
Description | Issue | Pull Request |
---|---|---|
Display operation history IDs for CLI wallet commands related to account history | - | 2645 |
Simplify help info in cli_wallet | - | 2661 |
Extend transaction_handle_type to 32 bits and handle overflow |
- | 2661 |
Description | Issue | Pull Request |
---|---|---|
Fix compiler warnings | 2340, 2501, 2567 | 2566, 2660 |
ElasticSearch related code refactory | - | 2576 |
Update connection_rejected_message member order |
112 | 2605 |
Refactor API code | - | 2613 |
Change address constructors to explicit | - | 1151 |
Refactor code about object_id and object_id_type |
- | 2658 |
Fix code smells | - | FC-246, FC-247, 2661, 2663, 2675 |
Description | Issue | Pull Request |
---|---|---|
Update Dockerfile and build-docker workflow |
2011 | 2666 |
Support building with curl v7.77 or higher in mac |
- | 2665 |
Fix SonarScanner version detection | - | 2598 |
Remove .travis and related files |
- | 2664 |
Use GITHUB_REF_NAME variable provided by Github |
- | 2664 |
Run sonar-scan workflow with Ubuntu 20.04 instead of ubuntu-latest |
- | 2664 |
Update dependency versions used in Github Actions, Dockerfile and Gitian | Gitian-63 | Gitian-58, Gitian-59, Gitian-64, Gitian-65, Gitian-66, Gitian-68, 2594, 2611, 2664, 2676 |
Description | Issue | Pull Request |
---|---|---|
Update README | - | 2615, 2646, 2672 |
Update license year to 2022 | 2572 | 2626 |
Fix Doxygen documentation warnings and errors | 2545, 2552 | 2659, 2675 |
Update docs | - | 2695 |
@abitmore (https://github.com/abitmore) @ioBanker (https://github.com/ioBanker) @jmjatlanta (https://github.com/jmjatlanta) @oxarbitrage (https://github.com/oxarbitrage)
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:
Full Changelog: https://github.com/bitshares/bitshares-core/compare/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 |