Follow the operator portal for upgrade announcements.
For Validators
Consult the Validator Troubleshooting Guide for upgrade and recovery procedures, including validator signing state precautions.Summary
The Injective Chain upgrade tov1.21.0 is targeted for November 24, 2026, at block 193,145,000, as described in proposal 717. Follow the block height countdown for the latest estimate.
| Network | Mainnet, injective-1 |
| Upgrade plan | v1.21.0 |
| Target halt height | 193,145,000 |
| Target date | November 24, 2026. Block countdown |
| Mainnet release | v1.21.0-1794954936 |
| Binary source commit | a13b8b7 |
- Wait for the node to halt at block height 193,145,000.
- Stop the process and back up configs, data and validator signing state.
- Remove the Wasm cache after the backup.
- Install the v1.21.0 binaries and bundled runtime library.
- Verify the binary versions,
libwasmvmchecksum and loaded library version 2.2.11-rc.4. - Restart the node with the new binary version.
Recovery
Prior to exporting chain state, validators are encouraged to take a full data snapshot at the export height before proceeding. Snapshotting depends heavily on infrastructure, but generally this can be done by backing up the.injectived directory.
It is critically important to backup the .injectived/data/priv_validator_state.json file after stopping your injectived process. This file is updated every block as your validator participates in consensus rounds. It is a critical file needed to prevent double-signing in case the upgrade fails and the previous chain needs to be restarted.
In the event that the upgrade does not succeed, validators and operators must restore the snapshot and downgrade back to Injective Chain release v1.20.4-safeharbor.5 and continue this earlier chain until the next upgrade announcement.
Official snapshots taken before the upgrade will be provided on the Chain Snapshots page so operators can roll back and restore from a snapshot in a worst-case recovery scenario. If an operator makes a mistake during the upgrade or encounters errors, follow the Validator Troubleshooting Guide, including its snapshot recovery and validator signing-state precautions.
Upgrade Procedure
Notes for Validators
Wait for the chain to halt at 193,145,000 before replacing the active binary. Stopinjectived fully before backing up data and validator signing state.
After the backup and before starting the new binary, remove the Wasm cache from the actual node home. For the default home:
Steps
-
Verify you are running
v1.20.4-safeharbor.5before the upgrade:Expected version: -
Wait for the node to halt at 193,145,000, then confirm
injectivedhas stopped. Make a backup of your.injectiveddirectory:Preservedata/priv_validator_state.jsonafter shutdown. Remote signer operators must preserve their signer’s state. -
Download the Linux amd64 archive from the official release, verify the published archive checksum, extract it, and install the release binaries and bundled runtime library:
-
Validate the installed
libwasmvmlibrary:Expected output:Validate that the installed binary loads the correct library version:Expected output:For the Docker image, check the bundled library version with:Expected output: -
Verify the installed
injectivedreports v1.21.0 and the build commit published in the release notes:Expected output: -
Start
injectived: -
If you run
peggo, verify its version against the release notes:Expected output: -
Start
peggoif you operate the bridge orchestrator:
With Cosmovisor
Before the halt, stage the verified binary under the exact upgrade plan name:v1.21.0. Verify the active version and confirm synchronization and validator participation after restart.