Updated Sep 6th 2023

Introduction

Polygon zkEVM Mainnet Beta update to Node v0.3.0 on Sep 6th can be done from Node v0.1.2 or Node v0.2.5. Make sure you follow the relevant instructions and apply the corresponding config changes.

<aside> 💡 Note that the version v0.3.0 with Prover v2.2.0 are required to be able to upgrade the network to Dragon Fruit [ForkID5]

</aside>

<aside> 💡 Note that it is not recommended/will be very difficult to rollback from version v0.3.0 to earlier versions as it adds a new table to the Statedb to facilitate the storage of ForkIDs intervals that results in a new migration file.

</aside>

<aside> 💡 Note that the version v0.1.2 with Prover v1.1.4 is now obsolete.

</aside>

This document contains instructions for updating zkEVM node version as below:

If you are updating from v0.1.2 to v0.3.0

If you are updating from v0.2.5 to v0.3.0

Additionally, after updating to v0.3.0,

If node encounters synchronisation issues when you are updating from v0.1.2 or v0.2.5 to v0.3.0

Please note:

If you need to report a issue or discrepancy

If you are updating from v0.1.2 to v0.3.0

Please see instructions below:

1. Stop the RPC, Synchronizer and Executor

2. Change the configurations below:

   2.1 Rename the following Executor/Prover configuration parameters:

    - runStateDBServer rename it to runHashDBServer
    - runStateDBTest rename it to runHashDBTest
    - stateDBServerPort rename it to hashDBServerPort
    - stateDBURL rename it to hashDBURL
    - maxStateDBThreads rename it to maxHashDBThreads
   

   2.2 Add the following Executor/Prover configuration parameters:

   - "ECRecoverPrecalc": false,
   - "ECRecoverPrecalcNThreads": 4,
   - "dbMultiWriteSinglePosition": false,
   - "stateManager": true
   - "useAssociativeCache" : false
   

   2.3 Node configuration changes:

    - No changes are needed