Configuration
Nethermind is highly configurable. There are 3 ways of configuring it, listed by priority:
- Command line options (aka arguments or flags)
- Environment variables
- Configuration file
Given the above priority list, an option defined in a more priority way overrides the same option defined elsewhere if any.
Command line options
The full list of command line options can be displayed by running:
nethermind -h
Below is the list of the basic options followed by an exhaustive list of options by namespace.
The command line options are case-sensitive and can be defined only once unless stated otherwise.
Basic options
-
-d, --baseDbPath <path>
The path to the Nethermind database directory. Defaults to
db
. -
-c, --config <value>
The path to the configuration file or the name (without extension) of any of the configuration files in the configuration directory. Defaults to
mainnet
.Available configurations
Nethermind provides the following pre-built configurations named as the networks they are for. Their respective versions for archive nodes are suffixed
_archive
.base-mainnet
base-mainnet_archive
base-sepolia
base-sepolia_archive
chiado
chiado_archive
energyweb
energyweb_archive
gnosis
gnosis_archive
holesky
holesky_archive
mainnet
mainnet_archive
op-mainnet
op-mainnet_archive
op-sepolia
op-sepolia_archive
sepolia
sepolia_archive
volta
volta_archive
-
-cd, --configsDirectory <path>
The path to the configuration files directory. Defaults to
configs
. -
-dd, --datadir <path>
The path to the Nethermind data directory. Defaults to Nethermind's current directory.
warningThe absolute paths set by
Init.BaseDbPath
,Init.LogDirectory
, orKeyStore.KeyStoreDirectory
options in a configuration file are not overridden by--datadir
. -
-?, -h, --help
Displays the full list of available command line options.
-
-l, --log <level>
Log level (severity). Allowed values:
TRACE
DEBUG
INFO
WARN
ERROR
OFF
. Defaults toINFO
. -
-lcs, --loggerConfigSource <path>
The path to the NLog configuration file. Defaults to
NLog.config
. -
-pd, --pluginsDirectory <path>
The path to the Nethermind plugins directory. Defaults to
plugins
. -
-v, --version
Displays the Nethermind version info.
Options by namespaces
Aura
-
--Aura.AllowAuRaPrivateChains <value>
NETHERMIND_AURACONFIG_ALLOWAURAPRIVATECHAINS
Whether to allow private Aura-based chains only. Do not use with existing Aura-based chains. Allowed values:
true
false
. Defaults tofalse
. -
--Aura.ForceSealing <value>
NETHERMIND_AURACONFIG_FORCESEALING
Whether to seal empty blocks if mining. Allowed values:
true
false
. Defaults totrue
. -
--Aura.Minimum2MlnGasPerBlockWhenUsingBlockGasLimitContract <value>
NETHERMIND_AURACONFIG_MINIMUM2MLNGASPERBLOCKWHENUSINGBLOCKGASLIMITCONTRACT
Whether to use 2M gas if the contract returns less than that when using
BlockGasLimitContractTransitions
. Allowed values:true
false
. Defaults tofalse
. -
--Aura.TxPriorityConfigFilePath <value>
NETHERMIND_AURACONFIG_TXPRIORITYCONFIGFILEPATH
The path to the transaction priority rules file to use when selecting transactions from the transaction pool. Defaults to
null
. -
--Aura.TxPriorityContractAddress <value>
NETHERMIND_AURACONFIG_TXPRIORITYCONTRACTADDRESS
The address of the transaction priority contract to use when selecting transactions from the transaction pool. Defaults to
null
.
Blocks
-
--Blocks.ExtraData <value>
NETHERMIND_BLOCKSCONFIG_EXTRADATA
The block header extra data up to 32 bytes in length. Defaults to
Nethermind
. -
--Blocks.MinGasPrice <value>
NETHERMIND_BLOCKSCONFIG_MINGASPRICE
The minimum gas premium (or the gas price before the London hard fork) for transactions accepted by the block producer. Defaults to
1
. -
--Blocks.RandomizedBlocks <value>
NETHERMIND_BLOCKSCONFIG_RANDOMIZEDBLOCKS
Whether to change the difficulty of the block randomly within the constraints. Used in NethDev only. Allowed values:
true
false
. Defaults tofalse
. -
--Blocks.SecondsPerSlot <value>
NETHERMIND_BLOCKSCONFIG_SECONDSPERSLOT
The block time slot, in seconds. Defaults to
12
. -
--Blocks.TargetBlockGasLimit <value>
NETHERMIND_BLOCKSCONFIG_TARGETBLOCKGASLIMIT
The block gas limit that the block producer should try to reach in the fastest possible way based on the protocol rules. If not specified, then the block producer should follow others. Defaults to
null
.
Bloom
-
--Bloom.Index <value>
NETHERMIND_BLOOMCONFIG_INDEX
Whether to use the Bloom index. The Bloom index speeds up the RPC log searches. Allowed values:
true
false
. Defaults totrue
. -
--Bloom.IndexLevelBucketSizes <value>
NETHERMIND_BLOOMCONFIG_INDEXLEVELBUCKETSIZES
An array of multipliers for index levels. Can be tweaked per chain to boost performance. Defaults to
[4, 8, 8]
. -
--Bloom.Migration <value>
NETHERMIND_BLOOMCONFIG_MIGRATION
Whether to migrate the previously downloaded blocks to the Bloom index. Allowed values:
true
false
. Defaults tofalse
. -
--Bloom.MigrationStatistics <value>
NETHERMIND_BLOOMCONFIG_MIGRATIONSTATISTICS
Whether the migration statistics should be calculated and output. Allowed values:
true
false
. Defaults tofalse
.
EthStats
-
--EthStats.Contact <value>
NETHERMIND_ETHSTATSCONFIG_CONTACT
The node owner contact details displayed on Ethstats. Defaults to
hello@nethermind.io
. -
--EthStats.Enabled <value>
NETHERMIND_ETHSTATSCONFIG_ENABLED
Whether to use Ethstats publishing. Allowed values:
true
false
. Defaults tofalse
. -
--EthStats.Name <value>
NETHERMIND_ETHSTATSCONFIG_NAME
The node name displayed on Ethstats. Defaults to
Nethermind
. -
--EthStats.Secret <value>
NETHERMIND_ETHSTATSCONFIG_SECRET
The Ethstats secret. Defaults to
secret
. -
--EthStats.SendInterval <value>
NETHERMIND_ETHSTATSCONFIG_SENDINTERVAL
The stats update interval, in seconds. Defaults to
15
. -
--EthStats.Server <value>
NETHERMIND_ETHSTATSCONFIG_SERVER
The Ethstats server URL. Defaults to
ws://localhost:3000/api
.
HealthChecks
-
--HealthChecks.Enabled <value>
NETHERMIND_HEALTHCHECKSCONFIG_ENABLED
Whether to enable the health check. Allowed values:
true
false
. Defaults tofalse
. -
--HealthChecks.LowStorageCheckAwaitOnStartup <value>
NETHERMIND_HEALTHCHECKSCONFIG_LOWSTORAGECHECKAWAITONSTARTUP
Whether to check for low disk space on startup and suspend until enough space is available. Allowed values:
true
false
. Defaults tofalse
. -
--HealthChecks.LowStorageSpaceShutdownThreshold <value>
NETHERMIND_HEALTHCHECKSCONFIG_LOWSTORAGESPACESHUTDOWNTHRESHOLD
The percentage of available disk space below which Nethermind shuts down.
0
to disable. Defaults to1
. -
--HealthChecks.LowStorageSpaceWarningThreshold <value>
NETHERMIND_HEALTHCHECKSCONFIG_LOWSTORAGESPACEWARNINGTHRESHOLD
The percentage of available disk space below which a warning is displayed.
0
to disable. Defaults to5
. -
--HealthChecks.MaxIntervalClRequestTime <value>
NETHERMIND_HEALTHCHECKSCONFIG_MAXINTERVALCLREQUESTTIME
The max request interval, in seconds, in which the consensus client is assumed healthy. Defaults to
300
. -
--HealthChecks.MaxIntervalWithoutProcessedBlock <value>
NETHERMIND_HEALTHCHECKSCONFIG_MAXINTERVALWITHOUTPROCESSEDBLOCK
The max interval, in seconds, in which the block processing is assumed healthy. Defaults to
null
. -
--HealthChecks.MaxIntervalWithoutProducedBlock <value>
NETHERMIND_HEALTHCHECKSCONFIG_MAXINTERVALWITHOUTPRODUCEDBLOCK
The max interval, in seconds, in which the block production is assumed healthy. Defaults to
null
. -
--HealthChecks.PollingInterval <value>
NETHERMIND_HEALTHCHECKSCONFIG_POLLINGINTERVAL
The health check updates polling interval, in seconds. Defaults to
5
. -
--HealthChecks.Slug <value>
NETHERMIND_HEALTHCHECKSCONFIG_SLUG
The URL slug the health checks service is exposed at. Defaults to
/health
. -
--HealthChecks.UIEnabled <value>
NETHERMIND_HEALTHCHECKSCONFIG_UIENABLED
Whether to enable the health checks UI. Allowed values:
true
false
. Defaults tofalse
. -
--HealthChecks.WebhooksEnabled <value>
NETHERMIND_HEALTHCHECKSCONFIG_WEBHOOKSENABLED
Whether to enable web hooks. Allowed values:
true
false
. Defaults tofalse
. -
--HealthChecks.WebhooksPayload <value>
NETHERMIND_HEALTHCHECKSCONFIG_WEBHOOKSPAYLOAD
An escaped JSON paylod to be sent to the web hook on failure. Defaults to:
{
"attachments": [
{
"color": "#FFCC00",
"pretext": "Health Check Status :warning:",
"fields": [
{
"title": "Details",
"value": "More details available at /healthchecks-ui",
"short": false
},
{
"title": "Description",
"value": "[[DESCRIPTIONS]]",
"short": false
}
]
}
]
} -
--HealthChecks.WebhooksRestorePayload <value>
NETHERMIND_HEALTHCHECKSCONFIG_WEBHOOKSRESTOREPAYLOAD
An escaped JSON paylod to be sent to the web hook on recovery. Defaults to:
{
"attachments": [
{
"color": "#36a64f",
"pretext": "Health Check Status :+1:",
"fields": [
{
"title": "Details",
"value": "More details available at /healthchecks-ui",
"short": false
},
{
"title": "description",
"value": "The HealthCheck `[[LIVENESS]]` is recovered. Everything is up and running.",
"short": false
}
]
}
]
} -
--HealthChecks.WebhooksUri <value>
NETHERMIND_HEALTHCHECKSCONFIG_WEBHOOKSURI
The web hook URL. Defaults to
null
.
Hive
-
--Hive.BlocksDir <value>
NETHERMIND_HIVECONFIG_BLOCKSDIR
The path to the directory with additional blocks. Defaults to
/blocks
. -
--Hive.ChainFile <value>
NETHERMIND_HIVECONFIG_CHAINFILE
The path to the test chain spec file. Defaults to
/chain.rlp
. -
--Hive.Enabled <value>
NETHERMIND_HIVECONFIG_ENABLED
Whether to enable Hive for debugging. Allowed values:
true
false
. Defaults tofalse
. -
--Hive.GenesisFilePath <value>
NETHERMIND_HIVECONFIG_GENESISFILEPATH
The path to the genesis block file. Defaults to
/genesis.json
. -
--Hive.KeysDir <value>
NETHERMIND_HIVECONFIG_KEYSDIR
The path to the keystore directory. Defaults to
/keys
.
Init
-
--Init.AutoDump <value>
NETHERMIND_INITCONFIG_AUTODUMP
Auto-dump on bad blocks for diagnostics.
Default
combinesReceipts
andRlp
.Allowed values:
None
Receipts
Parity
Geth
Rlp
RlpLog
Default
All
Defaults to
Default
. -
--Init.BadBlocksStored <value>
NETHERMIND_INITCONFIG_BADBLOCKSSTORED
The maximum number of bad blocks observed on the network that will be stored on disk. Defaults to
100
. -
--Init.BaseDbPath <value>
NETHERMIND_INITCONFIG_BASEDBPATH
The base path for all Nethermind databases. Defaults to
db
. -
--Init.ChainSpecPath <value>
NETHERMIND_INITCONFIG_CHAINSPECPATH
The path to the chain spec file. Defaults to
chainspec/foundation.json
. -
--Init.DiagnosticMode <value>
NETHERMIND_INITCONFIG_DIAGNOSTICMODE
The diagnostic mode.
Allowed values:
None
MemDb
RpcDb
ReadOnlyDb
VerifyRewards
VerifySupply
VerifyTrie
Defaults to
None
. -
--Init.DiscoveryEnabled <value>
NETHERMIND_INITCONFIG_DISCOVERYENABLED
Whether to enable the node discovery. If disabled, Nethermind doesn't look for other nodes beyond the bootnodes specified. Allowed values:
true
false
. Defaults totrue
. -
--Init.EnableUnsecuredDevWallet <value>
NETHERMIND_INITCONFIG_ENABLEUNSECUREDDEVWALLET
Whether to enable the in-app wallet/keystore. Allowed values:
true
false
. Defaults tofalse
. -
--Init.GenesisHash <value>
NETHERMIND_INITCONFIG_GENESISHASH
The hash of the genesis block. If not specified, the genesis block validity is not checked which is useful in the case of ad hoc test/private networks. Defaults to
null
. -
--Init.HiveChainSpecPath <value>
NETHERMIND_INITCONFIG_HIVECHAINSPECPATH
The path to the chain spec file for Hive tests. Defaults to
chainspec/test.json
. -
--Init.IsMining <value>
NETHERMIND_INITCONFIG_ISMINING
Whether to seal/mine new blocks. Allowed values:
true
false
. Defaults tofalse
. -
--Init.KeepDevWalletInMemory <value>
NETHERMIND_INITCONFIG_KEEPDEVWALLETINMEMORY
Whether to create session-only accounts and delete them on shutdown. Allowed values:
true
false
. Defaults tofalse
. -
--Init.KzgSetupPath <value>
NETHERMIND_INITCONFIG_KZGSETUPPATH
The path to KZG trusted setup file. Defaults to
null
. -
--Init.LogDirectory <value>
NETHERMIND_INITCONFIG_LOGDIRECTORY
The path to the Nethermind logs directory. Defaults to
logs
. -
--Init.LogFileName <value>
NETHERMIND_INITCONFIG_LOGFILENAME
The name of the log file. Defaults to
log.txt
. -
--Init.LogRules <value>
NETHERMIND_INITCONFIG_LOGRULES
The logs format as
LogPath:LogLevel;*
Defaults tonull
. -
--Init.MemoryHint <value>
NETHERMIND_INITCONFIG_MEMORYHINT
The hint on the max memory limit, in bytes, to configure the database and networking memory allocations. Defaults to
null
. -
--Init.PeerManagerEnabled <value>
NETHERMIND_INITCONFIG_PEERMANAGERENABLED
Whether to connect to newly discovered peers. Allowed values:
true
false
. Defaults totrue
. -
--Init.ProcessingEnabled <value>
NETHERMIND_INITCONFIG_PROCESSINGENABLED
Whether to download/process new blocks. Allowed values:
true
false
. Defaults totrue
. -
--Init.RpcDbUrl <value>
NETHERMIND_INITCONFIG_RPCDBURL
The URL of the remote node used as a database source when
DiagnosticMode
is set toRpcDb
. -
--Init.StaticNodesPath <value>
NETHERMIND_INITCONFIG_STATICNODESPATH
The path to the static nodes file. Defaults to
Data/static-nodes.json
. -
--Init.WebSocketsEnabled <value>
NETHERMIND_INITCONFIG_WEBSOCKETSENABLED
Whether to enable WebSocket service for the default JSON-RPC port on startup. Allowed values:
true
false
. Defaults totrue
.
JsonRpc
-
--JsonRpc.AdditionalRpcUrls <value>
NETHERMIND_JSONRPCCONFIG_ADDITIONALRPCURLS
An array of additional JSON-RPC URLs to listen at with protocol and JSON-RPC namespace list. For instance,
[http://localhost:8546|http;ws|eth;web3]
. Defaults to[]
. -
--JsonRpc.BufferResponses <value>
NETHERMIND_JSONRPCCONFIG_BUFFERRESPONSES
Whether to buffer responses before sending them. This allows using of
Content-Length
instead ofTransfer-Encoding: chunked
. Note that it may degrade performance on large responses. The max buffered response length is 2GB. Chunked responses can be larger. Allowed values:true
false
. Defaults tofalse
. -
--JsonRpc.CallsFilterFilePath <value>
NETHERMIND_JSONRPCCONFIG_CALLSFILTERFILEPATH
The path to a file with the list of new-line-separated JSON-RPC calls. If specified, only the calls from that file are allowed. Defaults to
Data/jsonrpc.filter
. -
--JsonRpc.Enabled <value>
NETHERMIND_JSONRPCCONFIG_ENABLED
Whether to enable the JSON-RPC service. Allowed values:
true
false
. Defaults tofalse
. -
--JsonRpc.EnabledModules <value>
NETHERMIND_JSONRPCCONFIG_ENABLEDMODULES
An array of JSON-RPC namespaces to enable. For instance,
[debug,eth]
.Built-in namespaces:
admin
client
debug
engine
eth
evm
health
net
parity
personal
proof
rpc
subscribe
trace
txpool
web3
Defaults to
[Eth,Subscribe,Trace,TxPool,Web3,Personal,Proof,Net,Parity,Health,Rpc]
. -
--JsonRpc.EngineEnabledModules <value>
NETHERMIND_JSONRPCCONFIG_ENGINEENABLEDMODULES
An array of additional JSON-RPC URLs to listen at with protocol and JSON-RPC namespace list for Engine API. Defaults to
[Net,Eth,Subscribe,Web3]
. -
--JsonRpc.EngineHost <value>
NETHERMIND_JSONRPCCONFIG_ENGINEHOST
The Engine API host. Defaults to
127.0.0.1
. -
--JsonRpc.EnginePort <value>
NETHERMIND_JSONRPCCONFIG_ENGINEPORT
The Engine API port. Defaults to
null
. -
--JsonRpc.EthModuleConcurrentInstances <value>
NETHERMIND_JSONRPCCONFIG_ETHMODULECONCURRENTINSTANCES
The number of concurrent instances for non-sharable calls:
eth_call
eth_estimateGas
eth_getLogs
eth_newBlockFilter
eth_newFilter
eth_newPendingTransactionFilter
eth_uninstallFilter
This limits the load on the CPU and I/O to reasonable levels. If the limit is exceeded, HTTP 503 is returned along with the JSON-RPC error. Defaults to the number of logical processors.
-
--JsonRpc.GasCap <value>
NETHERMIND_JSONRPCCONFIG_GASCAP
The gas limit for
eth_call
andeth_estimateGas
. Defaults to100000000
. -
--JsonRpc.Host <value>
NETHERMIND_JSONRPCCONFIG_HOST
The JSON-RPC service host. Defaults to
127.0.0.1
. -
--JsonRpc.IpcUnixDomainSocketPath <value>
NETHERMIND_JSONRPCCONFIG_IPCUNIXDOMAINSOCKETPATH
The path to connect a UNIX domain socket over.
-
--JsonRpc.JwtSecretFile <value>
NETHERMIND_JSONRPCCONFIG_JWTSECRETFILE
The path to the JWT secret file required for the Engine API authentication. Defaults to
keystore/jwt-secret
. -
--JsonRpc.MaxBatchResponseBodySize <value>
NETHERMIND_JSONRPCCONFIG_MAXBATCHRESPONSEBODYSIZE
The max batch size limit for batched JSON-RPC calls. Defaults to
33554432
. -
--JsonRpc.MaxBatchSize <value>
NETHERMIND_JSONRPCCONFIG_MAXBATCHSIZE
The max number of JSON-RPC requests in a batch. Defaults to
1024
. -
--JsonRpc.MaxLoggedRequestParametersCharacters <value>
NETHERMIND_JSONRPCCONFIG_MAXLOGGEDREQUESTPARAMETERSCHARACTERS
The max number of characters of a JSON-RPC request parameter printing to the log. Defaults to
null
. -
--JsonRpc.MaxRequestBodySize <value>
NETHERMIND_JSONRPCCONFIG_MAXREQUESTBODYSIZE
The max length of HTTP request body, in bytes. Defaults to
30000000
. -
--JsonRpc.MethodsLoggingFiltering <value>
NETHERMIND_JSONRPCCONFIG_METHODSLOGGINGFILTERING
An array of the method names not to log. Defaults to
[engine_newPayloadV1,engine_newPayloadV2,engine_newPayloadV3,engine_forkchoiceUpdatedV1,engine_forkchoiceUpdatedV2]
. -
--JsonRpc.Port <value>
NETHERMIND_JSONRPCCONFIG_PORT
The JSON-RPC service HTTP port. Defaults to
8545
. -
--JsonRpc.ReportIntervalSeconds <value>
NETHERMIND_JSONRPCCONFIG_REPORTINTERVALSECONDS
The interval, in seconds, between the JSON-RPC stats report log. Defaults to
300
. -
--JsonRpc.RequestQueueLimit <value>
NETHERMIND_JSONRPCCONFIG_REQUESTQUEUELIMIT
The max number of concurrent requests in the queue for:
eth_call
eth_estimateGas
eth_getLogs
eth_newFilter
eth_newBlockFilter
eth_newPendingTransactionFilter
eth_uninstallFilter
0
to lift the limit. Defaults to500
. -
--JsonRpc.RpcRecorderBaseFilePath <value>
NETHERMIND_JSONRPCCONFIG_RPCRECORDERBASEFILEPATH
The path to the base file for diagnostic recording. Defaults to
logs/rpc.{counter}.txt
. -
--JsonRpc.RpcRecorderState <value>
NETHERMIND_JSONRPCCONFIG_RPCRECORDERSTATE
The diagnostic recording mode.
Allowed values:
None
Request
Response
All
Defaults to
None
. -
--JsonRpc.Timeout <value>
NETHERMIND_JSONRPCCONFIG_TIMEOUT
The request timeout, in milliseconds. Defaults to
20000
. -
--JsonRpc.WebSocketsPort <value>
NETHERMIND_JSONRPCCONFIG_WEBSOCKETSPORT
The JSON-RPC service WebSockets port. Defaults to
8545
.
KeyStore
-
--KeyStore.BlockAuthorAccount <value>
NETHERMIND_KEYSTORECONFIG_BLOCKAUTHORACCOUNT
An account to use as the block author (coinbase).
-
--KeyStore.Cipher <value>
NETHERMIND_KEYSTORECONFIG_CIPHER
See Web3 secret storage definition. Defaults to
aes-128-ctr
. -
--KeyStore.EnodeAccount <value>
NETHERMIND_KEYSTORECONFIG_ENODEACCOUNT
An account to use for networking (enode). If neither this nor the
EnodeKeyFile
option is specified, the key is autogenerated innode.key.plain
file. -
--KeyStore.EnodeKeyFile <value>
NETHERMIND_KEYSTORECONFIG_ENODEKEYFILE
The path to the key file to use by for networking (enode). If neither this nor the
EnodeAccount
is specified, the key is autogenerated innode.key.plain
file. -
--KeyStore.IVSize <value>
NETHERMIND_KEYSTORECONFIG_IVSIZE
See Web3 secret storage definition. Defaults to
16
. -
--KeyStore.Kdf <value>
NETHERMIND_KEYSTORECONFIG_KDF
See Web3 secret storage definition. Defaults to
scrypt
. -
--KeyStore.KdfparamsDklen <value>
NETHERMIND_KEYSTORECONFIG_KDFPARAMSDKLEN
See Web3 secret storage definition. Defaults to
32
. -
--KeyStore.KdfparamsN <value>
NETHERMIND_KEYSTORECONFIG_KDFPARAMSN
See Web3 secret storage definition. Defaults to
262144
. -
--KeyStore.KdfparamsP <value>
NETHERMIND_KEYSTORECONFIG_KDFPARAMSP
See Web3 secret storage definition. Defaults to
1
. -
--KeyStore.KdfparamsR <value>
NETHERMIND_KEYSTORECONFIG_KDFPARAMSR
See Web3 secret storage definition. Defaults to
8
. -
--KeyStore.KdfparamsSaltLen <value>
NETHERMIND_KEYSTORECONFIG_KDFPARAMSSALTLEN
See Web3 secret storage definition. Defaults to
32
. -
--KeyStore.KeyStoreDirectory <value>
NETHERMIND_KEYSTORECONFIG_KEYSTOREDIRECTORY
The path to the keystore directory. Defaults to
keystore
. -
--KeyStore.KeyStoreEncoding <value>
NETHERMIND_KEYSTORECONFIG_KEYSTOREENCODING
See Web3 secret storage definition. Defaults to
UTF-8
. -
--KeyStore.PasswordFiles <value>
NETHERMIND_KEYSTORECONFIG_PASSWORDFILES
An array of password files paths used to unlock the accounts set with
UnlockAccounts
. Defaults to[]
. -
--KeyStore.Passwords <value>
NETHERMIND_KEYSTORECONFIG_PASSWORDS
An array of passwords used to unlock the accounts set with
UnlockAccounts
. Defaults to[]
. -
--KeyStore.SymmetricEncrypterBlockSize <value>
NETHERMIND_KEYSTORECONFIG_SYMMETRICENCRYPTERBLOCKSIZE
See Web3 secret storage definition. Defaults to
128
. -
--KeyStore.SymmetricEncrypterKeySize <value>
NETHERMIND_KEYSTORECONFIG_SYMMETRICENCRYPTERKEYSIZE
See Web3 secret storage definition. Defaults to
128
. -
--KeyStore.TestNodeKey <value>
NETHERMIND_KEYSTORECONFIG_TESTNODEKEY
A plaintext private key to use for testing purposes.
-
--KeyStore.UnlockAccounts <value>
NETHERMIND_KEYSTORECONFIG_UNLOCKACCOUNTS
An array of accounts to unlock on startup using passwords either in
PasswordFiles
andPasswords
. Defaults to[]
.
Merge
-
--Merge.BuilderRelayUrl <value>
NETHERMIND_MERGECONFIG_BUILDERRELAYURL
The URL of a builder relay. If specified, blocks are sent to the relay. Defaults to
null
. -
--Merge.CollectionsPerDecommit <value>
NETHERMIND_MERGECONFIG_COLLECTIONSPERDECOMMIT
Request the garbage collector (GC) to release the process memory.
Allowed values:
-1
to disable0
to release every time- A positive number to release memory after that many Engine API calls
Defaults to
25
. -
--Merge.CompactMemory <value>
NETHERMIND_MERGECONFIG_COMPACTMEMORY
The memory compaction mode. When set to
Full
, compacts the large object heap (LOH) ifSweepMemory
is set toGen2
.Allowed values:
No
Yes
Full
Defaults to
Yes
. -
--Merge.Enabled <value>
NETHERMIND_MERGECONFIG_ENABLED
Whether to enable the Merge hard fork. Allowed values:
true
false
. Defaults totrue
. -
--Merge.FinalTotalDifficulty <value>
NETHERMIND_MERGECONFIG_FINALTOTALDIFFICULTY
The total difficulty of the last PoW block. Must be greater than or equal to the terminal total difficulty (TTD). Defaults to
null
. -
--Merge.PrioritizeBlockLatency <value>
NETHERMIND_MERGECONFIG_PRIORITIZEBLOCKLATENCY
Whether to reduce block latency by disabling garbage collection during Engine API calls. Allowed values:
true
false
. Defaults totrue
. -
--Merge.SweepMemory <value>
NETHERMIND_MERGECONFIG_SWEEPMEMORY
The garbage collection (GC) mode between Engine API calls.
Allowed values:
NoGC
Gen0
Gen1
Gen2
Defaults to
Gen1
. -
--Merge.TerminalBlockHash <value>
NETHERMIND_MERGECONFIG_TERMINALBLOCKHASH
The terminal PoW block hash used for the transition. Defaults to
null
. -
--Merge.TerminalBlockNumber <value>
NETHERMIND_MERGECONFIG_TERMINALBLOCKNUMBER
The terminal PoW block number used for the transition.
-
--Merge.TerminalTotalDifficulty <value>
NETHERMIND_MERGECONFIG_TERMINALTOTALDIFFICULTY
The terminal total difficulty (TTD) used for the transition. Defaults to
null
.
Metrics
-
--Metrics.CountersEnabled <value>
NETHERMIND_METRICSCONFIG_COUNTERSENABLED
Whether to publish metrics using .NET diagnostics that can be collected with dotnet-counters. Allowed values:
true
false
. Defaults tofalse
. -
--Metrics.Enabled <value>
NETHERMIND_METRICSCONFIG_ENABLED
Whether to publish various metrics to Prometheus Pushgateway at a given interval. Allowed values:
true
false
. Defaults tofalse
. -
--Metrics.EnableDbSizeMetrics <value>
NETHERMIND_METRICSCONFIG_ENABLEDBSIZEMETRICS
Whether to publish database size metrics. Allowed values:
true
false
. Defaults totrue
. -
--Metrics.ExposeHost <value>
NETHERMIND_METRICSCONFIG_EXPOSEHOST
The IP address to expose Prometheus metrics at. The value of
+
means listening on all available hostnames. Setting this tolocalhost
prevents remote access. Defaults to+
. -
--Metrics.ExposePort <value>
NETHERMIND_METRICSCONFIG_EXPOSEPORT
The port to expose Prometheus metrics at. Defaults to
null
. -
--Metrics.IntervalSeconds <value>
NETHERMIND_METRICSCONFIG_INTERVALSECONDS
The frequency of pushing metrics to Prometheus, in seconds. Defaults to
5
. -
--Metrics.NodeName <value>
NETHERMIND_METRICSCONFIG_NODENAME
The name to display on the Grafana dashboard. Defaults to
"Nethermind"
. -
--Metrics.PushGatewayUrl <value>
NETHERMIND_METRICSCONFIG_PUSHGATEWAYURL
The Prometheus Pushgateway instance URL.
Mining
-
--Mining.Enabled <value>
NETHERMIND_MININGCONFIG_ENABLED
Whether to produce blocks. Allowed values:
true
false
. Defaults tofalse
.
Network
-
--Network.Bootnodes <value>
NETHERMIND_NETWORKCONFIG_BOOTNODES
A comma-separated enode list to be used as boot nodes.
-
--Network.DiagTracerEnabled <value>
NETHERMIND_NETWORKCONFIG_DIAGTRACERENABLED
Whether to enable a verbose diagnostic tracing. Allowed values:
true
false
. Defaults tofalse
. -
--Network.DiscoveryDns <value>
NETHERMIND_NETWORKCONFIG_DISCOVERYDNS
Use tree is available through a DNS name. For the default of
<chain name>.ethdisco.net
, leave unspecified. Defaults tonull
. -
--Network.DiscoveryPort <value>
NETHERMIND_NETWORKCONFIG_DISCOVERYPORT
The UDP port number for incoming discovery connections. It's recommended to keep it the same as the TCP port (
P2PPort
) because other values have not been tested yet. Defaults to30303
. -
--Network.EnableUPnP <value>
NETHERMIND_NETWORKCONFIG_ENABLEUPNP
Whether to enable automatic port forwarding via UPnP. Allowed values:
true
false
. Defaults tofalse
. -
--Network.ExternalIp <value>
NETHERMIND_NETWORKCONFIG_EXTERNALIP
The external IP. Use only when the external IP cannot be resolved automatically. Defaults to
null
. -
--Network.LocalIp <value>
NETHERMIND_NETWORKCONFIG_LOCALIP
The local IP. Use only when the local IP cannot be resolved automatically. Defaults to
null
. -
--Network.MaxActivePeers <value>
NETHERMIND_NETWORKCONFIG_MAXACTIVEPEERS
The max allowed number of connected peers. Defaults to
50
. -
--Network.MaxNettyArenaCount <value>
NETHERMIND_NETWORKCONFIG_MAXNETTYARENACOUNT
The maximum DotNetty arena count. Increasing this on a high-core CPU without increasing the memory budget may reduce chunk size so much that it causes a huge memory allocation. Defaults to
8
. -
--Network.NettyArenaOrder <value>
NETHERMIND_NETWORKCONFIG_NETTYARENAORDER
The size of the DotNetty arena order.
-1
to depend on the memory hint. Defaults to-1
. -
--Network.OnlyStaticPeers <value>
NETHERMIND_NETWORKCONFIG_ONLYSTATICPEERS
Whether to use static peers only. Allowed values:
true
false
. Defaults tofalse
. -
--Network.P2PPort <value>
NETHERMIND_NETWORKCONFIG_P2PPORT
The TCP port for incoming P2P connections. Defaults to
30303
. -
--Network.PriorityPeersMaxCount <value>
NETHERMIND_NETWORKCONFIG_PRIORITYPEERSMAXCOUNT
The max number of priority peers. Can be overridden by a plugin. Defaults to
0
. -
--Network.StaticPeers <value>
NETHERMIND_NETWORKCONFIG_STATICPEERS
A list of peers to keep connection for. Static peers are affected by
MaxActivePeers
. Defaults tonull
.
Pruning
-
--Pruning.AvailableSpaceCheckEnabled <value>
NETHERMIND_PRUNINGCONFIG_AVAILABLESPACECHECKENABLED
Whether to enables available disk space check. Allowed values:
true
false
. Defaults totrue
. -
--Pruning.CacheMb <value>
NETHERMIND_PRUNINGCONFIG_CACHEMB
The in-memory cache size, in MB. The bigger the cache size, the bigger the disk space savings. Defaults to
1024
. -
--Pruning.FullPruningCompletionBehavior <value>
NETHERMIND_PRUNINGCONFIG_FULLPRUNINGCOMPLETIONBEHAVIOR
The behavior after pruning completion:
None
: Do nothing.ShutdownOnSuccess
: Shut Nethermind down if pruning has succeeded but leave it running if failed.AlwaysShutdown
: Shut Nethermind down when pruning completes, regardless of its status.
Allowed values:
None
ShutdownOnSuccess
AlwaysShutdown
Defaults to
None
. -
--Pruning.FullPruningDisableLowPriorityWrites <value>
NETHERMIND_PRUNINGCONFIG_FULLPRUNINGDISABLELOWPRIORITYWRITES
Whether to disable low-priority for pruning writes. Full pruning uses low-priority write operations to prevent blocking block processing. If block processing is not high-priority, set this option to
true
for faster pruning. Allowed values:true
false
. Defaults tofalse
. -
--Pruning.FullPruningMaxDegreeOfParallelism <value>
NETHERMIND_PRUNINGCONFIG_FULLPRUNINGMAXDEGREEOFPARALLELISM
The max number of parallel tasks that can be used by full pruning:
Allowed values:
-1
to use the number of logical processors0
to use 25% of logical processors1
to run on single thread
The recommended value depends on the type of the node:
- If the node needs to be responsive (serves for RPC or validator), then the recommended value is
0
or-1
. - If the node doesn't have many other responsibilities but needs to be able to follow the chain reliably without any delays and produce live logs, the
0
or1
is recommended. - If the node doesn't have to be responsive, has very fast I/O (like NVMe) and the shortest pruning time is to be achieved, then
-1
is recommended. Defaults to0
.
-
--Pruning.FullPruningMemoryBudgetMb <value>
NETHERMIND_PRUNINGCONFIG_FULLPRUNINGMEMORYBUDGETMB
The memory budget, in MB, used for the trie visit. Increasing this value significantly reduces the IOPS requirement at the expense of memory usage.
0
to disable. Defaults to4000
. -
--Pruning.FullPruningMinimumDelayHours <value>
NETHERMIND_PRUNINGCONFIG_FULLPRUNINGMINIMUMDELAYHOURS
The minimum delay, in hours, between full pruning operations not to exhaust disk writes. Defaults to
240
. -
--Pruning.FullPruningThresholdMb <value>
NETHERMIND_PRUNINGCONFIG_FULLPRUNINGTHRESHOLDMB
The threshold, in MB, to trigger full pruning. Depends on
Mode
andFullPruningTrigger
. Defaults to256000
. -
--Pruning.FullPruningTrigger <value>
NETHERMIND_PRUNINGCONFIG_FULLPRUNINGTRIGGER
The full pruning trigger:
Manual
: Triggered manually.StateDbSize
: Trigger when the state DB size is above the threshold.VolumeFreeSpace
: Trigger when the free disk space where the state DB is stored is below the threshold.
Allowed values:
Manual
StateDbSize
VolumeFreeSpace
Defaults to
Manual
. -
--Pruning.Mode <value>
NETHERMIND_PRUNINGCONFIG_MODE
The pruning mode:
None
: No pruning (full archive)Memory
: In-memory pruningFull
: Full pruningHybrid
: Combined in-memory and full pruning
Allowed values:
None
Memory
Full
Hybrid
Defaults to
Hybrid
. -
--Pruning.PersistenceInterval <value>
NETHERMIND_PRUNINGCONFIG_PERSISTENCEINTERVAL
The block persistence frequency. If set to
N
, it caches after eachNth
block even if not required by cache memory usage. Defaults to8192
. -
--Pruning.PruningBoundary <value>
NETHERMIND_PRUNINGCONFIG_PRUNINGBOUNDARY
Past N state before state gets pruned Used to determine how old of a state to keep from the head. Defaults to
64
. -
--Pruning.TrackedPastKeyCountMemoryRatio <value>
NETHERMIND_PRUNINGCONFIG_TRACKEDPASTKEYCOUNTMEMORYRATIO
[TECHNICAL] Ratio of memory out of CacheMb to allocate for LRU used to track past keys for live pruning. Defaults to
0.1
.
Receipt
-
--Receipt.CompactReceiptStore <value>
NETHERMIND_RECEIPTCONFIG_COMPACTRECEIPTSTORE
Whether to compact receipts database size at the expense of RPC performance. Allowed values:
true
false
. Defaults totrue
. -
--Receipt.CompactTxIndex <value>
NETHERMIND_RECEIPTCONFIG_COMPACTTXINDEX
Whether to compact receipts transaction index database size at the expense of RPC performance. Allowed values:
true
false
. Defaults totrue
. -
--Receipt.ReceiptsMigration <value>
NETHERMIND_RECEIPTCONFIG_RECEIPTSMIGRATION
Whether to migrate the receipts database to the new schema. Allowed values:
true
false
. Defaults tofalse
. -
--Receipt.StoreReceipts <value>
NETHERMIND_RECEIPTCONFIG_STORERECEIPTS
Whether to store receipts after a new block is processed. This setting is independent from downloading receipts in fast sync mode. Allowed values:
true
false
. Defaults totrue
. -
--Receipt.TxLookupLimit <value>
NETHERMIND_RECEIPTCONFIG_TXLOOKUPLIMIT
The number of recent blocks to maintain transaction index for.
0
to never remove indices,-1
to never index. Defaults to2350000
.
Seq
-
--Seq.ApiKey <value>
NETHERMIND_SEQCONFIG_APIKEY
The Seq API key.
-
--Seq.MinLevel <value>
NETHERMIND_SEQCONFIG_MINLEVEL
The min log level to sent to Seq. Defaults to
Off
. -
--Seq.ServerUrl <value>
NETHERMIND_SEQCONFIG_SERVERURL
The Seq instance URL. Defaults to
http://localhost:5341
.
Snapshot
-
--Snapshot.Checksum <value>
NETHERMIND_SNAPSHOTCONFIG_CHECKSUM
The SHA-256 checksum of the snapshot file. Defaults to
null
. -
--Snapshot.DownloadUrl <value>
NETHERMIND_SNAPSHOTCONFIG_DOWNLOADURL
The URL of the snapshot file. Defaults to
null
. -
--Snapshot.Enabled <value>
NETHERMIND_SNAPSHOTCONFIG_ENABLED
Whether to enable the Snapshot plugin. Allowed values:
true
false
. Defaults tofalse
. -
--Snapshot.SnapshotDirectory <value>
NETHERMIND_SNAPSHOTCONFIG_SNAPSHOTDIRECTORY
The path to the directory to store the snapshot file. Defaults to
snapshot
. -
--Snapshot.SnapshotFileName <value>
NETHERMIND_SNAPSHOTCONFIG_SNAPSHOTFILENAME
The name of the snapshot file. Defaults to
snapshot.zip
.
Sync
-
--Sync.AncientBodiesBarrier <value>
NETHERMIND_SYNCCONFIG_ANCIENTBODIESBARRIER
The earliest body downloaded with fast sync when
DownloadBodiesInFastSync
is set totrue
. The actual value is determined as follows:max{ 1, min{ PivotNumber, AncientBodiesBarrier } }
Defaults to
0
. -
--Sync.AncientReceiptsBarrier <value>
NETHERMIND_SYNCCONFIG_ANCIENTRECEIPTSBARRIER
The earliest receipt downloaded with fast sync when
DownloadReceiptsInFastSync
is set totrue
. The actual value is determined as folows:max{ 1, min{ PivotNumber, max{ AncientBodiesBarrier, AncientReceiptsBarrier } } }
Defaults to
0
. -
--Sync.BlocksDbTuneDbMode <value>
NETHERMIND_SYNCCONFIG_BLOCKSDBTUNEDBMODE
Configure the blocks database for write optimizations during sync.
Allowed values:
Default
WriteBias
HeavyWrite
AggressiveHeavyWrite
DisableCompaction
EnableBlobFiles
HashDb
Defaults to
EnableBlobFiles
. -
--Sync.DownloadBodiesInFastSync <value>
NETHERMIND_SYNCCONFIG_DOWNLOADBODIESINFASTSYNC
Whether to download the block bodies in the Fast sync mode. Allowed values:
true
false
. Defaults totrue
. -
--Sync.DownloadHeadersInFastSync <value>
NETHERMIND_SYNCCONFIG_DOWNLOADHEADERSINFASTSYNC
Whether to download the old block headers in the Fast sync mode. If
false
, Nethermind downloads only recent blocks headers. Allowed values:true
false
. Defaults totrue
. -
--Sync.DownloadReceiptsInFastSync <value>
NETHERMIND_SYNCCONFIG_DOWNLOADRECEIPTSINFASTSYNC
Whether to download receipts in the Fast sync mode. This slows down the process by a few hours but allows to interact with dApps that perform extensive historical logs searches. Allowed values:
true
false
. Defaults totrue
. -
--Sync.ExitOnSynced <value>
NETHERMIND_SYNCCONFIG_EXITONSYNCED
Whether to shut down Nethermind once sync is finished. Allowed values:
true
false
. Defaults tofalse
. -
--Sync.ExitOnSyncedWaitTimeSec <value>
NETHERMIND_SYNCCONFIG_EXITONSYNCEDWAITTIMESEC
The time, in seconds, to wait before shutting down Nethermind once sync is finished. Defaults to
60
. -
--Sync.FastSync <value>
NETHERMIND_SYNCCONFIG_FASTSYNC
Whether to use the Fast sync mode (the eth/63 synchronization algorithm). Allowed values:
true
false
. Defaults tofalse
. -
--Sync.FastSyncCatchUpHeightDelta <value>
NETHERMIND_SYNCCONFIG_FASTSYNCCATCHUPHEIGHTDELTA
In Fast sync mode, the min height threshold limit up to which the Full sync, if already on, stays on when the chain is behind the network head. If the limit is exceeded, it switches back to Fast sync. For regular usage scenarios, setting this value lower than 32 is not recommended as this can cause issues with chain reorgs. Note that the last 2 blocks are always processed in Full sync, so setting it lower than 2 has no effect. Defaults to
8192
. -
--Sync.FixReceipts <value>
NETHERMIND_SYNCCONFIG_FIXRECEIPTS
Whether to enable receipts validation that checks for receipts that might be missing because of a bug. If needed, receipts are downloaded from the network. If
true
, the pivot number must be same one used originally as it's used as a cut-off point. Allowed values:true
false
. Defaults tofalse
. -
--Sync.FixTotalDifficulty <value>
NETHERMIND_SYNCCONFIG_FIXTOTALDIFFICULTY
Whether to recalculate the total difficulty from
FixTotalDifficultyStartingBlock
toFixTotalDifficultyLastBlock
. Allowed values:true
false
. Defaults tofalse
. -
--Sync.FixTotalDifficultyLastBlock <value>
NETHERMIND_SYNCCONFIG_FIXTOTALDIFFICULTYLASTBLOCK
The last block to recalculate the total difficulty for. If not specified, the best known block is used. Defaults to
null
. -
--Sync.FixTotalDifficultyStartingBlock <value>
NETHERMIND_SYNCCONFIG_FIXTOTALDIFFICULTYSTARTINGBLOCK
The first block to recalculate the total difficulty for. Defaults to
1
. -
--Sync.MaxAttemptsToUpdatePivot <value>
NETHERMIND_SYNCCONFIG_MAXATTEMPTSTOUPDATEPIVOT
The max number of attempts to update the pivot block based on the FCU message from the consensus client. Defaults to
2147483647
. -
--Sync.MaxProcessingThreads <value>
NETHERMIND_SYNCCONFIG_MAXPROCESSINGTHREADS
The max number of threads used for syncing.
0
to use the number of logical processors. Defaults to0
. -
--Sync.NetworkingEnabled <value>
NETHERMIND_SYNCCONFIG_NETWORKINGENABLED
Whether to connect to peers and sync. Allowed values:
true
false
. Defaults totrue
. -
--Sync.NonValidatorNode <value>
NETHERMIND_SYNCCONFIG_NONVALIDATORNODE
Whether to operate as a non-validator. If
true
, theDownloadReceiptsInFastSync
andDownloadBodiesInFastSync
can be set tofalse
. Allowed values:true
false
. Defaults tofalse
. -
--Sync.PivotHash <value>
NETHERMIND_SYNCCONFIG_PIVOTHASH
The hash of the pivot block for the Fast sync mode. Defaults to
null
. -
--Sync.PivotNumber <value>
NETHERMIND_SYNCCONFIG_PIVOTNUMBER
The number of the pivot block for the Fast sync mode. Defaults to
0
. -
--Sync.PivotTotalDifficulty <value>
NETHERMIND_SYNCCONFIG_PIVOTTOTALDIFFICULTY
The total difficulty of the pivot block for the Fast sync mode. Defaults to
null
. -
--Sync.SnapSync <value>
NETHERMIND_SYNCCONFIG_SNAPSYNC
Whether to use the Snap sync mode. Allowed values:
true
false
. Defaults tofalse
. -
--Sync.SnapSyncAccountRangePartitionCount <value>
NETHERMIND_SYNCCONFIG_SNAPSYNCACCOUNTRANGEPARTITIONCOUNT
The number of account range partitions to create. Increases the Snap sync request concurrency. Allowed values are between between 1 and 256. Defaults to
8
. -
--Sync.StrictMode <value>
NETHERMIND_SYNCCONFIG_STRICTMODE
Whether to disable some optimizations and do a more extensive sync. Useful when sync state is corrupted. Allowed values:
true
false
. Defaults tofalse
. -
--Sync.SynchronizationEnabled <value>
NETHERMIND_SYNCCONFIG_SYNCHRONIZATIONENABLED
Whether to download and process new blocks. Allowed values:
true
false
. Defaults totrue
. -
--Sync.TuneDbMode <value>
NETHERMIND_SYNCCONFIG_TUNEDBMODE
Configure the database for write optimizations during sync. Significantly reduces the total number of writes and sync time if you are not network limited.
Allowed values:
Default
WriteBias
HeavyWrite
AggressiveHeavyWrite
DisableCompaction
EnableBlobFiles
HashDb
Defaults to
HeavyWrite
. -
--Sync.UseGethLimitsInFastBlocks <value>
NETHERMIND_SYNCCONFIG_USEGETHLIMITSINFASTBLOCKS
Whether to make smaller requests, in Fast Blocks mode, to avoid Geth from disconnecting. On the Geth-heavy networks (e.g., Mainnet), it's a desired behavior while on Nethermind- or OpenEthereum-heavy networks (Goerli, Aura), it slows down the sync by a factor of ~4. Allowed values:
true
false
. Defaults totrue
. -
--Sync.WitnessProtocolEnabled <value>
NETHERMIND_SYNCCONFIG_WITNESSPROTOCOLENABLED
Whether to enable the Witness protocol. Allowed values:
true
false
. Defaults tofalse
.
TraceStore
-
--TraceStore.BlocksToKeep <value>
NETHERMIND_TRACESTORECONFIG_BLOCKSTOKEEP
The number of blocks to store, counting from the head. If
0
, all traces of the processed blocks are stored. Defaults to10000
. -
--TraceStore.DeserializationParallelization <value>
NETHERMIND_TRACESTORECONFIG_DESERIALIZATIONPARALLELIZATION
The max parallelization when deserialization requests the
trace_filter
method.0
to use the number of logical processors. If you experience a resource shortage, set to a low number. Defaults to0
. -
--TraceStore.Enabled <value>
NETHERMIND_TRACESTORECONFIG_ENABLED
Whether to enable the TraceStore plugin. If enabled, traces come from the database whenever possible. Allowed values:
true
false
. Defaults tofalse
. -
--TraceStore.TraceTypes <value>
NETHERMIND_TRACESTORECONFIG_TRACETYPES
The type of traces to store.
Allowed values:
None
VmTrace
StateDiff
Trace
Rewards
All
Defaults to
Trace, Rewards
.
TxPool
-
--TxPool.BlobCacheSize <value>
NETHERMIND_TXPOOLCONFIG_BLOBCACHESIZE
The max number of full blob transactions cached in memory. The default value uses max 200MB for 6 blobs where one blob is 33MB (256 * 128KB) Defaults to
256
. -
--TxPool.BlobsSupport <value>
NETHERMIND_TXPOOLCONFIG_BLOBSSUPPORT
Blobs support mode:
Disabled
: No support for blob transactionsInMemory
: Blob transactions stored only in memoryStorage
: Blob transactions stored in dbStorageWithReorgs
: Blob transactions stored in db with support for restoring reorganized blob transactions to blob pool
Allowed values:
Disabled
InMemory
Storage
StorageWithReorgs
Defaults to
StorageWithReorgs
. -
--TxPool.GasLimit <value>
NETHERMIND_TXPOOLCONFIG_GASLIMIT
The max transaction gas allowed. Defaults to
null
. -
--TxPool.HashCacheSize <value>
NETHERMIND_TXPOOLCONFIG_HASHCACHESIZE
The max number of cached hashes of already known transactions. Set automatically by the memory hint. Defaults to
524288
. -
--TxPool.InMemoryBlobPoolSize <value>
NETHERMIND_TXPOOLCONFIG_INMEMORYBLOBPOOLSIZE
The max number of full blob transactions stored in memory. Used only if persistent storage is disabled. Defaults to
512
. -
--TxPool.MaxPendingBlobTxsPerSender <value>
NETHERMIND_TXPOOLCONFIG_MAXPENDINGBLOBTXSPERSENDER
The max number of pending blob transactions per single sender.
0
to lift the limit. Defaults to16
. -
--TxPool.MaxPendingTxsPerSender <value>
NETHERMIND_TXPOOLCONFIG_MAXPENDINGTXSPERSENDER
The max number of pending transactions per single sender.
0
to lift the limit. Defaults to0
. -
--TxPool.MinBaseFeeThreshold <value>
NETHERMIND_TXPOOLCONFIG_MINBASEFEETHRESHOLD
The minimal percentage of the current base fee that must be surpassed by the max fee (
max_fee_per_gas
) for the transaction to be broadcasted. Defaults to70
. -
--TxPool.PeerNotificationThreshold <value>
NETHERMIND_TXPOOLCONFIG_PEERNOTIFICATIONTHRESHOLD
The average percentage of transaction hashes from persistent broadcast sent to a peer together with hashes of the last added transactions. Defaults to
5
. -
--TxPool.PersistentBlobStorageSize <value>
NETHERMIND_TXPOOLCONFIG_PERSISTENTBLOBSTORAGESIZE
The max number of full blob transactions stored in the database (increasing the number of transactions in the blob pool also results in higher memory usage). The default value uses max 13GB for 6 blobs where one blob is 2GB (16386 * 128KB). Defaults to
16384
. -
--TxPool.ReportMinutes <value>
NETHERMIND_TXPOOLCONFIG_REPORTMINUTES
The current transaction pool state reporting interval, in minutes. Defaults to
null
. -
--TxPool.Size <value>
NETHERMIND_TXPOOLCONFIG_SIZE
The max number of transactions held in the mempool (the more transactions in the mempool, the more memory used). Defaults to
2048
.
Wallet
-
--Wallet.DevAccounts <value>
NETHERMIND_WALLETCONFIG_DEVACCOUNTS
The number of autogenerated developer accounts to work with. Developer accounts have private keys from
00...01
to00...n
. Defaults to10
.
Environment variables
To configure Nethermind using environment variables, the following naming convention is used in all uppercase:
NETHERMIND_{NAMESPACE}CONFIG_{PROPERTY_NAME}
For instance, the environment variable equivalent of the command line --JsonRpc.JwtSecretFile
option is NETHERMIND_JSONRPCCONFIG_JWTSECRETFILE
. For the list of configuration namespaces and their options, see Options by namespaces.
Configuration file
The configuration file is a JSON file with .cfg
extension. The bundled configuration files are located in the configs
directory and named after the network they are used for. For instance, see the Mainnet configuration file mainnet.cfg
.