diff --git a/upgrade.html b/upgrade.html index 7b715f0..d6161ab 100644 --- a/upgrade.html +++ b/upgrade.html @@ -1,42 +1,45 @@ --- layout: base title: Network Upgrade ---
May 15, 2023 Upgrade

What happened?

The planned upgrade of the eCash network has successfully been completed. The first post-upgrade block is block number 792117.

Who needs to upgrade?

-

All operators of a Bitcoin ABC full node must upgrade to the latest major version (0.27.x). This includes Avalanche staking nodes, Miners and Exchanges. The up-to-date node version is available at our Releases page.

+

All operators of a Bitcoin ABC full node should have upgraded to the latest major version (0.27.x). This includes Avalanche staking nodes, Miners and Exchanges. The up-to-date node version is available at our Releases page.

+

I forgot to upgrade, what should I do?

+

If you forgot to upgrade and had an old node version running through the upgrade, your node may have marked the upgraded chain as invalid. In order to fix this problem, simply upgrade to Bitcoin ABC version 0.27.5 or greater, available at our Releases page. +This version includes a checkpoint that will cause the node to reconsider the upgrade block, and get back onto the correct chain tip.

What features are included in the Network Upgrade?

Consensus-enforced transaction version

The version field of eCash transactions is now restricted to versions 1 or 2 by the consensus rules. This means that blocks containing a transaction with a different version number can no longer be mined. The purpose of this change is to pave the way for future implementation of a new transaction format. It will allow the new transaction format to use a version number that has never been used before in the eCash blockchain. This rule was previously enforced by policy, so no wallet update is required.

Miner fund moved out of consensus rules

The miner fund, part of the block reward that is funding eCash network development, is no longer be enforced by consensus. It is now enforced by policy, and a block that contains an invalid or no miner fund output will be rejected by Avalanche Post-Consensus. This makes it easier to update the miner fund parameters such as the acceptable addresses.

Removed chained transactions limits

With the upgrade activated, Bitcoin ABC nodes now accept an unlimited number of chained transactions in the mempool. This was limited to 50 transactions before the upgrade. Note that this is a policy change and has no impact on the consensus rules.

How do I upgrade?

{% assign latestVersion = site.data.github-releases[0].name %}

The process of upgrading your node is straightforward: simply stop the currently running node, download the new version, and start the new version. Here are some example instructions for upgrading from version 0.26.13 to the latest version ({{ latestVersion }}) on Linux:

  • Shut down the node: ./bitcoin-abc-0.26.13/bin/bitcoin-cli stop
  • Download the new version archive from the website: wget https://download.bitcoinabc.org/{{ latestVersion }}/linux/bitcoin-abc-{{ latestVersion }}-x86_64-linux-gnu.tar.gz
  • Extract the archive: tar xzf bitcoin-abc-{{ latestVersion }}-x86_64-linux-gnu.tar.gz
  • Restart the node with the new version: ./bitcoin-abc-{{ latestVersion }}/bin/bitcoind -daemon
  • Clean up old version and archives (optional):
    • rm -rf bitcoin-abc-0.26.13
    • rm -f bitcoin-abc-0.26.13-x86_64-linux-gnu.tar.gz
    • rm -f bitcoin-abc-{{ latestVersion }}-x86_64-linux-gnu.tar.gz

Do I need to upgrade my wallet?

The network upgrade only affects full nodes. Other eCash software, including wallets such as Electrum ABC are not affected by the network upgrade.