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
NetworkingEnabled
NETHERMIND_SYNCCONFIG_NETWORKINGENABLED
If 'false' then the node does not connect to peers.
true
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.
null
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
SynchronizationEnabled
NETHERMIND_SYNCCONFIG_SYNCHRONIZATIONENABLED
If 'false' then the node does not download/process new blocks.
true
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
Last modified 3d ago
Copy link