v21
🔧 BitBadges Chain Upgrade — v21
📦 [Release v21](https://github.com/BitBadges/bitbadgeschain/releases/tag/v21) • 🆕 [Latest Release](https://github.com/BitBadges/bitbadgeschain/releases/latest)
Upgrade Name: v21
Upgrade Block Height: 7510000
Estimated Time: 12/14/2025, 10:52:18 AM EST
Summary of update: This upgrade introduces the mustPrioritize flag for approval criteria to control auto-scan functionality, adds support for badgeslp wrapped denominations in coin transfers, and improves validation logic for better code quality and readability.
🚨 Important Instructions for Node Operators
To successfully upgrade your node to v21 please follow these steps:
Download the New Binary
Download the latest v21 binary from the [release page](https://github.com/BitBadges/bitbadgeschain/releases/tag/v21).
Place Binary in the Correct Path
Move the new binary to:
<your_node_home>/cosmovisor/upgrades/v21/bin/
Ensure Correct Naming
Rename the binary file to:
bitbadgeschaind
This is required for nodes using the default Cosmovisor configuration.
Check Executable Permissions
Ensure the binary is executable:
chmod +x <your_node_home>/cosmovisor/upgrades/v21/bin/bitbadgeschaind
Verify Setup
Run the following to confirm the version and setup:
<your_node_home>/cosmovisor/upgrades/v21/bin/bitbadgeschaind version
Cosmovisor Will Auto-Switch
Cosmovisor will automatically switch to the new binary at the specified block height. If your node does not have the correct setup, it will halt and could be slashed.
📚 For full setup and operational details, see the [Run a Node documentation](https://docs.bitbadges.io/for-developers/bitbadges-blockchain/run-a-node).
📝 Notable Changes in v21
- Added mustPrioritize flag to approval criteria (collection, incoming, and outgoing) to control auto-scan functionality - when set to true, approvals must be explicitly prioritized in PrioritizedApprovals to be used
- Added support for badgeslp wrapped denominations in coin transfers - badgeslp: prefixed denoms now use badge module transfer functions for underlying badge transfers (still subject to allowed denoms though)
- Improved validation logic for better code quality and readability with more restrictive checks
- Improved auto scannability functionality to not include amount threhsolds or max num transfer thresholds by default
- Fixed issue with IBC denom expansion in coin transfers