Upgrade Lausanne Instructions (v2.3.0-bkc)

This upgrade contains 2025 Lausanne 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.3.0 from GitHub

// Download
wget https://github.com/kub-chain/bkc/releases/download/v2.3.0-bkc/geth2.3.0.linux-amd64.tar.gz
// Extact
tar -xvf ./geth2.3.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.3.0-bkc

Geth
Version: 2.3.0-bkc-stable
Git Commit: ccc47eed26444e7fc262705fd1c3561119da1664
Git Commit Date: 20250506
...

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

{
  ...
  lausanneBlock: <hard-fork-block>,
  ...
}

Apply new Genesis.json

/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