Links

Sync module

Property
Env Variable
Description
Default
AncientBodiesBarrier
NETHERMIND_SYNCCONFIG_ANCIENTBODIESBARRIER
[EXPERIMENTAL] Defines the earliest body downloaded in fast sync when DownloadBodiesInFastSync is enabled. Actual values used will be Math.Max(1, Math.Min(PivotNumber, AncientBodiesBarrier))
0
AncientReceiptsBarrier
NETHERMIND_SYNCCONFIG_ANCIENTRECEIPTSBARRIER
[EXPERIMENTAL] Defines the earliest receipts downloaded in fast sync when DownloadReceiptsInFastSync is enabled. Actual value used will be Math.Max(1, Math.Min(PivotNumber, Math.Max(AncientBodiesBarrier, AncientReceiptsBarrier)))
0
DownloadBodiesInFastSync
NETHERMIND_SYNCCONFIG_DOWNLOADBODIESINFASTSYNC
If set to 'true' then the block bodies will be downloaded in the Fast Sync mode.
true
DownloadHeadersInFastSync
NETHERMIND_SYNCCONFIG_DOWNLOADHEADERSINFASTSYNC
If set to 'false' then fast sync will only download recent blocks.
true
DownloadReceiptsInFastSync
NETHERMIND_SYNCCONFIG_DOWNLOADRECEIPTSINFASTSYNC
If set to 'true' then the receipts will be downloaded in the Fast Sync mode. This will slow down the process by a few hours but will allow you to interact with dApps that execute extensive historical logs searches (like Maker CDPs).
true
FastBlocks
NETHERMIND_SYNCCONFIG_FASTBLOCKS
If set to 'true' then in the Fast Sync mode blocks will be first downloaded from the provided PivotNumber downwards. This allows for parallelization of requests with many sync peers and with no need to worry about syncing a valid branch (syncing downwards to 0). You need to enter the pivot block number, hash and total difficulty from a trusted source (you can use etherscan and confirm with other sources if you wan to change it).
false
FastSync
NETHERMIND_SYNCCONFIG_FASTSYNC
If set to 'true' then the Fast Sync (eth/63) synchronization algorithm will be used.
false
FastSyncCatchUpHeightDelta
NETHERMIND_SYNCCONFIG_FASTSYNCCATCHUPHEIGHTDELTA
Relevant only if 'FastSync' is 'true'. If set to a value, then it will set a minimum height threshold limit up to which FullSync, if already on, will stay on when chain will be behind network. If this limit will be exceeded, it will switch back to FastSync. In normal usage we do not recommend setting this to less than 32 as this can cause issues with chain reorgs. Please note that last 2 blocks will always be processed in FullSync, so setting it to less than 2 will have no effect.
8192
FixReceipts
NETHERMIND_SYNCCONFIG_FIXRECEIPTS
[ONLY FOR MISSING RECEIPTS ISSUE] Turns on receipts validation that checks for ones that might be missing due to previous bug. It downloads them from network if needed.If used please check that PivotNumber is same as original used when syncing the node as its used as a cut-off point.
false
FixTotalDifficulty
NETHERMIND_SYNCCONFIG_FIXTOTALDIFFICULTY
[ONLY TO FIX INCORRECT TOTAL DIFFICULTY ISSUE] Recalculates total difficulty starting from FixTotalDifficultyStartingBlock to FixTotalDifficultyLastBlock.
false
FixTotalDifficultyLastBlock
NETHERMIND_SYNCCONFIG_FIXTOTALDIFFICULTYLASTBLOCK
[ONLY TO FIX INCORRECT TOTAL DIFFICULTY ISSUE] Last block which total difficulty will be recalculated. If set to null equals to best known block
null
FixTotalDifficultyStartingBlock
NETHERMIND_SYNCCONFIG_FIXTOTALDIFFICULTYSTARTINGBLOCK
[ONLY TO FIX INCORRECT TOTAL DIFFICULTY ISSUE] First block which total difficulty will be recalculated.
1
MaxAttemptsToUpdatePivot
NETHERMIND_SYNCCONFIG_MAXATTEMPTSTOUPDATEPIVOT
Max number of attempts (seconds) to update pivot block basing on Forkchoice message from Consensus Layer. Only for PoS chains.
900
NetworkingEnabled
NETHERMIND_SYNCCONFIG_NETWORKINGENABLED
If 'false' then the node does not connect to peers.
true
NonValidatorNode
NETHERMIND_SYNCCONFIG_NONVALIDATORNODE
[EXPERIMENTAL] Only for non validator nodes! If set to true, DownloadReceiptsInFastSync and/or DownloadBodiesInFastSync can be set to false.
false
PivotHash
NETHERMIND_SYNCCONFIG_PIVOTHASH
Hash of the pivot block for the Fast Blocks sync.
null
PivotNumber
NETHERMIND_SYNCCONFIG_PIVOTNUMBER
Number of the pivot block for the Fast Blocks sync.
0
PivotTotalDifficulty
NETHERMIND_SYNCCONFIG_PIVOTTOTALDIFFICULTY
Total Difficulty of the pivot block for the Fast Blocks sync (not - this is total difficulty and not difficulty).
null
SnapSync
NETHERMIND_SYNCCONFIG_SNAPSYNC
Enables SNAP sync protocol.
false
SnapSyncAccountRangePartitionCount
NETHERMIND_SYNCCONFIG_SNAPSYNCACCOUNTRANGEPARTITIONCOUNT
Number of account range partition to create. Increase snap sync request concurrency. Value must be between 1 to 256 (inclusive).
8
StrictMode
NETHERMIND_SYNCCONFIG_STRICTMODE
Disable some optimization and run a more extensive sync. Useful for broken sync state but normally not needed
false
SynchronizationEnabled
NETHERMIND_SYNCCONFIG_SYNCHRONIZATIONENABLED
If 'false' then the node does not download/process new blocks.
true
TuneDbMode
NETHERMIND_SYNCCONFIG_TUNEDBMODE
[EXPERIMENTAL] Optimize db for write during sync. Significantly reduce total writes written and some sync time if you are not network limited.
Default
UseGethLimitsInFastBlocks
NETHERMIND_SYNCCONFIG_USEGETHLIMITSINFASTBLOCKS
If set to 'true' then in the Fast Blocks mode Nethermind generates smaller requests to avoid Geth from disconnecting. On the Geth heavy networks (mainnet) it is desired while on Parity or Nethermind heavy networks (Goerli, AuRa) it slows down the sync by a factor of ~4
true
WitnessProtocolEnabled
NETHERMIND_SYNCCONFIG_WITNESSPROTOCOLENABLED
Enables witness protocol.
false