Upgrade Log

For each upgrade of the network, we will track important changes for node operators' deployments.

2020-11-18 (16:00 UTC) - Mainnet (Upcoming)

  • Block height when Mainnet Beta network stops: 702000.

We expect the Mainnet Beta network to reach this block height at around 2020-11-18 13:30 UTC.

  • Upgrade window:

    • Start: 2020-11-18T16:00:00Z.

    • End: After nodes representing 2/3+ stake do the upgrade.

Instructions

  • Download Oasis Node version 20.12.2, while continuing to run version 20.10.x.

  • (optional) Use Oasis Node version 20.12.2 to dump network state at the specified block height. It will connect to the running version 20.10.x node.

  • Download the Mainnet genesis file published in the 2020-11-18 release.

  • (optional) Verify the provided Mainnet genesis file by comparing it to network state dump. See instructions in the Handling Network Upgrades guide.

  • Replace the old Mainnet Beta genesis file with the Mainnet genesis file.

  • Stop your node.

  • Remove the old 20.10.x version of Oasis Node.

  • Update your node's configuration per instructions in Configuration changes below.

  • Start your node.

This time, we recommend dumping the network state with the upgraded Oasis Node binary so that the genesis file will be in the canonical form.

The canonical form will make it easier to compare the obtained genesis file with the one provided by us.

For more detailed instructions, see the Handling Network Upgrades guide.

Configuration changes

Since we are upgrading to the Mainnet, we recommend you change your node's configuration and disable pruning of the consensus' state by removing the consensus.tendermint.abci.prune key.

For example, this configuration:

...
# Consensus backend.
consensus:
# Setting this to true will mean that the node you're deploying will attempt
# to register as a validator.
validator: true
# Tendermint backend configuration.
tendermint:
abci:
prune:
strategy: keep_n
# Keep ~7 days of data since block production is ~1 block every 6 seconds.
# (7*24*3600/6 = 100800)
num_kept: 100800
core:
listen_address: tcp://0.0.0.0:26656
...

Becomes:

...
# Consensus backend.
consensus:
# Setting this to true will mean that the node you're deploying will attempt
# to register as a validator.
validator: true
# Tendermint backend configuration.
tendermint:
core:
listen_address: tcp://0.0.0.0:26656
...

2020-10-01 - Mainnet Beta

Instructions

You should keep using Oasis Core version 20.10.

For more detailed instructions, see the Handling Network Upgrades guide.

2020-09-22 - Mainnet Dry Run

Instructions

  • This is the initial deployment.