Skip to content

v0.24.0 - Hyperlane

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 23 Jun 10:37
v0.24.0
7207c48
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Hyperlane Integration

This release integrates the Hyperlane core and warp modules, enabling cross-chain messaging and token bridging between BitSong and EVM chains. Wiring is activated by the v024 on-chain upgrade handler.

⚠️ This is a STATE-BREAKING, coordinated upgrade. It must be applied at the governance-scheduled block height — NOT before.

⛔️ DO NOT upgrade before block 28760000

The upgrade is gated by an on-chain SoftwareUpgradeProposal with halt height 28760000 (≈ 2026-07-01, ~24h after the voting period ends).

  • Do not replace your binary before the chain halts at block 28760000. Running v0.24.0 early will cause an app-hash mismatch and your node will be unable to sync.
  • Keep running v0.23.1 until the chain reaches the upgrade height and halts.
  • At block 28760000 the chain stops; swap to v0.24.0 and resume.
  • Recommended: use Cosmovisor so the binary swap happens automatically at the halt height.

Changes

  • State-Breaking: Integrate Hyperlane core + warp modules via the v024 upgrade handler
  • Features: Hyperlane localnet tooling (chain init, bridge setup, EVM deploy, relayer orchestration, fantoken route + e2e tests)
  • Dependencies: Add hyperlane-cosmos v1.1.0; bump cosmos-sdk to v0.53.7, cometbft to v0.38.23, wasmd to v0.53.4

Upgrade Instructions

Recommended — Cosmovisor (automatic swap at halt height):

# Prepare the upgrade binary ahead of time; Cosmovisor swaps it in at block 28760000
mkdir -p ~/.bitsongd/cosmovisor/upgrades/v024/bin
cd go-bitsong
git fetch --tags && git checkout v0.24.0
make build
cp build/bitsongd ~/.bitsongd/cosmovisor/upgrades/v024/bin/
# Keep the node running on v0.23.1 — Cosmovisor handles the switch at the halt height.

Manual (only at the halt height):

# ONLY after the chain has halted at block 28760000
sudo systemctl stop bitsongd
cd go-bitsong
git fetch --tags && git checkout v0.24.0
make install
sudo systemctl restart bitsongd

Verify Installation

Check version:

bitsongd version
# Expected output: 0.24.0

Check full version details:

bitsongd version --long
# Expected: version: 0.24.0, cosmos_sdk_version: v0.53.7

Verify Binary Checksum

Linux (amd64):

wget https://github.com/bitsongofficial/go-bitsong/releases/download/v0.24.0/bitsongd-0.24.0-linux-amd64.tar.gz
wget https://github.com/bitsongofficial/go-bitsong/releases/download/v0.24.0/bitsongd-0.24.0-linux-amd64.tar.gz.sha256
sha256sum -c bitsongd-0.24.0-linux-amd64.tar.gz.sha256
# Expected: bitsongd-0.24.0-linux-amd64.tar.gz: OK

macOS (arm64):

shasum -a 256 -c bitsongd-0.24.0-darwin-arm64.tar.gz.sha256

Checksums (sha256):

Asset sha256
bitsongd-0.24.0-linux-amd64.tar.gz 62448e47cf7b6821e2b52b33134770686fa38791093742215f9b54f5426804bd
bitsongd-0.24.0-linux-arm64.tar.gz 2934810af32210400e1a9ea2a3dedb740762fb1cabf234009815adadb0e672a7
bitsongd-0.24.0-darwin-arm64.tar.gz f3a2896e3cdb3154c7b2776df321cbfa8c601667e4a7e75ba7fb2f1365cd572c

Available Binaries

Platform Architecture Status
Linux amd64 ✅ Available
Linux arm64 ✅ Available
macOS arm64 (Apple Silicon) ✅ Available
macOS amd64 (Intel) ⏸️ Temporarily unavailable
Windows amd64 ⏸️ Temporarily unavailable

Full Changelog: https://github.com/bitsongofficial/go-bitsong/blob/main/CHANGELOG.md

Assets 8
Loading