Heimdall v2 v0.2.4 (AMOY ONLY)

Announcements
1

Hi all, we have released a new version of heimdall-v2, v0.2.4

This solves a bug related to state syncs fetching (especially for nodes dealing with erigon clients).
Also, includes a fix for a command to decode VEs from heimdall txs. It’s recommended to upgrade asap to all nodes which performed a migration to v2 in Amoy.

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.

  1. Stop heimdalld service

    sudo service heimdalld stop

  2. Install heimdall with a version tag, network name (amoy), 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.4 <network> <node_type>

  3. Check heimdall version

    /usr/bin/heimdalld version

# It should print
# 0.2.4

  4. Restart heimdall service

    sudo service heimdalld start

  5. Restart the telemetry services

    sudo service telemetry restart

What’s Changed

WebSocket for Bor–Heimdall communication

Also, we remind you to enable WebSocket support in your bor config.toml for the migrated amoy nodes. file. After the migration, to optimize communication between Heimdall and Bor, you can (optionally) enable WebSockets. By default, heimdall-v2 polls bor by using frequent HTTP requests, which can be inefficient. Enabling WebSocket support reduces overhead and improves sync responsiveness.

Edit your bor config.toml file and add the following under the [heimdall] section:

[heimdall]
ws-address = "ws://localhost:26657/websocket"

This assumes Heimdall-v2 is running with its WebSocket endpoint enabled on port 26657.

Adjust the port or host if your setup differs.

After updating, restart your Bor node to apply the new configuration.

1 Like
2

Thanks for the update! Upgrading to Heimdall v0.2.4 is essential for Amoy nodes, especially to fix state sync issues with Erigon clients and decode VEs correctly. Remember to back up your config, stop the service, and run the installer with the right network and node type. Also, enabling WebSocket in Bor’s config improves communication efficiency with Heimdall. Don’t forget to restart Heimdall, telemetry, and your Bor node after changes. This update should enhance sync performance and stability - highly recommended for all migrated nodes!