Version: 1.27.0

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

note

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.

warning

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.

warning
The absolute paths set by Init.BaseDbPath, Init.LogDirectory, or KeyStore.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 to INFO.
-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 to false.
--Aura.ForceSealing <value> NETHERMIND_AURACONFIG_FORCESEALING

Whether to seal empty blocks if mining. Allowed values: true false. Defaults to true.
--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 to false.
--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.PreWarmStateOnBlockProcessing <value> NETHERMIND_BLOCKSCONFIG_PREWARMSTATEONBLOCKPROCESSING

Try to pre-warm the state when processing blocks. Can lead to 2x speedup in main loop block processing. Allowed values: true false. Defaults to True.
--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 to false.
--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 to true.
--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 to false.
--Bloom.MigrationStatistics <value> NETHERMIND_BLOOMCONFIG_MIGRATIONSTATISTICS

Whether the migration statistics should be calculated and output. Allowed values: true false. Defaults to false.

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 to false.
--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 to false.
--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 to false.
--HealthChecks.LowStorageSpaceShutdownThreshold <value> NETHERMIND_HEALTHCHECKSCONFIG_LOWSTORAGESPACESHUTDOWNTHRESHOLD

The percentage of available disk space below which Nethermind shuts down. 0 to disable. Defaults to 1.
--HealthChecks.LowStorageSpaceWarningThreshold <value> NETHERMIND_HEALTHCHECKSCONFIG_LOWSTORAGESPACEWARNINGTHRESHOLD

The percentage of available disk space below which a warning is displayed. 0 to disable. Defaults to 5.
--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 to false.
--HealthChecks.WebhooksEnabled <value> NETHERMIND_HEALTHCHECKSCONFIG_WEBHOOKSENABLED

Whether to enable web hooks. Allowed values: true false. Defaults to false.

--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 to false.
--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 combines Receipts and Rlp.

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 to true.
--Init.EnableUnsecuredDevWallet <value> NETHERMIND_INITCONFIG_ENABLEUNSECUREDDEVWALLET

Whether to enable the in-app wallet/keystore. Allowed values: true false. Defaults to false.
--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 to false.
--Init.KeepDevWalletInMemory <value> NETHERMIND_INITCONFIG_KEEPDEVWALLETINMEMORY

Whether to create session-only accounts and delete them on shutdown. Allowed values: true false. Defaults to false.
--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 to null.
--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 to true.
--Init.ProcessingEnabled <value> NETHERMIND_INITCONFIG_PROCESSINGENABLED

Whether to download/process new blocks. Allowed values: true false. Defaults to true.
--Init.RpcDbUrl <value> NETHERMIND_INITCONFIG_RPCDBURL

The URL of the remote node used as a database source when DiagnosticMode is set to RpcDb.
--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 to true.

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 of Transfer-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 to false.
--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 to false.
--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.EstimateErrorMargin <value> NETHERMIND_JSONRPCCONFIG_ESTIMATEERRORMARGIN

The error margin used in eth_estimateGas expressed in basis points. Defaults to 150.
--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 and eth_estimateGas. Defaults to 100000000.
--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.MaxLogsPerResponse <value> NETHERMIND_JSONRPCCONFIG_MAXLOGSPERRESPONSE

The max number of logs per response. For method eth_getLogs. If 0 then no limit. Defaults to 20000.
--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 to 500.
--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 in node.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 in node.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 and Passwords. 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 disable
- 0 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) if SweepMemory is set to Gen2.

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 to true.
--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 to true.
--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 to false.
--Metrics.Enabled <value> NETHERMIND_METRICSCONFIG_ENABLED

Whether to publish various metrics to Prometheus Pushgateway at a given interval. Allowed values: true false. Defaults to false.
--Metrics.EnableDbSizeMetrics <value> NETHERMIND_METRICSCONFIG_ENABLEDBSIZEMETRICS

Whether to publish database size metrics. Allowed values: true false. Defaults to true.
--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 to localhost 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 to false.
--Mining.Signer <value> NETHERMIND_MININGCONFIG_SIGNER

