Upgrade to v4.x
This upgrade moved cheqd to support Cosmos SDK v0.50 "Eden".
Cosmos SDK v0.50 is a long-term support version bringing major improvements in performance, developer experience, and modularity. Key features include ABCI++ for more flexible and efficient consensus and IAVL 1.0 for faster and more efficient data storage. It also adds Optimistic Execution to reduce block times and Sign Mode Textual for clearer, more secure transaction signing. This release sets a solid foundation for building faster, more customizable applications on cheqd.
We also enhanced our DIDs to support a more flexible service section, enabling direct connections to did:cheqd
DIDs using DIDComm. This enhancement brings full cheqd support for DIDComm endpoint discovery, making it easier for apps and SDKs like ACA-Py and Credo to integrate seamless messaging and communication.
You can find more technical details about this upgrade on our product docs page.
Actions that should be taken
If you're running your node with Cosmovisor and have the binary auto-download feature enabled, no action is required.
In case you run standalone node, you can download the
v4.1.1
binary from our GitHub Releases page and replace them manually on your node.
⚠️ Potential errors with binary auto download on Cosmovisor v1.7.1
In case you are running Cosmovisor v1.7.1, you might see one potential error when upgrade height is reached. Apparently, even though binary is correctly downloaded to /home/cheqd/.cheqdnode/cosmovisor/upgrades/v4
, the wrong file (the LICENSE file) gets copied to bin/cheqd-noded
. As a result, your node won’t start after the upgrade.
We suspect this issue is related to upstream Cosmos SDK x/upgrade
module, and we will investigate separately of this release.
ℹ️ This does not present a danger to your node state, but node won't start until you replace binaries.
🛠️ How to Prevent This Issue
You have two options:
Re-run interactive installer to make sure you're running Cosmovisor v1.3.0 before upgrade height is reached. You will get asked if you want to roll back to Cosmovisor v1.3.0. If you already used interactive installer, just make sure to download the latest one from the link above, before the execution.
Alternatively, you can replace binaries when upgrade height is reached. You can achieve this with one simple command:
cp -P /home/cheqd/.cheqdnode/cosmovisor/upgrades/v4/cheqd-noded /home/cheqd/.cheqdnode/cosmovisor/upgrades/v4/bin/cheqd-noded
To confirm this resolved you issue, just run this:
cheqd-noded version
Check Cosmovisor version
To determine whether you need to take any action, check your current Cosmovisor version:
cosmovisor --help
If you're running version later than v1.3.0, you will see output like this:
Available Commands:
add-batch-upgrade Add multiple upgrade binaries at specified heights to cosmovisor
add-upgrade Add APP upgrade binary to cosmovisor
completion Generate the autocompletion script for the specified shell
config Display cosmovisor config.
help Help about any command
init Initialize a cosmovisor daemon home directory.
prepare-upgrade Prepare for the next upgrade
run Run an APP command.
show-upgrade-info Display current upgrade-info.json from <app> data directory
version Display cosmovisor and APP version.
In v1.3.0, these upgrade-related commands are not available (add-batch-upgrade, add-upgrade, prepare-upgrade):
Available Commands:
completion Generate the autocompletion script for the specified shell
help Help about any command
init Initializes a cosmovisor daemon home directory.
run Run an APP command.
version Prints the version of Cosmovisor.
To summarize, if you see the second (shorter) output above, you're good to go! ✅
If not, refer back to the previous section and either:
Roll back to v1.3.0, or
Manually replace the binaries at the upgrade height.
If anything's unclear or if you face any additional issues, you can always ask for support on our #mainnet-operators Discord channel! Also, follow the updates on our status page and 🔊mainnet-upgrades Discord channel.
Last updated
Was this helpful?