Heimdall v2 v0.2.12 for Mainnet and Amoy

Announcements
1

Heimdall v2 v0.2.12

This version includes the following key improvements and fixes:

  • Checkpoint validation cache:

    Improved the speed at which checkpoints vote extensions get verified and gossiped around the network by introducing cache for calls to bor.

  • GetSpanList & GetCheckpointList:

    Clearer validation and error messages for missing pagination or excessive limits.

  • GetRecordList:

    Page cannot be 0 anymore. Limit must be 1–50. Exceeding this throws a hard error (previously was truncated). Removed default fallback behavior; strict validation now enforced.

  • GetRecordListWithTime:
    Deprecated custom pagination logic (filterWithPage) in favor of proper iterator-based pagination. Added skipping using offset, early stopping after hitting limit. Returns clean error if FromId < 1 or Limit invalid.

Steps for upgrading Heimdall:

Before proceeding, please create a backup of your heimdall config file whose default location is: /var/lib/heimdall/config/config.toml. This might differ if you have setup heimdall at a different location.

sudo service telemetry restart

  1. Stop heimdalld service

    sudo service heimdalld stop

  2. Install heimdall with a version tag, network name, and node type (sentry or validator).

    # Replace the network and node type
curl -L https://raw.githubusercontent.com/maticnetwork/install/heimdall-v2/heimdall-v2.sh | bash -s -- v0.2.12 <network> <node_type>

  3. Check heimdall version

    /usr/bin/heimdalld version

# It should print
# 0.2.12

  4. Restart heimdall service

    sudo service heimdalld start

  5. Restart the telemetry services

    sudo service telemetry restart

What’s Changed

Full Changelog: v0.2.10…v0.2.12

Docker Images

You can find the latest docker images here:

Heimdall:https://hub.docker.com/r/0xpolygon/heimdall-v2/tags

Thanks,

Polygon Team