Releases: LumeraProtocol/lumera
Release list
v1.20.1
evmigration + upgrades: v1.20.1 hotfix hardening
Squash-merge PR #184 — validator-migration scaling, correctness fixes, and state-driven v1.20.1 EVM bring-up.
Summary
- Faster validator migration. The hot path now scales with the migrating validator's own footprint instead of global chain state. Scoped staking/distribution reads replace full-chain scans, redundant staking reads are removed, and historical-rewards refcount updates collapse into a single deterministic write.
- Live-network correctness fixes. Non-jailed Unbonded validators are now allowed to migrate; delegation starting stake is stored as tokens rather than shares; scoped redelegation replay is deterministic; and action re-keying is scoped through action secondary indexes instead of scanning all actions.
- Claim records left frozen. Claim-record re-keying is removed from migration, and devnet verification is updated to match — claim state is frozen/reference-only, so leftover claim rows are expected.
- State-driven upgrade routing. v1.20.1 behavior is now routed by chain state rather than chain-id alone. Chains that never initialized EVM run the full v1.20.0 bring-up through v1.20.1; chains that already ran v1.20.0 take the migration-only hotfix path.
- Add-only store loader. The new v1.20.1 loader mounts only missing EVM stores and fails closed on impossible/partial state — it never deletes, renames, or blindly re-adds stores.
- Devnet wiring. Release wiring and scripts are updated for the v1.20.1 EVM upgrade path: the devnet-evm-upgrade target, binaries config, uploader gRPC port, and a devnet module-dependency tidy after the x/net security bump.
- Docs. The hotfix is documented in the CHANGELOG and EVM migration docs, including benchmark/scaling evidence and the state-driven v1.20.1 upgrade design.
Validation before merge
- PR state: open, approved, mergeable, mergeStateStatus=CLEAN.
- Checks: CodeQL, lint, unit, integration, simulation, determinism, system, and build all passed.
- Local review: branch clean and matching head 400e8ea.
- Upgrade tests: go test ./app/upgrades ./app/upgrades/v1_20_0 ./app/upgrades/v1_20_1 passed locally.
- Devnet rehearsal: devnet/logs/evm-upgrade-20260706-1351.log ended with devnet-evm-upgrade completed successfully. Final stats: migrated=92, legacy_staked=0, validators_migrated=5, validators_legacy=0; all validator verification reported clean migrated addresses.
Safety notes
- Partial EVM module state is treated as an error, not silently skipped during EVM finalization.
- The add-only store loader never emits deletions or renames, and no longer falls back to a blind standard store loader if committed store-name inspection fails.
- Mainnet can one-hop from v1.12.0 → v1.20.1, while devnet/testnet chains that already ran v1.20.0 stay on the migration-only hotfix path.
Tag: v1.20.1
Commit: 4ce27cf
Installation:
- Extract the archive
- Run
sudo ./install.shto install required libraries - Run the binary:
./lumerad
v1.20.0 - Aurora Convergence
v1.20.0 — Aurora Convergence
Aurora Convergence is a major Lumera release introducing full EVM compatibility alongside the existing Cosmos SDK and CosmWasm runtime.
This release expands Lumera access for MetaMask users, EVM developers, Solidity smart contracts, JSON-RPC tooling, and ERC20-style asset flows — without replacing the Cosmos-native architecture.
Highlights
- Added Cosmos EVM v0.6.0 integration
- Added EVM modules:
x/vm,x/feemarket,x/precisebank,x/erc20 - Added Ethereum-compatible key derivation using
eth_secp256k1and coin type60 - Added 18-decimal EVM precision through
alume, bridged to native 6-decimalulume - Added
x/evmigrationfor migrating legacy Lumera accounts to Ethereum-compatible addresses - Added JSON-RPC, EVM indexer, OpenRPC discovery, tracing, and EVM mempool support
- Added EVM precompiles for native Lumera modules, including Action, SuperNode, Wasm, bank, staking, distribution, gov, slashing, ICS20, Bech32, and P256
- Added Phase 1 of the CosmWasm ↔ EVM bridge
- Added IBC ERC20 middleware for v1 and v2 transfer stacks
- Added upgrade/config migration logic for EVM, JSON-RPC, TLS, and Lumera node settings
- Updated dependencies to address critical and high-severity security issues
Notes
This release introduces important compatibility changes around account derivation, address format, and denomination precision. Operators and integrators should review the changelog and EVM documentation before upgrading.
Full EVM documentation:
https://github.com/LumeraProtocol/lumera/blob/master/docs/evm-integration/main.md
Full CHANGE LOG:
https://github.com/LumeraProtocol/lumera/blob/master/CHANGELOG.md
Tag: v1.20.0
Commit: 7b8a028
Installation:
- Extract the archive
- Run
sudo ./install.shto install required libraries - Run the binary:
./lumerad
NOTE: lumera_linux_amd64.tar.gz and lumera_v1.20.0_linux_amd64.tar.gz are the SAME, different names to satisfy auto scripts
v1.20.0-rc5
DO NOT USE! This is pre-release version.
v1.20.0-rc4
DO NOT USE! This is pre-release version.
v1.20.0-rc3
DO NOT USE !! THIS IS PRE-RELEASE ONLY
v1.12.0 Aurora Zenith
🚀 Lumera v1.12.0
Tag: v1.12.0
Commit: b64a33b
Changes included since v1.11.1
Compare range: v1.11.1...v1.12.0
🌊 Cascade & Storage
-
Added LEP-5 — Cascade Availability Commitments, including:
- BLAKE3 Merkle commitments
- Chunk proofs
- Commitment validation
- SVC proof verification
- Integration, system, and devnet coverage
-
Added LEP-6 — Storage-Truth Foundation scaffolding in
x/audit/v1, including:- Storage-truth messages
- Scoring and state support
- Query support
- Pruning
- Broad keeper and system test coverage
🌅 Everlight Phase 1
-
Added Cascade Everlight Phase 1 in
x/supernode, including:STORAGE_FULLSuperNode state- Reward distribution parameters, state, and queries
- Periodic pool distribution
- Registration-fee routing
v1.12.0upgrade initialization
-
Improved Everlight devnet tests, genesis defaults, epoch-boundary handling, and upgrade-handler completeness for post-
v1.11.1defaults.
🔐 Ledger & Release Builds
- Added Ledger build support.
- Pinned release builds to Ubuntu 22.04 for improved
glibccompatibility.
🧩 Consensus & Determinism
- Replaced consensus-sensitive protobuf maps with deterministic concrete structures.
- Added consensus-determinism CI coverage.
🛠️ Fixes
- Fixed Audit and SuperNode AutoCLI query marshalling issues, including:
float64query argumentsget-metricswiring
📦 Release Metadata
- Tag:
v1.12.0 - Commit:
70905813d2feac6ba047e9a65eee03db7968a9ec
⚙️ Installation
-
Extract the release archive.
-
Install required libraries:
sudo ./install.sh
-
Run the binary:
./lumerad
v1.20.0-rc2
pre-release - DO NOT USE
v1.12.0-rc2
docs: update Everlight funding model
Tag: v.1.12.0-rc2
Commit: 80a4b00
Installation:
- Extract the archive
- Run
sudo ./install.shto install required libraries - Run the binary:
./lumerad
v1.12.0-rc
Everlight (#113)%0A%0AEverlight %0A%0ACo-authored-by: Matee ullah Malik mateeullahmalik@hotmail.com
Tag: v1.12.0-rc
Commit: 7ca770a
Installation:
- Extract the archive
- Run
sudo ./install.shto install required libraries - Run the binary:
./lumerad
v1.11.1-hotfix
Hotfix: bad EVIDENCE_TYPE_CASCADE_CLIENT_FAILURE
Tag: v1.11.1-hotfix
Commit: d81d905
Installation:
- Extract the archive
- Run
sudo ./install.shto install required libraries - Run the binary:
./lumerad