Upgrade Basel Instructions (v2.4.0-bkc)

This upgrade contains 2026 Basel hard fork

⭐ Before Upgrading

• 🚨 This upgrade may involve some downtime. Please ensure you have a maintenance plan in place before proceeding with the following upgrade instructions.

• 🚨 During the upgrade, your Geth node will be temporarily unavailable to the KUB Chain network. After upgrading to the new version, the node may take approximately 5 to 15 minutes to resynchronize with the latest blockchain head.

• We strongly recommend creating a disk snapshot before upgrading to prevent any potential data loss during the process. (Optional)

⭐ Instructions

1. Stop Geth

Please make sure that your Geth node is stopped before the upgrade.

systemctl stop geth

2. Update Geth

Download the Geth v2.4.0 from GitHub

## Download
wget https://github.com/kub-chain/bkc/releases/download/v2.4.0-bkc/geth2.4.0.linux-amd64.tar.gz
## Extact
tar -xvf ./geth2.4.0.linux-amd64.tar.gz -c /usr/bin/

Allow file permission

sudo chmod +x /usr/bin/geth

Make sure you have downloaded the upgraded version

/usr/bin/geth version

Then you should see the binary version. It should be v2.4.0-bkc-stable

Geth
Version: 2.4.0-bkc-stable
Git Commit: 28cb5603e9c866a0ff67c5e0520274adf819402a ## this maybe different
Git Commit Date: 20260303 ## this maybe different
...

3. Update Genesis.json

Download the latest genesis.json

# Download the genesis file
wget https://raw.githubusercontent.com/kub-chain/bkc-node/main/mainnet/genesis.json

Make sure the version that you have downloaded contains the hard fork config.

cat ./genesis.json

The output should contain the following

{
  ...
  "baselBlock": {
      "block": 31237946,
      "superNode": "0xcf723fE5a8118efE70D3fAdd56C5e6D01aDeC7A3",
      "superNodeOwner": "0x5106ffca7cC44E6cFfEE9bD016A0934130b0322f",
      "period": 3
  },
  ...
}

Apply new Genesis.json

Make sure the data directory of Geth, it will be different from the instruction.

/usr/bin/geth --datadir /bkc-node/mainnet/data init ./genesis.json

4. Start the Geth service

systemctl start geth

Check the outputs/logs to make sure that everything runs properly

journalctl -fu geth