besu-hidden-command-line
command line options for hyperledger besu that are not "generally available"
Experimental offline backup and restore: operator x-backup-state
and operator x-restore-state
CLI option --Xnat-kube-pod-name
to specify the name of the loadbalancer used by the Kubernetes nat manager
The Tracing API is no longer an Early Access feature and now has full support for trace_replayBlockTransactions
, trace_Block
and trace_transaction
.
besu/src/main/java/org/hyperledger/besu/cli/UnstableOptionsSubCommand
🥺 Just Don't.
Unstable options for experimentalEIPs
--Xberlin-enabled=<berlinEnabled>
Enable non-finalized Berlin features (default: false)
--Xeip1559-basefee-max-change-denominator=<basefeeMaxChangeDenominator>
--Xeip1559-decay-range=<decayRange>
--Xeip1559-enabled=<eip1559Enabled>
Enable experimental EIP-1559 fee market change (default: false)
--Xeip1559-initial-base-fee=<initialBasefee>
--Xeip1559-per-tx-gas-limit=<perTxGasLimit>
--Xeip1559-slack-coefficient=<slackCoefficient>
--Xeip1559-target-gas-used=<targetGasUsed>
Unstable options for Ethereum Wire Protocol
--Xeth-65-enabled Enable the Eth/65 subprotocol. (default: false)
--Xewp-max-get-bodies=<INTEGER>
Maximum request limit for Ethereum Wire Protocol
GET_BLOCK_BODIES. (default: +128)
--Xewp-max-get-headers=<INTEGER>
Maximum request limit for Ethereum Wire Protocol
GET_BLOCK_HEADERS. (default: +192)
--Xewp-max-get-node-data=<INTEGER>
Maximum request limit for Ethereum Wire Protocol
GET_NODE_DATA. (default: +384)
--Xewp-max-get-pooled-transactions=<INTEGER>
Maximum request limit for Ethereum Wire Protocol
GET_POOLED_TRANSACTIONS. (default: +256)
--Xewp-max-get-receipts=<INTEGER>
Maximum request limit for Ethereum Wire Protocol
GET_RECEIPTS. (default: +256)
Unstable options for Metrics
--Xmetrics-timers-enabled
Whether to enable timer metrics (default: true).
Unstable options for P2P Network
--Xp2p-check-maintained-connections-frequency=<INTEGER>
The frequency (in seconds) at which to check maintained connections
(default: 60)
--Xp2p-initiate-connections-frequency=<INTEGER>
The frequency (in seconds) at which to initiate new outgoing
connections (default: 30)
Unstable options for Synchronizer
--Xsynchronizer-block-propagation-range=<LONG>..<LONG>
Range around chain head where inbound blocks are propagated (default:
-10..30)
--Xsynchronizer-computation-parallelism=<INTEGER>
Number of threads to make available for bulk hash computations during
downloads (default: # of processors)
--Xsynchronizer-downloader-chain-segment-size=<INTEGER>
Distance between checkpoint headers (default: 200)
--Xsynchronizer-downloader-change-target-threshold-by-height=<LONG>
Minimum height difference before switching fast sync download peers
(default: 200)
--Xsynchronizer-downloader-change-target-threshold-by-td=<UINT256>
Minimum total difficulty difference before switching fast sync
download peers (default: 1000000000000000000)
--Xsynchronizer-downloader-checkpoint-timeouts-permitted=<INTEGER>
Number of tries to attempt to download checkpoints before stopping
(default: 5)
--Xsynchronizer-downloader-header-request-size=<INTEGER>
Number of headers to request per packet (default: 200)
--Xsynchronizer-downloader-parallelism=<INTEGER>
Number of threads to provide to chain downloader (default: 4)
--Xsynchronizer-fast-sync-full-validation-rate=<FLOAT>
Fraction of headers fast sync will fully validate (default: 0.1)
--Xsynchronizer-fast-sync-pivot-distance=<INTEGER>
Distance from initial chain head to fast sync target (default: 50)
--Xsynchronizer-transactions-parallelism=<INTEGER>
Number of threads to commit to transaction processing (default: 2)
--Xsynchronizer-world-state-hash-count-per-request=<INTEGER>
Fast sync world state hashes queried per request (default: 384)
--Xsynchronizer-world-state-max-requests-without-progress=<INTEGER>
Number of world state requests accepted without progress before
considering the download stalled (default: 1000)
--Xsynchronizer-world-state-min-millis-before-stalling=<LONG>
Minimum time in ms without progress before considering a world state
download as stalled (default: 300000)
--Xsynchronizer-world-state-request-parallelism=<INTEGER>
Number of concurrent requests to use when downloading fast sync world
state (default: 10)
--Xsynchronizer-world-state-task-cache-size=<INTEGER>
The max number of pending node data requests cached in-memory during
fast sync world state download. (default: 1000000)
Unstable options for TransactionPool
--Xincoming-tx-messages-keep-alive-seconds=<INTEGER>
Keep alive of incoming transaction messages in seconds (default: 60)
Unstable options for Plugin rocksdb
--Xplugin-rocksdb-background-thread-count=<INTEGER>
Number of RocksDB background threads (default: 4)
--Xplugin-rocksdb-cache-capacity=<LONG>
Cache capacity of RocksDB (default: 8388608)
--Xplugin-rocksdb-max-background-compactions=<INTEGER>
Maximum number of RocksDB background compactions (default: 4)
--Xplugin-rocksdb-max-open-files=<INTEGER>
Max number of files RocksDB will open (default: 1024)
Option
cli: --override-genesis-config
paramLabel: NAME=VALUE",
description: Overrides configuration values in the genesis file. Use with care.",
> 💣 This is for aborting a planned hardfork, see Petersburg
`private final Map<String, String> genesisConfigOverrides =
new TreeMap<>(String.CASE_INSENSITIVE_ORDER);`
Additional Hidden Command Options
Command
cli: --Xsecp256k1-native-enabled
description: Path to PID file `optional`
`private final Boolean nativeSecp256k1 = Boolean.TRUE;`
Command
cli: --Xaltbn128-native-enabled
description: Path to PID file `optional`
`private final Boolean nativeAltbn128 = Boolean.TRUE;`
Command
cli: --Xhttp-timeout-seconds
description: HTTP timeout in seconds (default: ${DEFAULT-VALUE})",
`private final Long httpTimeoutSec = TimeoutOptions.defaultOptions().getTimeoutSeconds();`
Command
cli: --Xws-timeout-seconds
description: Web socket timeout in seconds (default: ${DEFAULT-VALUE})",
`private final Long wsTimeoutSec = TimeoutOptions.defaultOptions().getTimeoutSeconds();`
Command
cli: --Xminer-stratum-extranonce
description: Extranonce for Stratum network miners (default: ${DEFAULT-VALUE})")
`private String stratumExtranonce: 080c";`
As of Besu 1.5
Additional Options like --ottoman
are P.B. or Pre-Besu
and have been removed. Will compile a list of historical command line options maybe if there is interest along with other clients. Geth has much more, even options not technically documented in the code itself as parts of its API do not conform to its specification.
CC BY 4.0 and/or Apache-2.0.