Head back to Documentation
This document pertains to the upcoming bromine hardfork which is currently in testnet.
If you’re looking to get involved with testnet, head over to our testnet node documentation page.
There’s nothing you need to do unless you are
To clarify, if you’re someone who’s holding QRL in a wallet, whether that’s a hardware wallet, one of our desktop wallets, or otherwise, there’s no action needed on your part. The exception to that is if you want to take advantage of new features like multisignature addresses and transactions.
If you’re running your own node, you’ll want to perform an update when we do a release of the next hardfork but before the next hardfork date.
The latest code will automatically switch over to the new mining algorithm and new features at blockheight 942375. At that point in the chain all new features will be live and old instances of the node will be rejected. Update nodes prior to this blockheight.
There’s no need to download the whole blockchain again during this process however there is a revalidation of the state that will take place. This revalidation may take anywhere from 5 to 7 hours to complete. While the revalidation process is underway the node will be unresponsive.
There is some downtime to upgrade the node however we have minimized the impact as much as possible. Please allow for this time when updating a node to the latest.
Update: Using pip
Most people already running a node will have done so through the pip install which can be found in our documentation at docs.theqrl.org/node/QRLnode/.
To update, you’ll first want to stop your node, then run the command:
pip3 install qrl --upgrade
Then start the node and check the state which contains the version
start_qrl qrl state
There’s two ways to run a node now. You can run a python node or a docker node.
Tip: Regardless of what node you choose to run, syncing the state can take a while, so you’ll want to install as soon as we do a release before the final hard fork date if you’re mining the moment the fork happens. There will be a note to prompt people to do so when we release.
Docker has a few benefits:
The main downside of qrl-docker is when it comes to mining, you’re going to be seeing a loss in hashrate.
To start a docker node, you’ll want to follow our docker node instructions
To start a python node, you’ll want to follow python node instructions here
You’ll need to get acquainted with the Hardware required to mine randomX and select a pool to mine from.
You can find more information on this at pool mining.
Stop the QRL wallet daemon REST proxy
Either Ctrl-C or kill the process
The following command will upgrade the QRL node:
pip3 install qrl --upgrade
Please note it will take around 6 to 7 hours to finish the state migration process.
Once it has been finished proceed to further steps.
To take advantage of multisignature transactions, you’ll need to update to the latest QRL wallet which will be released after the hardfork takes place.