Heimdall v0.2.2 Released

Hi Validators and Partners,

The latest version, heimdall v.0.2.2 contains few enhancements and bug fixes as listed below:

  • Configurable Max Gas Price for Checkpoints: We have introduced a config option where we can set the max gas price in heimdall-config.toml file with the flag main_chain_max_gas_price. The default is 400 gwei:

    # heimdall-config.toml
    main_chain_max_gas_price = "400000000000"

    This has been added to mitigate instances where very high fee was paid for submitting checkpoint txs on the main chain (ethereum).

  • Child Chain min Block Confirmations in Side Channel: While submitting a checkpoint, the proposer node validates if at least maticchain_tx_confirmations no of blocks have passed since the end_block of the checkpoint being proposed. This check is now implemented in nodes other than the proposer in the side channel.

  • Merging Mumbai and Mainnet Branches: We had two different branches as a parameter was different for mumbai and mainnet. We have now incorporated a new config file for chain specific parameters. While setting up a node, an additional parameter called network has to be passed to the make install command to generate this new config file. If nothing is passed, config for mainnet is generated:

    make install             			#Will generate for mainnet
    make install network=mumbai			#Will generate for mumbai
    make install network=local			#Will generate for local devnet
  • Setu/Bridge - Handling non-contiguous nonce: Earlier, when multiple staking txns from the same account were submitted within a short interval (< 2 * block time of heimdall), the second txn would fail as the first one takes 2 blocks to get confirmed due to side channel. Due to the gap in the nonce, all subsequent txns from the same account would also fail. We have now handled this scenario by ensuring the second txn is retried after a sufficient amount of time ensuring that it goes through eventually without creating any gaps in the nonce.

Instructions to Upgrade:

To upgrade to the latest version (https://github.com/maticnetwork/heimdall/releases/tag/v0.2.2), please follow the below instructions:

  1. SSH to your sentry and validator nodes and navigate to the heimdall directory:

    cd ~/heimdall
  2. Fetch the latest changes and switch to v0.2.2:

    git fetch
    git checkout v0.2.2
  3. Build the latest code:

    make install network=mainnet

    Note: if you are also running a node on mumbai network, you will have to run make install network=mumbai

  4. Restart heimdall and other services:

    sudo service heimdalld restart
    sudo service heimdalld-bridge restart
    sudo service heimdalld-rest-server restart

Let us know if you have any questions.

Thank you.