Url for an external signer like clef: https://github.com/ethereum/go-ethereum/blob/master/cmd/clef/tutorial.md Defaults to null.

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 to false.
--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 to null.
--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 to 30303.
--Network.EnableUPnP <value> NETHERMIND_NETWORKCONFIG_ENABLEUPNP

Whether to enable automatic port forwarding via UPnP. Allowed values: true false. Defaults to false.
--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 to false.
--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 to null.

Optimism

--Optimism.SequencerUrl <value> NETHERMIND_OPTIMISMCONFIG_SEQUENCERURL

Sequencer address Defaults to null.

Pruning

--Pruning.AvailableSpaceCheckEnabled <value> NETHERMIND_PRUNINGCONFIG_AVAILABLESPACECHECKENABLED

Whether to enables available disk space check. Allowed values: true false. Defaults to true.
--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 to false.
--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 processors
- 0 to use 25% of logical processors
- 1 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 or 1 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 to 0.
--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 to 4000.
--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 and FullPruningTrigger. Defaults to 256000.
--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 pruning
- Full: Full pruning
- Hybrid: 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 each Nth block even if not required by cache memory usage. Defaults to 8192.
--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 to true.
--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 to true.
--Receipt.ReceiptsMigration <value> NETHERMIND_RECEIPTCONFIG_RECEIPTSMIGRATION

Whether to migrate the receipts database to the new schema. Allowed values: true false. Defaults to false.
--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 to true.
--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 to 2350000.

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 to false.
--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 to true. 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 to true. 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 to true.
--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 to true.
--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 to true.
--Sync.ExitOnSynced <value> NETHERMIND_SYNCCONFIG_EXITONSYNCED

Whether to shut down Nethermind once sync is finished. Allowed values: true false. Defaults to false.
--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 to false.
--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 to false.
--Sync.FixTotalDifficulty <value> NETHERMIND_SYNCCONFIG_FIXTOTALDIFFICULTY

Whether to recalculate the total difficulty from FixTotalDifficultyStartingBlock to FixTotalDifficultyLastBlock. Allowed values: true false. Defaults to false.
--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 to 0.
--Sync.NetworkingEnabled <value> NETHERMIND_SYNCCONFIG_NETWORKINGENABLED

Whether to connect to peers and sync. Allowed values: true false. Defaults to true.
--Sync.NonValidatorNode <value> NETHERMIND_SYNCCONFIG_NONVALIDATORNODE

Whether to operate as a non-validator. If true, the DownloadReceiptsInFastSync and DownloadBodiesInFastSync can be set to false. Allowed values: true false. Defaults to false.
--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 to false.
--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 to false.
--Sync.SynchronizationEnabled <value> NETHERMIND_SYNCCONFIG_SYNCHRONIZATIONENABLED

Whether to download and process new blocks. Allowed values: true false. Defaults to true.
--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 (Aura), it slows down the sync by a factor of ~4. Allowed values: true false. Defaults to true.

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 to 10000.
--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 to 0.
--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 to false.
--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 transactions
- InMemory: Blob transactions stored only in memory
- Storage: Blob transactions stored in db
- StorageWithReorgs: 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 to 16.
--TxPool.MaxPendingTxsPerSender <value> NETHERMIND_TXPOOLCONFIG_MAXPENDINGTXSPERSENDER

The max number of pending transactions per single sender. 0 to lift the limit. Defaults to 0.
--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 to 70.
--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 to 00...n. Defaults to 10.

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.

Command line options​

Basic options​

Options by namespaces​

Aura​

Blocks​

Bloom​

EthStats​

HealthChecks​

Hive​

Init​

JsonRpc​

KeyStore​

Merge​

Metrics​

Mining​

Network​

Optimism​

Pruning​

Receipt​

Seq​

Snapshot​

Sync​

TraceStore​

TxPool​

Wallet​

Environment variables​

Configuration file​