Bor v2.5.3 and Heimdall v0.5.2 for all networks

Sanket_Polygon · December 4, 2025, 2:46pm

Hi all, we have released a new stable version for bor, v2.5.3 , and a new stable version of heimdall, v0.5.2 for Polygon Mainnet. We recommend to install these versions on all networks.

Bor

Bor v2.5.3 is a maintenance release containing improvements and bugs’ fixes.

It doesn’t change the behaviour for the upcoming Madhugiri mainnet HF, happening on Tuesday, Dec 9th at around 10.00 UTC, at block 80084800 .

Steps for upgrading Bor node

Stop bor service
```
sudo service bor stop
```

Install Bor with a version tag, network name (mainnet/amoy), 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.5.3 <network> <node_type>

Check bor version

/usr/bin/bor version

# It should print 
# v2.5.3

Restart bor service

What’s Changed

feat: add metrics for pebbledb read/writes by @jhkimqd in #1900
merge master to develop by @marcello33 in #1908
chore: fix some typos in comment by @russcoss in #1804
Enable block stm for non witness producers by @lucca30 in #1911
updated auto generated docs by @pratikspatil024 in #1912
core(txpool): align with geth by @kamuikatsurgi in #1903
security improvements by @marcello33 in #1914
bug fix: core/rawdb: apply ancient db offset to the freezer by @pratikspatil024 in #1915
v2.5.3 candidate by @marcello33 in #1917

New Contributors

@jhkimqd made their first contribution in #1900
@russcoss made their first contribution in #1804

Full Changelog: v2.5.2…v2.5.3

Heimdall

This is a maintenance release containing improvements and bugs’ fixes.

It also sets the block height for the upcoming mainnet HF, scheduled for Tuesday, December 16th at around 12:00 UTC, block 34966593.

This release can be used on mainnet and amoy.

Also, it’s the first stable release shipping the new online pruning solution, helping node operators drastically reduce the disk size for heimdall, and keeping it stable going forward. To enable it:

on config.toml:

[storage]
compact = true
compaction_interval = 1000

[storage.pruning]
interval = "3h"
indexer_pruning_enabled = true

on app.toml:

min-retain-blocks = 2500000

Check ./packaging/templates/config/amoy/app.toml or ./packaging/templates/config/mainnet/app.toml for more info and comprehensive descriptions for each variable.

Steps for upgrading Heimdall:

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

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

Check heimdall version

/usr/bin/heimdalld version

# It should print
# 0.5.2

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

What’s Changed

revert: rio height to 256 by @kamuikatsurgi in #489
chore: bump kurtosis-pos by @kamuikatsurgi in #490
opt: RPC Calls in Milestone Block Fetching by @kamuikatsurgi in #491
chore: bump kurtosis-pos by @kamuikatsurgi in #494
perf(milestone): optimize RPC calls in block fetching by @kamuikatsurgi in #493
Pruner Optimization by @lucca30 in #496
fix releaser by @lucca30 in #497
Backporting Main to Develop by @lucca30 in #500
Set producer planned downtime by @avalkov in #472
Removing main/master package trigger by @djpolygon in #502
Enable test for SetValidatorDowntime tx by @avalkov in #501
chore: backport main to develop by @kamuikatsurgi in #505
refactor: omit unnecessary reassignment by @rifeplight in #508
misc fixes and improvements by @marcello33 in #507
Producer downtime tx HF block by @avalkov in #509
v0.5.2 candidate by @marcello33 in #511

New Contributors

@rifeplight made their first contribution in #508

Full Changelog: v0.4.5…v0.5.2