Bor v2.2.11-beta2 and Heimdall v0.3.1 hot fix release for Polygon Mainnet

Announcements
1

Hi all, in the light of issues encountered Polygon Mainnet today, we’ve released versions of bor and heimdall to address them.

Bor v2.2.11-beta2

A new cli subcommand has been added to prune local whitelisted entries for checkpoints and milestones.

Steps for upgrading Bor node

  1. Stop bor service

    sudo service bor stop

  2. Install Bor with a version tag, network name (amoy, mainnet), and node type (sentry, validator, or archive).

    # Replace the node type
curl -L https://raw.githubusercontent.com/maticnetwork/install/main/bor.sh | bash -s -- v2.2.11-beta2 <network> <node_type>

  3. Check bor version

    /usr/bin/bor version

# It should print 
# v2.2.11-beta2

  4. Purge local whitelisted entries

    bor purge-whitelisted-entries --datadir <datadir>

  5. Restart bor service

    sudo service bor start

  6. Rewind bor to 1 block before the incorrect milestone via IPC. This translates to block 76273069.

    debug.setHead("0x48BD5AD")

Please find the full change log in the github release: https://github.com/0xPolygon/bor/releases/tag/v2.2.11-beta2

Heimdall

We have released a new version of heimdall-v2 v0.3.1 for Polygon mainnet.

This is a hardfork release, scheduled for September 10th 2025, at around 15:00 UTC (block number 28525000)

It addresses an ongoing issue detected on mainnet, and it contains the following changes: hotfix: milestone deletion by @marcello33 in #457

Full Changelog: https://github.com/0xPolygon/heimdall-v2/compare/v0.3.0…v0.3.1

Steps for upgrading Heimdall:

  1. Stop heimdalld service

    sudo service heimdalld stop

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

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

  3. Check heimdall version

    /usr/bin/heimdalld version

# It should print
# 0.3.1

  4. Restart heimdall service

    sudo service heimdalld start

  5. Restart the telemetry services

    sudo service telemetry restart

Docker Images

You can find the latest docker images here:

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

Thanks,

Polygon Team

Docker Images

You can find the latest docker images here:

Bor: https://hub.docker.com/r/0xpolygon/bor/tags

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

Thanks,

Polygon Team

1 Like
2

Seems heimdalld service is still panic. There is the panic log context.

image
image1920×737 232 KB

1 Like
3

face below issue in beta version in heimdalld service

Screenshot 2025-09-11 at 11.17.20 AM
Screenshot 2025-09-11 at 11.17.20 AM1920×1080 429 KB

1 Like
4

Hey all,

If you see this panic please try rolling back your heimdall by one block:

heimdalld rollback --home /var/lib/heimdall
​
It can be a little slow (takes 5 mins or so) but it should help your node progress. Also make sure you are on the latest version.

Please let us know if the issue still persists.

Thanks!

2 Likes
5

i ‘m instaling from scratch with the new heimdall v0.3.1 is the installer different than before ? it does not create service anymore

curl -L https://raw.githubusercontent.com/0xpolygon/install/heimdall-v2/heimdall-v2.sh | bash -s – v0.3.1 mainnet sentry

and heimdalld crash if i create the service myself (i run sentry rpc node , not validator)

ERR no file exist corresponding to this path: /var/lib/heimdall/config/priv_validator_key.json
root@65-108-111-212 ~ # heimdalld version --longname: heimdallserver_name: heimdalldclient_name: heimdalldversion: 0.3.1commit: fd60589930f4f635e8fdf7e1f9dd92436616a0b0go: go version go1.24.7 linux/amd64root@65-108-111-212 ~ # this is what the heimdalld-v2 script installed in the config folder: root@123 /var/lib/heimdall/config # ls app.toml client.toml config.toml

6

Please make sure you use the main branch, the link should be this: https://raw.githubusercontent.com/0xpolygon/install/main/heimdall.sh