Heimdall v2 v0.2.10 for Mainnet and Amoy

Sanket_Polygon · July 14, 2025, 12:31pm

This version includes the following key improvements and fixes:

Bridge Listener Module Fix:

Resolved timeout issues when fetching events by dynamically determining the fromBlock value based on the chain.
Clerk Module Optimisation:

Improved the /clerk/event-records/list?page=<page>&limit=<limit> and /clerk/event-records/count endpoints by preventing the entire database from being loaded into memory. This results in significantly better performance and reduced memory usage.
Documentation Update:

Updated migration-related documentation.
Error Handling Fix:

Corrected an inaccurate error message that previously caused confusion during a specific edge case.

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.

Stop heimdalld service
```
sudo service heimdalld stop
```

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.10 <network> <node_type>

Check heimdall version

/usr/bin/heimdalld version

# It should print
# 0.2.10

Restart heimdall service
```
sudo service heimdalld start
```
Restart the telemetry services
```
sudo service telemetry restart
```

What’s Changed

update migration versions by @marcello33 in #361
Fix wrong error message by @avalkov in #362
start block for heimdall v2 listener by @marcello33 in #363
opt: GetEventRecordList and GetEventRecordCount by @kamuikatsurgi in #358

Full Changelog: v0.2.9…v0.2.10

Docker Images

You can find the latest docker images here:

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

Thanks,

Polygon Team

hacxx · July 15, 2025, 7:40am

Thanks for the detailed update! Heimdall v0.2.10 brings important fixes like dynamic fromBlock handling to prevent timeouts, optimized database queries for better performance, and clearer error messages. The upgrade steps are straightforward - remember to back up your config before updating. Also, updated docs and Docker images are available for easy deployment. Overall, this release improves stability and efficiency for Mainnet and Amoy nodes. Great work by the Polygon team!