mirror of
https://github.com/sigp/lighthouse.git
synced 2026-03-04 09:11:42 +00:00
43c5e924d7
Addresses #8218
A simplified version of #8241 for the initial release.
I've tried to minimise the logic change in this PR, although introducing the `NodeCustodyType` enum still result in quite a bit a of diff, but the actual logic change in `CustodyContext` is quite small.
The main changes are in the `CustdoyContext` struct
* ~~combining `validator_custody_count` and `current_is_supernode` fields into a single `custody_group_count_at_head` field. We persist the cgc of the initial cli values into the `custody_group_count_at_head` field and only allow for increase (same behaviour as before).~~
* I noticed the above approach caused a backward compatibility issue, I've [made a fix](15569bc085) and changed the approach slightly (which was actually what I had originally in mind):
* when initialising, only override the `validator_custody_count` value if either flag `--supernode` or `--semi-supernode` is used; otherwise leave it as the existing default `0`. Most other logic remains unchanged.
All existing validator custody unit tests are still all passing, and I've added additional tests to cover semi-supernode, and restoring `CustodyContext` from disk.
Note: I've added a `WARN` if the user attempts to switch to a `--semi-supernode` or `--supernode` - this currently has no effect, but once @eserilev column backfill is merged, we should be able to support this quite easily.
Things to test
- [x] cgc in metadata / enr
- [x] cgc in metrics
- [x] subscribed subnets
- [x] getBlobs endpoint
Co-Authored-By: Jimmy Chen <jchen.tc@gmail.com>
1638 lines
74 KiB
Rust
1638 lines
74 KiB
Rust
use std::time::Duration;
|
|
|
|
use clap::{Arg, ArgAction, ArgGroup, Command, builder::ArgPredicate, crate_version};
|
|
use clap_utils::{FLAG_HEADER, get_color_style};
|
|
use strum::VariantNames;
|
|
|
|
#[allow(clippy::large_stack_frames)]
|
|
pub fn cli_app() -> Command {
|
|
Command::new("beacon_node")
|
|
.display_order(0)
|
|
.visible_aliases(["b", "bn", "beacon"])
|
|
.version(crate_version!())
|
|
.author("Sigma Prime <contact@sigmaprime.io>")
|
|
.styles(get_color_style())
|
|
.about("The primary component which connects to the Ethereum 2.0 P2P network and \
|
|
downloads, verifies and stores blocks. Provides a HTTP API for querying \
|
|
the beacon chain and publishing messages to the network.")
|
|
/*
|
|
* Configuration directory locations.
|
|
*/
|
|
.arg(
|
|
Arg::new("network-dir")
|
|
.long("network-dir")
|
|
.value_name("DIR")
|
|
.help("Data directory for network keys. Defaults to network/ inside the beacon node \
|
|
dir.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("freezer-dir")
|
|
.long("freezer-dir")
|
|
.value_name("DIR")
|
|
.help("Data directory for the freezer database.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("blobs-dir")
|
|
.long("blobs-dir")
|
|
.value_name("DIR")
|
|
.help("Data directory for the blobs database.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
/*
|
|
* Network parameters.
|
|
*/
|
|
.arg(
|
|
Arg::new("supernode")
|
|
.long("supernode")
|
|
.alias("subscribe-all-data-column-subnets")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("Run as a voluntary supernode. This node will subscribe to all data column \
|
|
subnets, custody all data columns, and perform reconstruction and cross-seeding. \
|
|
This requires significantly more bandwidth, storage, and computation requirements but \
|
|
the node will have direct access to all blobs via the beacon API and it \
|
|
helps network resilience by serving all data columns to syncing peers.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("semi-supernode")
|
|
.long("semi-supernode")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.conflicts_with("supernode")
|
|
.help("Run in minimal reconstruction mode. This node will subscribe to and custody \
|
|
half of the data columns (enough for reconstruction), enabling efficient \
|
|
data availability with lower bandwidth and storage requirements compared to \
|
|
a supernode, while still supporting full blob reconstruction.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("malicious-withhold-count")
|
|
.long("malicious-withhold-count")
|
|
.action(ArgAction::Set)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("TESTING ONLY: Withholds a subset of data columns during publishing. \
|
|
Do not use in production. Requires the 'testing' feature to be enabled.")
|
|
.hide(true)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("advertise-false-custody-group-count")
|
|
.long("advertise-false-custody-group-count")
|
|
.action(ArgAction::Set)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("TESTING ONLY: Advertises a false custody group count for testing PeerDAS. \
|
|
Do not use in production. Requires the 'testing' feature to be enabled.")
|
|
.hide(true)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("blob-publication-batches")
|
|
.long("blob-publication-batches")
|
|
.action(ArgAction::Set)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("Number of batches that the node splits blobs or data columns into during publication. This doesn't apply if the node is the block proposer. Used in PeerDAS only.")
|
|
.display_order(0)
|
|
.hide(true)
|
|
)
|
|
.arg(
|
|
Arg::new("blob-publication-batch-interval")
|
|
.long("blob-publication-batch-interval")
|
|
.action(ArgAction::Set)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("The delay in milliseconds applied by the node between sending each blob or data column batch. This doesn't apply if the node is the block proposer.")
|
|
.display_order(0)
|
|
.hide(true)
|
|
)
|
|
.arg(
|
|
Arg::new("subscribe-all-subnets")
|
|
.long("subscribe-all-subnets")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("Subscribe to all subnets regardless of validator count. \
|
|
This will also advertise the beacon node as being long-lived subscribed to all subnets.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("import-all-attestations")
|
|
.long("import-all-attestations")
|
|
.help("Import and aggregate all attestations, regardless of validator subscriptions. \
|
|
This will only import attestations from already-subscribed subnets, use with \
|
|
--subscribe-all-subnets to ensure all attestations are received for import.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.global(true)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-packet-filter")
|
|
.long("disable-packet-filter")
|
|
.help("Disables the discovery packet filter. Useful for testing in smaller networks")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("shutdown-after-sync")
|
|
.long("shutdown-after-sync")
|
|
.help("Shutdown beacon node as soon as sync is completed. Backfill sync will \
|
|
not be performed before shutdown.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("zero-ports")
|
|
.long("zero-ports")
|
|
.short('z')
|
|
.help("Sets all listening TCP/UDP ports to 0, allowing the OS to choose some \
|
|
arbitrary free ports.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("listen-address")
|
|
.long("listen-address")
|
|
.value_name("ADDRESS")
|
|
.help("The address lighthouse will listen for UDP and TCP connections. To listen \
|
|
over IPv4 and IPv6 set this flag twice with the different values.\n\
|
|
Examples:\n\
|
|
- --listen-address '0.0.0.0' will listen over IPv4.\n\
|
|
- --listen-address '::' will listen over IPv6.\n\
|
|
- --listen-address '0.0.0.0' --listen-address '::' will listen over both \
|
|
IPv4 and IPv6. The order of the given addresses is not relevant. However, \
|
|
multiple IPv4, or multiple IPv6 addresses will not be accepted. \
|
|
If omitted, Lighthouse will listen on all interfaces, for both IPv4 and IPv6.")
|
|
.action(ArgAction::Append)
|
|
.num_args(0..=2)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("port")
|
|
.long("port")
|
|
.value_name("PORT")
|
|
.help("The TCP/UDP ports to listen on. There are two UDP ports. \
|
|
The discovery UDP port will be set to this value and the Quic UDP port will be set to this value + 1. The discovery port can be modified by the \
|
|
--discovery-port flag and the quic port can be modified by the --quic-port flag. If listening over both IPv4 and IPv6 the --port flag \
|
|
will apply to the IPv4 address and --port6 to the IPv6 address.")
|
|
.default_value("9000")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("port6")
|
|
.long("port6")
|
|
.value_name("PORT")
|
|
.help("The TCP/UDP ports to listen on over IPv6 when listening over both IPv4 and \
|
|
IPv6. Defaults to --port. The Quic UDP port will be set to this value + 1.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("discovery-port")
|
|
.long("discovery-port")
|
|
.value_name("PORT")
|
|
.help("The UDP port that discovery will listen on. Defaults to `port`")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("quic-port")
|
|
.long("quic-port")
|
|
.value_name("PORT")
|
|
.help("The UDP port that quic will listen on. Defaults to `port` + 1")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("discovery-port6")
|
|
.long("discovery-port6")
|
|
.value_name("PORT")
|
|
.help("The UDP port that discovery will listen on over IPv6 if listening over \
|
|
both IPv4 and IPv6. Defaults to `port6`")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("quic-port6")
|
|
.long("quic-port6")
|
|
.value_name("PORT")
|
|
.help("The UDP port that quic will listen on over IPv6 if listening over \
|
|
both IPv4 and IPv6. Defaults to `port6` + 1")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("target-peers")
|
|
.long("target-peers")
|
|
.help("The target number of peers.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("boot-nodes")
|
|
.long("boot-nodes")
|
|
.allow_hyphen_values(true)
|
|
.value_name("ENR/MULTIADDR LIST")
|
|
.help("One or more comma-delimited base64-encoded ENR's to bootstrap the p2p network. Multiaddr is also supported.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("network-load")
|
|
.long("network-load")
|
|
.value_name("INTEGER")
|
|
.help("Lighthouse's network can be tuned for bandwidth/performance. Setting this to a high value, will increase the bandwidth lighthouse uses, increasing the likelihood of redundant information in exchange for faster communication. This can increase profit of validators marginally by receiving messages faster on the network. Lower values decrease bandwidth usage, but makes communication slower which can lead to validator performance reduction. Values are in the range [1,5].")
|
|
.hide(true)
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-upnp")
|
|
.long("disable-upnp")
|
|
.help("Disables UPnP support. Setting this will prevent Lighthouse from attempting to automatically establish external port mappings.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("private")
|
|
.long("private")
|
|
.help("Prevents sending various client identification information.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("enr-udp-port")
|
|
.long("enr-udp-port")
|
|
.value_name("PORT")
|
|
.help("The UDP4 port of the local ENR. Set this only if you are sure other nodes \
|
|
can connect to your local node on this port over IPv4.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("enr-quic-port")
|
|
.long("enr-quic-port")
|
|
.value_name("PORT")
|
|
.help("The quic UDP4 port that will be set on the local ENR. Set this only if you are sure other nodes \
|
|
can connect to your local node on this port over IPv4.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("enr-udp6-port")
|
|
.long("enr-udp6-port")
|
|
.value_name("PORT")
|
|
.help("The UDP6 port of the local ENR. Set this only if you are sure other nodes \
|
|
can connect to your local node on this port over IPv6.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("enr-quic6-port")
|
|
.long("enr-quic6-port")
|
|
.value_name("PORT")
|
|
.help("The quic UDP6 port that will be set on the local ENR. Set this only if you are sure other nodes \
|
|
can connect to your local node on this port over IPv6.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("enr-tcp-port")
|
|
.long("enr-tcp-port")
|
|
.value_name("PORT")
|
|
.help("The TCP4 port of the local ENR. Set this only if you are sure other nodes \
|
|
can connect to your local node on this port over IPv4. The --port flag is \
|
|
used if this is not set.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("enr-tcp6-port")
|
|
.long("enr-tcp6-port")
|
|
.value_name("PORT")
|
|
.help("The TCP6 port of the local ENR. Set this only if you are sure other nodes \
|
|
can connect to your local node on this port over IPv6. The --port6 flag is \
|
|
used if this is not set.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("enr-address")
|
|
.long("enr-address")
|
|
.value_name("ADDRESS")
|
|
.help("The IP address/ DNS address to broadcast to other peers on how to reach \
|
|
this node. If a DNS address is provided, the enr-address is set to the IP \
|
|
address it resolves to and does not auto-update based on PONG responses in \
|
|
discovery. Set this only if you are sure other nodes can connect to your \
|
|
local node on this address. This will update the `ip4` or `ip6` ENR fields \
|
|
accordingly. To update both, set this flag twice with the different values.")
|
|
.action(ArgAction::Append)
|
|
.num_args(1..=2)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("enr-match")
|
|
.short('e')
|
|
.long("enr-match")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("Sets the local ENR IP address and port to match those set for lighthouse. \
|
|
Specifically, the IP address will be the value of --listen-address and the \
|
|
UDP port will be --discovery-port.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-enr-auto-update")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.long("disable-enr-auto-update")
|
|
.help("Discovery automatically updates the nodes local ENR with an external IP address and port as seen by other peers on the network. \
|
|
This disables this feature, fixing the ENR's IP/PORT to those specified on boot.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("libp2p-addresses")
|
|
.long("libp2p-addresses")
|
|
.value_name("MULTIADDR")
|
|
.help("One or more comma-delimited multiaddrs to manually connect to a libp2p peer \
|
|
without an ENR.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
// NOTE: This is hide because it is primarily a developer feature for testnets and
|
|
// debugging. We remove it from the list to avoid clutter.
|
|
.arg(
|
|
Arg::new("disable-discovery")
|
|
.long("disable-discovery")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("Disables the discv5 discovery protocol. The node will not search for new peers or participate in the discovery protocol.")
|
|
.hide(true)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-quic")
|
|
.long("disable-quic")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("Disables the quic transport. The node will rely solely on the TCP transport for libp2p connections.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-peer-scoring")
|
|
.long("disable-peer-scoring")
|
|
.help("Disables peer scoring in lighthouse. WARNING: This is a dev only flag is only meant to be used in local testing scenarios \
|
|
Using this flag on a real network may cause your node to become eclipsed and see a different view of the network")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.hide(true)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("trusted-peers")
|
|
.long("trusted-peers")
|
|
.value_name("TRUSTED_PEERS")
|
|
.help("One or more comma-delimited trusted peer ids which always have the highest score according to the peer scoring system.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("genesis-backfill")
|
|
.long("genesis-backfill")
|
|
.help("Attempts to download blocks all the way back to genesis when checkpoint syncing.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("complete-blob-backfill")
|
|
.long("complete-blob-backfill")
|
|
.help("Download all blobs back to the Deneb fork epoch. This will likely result in \
|
|
the node banning most of its peers.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
.hide(true)
|
|
)
|
|
.arg(
|
|
Arg::new("enable-private-discovery")
|
|
.long("enable-private-discovery")
|
|
.help("Lighthouse by default does not discover private IP addresses. Set this flag to enable connection attempts to local addresses.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-self-limiter")
|
|
.long("disable-self-limiter")
|
|
.help(
|
|
"Disables the outbound rate limiter (requests sent by this node)."
|
|
)
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("self-limiter-protocols")
|
|
.long("self-limiter-protocols")
|
|
.help(
|
|
"Enables the outbound rate limiter (requests made by this node).\
|
|
\
|
|
Rate limit quotas per protocol can be set in the form of \
|
|
<protocol_name>:<tokens>/<time_in_seconds>. To set quotas for multiple protocols, \
|
|
separate them by ';'. If the self rate limiter is enabled and a protocol is not \
|
|
present in the configuration, the quotas used for the inbound rate limiter will be \
|
|
used."
|
|
)
|
|
.action(ArgAction::Append)
|
|
.value_delimiter(';')
|
|
.conflicts_with("disable-self-limiter")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("proposer-only")
|
|
.long("proposer-only")
|
|
.help("Sets this beacon node at be a block proposer only node. \
|
|
This will run the beacon node in a minimal configuration that is sufficient for block publishing only. This flag should be used \
|
|
for a beacon node being referenced by validator client using the --proposer-node flag. This configuration is for enabling more secure setups.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-inbound-rate-limiter")
|
|
.long("disable-inbound-rate-limiter")
|
|
.help(
|
|
"Disables the inbound rate limiter (requests received by this node)."
|
|
)
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("inbound-rate-limiter-protocols")
|
|
.long("inbound-rate-limiter-protocols")
|
|
.help(
|
|
"Configures the inbound rate limiter (requests received by this node).\
|
|
\
|
|
Rate limit quotas per protocol can be set in the form of \
|
|
<protocol_name>:<tokens>/<time_in_seconds>. To set quotas for multiple protocols, \
|
|
separate them by ';'. \
|
|
\
|
|
This is enabled by default, using default quotas. To disable rate limiting use \
|
|
the disable-inbound-rate-limiter flag instead."
|
|
)
|
|
.action(ArgAction::Set)
|
|
.conflicts_with("disable-inbound-rate-limiter")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-backfill-rate-limiting")
|
|
.long("disable-backfill-rate-limiting")
|
|
.help("Disable the backfill sync rate-limiting. This allow users to just sync the entire chain as fast \
|
|
as possible, however it can result in resource contention which degrades staking performance. Stakers \
|
|
should generally choose to avoid this flag since backfill sync is not required for staking.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
/* REST API related arguments */
|
|
.arg(
|
|
Arg::new("http")
|
|
.long("http")
|
|
.help("Enable the RESTful HTTP API server. Disabled by default.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("http-address")
|
|
.long("http-address")
|
|
.requires("enable_http")
|
|
.value_name("ADDRESS")
|
|
.help("Set the listen address for the RESTful HTTP API server.")
|
|
.default_value_if("enable_http", ArgPredicate::IsPresent, "127.0.0.1")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("http-port")
|
|
.long("http-port")
|
|
.requires("enable_http")
|
|
.value_name("PORT")
|
|
.help("Set the listen TCP port for the RESTful HTTP API server.")
|
|
.default_value_if("enable_http", ArgPredicate::IsPresent, "5052")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("http-allow-origin")
|
|
.long("http-allow-origin")
|
|
.requires("enable_http")
|
|
.value_name("ORIGIN")
|
|
.help("Set the value of the Access-Control-Allow-Origin response HTTP header. \
|
|
Use * to allow any origin (not recommended in production). \
|
|
If no value is supplied, the CORS allowed origin is set to the listen \
|
|
address of this server (e.g., http://localhost:5052).")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("http-enable-tls")
|
|
.long("http-enable-tls")
|
|
.help("Serves the RESTful HTTP API server over TLS. This feature is currently \
|
|
experimental.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.requires("http-tls-cert")
|
|
.requires("http-tls-key")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("http-tls-cert")
|
|
.long("http-tls-cert")
|
|
.requires("enable_http")
|
|
.help("The path of the certificate to be used when serving the HTTP API server \
|
|
over TLS.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("http-tls-key")
|
|
.long("http-tls-key")
|
|
.requires("enable_http")
|
|
.help("The path of the private key to be used when serving the HTTP API server \
|
|
over TLS. Must not be password-protected.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("http-sse-capacity-multiplier")
|
|
.long("http-sse-capacity-multiplier")
|
|
.requires("enable_http")
|
|
.action(ArgAction::Set)
|
|
.default_value_if("enable_http", ArgPredicate::IsPresent, "1")
|
|
.value_name("N")
|
|
.help("Multiplier to apply to the length of HTTP server-sent-event (SSE) channels. \
|
|
Increasing this value can prevent messages from being dropped.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("http-duplicate-block-status")
|
|
.long("http-duplicate-block-status")
|
|
.requires("enable_http")
|
|
.action(ArgAction::Set)
|
|
.default_value_if("enable_http", ArgPredicate::IsPresent, "202")
|
|
.value_name("STATUS_CODE")
|
|
.help("Status code to send when a block that is already known is POSTed to the \
|
|
HTTP API.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("http-enable-beacon-processor")
|
|
.long("http-enable-beacon-processor")
|
|
.requires("enable_http")
|
|
.value_name("BOOLEAN")
|
|
.help("The beacon processor is a scheduler which provides quality-of-service and \
|
|
DoS protection. When set to \"true\", HTTP API requests will be queued and scheduled \
|
|
alongside other tasks. When set to \"false\", HTTP API responses will be executed \
|
|
immediately.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
.default_value_if("enable_http", ArgPredicate::IsPresent, "true")
|
|
)
|
|
/* Prometheus metrics HTTP server related arguments */
|
|
.arg(
|
|
Arg::new("metrics")
|
|
.long("metrics")
|
|
.help("Enable the Prometheus metrics HTTP server. Disabled by default.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("metrics-address")
|
|
.long("metrics-address")
|
|
.value_name("ADDRESS")
|
|
.requires("metrics")
|
|
.help("Set the listen address for the Prometheus metrics HTTP server.")
|
|
.default_value_if("metrics", ArgPredicate::IsPresent, "127.0.0.1")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("metrics-port")
|
|
.long("metrics-port")
|
|
.requires("metrics")
|
|
.value_name("PORT")
|
|
.help("Set the listen TCP port for the Prometheus metrics HTTP server.")
|
|
.default_value_if("metrics", ArgPredicate::IsPresent, "5054")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("metrics-allow-origin")
|
|
.long("metrics-allow-origin")
|
|
.value_name("ORIGIN")
|
|
.requires("metrics")
|
|
.help("Set the value of the Access-Control-Allow-Origin response HTTP header. \
|
|
Use * to allow any origin (not recommended in production). \
|
|
If no value is supplied, the CORS allowed origin is set to the listen \
|
|
address of this server (e.g., http://localhost:5054).")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("shuffling-cache-size")
|
|
.long("shuffling-cache-size")
|
|
.help("Some HTTP API requests can be optimised by caching the shufflings at each epoch. \
|
|
This flag allows the user to set the shuffling cache size in epochs. \
|
|
Shufflings are dependent on validator count and setting this value to a large number can consume a large amount of memory.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("idontwant-message-size-threshold")
|
|
.long("idontwant-message-size-threshold")
|
|
.help("Specifies the minimum message size for which IDONTWANT messages are sent. \
|
|
This an optimization strategy to not send IDONTWANT messages for smaller messages.")
|
|
.action(ArgAction::Set)
|
|
.hide(true)
|
|
.display_order(0)
|
|
)
|
|
/*
|
|
* Monitoring metrics
|
|
*/
|
|
|
|
.arg(
|
|
Arg::new("monitoring-endpoint")
|
|
.long("monitoring-endpoint")
|
|
.value_name("ADDRESS")
|
|
.help("Enables the monitoring service for sending system metrics to a remote endpoint. \
|
|
This can be used to monitor your setup on certain services (e.g. beaconcha.in). \
|
|
This flag sets the endpoint where the beacon node metrics will be sent. \
|
|
Note: This will send information to a remote sever which may identify and associate your \
|
|
validators, IP address and other personal information. Always use a HTTPS connection \
|
|
and never provide an untrusted URL.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("monitoring-endpoint-period")
|
|
.long("monitoring-endpoint-period")
|
|
.value_name("SECONDS")
|
|
.help("Defines how many seconds to wait between each message sent to \
|
|
the monitoring-endpoint. Default: 60s")
|
|
.requires("monitoring-endpoint")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
|
|
/*
|
|
* Standard staking flags
|
|
*/
|
|
|
|
.arg(
|
|
Arg::new("staking")
|
|
.long("staking")
|
|
.help("Standard option for a staking beacon node. This will enable the HTTP server \
|
|
on localhost:5052 and import deposit logs from the execution node.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slots-per-restore-point")
|
|
.long("slots-per-restore-point")
|
|
.value_name("SLOT_COUNT")
|
|
.help("DEPRECATED. This flag has no effect.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("hierarchy-exponents")
|
|
.long("hierarchy-exponents")
|
|
.value_name("EXPONENTS")
|
|
.help("Specifies the frequency for storing full state snapshots and hierarchical \
|
|
diffs in the freezer DB. Accepts a comma-separated list of ascending \
|
|
exponents. Each exponent defines an interval for storing diffs to the layer \
|
|
above. The last exponent defines the interval for full snapshots. \
|
|
For example, a config of '4,8,12' would store a full snapshot every \
|
|
4096 (2^12) slots, first-level diffs every 256 (2^8) slots, and second-level \
|
|
diffs every 16 (2^4) slots. \
|
|
Cannot be changed after initialization. \
|
|
[default: 5,9,11,13,16,18,21]")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("epochs-per-migration")
|
|
.long("epochs-per-migration")
|
|
.value_name("N")
|
|
.help("The number of epochs to wait between running the migration of data from the \
|
|
hot DB to the cold DB. Less frequent runs can be useful for minimizing disk \
|
|
writes")
|
|
.default_value("1")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("state-cache-headroom")
|
|
.long("state-cache-headroom")
|
|
.value_name("N")
|
|
.help("Minimum number of states to cull from the state cache when it gets full")
|
|
.default_value("1")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("block-cache-size")
|
|
.long("block-cache-size")
|
|
.value_name("SIZE")
|
|
.help("Specifies how many blocks the database should cache in memory")
|
|
.default_value("0")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("historic-state-cache-size")
|
|
.long("historic-state-cache-size")
|
|
.value_name("SIZE")
|
|
.help("Specifies how many states from the freezer database should be cached in \
|
|
memory")
|
|
.default_value("1")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("hdiff-buffer-cache-size")
|
|
.long("hdiff-buffer-cache-size")
|
|
.value_name("SIZE")
|
|
.help("Number of cold hierarchical diff (hdiff) buffers to cache in memory. Each \
|
|
buffer is around the size of a BeaconState so you should be cautious about \
|
|
setting this value too high. This flag is irrelevant for most nodes, which \
|
|
run with state pruning enabled.")
|
|
.default_value("16")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("hot-hdiff-buffer-cache-size")
|
|
.long("hot-hdiff-buffer-cache-size")
|
|
.value_name("SIZE")
|
|
.help("Number of hot hierarchical diff (hdiff) buffers to cache in memory. Each \
|
|
buffer is around the size of a BeaconState so you should be cautious about \
|
|
setting this value too high. Setting this value higher can reduce the time \
|
|
taken to store new states on disk at the cost of higher memory usage.")
|
|
.default_value("1")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("state-cache-size")
|
|
.long("state-cache-size")
|
|
.value_name("STATE_CACHE_SIZE")
|
|
.help("Specifies the size of the state cache")
|
|
.default_value("128")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
/*
|
|
* Execution Layer Integration
|
|
*/
|
|
.arg(
|
|
Arg::new("execution-endpoint")
|
|
.long("execution-endpoint")
|
|
.value_name("EXECUTION-ENDPOINT")
|
|
.alias("execution-endpoints")
|
|
.help("Server endpoint for an execution layer JWT-authenticated HTTP \
|
|
JSON-RPC connection. Uses the same endpoint to populate the \
|
|
deposit cache.")
|
|
.required(true)
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("execution-jwt")
|
|
.long("execution-jwt")
|
|
.value_name("EXECUTION-JWT")
|
|
.alias("jwt-secrets")
|
|
.help("File path which contains the hex-encoded JWT secret for the \
|
|
execution endpoint provided in the --execution-endpoint flag.")
|
|
.requires("execution-endpoint")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("execution-jwt-secret-key")
|
|
.long("execution-jwt-secret-key")
|
|
.value_name("EXECUTION-JWT-SECRET-KEY")
|
|
.alias("jwt-secret-key")
|
|
.help("Hex-encoded JWT secret for the \
|
|
execution endpoint provided in the --execution-endpoint flag.")
|
|
.requires("execution-endpoint")
|
|
.conflicts_with("execution-jwt")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("execution-jwt-id")
|
|
.long("execution-jwt-id")
|
|
.value_name("EXECUTION-JWT-ID")
|
|
.alias("jwt-id")
|
|
.help("Used by the beacon node to communicate a unique identifier to execution nodes \
|
|
during JWT authentication. It corresponds to the 'id' field in the JWT claims object.\
|
|
Set to empty by default")
|
|
.requires("execution-jwt")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("execution-jwt-version")
|
|
.long("execution-jwt-version")
|
|
.value_name("EXECUTION-JWT-VERSION")
|
|
.alias("jwt-version")
|
|
.help("Used by the beacon node to communicate a client version to execution nodes \
|
|
during JWT authentication. It corresponds to the 'clv' field in the JWT claims object.\
|
|
Set to empty by default")
|
|
.requires("execution-jwt")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("suggested-fee-recipient")
|
|
.long("suggested-fee-recipient")
|
|
.value_name("SUGGESTED-FEE-RECIPIENT")
|
|
.help("Emergency fallback fee recipient for use in case the validator client does \
|
|
not have one configured. You should set this flag on the validator \
|
|
client instead of (or in addition to) setting it here.")
|
|
.requires("execution-endpoint")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("builder")
|
|
.long("builder")
|
|
.alias("payload-builder")
|
|
.alias("payload-builders")
|
|
.help("The URL of a service compatible with the MEV-boost API.")
|
|
.requires("execution-endpoint")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("execution-timeout-multiplier")
|
|
.long("execution-timeout-multiplier")
|
|
.value_name("NUM")
|
|
.help("Unsigned integer to multiply the default execution timeouts by.")
|
|
.default_value("1")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-get-blobs")
|
|
.long("disable-get-blobs")
|
|
.help("Disables the getBlobs optimisation to fetch blobs from the EL mempool")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("builder-header-timeout")
|
|
.long("builder-header-timeout")
|
|
.value_name("MILLISECONDS")
|
|
.help("Defines a timeout value (in milliseconds) to use when \
|
|
fetching a block header from the builder API.")
|
|
.default_value("1000")
|
|
.value_parser(|timeout: &str| {
|
|
match timeout
|
|
.parse::<u64>()
|
|
.ok()
|
|
.map(Duration::from_millis)
|
|
{
|
|
Some(val) => {
|
|
if val > Duration::from_secs(3) {
|
|
return Err("builder-header-timeout cannot exceed 3000ms")
|
|
}
|
|
Ok(timeout.to_string())
|
|
},
|
|
None => Err("builder-header-timeout must be a number"),
|
|
}
|
|
})
|
|
.requires("builder")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
/* Deneb settings */
|
|
.arg(
|
|
Arg::new("trusted-setup-file-override")
|
|
.long("trusted-setup-file-override")
|
|
.value_name("FILE")
|
|
.help("Path to a json file containing the trusted setup params. \
|
|
NOTE: This will override the trusted setup that is generated \
|
|
from the mainnet kzg ceremony. Use with caution")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
/*
|
|
* Database purging and compaction.
|
|
*/
|
|
.arg(
|
|
Arg::new("purge-db")
|
|
.long("purge-db")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("If present, the chain database will be deleted. Requires manual confirmation.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("purge-db-force")
|
|
.long("purge-db-force")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("If present, the chain database will be deleted without confirmation. Use with caution.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("compact-db")
|
|
.long("compact-db")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("If present, apply compaction to the database on start-up. Use with caution. \
|
|
It is generally not recommended unless auto-compaction is disabled.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("auto-compact-db")
|
|
.long("auto-compact-db")
|
|
.help("Enable or disable automatic compaction of the database on finalization.")
|
|
.action(ArgAction::Set)
|
|
.default_value("true")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("prune-payloads")
|
|
.long("prune-payloads")
|
|
.help("Prune execution payloads from Lighthouse's database. This saves space but \
|
|
imposes load on the execution client, as payloads need to be \
|
|
reconstructed and sent to syncing peers.")
|
|
.action(ArgAction::Set)
|
|
.default_value("true")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("prune-blobs")
|
|
.long("prune-blobs")
|
|
.value_name("BOOLEAN")
|
|
.help("Prune blobs from Lighthouse's database when they are older than the data \
|
|
data availability boundary relative to the current epoch.")
|
|
.action(ArgAction::Set)
|
|
.default_value("true")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("epochs-per-blob-prune")
|
|
.long("epochs-per-blob-prune")
|
|
.value_name("EPOCHS")
|
|
.help("The epoch interval with which to prune blobs from Lighthouse's \
|
|
database when they are older than the data availability boundary \
|
|
relative to the current epoch.")
|
|
.action(ArgAction::Set)
|
|
.default_value("256")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("blob-prune-margin-epochs")
|
|
.long("blob-prune-margin-epochs")
|
|
.value_name("EPOCHS")
|
|
.help("The margin for blob pruning in epochs. The oldest blobs are pruned \
|
|
up until data_availability_boundary - blob_prune_margin_epochs.")
|
|
.action(ArgAction::Set)
|
|
.default_value("0")
|
|
.display_order(0)
|
|
)
|
|
/*
|
|
* Misc.
|
|
*/
|
|
.arg(
|
|
Arg::new("graffiti")
|
|
.long("graffiti")
|
|
.help(
|
|
"Specify your custom graffiti to be included in blocks. \
|
|
Defaults to the current version and commit, truncated to fit in 32 bytes. "
|
|
)
|
|
.value_name("GRAFFITI")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("max-skip-slots")
|
|
.long("max-skip-slots")
|
|
.help(
|
|
"Refuse to skip more than this many slots when processing an attestation. \
|
|
This prevents nodes on minority forks from wasting our time and disk space, \
|
|
but could also cause unnecessary consensus failures, so is disabled by default."
|
|
)
|
|
.value_name("NUM_SLOTS")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
/*
|
|
* Slasher.
|
|
*/
|
|
.arg(
|
|
Arg::new("slasher")
|
|
.long("slasher")
|
|
.help(
|
|
"Run a slasher alongside the beacon node. It is currently only recommended for \
|
|
expert users because of the immaturity of the slasher UX and the extra \
|
|
resources required."
|
|
)
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-dir")
|
|
.long("slasher-dir")
|
|
.help(
|
|
"Set the slasher's database directory."
|
|
)
|
|
.value_name("PATH")
|
|
.action(ArgAction::Set)
|
|
.requires("slasher")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-update-period")
|
|
.long("slasher-update-period")
|
|
.help(
|
|
"Configure how often the slasher runs batch processing."
|
|
)
|
|
.value_name("SECONDS")
|
|
.requires("slasher")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-slot-offset")
|
|
.long("slasher-slot-offset")
|
|
.help(
|
|
"Set the delay from the start of the slot at which the slasher should ingest \
|
|
attestations. Only effective if the slasher-update-period is a multiple of the \
|
|
slot duration."
|
|
)
|
|
.value_name("SECONDS")
|
|
.requires("slasher")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-history-length")
|
|
.long("slasher-history-length")
|
|
.help(
|
|
"Configure how many epochs of history the slasher keeps. Immutable after \
|
|
initialization."
|
|
)
|
|
.value_name("EPOCHS")
|
|
.requires("slasher")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-max-db-size")
|
|
.long("slasher-max-db-size")
|
|
.help(
|
|
"Maximum size of the MDBX database used by the slasher."
|
|
)
|
|
.value_name("GIGABYTES")
|
|
.requires("slasher")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-att-cache-size")
|
|
.long("slasher-att-cache-size")
|
|
.help("Set the maximum number of attestation roots for the slasher to cache")
|
|
.value_name("COUNT")
|
|
.requires("slasher")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-chunk-size")
|
|
.long("slasher-chunk-size")
|
|
.help(
|
|
"Number of epochs per validator per chunk stored on disk."
|
|
)
|
|
.value_name("EPOCHS")
|
|
.requires("slasher")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-validator-chunk-size")
|
|
.long("slasher-validator-chunk-size")
|
|
.help(
|
|
"Number of validators per chunk stored on disk."
|
|
)
|
|
.value_name("NUM_VALIDATORS")
|
|
.requires("slasher")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-broadcast")
|
|
.long("slasher-broadcast")
|
|
.help("Broadcast slashings found by the slasher to the rest of the network \
|
|
[Enabled by default].")
|
|
.action(ArgAction::Set)
|
|
.default_value("true")
|
|
.num_args(0..=1)
|
|
.default_missing_value("true")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("slasher-backend")
|
|
.long("slasher-backend")
|
|
.value_name("DATABASE")
|
|
.help("Set the database backend to be used by the slasher.")
|
|
.action(ArgAction::Set)
|
|
.value_parser(slasher::DatabaseBackend::VARIANTS.to_vec())
|
|
.requires("slasher")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("wss-checkpoint")
|
|
.long("wss-checkpoint")
|
|
.help(
|
|
"Specify a weak subjectivity checkpoint in `block_root:epoch` format to verify \
|
|
the node's sync against. The block root should be 0x-prefixed. Note that this \
|
|
flag is for verification only, to perform a checkpoint sync from a recent \
|
|
state use --checkpoint-sync-url."
|
|
)
|
|
.value_name("WSS_CHECKPOINT")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("checkpoint-state")
|
|
.long("checkpoint-state")
|
|
.help("Set a checkpoint state to start syncing from. Must be aligned and match \
|
|
--checkpoint-block. Using --checkpoint-sync-url instead is recommended.")
|
|
.value_name("STATE_SSZ")
|
|
.action(ArgAction::Set)
|
|
.requires("checkpoint-block")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("checkpoint-block")
|
|
.long("checkpoint-block")
|
|
.help("Set a checkpoint block to start syncing from. Must be aligned and match \
|
|
--checkpoint-state. Using --checkpoint-sync-url instead is recommended.")
|
|
.value_name("BLOCK_SSZ")
|
|
.action(ArgAction::Set)
|
|
.requires("checkpoint-state")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("checkpoint-blobs")
|
|
.long("checkpoint-blobs")
|
|
.help("Set the checkpoint blobs to start syncing from. Must be aligned and match \
|
|
--checkpoint-block. Using --checkpoint-sync-url instead is recommended.")
|
|
.value_name("BLOBS_SSZ")
|
|
.action(ArgAction::Set)
|
|
.requires("checkpoint-block")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("checkpoint-sync-url")
|
|
.long("checkpoint-sync-url")
|
|
.help("Set the remote beacon node HTTP endpoint to use for checkpoint sync.")
|
|
.value_name("BEACON_NODE")
|
|
.action(ArgAction::Set)
|
|
.conflicts_with("checkpoint-state")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("checkpoint-sync-url-timeout")
|
|
.long("checkpoint-sync-url-timeout")
|
|
.help("Set the timeout for checkpoint sync calls to remote beacon node HTTP endpoint.")
|
|
.value_name("SECONDS")
|
|
.action(ArgAction::Set)
|
|
.default_value("180")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("allow-insecure-genesis-sync")
|
|
.long("allow-insecure-genesis-sync")
|
|
.help("Enable syncing from genesis, which is generally insecure and incompatible with data availability checks. \
|
|
Checkpoint syncing is the preferred method for syncing a node. \
|
|
Only use this flag when testing. DO NOT use on mainnet!")
|
|
.conflicts_with("checkpoint-sync-url")
|
|
.conflicts_with("checkpoint-state")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("reconstruct-historic-states")
|
|
.long("reconstruct-historic-states")
|
|
.help("After a checkpoint sync, reconstruct historic states in the database. This requires syncing all the way back to genesis.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("validator-monitor-auto")
|
|
.long("validator-monitor-auto")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("Enables the automatic detection and monitoring of validators connected to the \
|
|
HTTP API and using the subnet subscription endpoint. This generally has the \
|
|
effect of providing additional logging and metrics for locally controlled \
|
|
validators.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("validator-monitor-pubkeys")
|
|
.long("validator-monitor-pubkeys")
|
|
.help("A comma-separated list of 0x-prefixed validator public keys. \
|
|
These validators will receive special monitoring and additional \
|
|
logging.")
|
|
.value_name("PUBKEYS")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("validator-monitor-file")
|
|
.long("validator-monitor-file")
|
|
.help("As per --validator-monitor-pubkeys, but the comma-separated list is \
|
|
contained within a file at the given path.")
|
|
.value_name("PATH")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("validator-monitor-individual-tracking-threshold")
|
|
.long("validator-monitor-individual-tracking-threshold")
|
|
.help("Once the validator monitor reaches this number of local validators \
|
|
it will stop collecting per-validator Prometheus metrics and issuing \
|
|
per-validator logs. Instead, it will provide aggregate metrics and logs. \
|
|
This avoids infeasibly high cardinality in the Prometheus database and \
|
|
high log volume when using many validators. Defaults to 64.")
|
|
.value_name("INTEGER")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-proposer-reorgs")
|
|
.long("disable-proposer-reorgs")
|
|
.help("Do not attempt to reorg late blocks from other validators when proposing.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("proposer-reorg-threshold")
|
|
.long("proposer-reorg-threshold")
|
|
.action(ArgAction::Set)
|
|
.value_name("PERCENT")
|
|
.help("Percentage of head vote weight below which to attempt a proposer reorg. \
|
|
Default: 20%")
|
|
.conflicts_with("disable-proposer-reorgs")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("proposer-reorg-parent-threshold")
|
|
.long("proposer-reorg-parent-threshold")
|
|
.value_name("PERCENT")
|
|
.help("Percentage of parent vote weight above which to attempt a proposer reorg. \
|
|
Default: 160%")
|
|
.conflicts_with("disable-proposer-reorgs")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("proposer-reorg-epochs-since-finalization")
|
|
.long("proposer-reorg-epochs-since-finalization")
|
|
.action(ArgAction::Set)
|
|
.value_name("EPOCHS")
|
|
.help("Maximum number of epochs since finalization at which proposer reorgs are \
|
|
allowed. Default: 2")
|
|
.conflicts_with("disable-proposer-reorgs")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("proposer-reorg-cutoff")
|
|
.long("proposer-reorg-cutoff")
|
|
.value_name("MILLISECONDS")
|
|
.action(ArgAction::Set)
|
|
.help("Maximum delay after the start of the slot at which to propose a reorging \
|
|
block. Lower values can prevent failed reorgs by ensuring the block has \
|
|
ample time to propagate and be processed by the network. The default is \
|
|
1/12th of a slot (1 second on mainnet)")
|
|
.conflicts_with("disable-proposer-reorgs")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("proposer-reorg-disallowed-offsets")
|
|
.long("proposer-reorg-disallowed-offsets")
|
|
.action(ArgAction::Set)
|
|
.value_name("N1,N2,...")
|
|
.help("Comma-separated list of integer offsets which can be used to avoid \
|
|
proposing reorging blocks at certain slots. An offset of N means that \
|
|
reorging proposals will not be attempted at any slot such that \
|
|
`slot % SLOTS_PER_EPOCH == N`. By default only re-orgs at offset 0 will be \
|
|
avoided. Any offsets supplied with this flag will impose additional \
|
|
restrictions.")
|
|
.conflicts_with("disable-proposer-reorgs")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("prepare-payload-lookahead")
|
|
.long("prepare-payload-lookahead")
|
|
.value_name("MILLISECONDS")
|
|
.help("The time before the start of a proposal slot at which payload attributes \
|
|
should be sent. Low values are useful for execution nodes which don't \
|
|
improve their payload after the first call, and high values are useful \
|
|
for ensuring the EL is given ample notice. Default: 1/3 of a slot.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("always-prepare-payload")
|
|
.long("always-prepare-payload")
|
|
.help("Send payload attributes with every fork choice update. This is intended for \
|
|
use by block builders, relays and developers. You should set a fee \
|
|
recipient on this BN and also consider adjusting the \
|
|
--prepare-payload-lookahead flag.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
.requires("suggested-fee-recipient")
|
|
)
|
|
.arg(
|
|
Arg::new("fork-choice-before-proposal-timeout")
|
|
.long("fork-choice-before-proposal-timeout")
|
|
.help("Set the maximum number of milliseconds to wait for fork choice before \
|
|
proposing a block. You can prevent waiting at all by setting the timeout \
|
|
to 0, however you risk proposing atop the wrong parent block.")
|
|
.default_value("250")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("paranoid-block-proposal")
|
|
.long("paranoid-block-proposal")
|
|
.help("Paranoid enough to be reading the source? Nice. This flag reverts some \
|
|
block proposal optimisations and forces the node to check every attestation \
|
|
it includes super thoroughly. This may be useful in an emergency, but not \
|
|
otherwise.")
|
|
.hide(true)
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("builder-fallback-skips")
|
|
.long("builder-fallback-skips")
|
|
.help("If this node is proposing a block and has seen this number of skip slots \
|
|
on the canonical chain in a row, it will NOT query any connected builders, \
|
|
and will use the local execution engine for payload construction.")
|
|
.default_value("3")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("builder-fallback-skips-per-epoch")
|
|
.long("builder-fallback-skips-per-epoch")
|
|
.help("If this node is proposing a block and has seen this number of skip slots \
|
|
on the canonical chain in the past `SLOTS_PER_EPOCH`, it will NOT query \
|
|
any connected builders, and will use the local execution engine for \
|
|
payload construction.")
|
|
.default_value("8")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("builder-fallback-epochs-since-finalization")
|
|
.long("builder-fallback-epochs-since-finalization")
|
|
.help("If this node is proposing a block and the chain has not finalized within \
|
|
this number of epochs, it will NOT query any connected builders, \
|
|
and will use the local execution engine for payload construction. Setting \
|
|
this value to anything less than 2 will cause the node to NEVER query \
|
|
connected builders. Setting it to 2 will cause this condition to be hit \
|
|
if there are skips slots at the start of an epoch, right before this node \
|
|
is set to propose.")
|
|
.default_value("3")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("builder-fallback-disable-checks")
|
|
.long("builder-fallback-disable-checks")
|
|
.help("This flag disables all checks related to chain health. This means the builder \
|
|
API will always be used for payload construction, regardless of recent chain \
|
|
conditions.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("builder-user-agent")
|
|
.long("builder-user-agent")
|
|
.value_name("STRING")
|
|
.help("The HTTP user agent to send alongside requests to the builder URL. The \
|
|
default is Lighthouse's version string.")
|
|
.requires("builder")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("builder-disable-ssz")
|
|
.long("builder-disable-ssz")
|
|
.value_name("BOOLEAN")
|
|
.help("Disables sending requests using SSZ over the builder API.")
|
|
.requires("builder")
|
|
.action(ArgAction::SetTrue)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("reset-payload-statuses")
|
|
.long("reset-payload-statuses")
|
|
.help("When present, Lighthouse will forget the payload statuses of any \
|
|
already-imported blocks. This can assist in the recovery from a consensus \
|
|
failure caused by the execution layer.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-optimistic-finalized-sync")
|
|
.long("disable-optimistic-finalized-sync")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("Force Lighthouse to verify every execution block hash with the execution \
|
|
client during finalized sync. By default block hashes will be checked in \
|
|
Lighthouse and only passed to the EL if initial verification fails.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("disable-light-client-server")
|
|
.long("disable-light-client-server")
|
|
.help("Disables light client support on the p2p network")
|
|
.action(ArgAction::SetTrue)
|
|
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("sync-tolerance-epochs")
|
|
.long("sync-tolerance-epochs")
|
|
.help("Overrides the default SYNC_TOLERANCE_EPOCHS. This flag is not intended \
|
|
for production and MUST only be used in TESTING only. This is primarily used \
|
|
for testing range sync, to prevent the node from producing a block before the \
|
|
node is synced with the network which may result in the node getting \
|
|
disconnected from peers immediately.")
|
|
.hide(true)
|
|
.requires("enable_http")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("gui")
|
|
.long("gui")
|
|
.help("Enable the graphical user interface and all its requirements. \
|
|
This enables --http and --validator-monitor-auto and enables SSE logging.")
|
|
.action(ArgAction::SetTrue)
|
|
.help_heading(FLAG_HEADER)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("invalid-gossip-verified-blocks-path")
|
|
.action(ArgAction::Set)
|
|
.long("invalid-gossip-verified-blocks-path")
|
|
.value_name("PATH")
|
|
.help("If a block succeeds gossip validation whilst failing full validation, store \
|
|
the block SSZ as a file at this path. This feature is only recommended for \
|
|
developers. This directory is not pruned, users should be careful to avoid \
|
|
filling up their disks.")
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("beacon-processor-max-workers")
|
|
.long("beacon-processor-max-workers")
|
|
.value_name("INTEGER")
|
|
.help("Specifies the maximum concurrent tasks for the task scheduler. Increasing \
|
|
this value may increase resource consumption. Reducing the value \
|
|
may result in decreased resource usage and diminished performance. The \
|
|
default value is the number of logical CPU cores on the host.")
|
|
.hide(true)
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("beacon-processor-work-queue-len")
|
|
.long("beacon-processor-work-queue-len")
|
|
.value_name("INTEGER")
|
|
.help("Specifies the length of the inbound event queue. \
|
|
Higher values may prevent messages from being dropped while lower values \
|
|
may help protect the node from becoming overwhelmed.")
|
|
.default_value("16384")
|
|
.hide(true)
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("beacon-processor-reprocess-queue-len")
|
|
.long("beacon-processor-reprocess-queue-len")
|
|
.value_name("INTEGER")
|
|
.help("Specifies the length of the queue for messages requiring delayed processing. \
|
|
Higher values may prevent messages from being dropped while lower values \
|
|
may help protect the node from becoming overwhelmed.")
|
|
.hide(true)
|
|
.default_value("12288")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("beacon-processor-attestation-batch-size")
|
|
.long("beacon-processor-attestation-batch-size")
|
|
.value_name("INTEGER")
|
|
.help("Specifies the number of gossip attestations in a signature verification batch. \
|
|
Higher values may reduce CPU usage in a healthy network whilst lower values may \
|
|
increase CPU usage in an unhealthy or hostile network.")
|
|
.hide(true)
|
|
.default_value("64")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("beacon-processor-aggregate-batch-size")
|
|
.long("beacon-processor-aggregate-batch-size")
|
|
.value_name("INTEGER")
|
|
.help("Specifies the number of gossip aggregate attestations in a signature \
|
|
verification batch. \
|
|
Higher values may reduce CPU usage in a healthy network while lower values may \
|
|
increase CPU usage in an unhealthy or hostile network.")
|
|
.hide(true)
|
|
.default_value("64")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("beacon-node-backend")
|
|
.long("beacon-node-backend")
|
|
.value_name("DATABASE")
|
|
.value_parser(store::config::DatabaseBackend::VARIANTS.to_vec())
|
|
.help("Set the database backend to be used by the beacon node.")
|
|
.action(ArgAction::Set)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("delay-block-publishing")
|
|
.long("delay-block-publishing")
|
|
.value_name("SECONDS")
|
|
.action(ArgAction::Set)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("TESTING ONLY: Artificially delays block publishing by the specified number of seconds. \
|
|
This only works if BroadcastValidation::Gossip is used (default). \
|
|
Do not use in production. Requires the 'testing' feature to be enabled.")
|
|
.hide(true)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("delay-data-column-publishing")
|
|
.long("delay-data-column-publishing")
|
|
.value_name("SECONDS")
|
|
.action(ArgAction::Set)
|
|
.help_heading(FLAG_HEADER)
|
|
.help("TESTING ONLY: Artificially delays data column publishing by the specified number of seconds. \
|
|
Limitation: If delay-block-publishing is also used, data columns will be delayed for a \
|
|
minimum of delay-block-publishing seconds. \
|
|
Do not use in production. Requires the 'testing' feature to be enabled.")
|
|
.hide(true)
|
|
.display_order(0)
|
|
)
|
|
.arg(
|
|
Arg::new("invalid-block-roots")
|
|
.long("invalid-block-roots")
|
|
.value_name("FILE")
|
|
.help("Path to a comma separated file containing block roots that should be treated as invalid during block verification.")
|
|
.action(ArgAction::Set)
|
|
.hide(true)
|
|
)
|
|
.group(ArgGroup::new("enable_http").args(["http", "gui", "staking"]).multiple(true))
|
|
}
|