v20
🔧 BitBadges Chain Upgrade — v20
📦 [Release v20](https://github.com/BitBadges/bitbadgeschain/releases/tag/v20) • 🆕 [Latest Release](https://github.com/BitBadges/bitbadgeschain/releases/latest)
Upgrade Name: v20
Upgrade Block Height: 7152000
Estimated Time: 11/26/2025, 12:42:06 PM EST
Summary of update: This upgrade introduces affiliate handling for gamm swaps and IBC hooks, deprecates native MsgTransferTokens affiliate address taking from protocol fees, fixes gamm amino names to match other modules, and includes minor tracking logic fixes.
🚨 Important Instructions for Node Operators
To successfully upgrade your node to v20 please follow these steps:
Download the New Binary
Download the latest v20 binary from the [release page](https://github.com/BitBadges/bitbadgeschain/releases/tag/v20).
Place Binary in the Correct Path
Move the new binary to:
<your_node_home>/cosmovisor/upgrades/v20/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/v20/bin/bitbadgeschaind
Verify Setup
Run the following to confirm the version and setup:
<your_node_home>/cosmovisor/upgrades/v20/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 v20
- Affiliates handling for gamm swaps and IBC hooks
- Deprecate native MsgTransferTokens affiliate address taking from the protocol fee
- Fix gamm amino names to match other modules
- Minor fixes within tracking logic
- Add alt time checks to approval criteria (collection, incoming, and outgoing) for denying transfers during specified UTC hours and days
- Add rate limit + taker fee
- More thorough error handling, especially via custom hooks