![](https://images.hive.blog/p/C3TZR1g81UNaPs7vzNXHueW5ZM76DSHWEY7onmfLxcK2iPdiAa6tkfVRkpf9tvraQ9z55QS9fmMKbN32DMR4fCUEJKM2bGoquU7xeXZ7ZoKe6yrMrAtFTxA) The [BitShares](https://bitshares.github.io) Core software has been updated to the [6.1.0 Feature Release](https://github.com/bitshares/bitshares-core/milestone/38?closed=1). 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](https://how.bitshares.works). Documentation for BitShares developers may be found at the [BitShares Developer Portal](https://dev.bitshares.works). * [Who should upgrade](#who-should-upgrade-6-1-0) * [How to upgrade](#how-to-upgrade-6-1-0) * [Binaries for download](#binaries-for-download-6-1-0) * [Changes](#changes-6-1-0) * [Release contributors](#release-contributors-6-1-0) ##

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](https://github.com/bitshares/bitshares-core/pull/1764). API nodes will benefit from the [new APIs](#api-6-1-0). Docker image users will benefit from security updates and reduced Docker image size. Command-line wallet users will benefit from [command-line wallet improvements](#cli-6-1-0). ElasticSearch nodes will benefit from [new data, new program options and bug fixes](#node-plugins-6-1-0). Account history plugin users will benefit from [new program options](https://github.com/bitshares/bitshares-core/pull/2648). ##

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](#node-plugins-6-1-0) before upgrade. - Due to the changes in [PR 2648](https://github.com/bitshares/bitshares-core/pull/2648) and [PR 2642](https://github.com/bitshares/bitshares-core/pull/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](https://hub.docker.com/r/bitshares/bitshares-core/) 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](https://github.com/bitshares/bitshares-core/releases/tag/6.1.0). Download the source at: * [6.1.0.zip](https://github.com/bitshares/bitshares-core/archive/6.1.0.zip) * [6.1.0.tar.gz](https://github.com/bitshares/bitshares-core/archive/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](https://github.com/bitshares/bitshares-core/wiki/BUILD_UBUNTU) * [macOS](https://github.com/bitshares/bitshares-core/wiki/Building-on-macOS) * [Windows](https://github.com/bitshares/bitshares-core/wiki/BUILD_WIN32) #### 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](https://github.com/bitshares/bitshares-gitian/tree/6.1.0). Please check the [README of Gitian](https://github.com/bitshares/bitshares-gitian/blob/master/README.md) 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](https://github.com/bitshares/bitshares-core/releases/download/6.1.0/bitshares-core-6.1.0-linux-amd64-bin.tar.bz2)|`36e24b86b5493981b6774cc7f58194a3f0f31eea6b1b40aeda4f989b5bd324e1`| |[macOS](https://github.com/bitshares/bitshares-core/releases/download/6.1.0/bitshares-core-6.1.0-macos64-bin.tar.bz2)|`7796e05314c78e155e67081f8157cfb476901af7cf038bf96465792c1cc6a83f`| |[Windows](https://github.com/bitshares/bitshares-core/releases/download/6.1.0/bitshares-core-6.1.0-win64-bin.zip)|`4e9d7387dc29846bdcb5715adfd43f67817ef317439b2029a5e42c1305a59893`| #

Changes The changes for [6.1.0 Feature Release](https://github.com/bitshares/bitshares-core/milestone/38?closed=1) are summarized below. ##

Node Functionality |Description|Issue|Pull Request| |-|-|-| |Improve P2P security, add new node startup options|[659](https://github.com/bitshares/bitshares-core/issues/659)|[FC-244](https://github.com/bitshares/bitshares-fc/pull/244), [1764 (main)](https://github.com/bitshares/bitshares-core/pull/1764), [2640](https://github.com/bitshares/bitshares-core/pull/2640)| |Add creation block number and timestamp for accounts and assets|[2586](https://github.com/bitshares/bitshares-core/issues/2586)|[2639](https://github.com/bitshares/bitshares-core/pull/2639)| |Show more detailed error messages about `static_variant` `static_cast(tag) < count()`|[2578](https://github.com/bitshares/bitshares-core/issues/2578)|[FC-243](https://github.com/bitshares/bitshares-fc/pull/243), [2579](https://github.com/bitshares/bitshares-core/pull/2579)| |Update seed nodes|-|[2590](https://github.com/bitshares/bitshares-core/pull/2590), [2592](https://github.com/bitshares/bitshares-core/pull/2590), [2684](https://github.com/bitshares/bitshares-core/pull/2684), [2685](https://github.com/bitshares/bitshares-core/pull/2685)| ##

Node Performance and Stability

Node Plugins |Description|Plugins|Issue|Pull Request| |-|-|-|-| |Fix "Specifying types in bulk requests is deprecated" (**with [breaking changes](https://github.com/bitshares/bitshares-core/pull/1997)**)|ElasticSearch Operations, ElasticSearch Objects|[2240](https://github.com/bitshares/bitshares-core/issues/2240)|[1997](https://github.com/bitshares/bitshares-core/pull/1997)| |Fix data deletion in `es_objects` plugin, update program options (**with [breaking changes](https://github.com/bitshares/bitshares-core/pull/2570)**)|ElasticSearch Objects|[2464](https://github.com/bitshares/bitshares-core/issues/2464)|[2570 (main)](https://github.com/bitshares/bitshares-core/pull/2570), [2623](https://github.com/bitshares/bitshares-core/pull/2623)| |Store some data in ES as objects instead of just as strings|ElasticSearch Operations, ElasticSearch Objects|[1400](https://github.com/bitshares/bitshares-core/issues/1400), [2380](https://github.com/bitshares/bitshares-core/issues/2380), [2680](https://github.com/bitshares/bitshares-core/issues/2680)|[2565 (main)](https://github.com/bitshares/bitshares-core/pull/2565), [2681](https://github.com/bitshares/bitshares-core/pull/2681)| |Store budget records in ES|ElasticSearch Objects|[2298](https://github.com/bitshares/bitshares-core/issues/2298)|[2573](https://github.com/bitshares/bitshares-core/pull/2573)| |Add fee payer to account history in ElasticSearch database|ElasticSearch Operations|[2583](https://github.com/bitshares/bitshares-core/issues/2583)|[2624](https://github.com/bitshares/bitshares-core/pull/2624)| |Add `block_time` and `is_virtual` fields to `operation_history_object`|Account History, ElasticSearch Operations|[487](https://github.com/bitshares/bitshares-core/issues/487)|[2642](https://github.com/bitshares/bitshares-core/pull/2642)| |Add option to account history plugin to keep operations that happened in last X blocks in memory|Account History|[2268](https://github.com/bitshares/bitshares-core/issues/2268)|[2648](https://github.com/bitshares/bitshares-core/pull/2648)| |Update `api_helper_indexes` plugin to support `database_api::get_next_object_id` API|API Helper Indexes|[2649](https://github.com/bitshares/bitshares-core/issues/2649)|[2653](https://github.com/bitshares/bitshares-core/pull/2653)| |Limit recursion depth when adapting objects for ES|ElasticSearch Operations|[2577](https://github.com/bitshares/bitshares-core/issues/2577)|[2609](https://github.com/bitshares/bitshares-core/pull/2609)| |Update default `es-objects-max-mapping-depth` to 10|ElasticSearch Objects|[2612](https://github.com/bitshares/bitshares-core/issues/2612)|[2616](https://github.com/bitshares/bitshares-core/pull/2616)| |Add logging about sending bulk data in replay mode|ElasticSearch Objects|-|[2636](https://github.com/bitshares/bitshares-core/pull/2636)| |Fix "413 request too large" error|ElasticSearch Operations, ElasticSearch Objects|[2682](https://github.com/bitshares/bitshares-core/issues/2682)|[2683](https://github.com/bitshares/bitshares-core/pull/2683), [2688](https://github.com/bitshares/bitshares-core/pull/2688)| ##

API Please check the linked pull requests for more info and documentation. |Description|Issue|Pull Request| |-|-|-| |Add `history_api::get_block_operation_history` API|[243](https://github.com/bitshares/bitshares-core/issues/243)|[1899](https://github.com/bitshares/bitshares-core/pull/1899)| |Add `api-limit-get-market-history` and `api-limit-get-full-accounts-subscribe` node startup options|-|[2613](https://github.com/bitshares/bitshares-core/pull/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](https://github.com/bitshares/bitshares-core/pull/2613)| |Add `login_api::get_info` API to return data defined by a new `api-node-info` node startup option|[626](https://github.com/bitshares/bitshares-core/issues/626)|[2617](https://github.com/bitshares/bitshares-core/pull/2617)| |Add `login_api::get_config` API to return configured API limits|[626](https://github.com/bitshares/bitshares-core/issues/626)|[2617](https://github.com/bitshares/bitshares-core/pull/2617)| |Add `login_api::get_available_api_sets` API|[1689](https://github.com/bitshares/bitshares-core/issues/1689)|[2617](https://github.com/bitshares/bitshares-core/pull/2617)| |Add `login_api::logout` API|-|[2617](https://github.com/bitshares/bitshares-core/pull/2617)| |Fix some issues related to `login_api`|[2614](https://github.com/bitshares/bitshares-core/issues/2614)|[2617 (main)](https://github.com/bitshares/bitshares-core/pull/2617), [2679](https://github.com/bitshares/bitshares-core/pull/2679)| |Add creation block number and timestamp for accounts and assets|[2586](https://github.com/bitshares/bitshares-core/issues/2586)|[2639](https://github.com/bitshares/bitshares-core/pull/2639)| |Add `block_time` and `is_virtual` fields to `operation_history_object`|[487](https://github.com/bitshares/bitshares-core/issues/487)|[2642](https://github.com/bitshares/bitshares-core/pull/2642)| |Add `history_api::get_account_history_by_time` API|[2647](https://github.com/bitshares/bitshares-core/issues/2647)|[2650](https://github.com/bitshares/bitshares-core/pull/2650)| |Add `history_api::get_block_operations_by_time` API|[2498](https://github.com/bitshares/bitshares-core/issues/2498)|[2651](https://github.com/bitshares/bitshares-core/pull/2651)| |Add `database_api::get_next_object_id` API|[2649](https://github.com/bitshares/bitshares-core/issues/2649)|[2653](https://github.com/bitshares/bitshares-core/pull/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](https://github.com/bitshares/bitshares-core/issues/2139)|[2620](https://github.com/bitshares/bitshares-core/pull/2620)| |Extend `get_order_book` API to return limit order owners and other info|[2637](https://github.com/bitshares/bitshares-core/issues/2637)|[2638](https://github.com/bitshares/bitshares-core/pull/2638)| |Extend `get_block_header` and `get_block_header_batch` APIs to optionally return witness signatures|[2588](https://github.com/bitshares/bitshares-core/issues/2588)|[2641](https://github.com/bitshares/bitshares-core/pull/2641), [2652 (main)](https://github.com/bitshares/bitshares-core/pull/2652)| |Use configured limit as API page size if omitted|[2619](https://github.com/bitshares/bitshares-core/issues/2619)|[2622](https://github.com/bitshares/bitshares-core/pull/2622)| ##

Command-Line (CLI) Wallet |Description|Issue|Pull Request| |-|-|-| |Display operation history IDs for CLI wallet commands related to account history|-|[2645](https://github.com/bitshares/bitshares-core/pull/2645)| |Simplify help info in cli_wallet|-|[2661](https://github.com/bitshares/bitshares-core/pull/2661)| |Extend `transaction_handle_type` to 32 bits and handle overflow|-|[2661](https://github.com/bitshares/bitshares-core/pull/2661)| ## Software Design |Description|Issue|Pull Request| |-|-|-| |Fix compiler warnings|[2340](https://github.com/bitshares/bitshares-core/issues/2340), [2501](https://github.com/bitshares/bitshares-core/issues/2501), [2567](https://github.com/bitshares/bitshares-core/issues/2567)|[2566](https://github.com/bitshares/bitshares-core/pull/2566), [2660](https://github.com/bitshares/bitshares-core/pull/2660)| |ElasticSearch related code refactory|-|[2576](https://github.com/bitshares/bitshares-core/pull/2576)| |Update `connection_rejected_message` member order|[112](https://github.com/bitshares/bitshares-core/issues/112)|[2605](https://github.com/bitshares/bitshares-core/pull/2605)| |Refactor API code|-|[2613](https://github.com/bitshares/bitshares-core/pull/2613)| |Change address constructors to explicit|-|[1151](https://github.com/bitshares/bitshares-core/pull/1151)| |Refactor code about `object_id` and `object_id_type`|-|[2658](https://github.com/bitshares/bitshares-core/pull/2658)| |Fix code smells|-|[FC-246](https://github.com/bitshares/bitshares-fc/pull/246), [FC-247](https://github.com/bitshares/bitshares-fc/pull/247), [2661](https://github.com/bitshares/bitshares-core/pull/2661), [2663](https://github.com/bitshares/bitshares-core/pull/2663), [2675](https://github.com/bitshares/bitshares-core/pull/2675)| ## Build Process and Continuous Integration (CI) |Description|Issue|Pull Request| |-|-|-| |Update Dockerfile and `build-docker` workflow|[2011](https://github.com/bitshares/bitshares-core/issues/2011)|[2666](https://github.com/bitshares/bitshares-core/pull/2666)| |Support building with `curl` `v7.77` or higher in mac|-|[2665](https://github.com/bitshares/bitshares-core/pull/2665)| |Fix SonarScanner version detection|-|[2598](https://github.com/bitshares/bitshares-core/pull/2598)| |Remove `.travis` and related files|-|[2664](https://github.com/bitshares/bitshares-core/pull/2664)| |Use `GITHUB_REF_NAME` variable provided by Github|-|[2664](https://github.com/bitshares/bitshares-core/pull/2664)| |Run `sonar-scan` workflow with Ubuntu 20.04 instead of `ubuntu-latest`|-|[2664](https://github.com/bitshares/bitshares-core/pull/2664)| |Update dependency versions used in Github Actions, Dockerfile and Gitian|[Gitian-63](https://github.com/bitshares/bitshares-gitian/issues/63)|[Gitian-58](https://github.com/bitshares/bitshares-gitian/pull/58), [Gitian-59](https://github.com/bitshares/bitshares-gitian/pull/59), [Gitian-64](https://github.com/bitshares/bitshares-gitian/pull/64), [Gitian-65](https://github.com/bitshares/bitshares-gitian/pull/65), [Gitian-66](https://github.com/bitshares/bitshares-gitian/pull/66), [Gitian-68](https://github.com/bitshares/bitshares-gitian/pull/68), [2594](https://github.com/bitshares/bitshares-core/pull/2594), [2611](https://github.com/bitshares/bitshares-core/pull/2611), [2664](https://github.com/bitshares/bitshares-core/pull/2664), [2676](https://github.com/bitshares/bitshares-core/pull/2676)| ## Documentation |Description|Issue|Pull Request| |-|-|-| |Update README|-|[2615](https://github.com/bitshares/bitshares-core/pull/2615), [2646](https://github.com/bitshares/bitshares-core/pull/2646), [2672](https://github.com/bitshares/bitshares-core/pull/2672)| |Update license year to 2022|[2572](https://github.com/bitshares/bitshares-core/issues/2572)|[2626](https://github.com/bitshares/bitshares-core/pull/2626)| |Fix Doxygen documentation warnings and errors|[2545](https://github.com/bitshares/bitshares-core/issues/2545), [2552](https://github.com/bitshares/bitshares-core/issues/2552)|[2659](https://github.com/bitshares/bitshares-core/pull/2659), [2675](https://github.com/bitshares/bitshares-core/pull/2675)| |Update docs|-|[2695](https://github.com/bitshares/bitshares-core/pull/2695)| #

Release Contributors @abitmore (https://github.com/abitmore) @ioBanker (https://github.com/ioBanker) @jmjatlanta (https://github.com/jmjatlanta) @oxarbitrage (https://github.com/oxarbitrage)