RNode-0.9.5 release plan
Reference
Document status | COMPLETE |
---|---|
Release status | RELEASED |
Related pages |
Milestones
Start date | |
---|---|
Release |
|
Release summary
RNode v0.9.5 introduces a redesign of RSpace to better support blockchain building on the RChain platform and provides optimizations in RNode to improve the user experience for RNode operators.
RSpace renovation
The release of RNode v0.9.5 completes the delivery of work to renovate RSpace to better support blockchain building on the RChain platform. This release offers users the option to run RNode with the new RSpace via a flag in the run command, --store-type v2
. In an upcoming release and once we fully complete testing of the new RSpace, v2
, we will change to make this run by default and without the flagThe need for this work emerged in late March 2019 when we observed limitations in the platform for building long chains. The RSpace team investigated the issue and proposed renovating the data, trie, and hot storages solutions. To do this they introduced a history reader impl to the data store, created a trie store that tracks only key structures without data, and provided a new in-memory hot store that lazily reads data from history when needed. Full details and links to relevant PRs to the codebase are available in
-
RCHAIN-3138Getting issue details...
STATUS
. The remaining work to complete the RSpace renovation work will be to optimize the system.
RNode optimizations
This release contains several changes to improve the user experience of RNode. For complete information on running RNode, please see User guide for running RNode.
Generate a public/private key pair via the command line
You can now generate a public/private key pair to use with RNode and on the RChain platform via the command line. Today this generates an ed25519 key pair. In the next release, as we move over to using secp256k1, this command line key generator will be updated to provide this type of key pair.
rnode keygen Generated public key: <public key> Generated private key: <private key>
Node fails if passed invalid paths to files
Previously if users provided an invalid path to a file in the run command such as --bonds-file
or --config-file
there was no feedback from RNode to indicate this was the cause of problems with operation after node startup. We resolve that in this release with a change that makes node fail immediately if the path to a file is invalid.
Completion of work to support blocks of all sizes with the addition of a circuit breaker
The release of RNode v0.9.5 completes the feature work to provide streaming of block messages of all sizes and provision for a circuit breaker to stop receiving a stream if the data received is too big. See RCHAIN-1496 for complete details. By default the circuit breaker is set at 200 MB. Users can customize this value by specifying using the flag --max-allowed-streamed-message
. RNode logs a warning when the circuit breaker breaks.
Locate RNode address in HTTP node information
This release adds the RNode address to the information provided via port 40403.
curl -s http://localhost:40403/status {"address":"rnode://18b72b3e6ddd5fd486f6fa3b69c9d94371d1791e@52.119.8.64?protocol=40400&discovery=40404","version":"RChain Node 0.9.5.git0fd89a5 (0fd89a5ca7902baa3aeae0bc9ac804ddade74ff0)","peers":6,"nodes":56}
Improved messaging from consensus
RNode operators now have better messaging from the consensus module at RNode startup to observe the execution of steps to request, receive, and process the approved genesis block and initialize the consensus module in RNode as part of the process of joining an RChain network. In addition to improving the RNode operator experience, this improved messaging supports debugging of issues at startup.
Work included in this release
Description of release packaging
Release packaging will include:
Docker image (Supported on Linux only)
Debian package
RPM package
.zip file
tar.gz file
Brew installation
Where do developers go to learn more and get started?
Please visit our release page on GitHub for binary artifacts.
A docker image is available
docker pull rchain/rnode
Homebrew installation via
brew install rchain/rchain/rnode
Where will bugs be filed?
We use Jira to collect bugs and feedback. File a bug
Where do developers go for support?
Please visit https://developer.rchain.coop or file a bug.
What license will this be released under?
The RChain software is licensed under Apache License, version 2.0
Rholang is licensed under the MIT License (MIT)
The Docker image is licensed under the GPL 2.0 License
Work completed since last release