Difference between revisions of "Lighthouse beacon node --help"

From wikieduonline
Jump to navigation Jump to search
Line 4: Line 4:
  
 
== 3.0.0 ==
 
== 3.0.0 ==
−
<pre>
+
lighthouse-beacon_node 3.0.0
−
lighthouse-beacon_node 3.0.0
+
Sigma Prime <[email protected]>
−
Sigma Prime <[email protected]>
+
The primary component which connects to the Ethereum 2.0 P2P network and downloads, verifies and stores blocks. Provides
−
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.
−
a HTTP API for querying the beacon chain and publishing messages to the network.
 
  
−
USAGE:
+
USAGE:
−
    lighthouse beacon_node [FLAGS] [OPTIONS]
+
    lighthouse beacon_node [FLAGS] [OPTIONS]
  
−
FLAGS:
+
FLAGS:
−
        --builder-fallback-disable-checks    This flag disables all checks related to chain health. This means the
+
        --builder-fallback-disable-checks    This flag disables all checks related to chain health. This means the
−
                                            builder API will always be used for payload construction, regardless of
+
                                              builder API will always be used for payload construction, regardless of
−
                                            recent chain conditions.
+
                                              recent chain conditions.
−
        --compact-db                        If present, apply compaction to the database on start-up. Use with caution.
+
        --compact-db                        If present, apply compaction to the database on start-up. Use with caution.
−
                                            It is generally not recommended unless auto-compaction is disabled.
+
                                              It is generally not recommended unless auto-compaction is disabled.
−
        --disable-discovery                  Disables the discv5 discovery protocol. The node will not search for new
+
        --disable-discovery                  Disables the discv5 discovery protocol. The node will not search for new
−
                                            peers or participate in the discovery protocol.
+
                                              peers or participate in the discovery protocol.
−
    -x, --disable-enr-auto-update            Discovery automatically updates the nodes local ENR with an external IP
+
    -x, --disable-enr-auto-update            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
+
                                              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.
+
                                              feature, fixing the ENR's IP/PORT to those specified on boot.
−
        --disable-lock-timeouts              Disable the timeouts applied to some internal locks by default. This can
+
        --disable-lock-timeouts              Disable the timeouts applied to some internal locks by default. This can
−
                                            lead to less spurious failures on slow hardware but is considered
+
                                              lead to less spurious failures on slow hardware but is considered
−
                                            experimental as it may obscure performance issues.
+
                                              experimental as it may obscure performance issues.
−
        --disable-malloc-tuning              If present, do not configure the system allocator. Providing this flag will
+
        --disable-malloc-tuning              If present, do not configure the system allocator. Providing this flag will
−
                                            generally increase memory usage, it should only be provided when debugging
+
                                              generally increase memory usage, it should only be provided when debugging
−
                                            specific memory allocation issues.
+
                                              specific memory allocation issues.
−
        --disable-packet-filter              Disables the discovery packet filter. Useful for testing in smaller
+
        --disable-packet-filter              Disables the discovery packet filter. Useful for testing in smaller
−
                                            networks
+
                                              networks
−
        --disable-upnp                      Disables UPnP support. Setting this will prevent Lighthouse from attempting
+
        --disable-upnp                      Disables UPnP support. Setting this will prevent Lighthouse from attempting
−
                                            to automatically establish external port mappings.
+
                                              to automatically establish external port mappings.
−
        --dummy-eth1                        If present, uses an eth1 backend that generates static dummy data.Identical
+
        --dummy-eth1                        If present, uses an eth1 backend that generates static dummy data.Identical
−
                                            to the method used at the 2019 Canada interop.
+
                                              to the method used at the 2019 Canada interop.
−
        --enable-private-discovery          Lighthouse by default does not discover private IP addresses. Set this flag
+
        --enable-private-discovery          Lighthouse by default does not discover private IP addresses. Set this flag
−
                                            to enable connection attempts to local addresses.
+
                                              to enable connection attempts to local addresses.
−
    -e, --enr-match                          Sets the local ENR IP address and port to match those set for lighthouse.
+
    -e, --enr-match                          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
+
                                              Specifically, the IP address will be the value of --listen-address and the
−
                                            UDP port will be --discovery-port.
+
                                              UDP port will be --discovery-port.
−
        --eth1                              If present the node will connect to an eth1 node. This is required for
+
        --eth1                              If present the node will connect to an eth1 node. This is required for
−
                                            block production, you must use this flag if you wish to serve a validator.
+
                                              block production, you must use this flag if you wish to serve a validator.
−
        --eth1-purge-cache                  Purges the eth1 block and deposit caches
+
        --eth1-purge-cache                  Purges the eth1 block and deposit caches
−
    -h, --help                              Prints help information
+
    -h, --help                              Prints help information
−
        --http                              Enable the RESTful HTTP API server. Disabled by default.
+
        --http                              Enable the RESTful HTTP API server. Disabled by default.
−
        --http-allow-sync-stalled            Forces the HTTP to indicate that the node is synced when sync is actually
+
        --http-allow-sync-stalled            Forces the HTTP to indicate that the node is synced when sync is actually
−
                                            stalled. This is useful for very small testnets. TESTING ONLY. DO NOT USE
+
                                              stalled. This is useful for very small testnets. TESTING ONLY. DO NOT USE
−
                                            ON MAINNET.
+
                                              ON MAINNET.
−
        --http-enable-tls                    Serves the RESTful HTTP API server over TLS. This feature is currently
+
        --http-enable-tls                    Serves the RESTful HTTP API server over TLS. This feature is currently
−
                                            experimental.
+
                                              experimental.
−
        --import-all-attestations            Import and aggregate all attestations, regardless of validator
+
        --import-all-attestations            Import and aggregate all attestations, regardless of validator
−
                                            subscriptions. This will only import attestations from already-subscribed
+
                                              subscriptions. This will only import attestations from already-subscribed
−
                                            subnets, use with --subscribe-all-subnets to ensure all attestations are
+
                                              subnets, use with --subscribe-all-subnets to ensure all attestations are
−
                                            received for import.
+
                                              received for import.
−
        --logfile-compress                  If present, compress old log files. This can help reduce the space needed
+
        --logfile-compress                  If present, compress old log files. This can help reduce the space needed
−
                                            to store old logs.
+
                                              to store old logs.
−
        --merge                              Deprecated. The feature activates automatically when --execution-endpoint
+
        --merge                              Deprecated. The feature activates automatically when --execution-endpoint
−
                                            is supplied.
+
                                              is supplied.
−
        --metrics                            Enable the Prometheus metrics HTTP server. Disabled by default.
+
        --metrics                            Enable the Prometheus metrics HTTP server. Disabled by default.
−
        --private                            Prevents sending various client identification information.
+
        --private                            Prevents sending various client identification information.
−
        --purge-db                          If present, the chain database will be deleted. Use with caution.
+
        --purge-db                          If present, the chain database will be deleted. Use with caution.
−
        --reconstruct-historic-states        After a checkpoint sync, reconstruct historic states in the database.
+
        --reconstruct-historic-states        After a checkpoint sync, reconstruct historic states in the database.
−
        --shutdown-after-sync                Shutdown beacon node as soon as sync is completed. Backfill sync will not
+
        --shutdown-after-sync                Shutdown beacon node as soon as sync is completed. Backfill sync will not
−
                                            be performed before shutdown.
+
                                              be performed before shutdown.
−
        --slasher                            Run a slasher alongside the beacon node. It is currently only recommended
+
        --slasher                            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
+
                                              for expert users because of the immaturity of the slasher UX and the extra
−
                                            resources required.
+
                                              resources required.
−
        --slasher-broadcast                  Broadcast slashings found by the slasher to the rest of the network
+
        --slasher-broadcast                  Broadcast slashings found by the slasher to the rest of the network
−
                                            [disabled by default].
+
                                              [disabled by default].
−
        --staking                            Standard option for a staking beacon node. Equivalent to `lighthouse bn
+
        --staking                            Standard option for a staking beacon node. Equivalent to `lighthouse bn
−
                                            --http --eth1 `. This will enable the http server on localhost:5052 and try
+
                                              --http --eth1 `. This will enable the http server on localhost:5052 and try
−
                                            connecting to an eth1 node on localhost:8545
+
                                              connecting to an eth1 node on localhost:8545
−
        --subscribe-all-subnets              Subscribe to all subnets regardless of validator count. This will also
+
        --subscribe-all-subnets              Subscribe to all subnets regardless of validator count. This will also
−
                                            advertise the beacon node as being long-lived subscribed to all subnets.
+
                                              advertise the beacon node as being long-lived subscribed to all subnets.
−
        --validator-monitor-auto            Enables the automatic detection and monitoring of validators connected to
+
        --validator-monitor-auto            Enables the automatic detection and monitoring of validators connected to
−
                                            the HTTP API and using the subnet subscription endpoint. This generally has
+
                                              the HTTP API and using the subnet subscription endpoint. This generally has
−
                                            the effect of providing additional logging and metrics for locally
+
                                              the effect of providing additional logging and metrics for locally
−
                                            controlled validators.
+
                                              controlled validators.
−
    -V, --version                            Prints version information
+
    -V, --version                            Prints version information
−
    -z, --zero-ports                        Sets all listening TCP/UDP ports to 0, allowing the OS to choose some
+
    -z, --zero-ports                        Sets all listening TCP/UDP ports to 0, allowing the OS to choose some
−
                                            arbitrary free ports.
+
                                              arbitrary free ports.
  
−
OPTIONS:
+
OPTIONS:
−
        --auto-compact-db <auto-compact-db>
+
        --auto-compact-db <auto-compact-db>
−
            Enable or disable automatic compaction of the database on finalization. [default: true]
+
            Enable or disable automatic compaction of the database on finalization. [default: true]
  
−
        --block-cache-size <SIZE>
+
        --block-cache-size <SIZE>
−
            Specifies how many blocks the database should cache in memory [default: 5]
+
            Specifies how many blocks the database should cache in memory [default: 5]
  
−
        --boot-nodes <ENR/MULTIADDR LIST>
+
        --boot-nodes <ENR/MULTIADDR LIST>
−
            One or more comma-delimited base64-encoded ENR's to bootstrap the p2p network. Multiaddr is also supported.
+
            One or more comma-delimited base64-encoded ENR's to bootstrap the p2p network. Multiaddr is also supported.
  
−
        --builder <builder>
+
        --builder <builder>
−
            The URL of a service compatible with the MEV-boost API.
+
            The URL of a service compatible with the MEV-boost API.
  
−
        --builder-fallback-epochs-since-finalization <builder-fallback-epochs-since-finalization>
+
        --builder-fallback-epochs-since-finalization <builder-fallback-epochs-since-finalization>
−
            If this node is proposing a block and the chain has not finalized within this number of epochs, it will NOT
+
            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
+
            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
+
            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
+
            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: 3]
+
            set to propose. [default: 3]
−
        --builder-fallback-skips <builder-fallback-skips>
+
        --builder-fallback-skips <builder-fallback-skips>
−
            If this node is proposing a block and has seen this number of skip slots on the canonical chain in a row, it
+
            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.
+
            will NOT query any connected builders, and will use the local execution engine for payload construction.
−
            [default: 3]
+
            [default: 3]
−
        --builder-fallback-skips-per-epoch <builder-fallback-skips-per-epoch>
+
        --builder-fallback-skips-per-epoch <builder-fallback-skips-per-epoch>
−
            If this node is proposing a block and has seen this number of skip slots on the canonical chain in the past
+
            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
+
            `SLOTS_PER_EPOCH`, it will NOT query any connected builders, and will use the local execution engine for
−
            payload construction. [default: 8]
+
            payload construction. [default: 8]
−
        --checkpoint-block <BLOCK_SSZ>
+
        --checkpoint-block <BLOCK_SSZ>
−
            Set a checkpoint block to start syncing from. Must be aligned and match --checkpoint-state. Using
+
            Set a checkpoint block to start syncing from. Must be aligned and match --checkpoint-state. Using
−
            --checkpoint-sync-url instead is recommended.
+
            --checkpoint-sync-url instead is recommended.
−
        --checkpoint-state <STATE_SSZ>
+
        --checkpoint-state <STATE_SSZ>
−
            Set a checkpoint state to start syncing from. Must be aligned and match --checkpoint-block. Using
+
            Set a checkpoint state to start syncing from. Must be aligned and match --checkpoint-block. Using
−
            --checkpoint-sync-url instead is recommended.
+
            --checkpoint-sync-url instead is recommended.
−
        --checkpoint-sync-url <BEACON_NODE>
+
        --checkpoint-sync-url <BEACON_NODE>
−
            Set the remote beacon node HTTP endpoint to use for checkpoint sync.
+
            Set the remote beacon node HTTP endpoint to use for checkpoint sync.
  
−
    -d, --datadir <DIR>
+
    -d, --datadir <DIR>
−
            Used to specify a custom root data directory for lighthouse keys and databases. Defaults to
+
            Used to specify a custom root data directory for lighthouse keys and databases. Defaults to
−
            $HOME/.lighthouse/{network} where network is the value of the `network` flag Note: Users should specify
+
            $HOME/.lighthouse/{network} where network is the value of the `network` flag Note: Users should specify
−
            separate custom datadirs for different networks.
+
            separate custom datadirs for different networks.
−
        --debug-level <LEVEL>
+
        --debug-level <LEVEL>
−
            Specifies the verbosity level used when emitting logs to the terminal. [default: info]  [possible
+
            Specifies the verbosity level used when emitting logs to the terminal. [default: info]  [possible values:
−
            values: info, debug, trace, warn, error, crit]
+
            info, debug, trace, warn, error, crit]
−
        --discovery-port <PORT>
+
        --discovery-port <PORT>
−
            The UDP port that discovery will listen on. Defaults to `port`
+
            The UDP port that discovery will listen on. Defaults to `port`
  
−
        --enr-address <ADDRESS>
+
        --enr-address <ADDRESS>
−
            The IP address/ DNS address to broadcast to other peers on how to reach this node. If a DNS address is
+
            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
+
            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
+
            responses in discovery. Set this only if you are sure other nodes can connect to your local node on this
−
            address. Discovery will automatically find your external address, if possible.
+
            address. Discovery will automatically find your external address, if possible.
−
        --enr-tcp-port <PORT>
+
        --enr-tcp-port <PORT>
−
            The TCP port of the local ENR. Set this only if you are sure other nodes can connect to your local node on
+
            The TCP port of the local ENR. Set this only if you are sure other nodes can connect to your local node on
−
            this port.The --port flag is used if this is not set.
+
            this port.The --port flag is used if this is not set.
−
        --enr-udp-port <PORT>
+
        --enr-udp-port <PORT>
−
            The UDP port of the local ENR. Set this only if you are sure other nodes can connect to your local node on
+
            The UDP port of the local ENR. Set this only if you are sure other nodes can connect to your local node on
−
            this port.
+
            this port.
−
        --eth1-blocks-per-log-query <BLOCKS>
+
        --eth1-blocks-per-log-query <BLOCKS>
−
            Specifies the number of blocks that a deposit log query should span. This will reduce the size of responses
+
            Specifies the number of blocks that a deposit log query should span. This will reduce the size of responses
−
            from the Eth1 endpoint. [default: 1000]
+
            from the Eth1 endpoint. [default: 1000]
−
        --eth1-cache-follow-distance <BLOCKS>
+
        --eth1-cache-follow-distance <BLOCKS>
−
            Specifies the distance between the Eth1 chain head and the last block which should be imported into the
+
            Specifies the distance between the Eth1 chain head and the last block which should be imported into the
−
            cache. Setting this value lower can help compensate for irregular Proof-of-Work block times, but setting it
+
            cache. Setting this value lower can help compensate for irregular Proof-of-Work block times, but setting it
−
            too low can make the node vulnerable to re-orgs.
+
            too low can make the node vulnerable to re-orgs.
−
        --eth1-endpoint <HTTP-ENDPOINT>
+
        --eth1-endpoint <HTTP-ENDPOINT>
−
            Deprecated. Use --eth1-endpoints.
+
            Deprecated. Use --eth1-endpoints.
  
−
        --eth1-endpoints <HTTP-ENDPOINTS>
+
        --eth1-endpoints <HTTP-ENDPOINTS>
−
            One or more comma-delimited server endpoints for web3 connection. If multiple endpoints are given the
+
            One or more comma-delimited server endpoints for web3 connection. If multiple endpoints are given the
−
            endpoints are used as fallback in the given order. Also enables the --eth1 flag. Defaults to
+
            endpoints are used as fallback in the given order. Also enables the --eth1 flag. Defaults to
−
            http://127.0.0.1:8545.
+
            http://127.0.0.1:8545.
−
        --execution-endpoint <EXECUTION-ENDPOINT>
+
        --execution-endpoint <EXECUTION-ENDPOINT>
−
            Server endpoint for an execution layer jwt authenticated HTTP JSON-RPC connection. Uses the same endpoint to
+
            Server endpoint for an execution layer jwt authenticated HTTP JSON-RPC connection. Uses the same endpoint to
−
            populate the deposit cache. Also enables the --merge flag.If not provided, uses the default value of
+
            populate the deposit cache. Also enables the --merge flag.If not provided, uses the default value of
−
            http://127.0.0.1:8551
+
            http://127.0.0.1:8551
−
        --execution-jwt <EXECUTION-JWT>
+
        --execution-jwt <EXECUTION-JWT>
−
            File path which contains the hex-encoded JWT secret for the execution endpoint provided in the --execution-
+
            File path which contains the hex-encoded JWT secret for the execution endpoint provided in the --execution-
−
            endpoint flag.
+
            endpoint flag.
−
        --execution-jwt-id <EXECUTION-JWT-ID>
+
        --execution-jwt-id <EXECUTION-JWT-ID>
−
            Used by the beacon node to communicate a unique identifier to execution nodes during JWT authentication. It
+
            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
+
            corresponds to the 'id' field in the JWT claims object.Set to empty by default
−
        --execution-jwt-version <EXECUTION-JWT-VERSION>
+
        --execution-jwt-version <EXECUTION-JWT-VERSION>
−
            Used by the beacon node to communicate a client version to execution nodes during JWT authentication. It
+
            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
+
            corresponds to the 'clv' field in the JWT claims object.Set to empty by default
−
        --fork-choice-before-proposal-timeout <fork-choice-before-proposal-timeout>
+
        --fork-choice-before-proposal-timeout <fork-choice-before-proposal-timeout>
−
            Set the maximum number of milliseconds to wait for fork choice before proposing a block. You can prevent
+
            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.
+
            waiting at all by setting the timeout to 0, however you risk proposing atop the wrong parent block.
−
            [default: 250]
+
            [default: 250]
−
        --freezer-dir <DIR>
+
        --freezer-dir <DIR>
−
            Data directory for the freezer database.
+
            Data directory for the freezer database.
  
−
        --graffiti <GRAFFITI>
+
        --graffiti <GRAFFITI>
−
            Specify your custom graffiti to be included in blocks. Defaults to the current version and commit, truncated
+
            Specify your custom graffiti to be included in blocks. Defaults to the current version and commit, truncated
−
            to fit in 32 bytes.
+
            to fit in 32 bytes.
−
        --http-address <ADDRESS>
+
        --http-address <ADDRESS>
−
            Set the listen address for the RESTful HTTP API server. [default: 127.0.0.1]
+
            Set the listen address for the RESTful HTTP API server. [default: 127.0.0.1]
  
−
        --http-allow-origin <ORIGIN>
+
        --http-allow-origin <ORIGIN>
−
            Set the value of the Access-Control-Allow-Origin response HTTP header. Use * to allow any origin (not
+
            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
+
            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).
+
            this server (e.g., http://localhost:5052).
−
        --http-port <PORT>
+
        --http-port <PORT>
−
            Set the listen TCP port for the RESTful HTTP API server. [default: 5052]
+
            Set the listen TCP port for the RESTful HTTP API server. [default: 5052]
  
−
        --http-spec-fork <http-spec-fork>
+
        --http-spec-fork <http-spec-fork>
−
            Serve the spec for a specific hard fork on /eth/v1/config/spec. It should not be necessary to set this flag.
+
            Serve the spec for a specific hard fork on /eth/v1/config/spec. It should not be necessary to set this flag.
  
−
        --http-tls-cert <http-tls-cert>
+
        --http-tls-cert <http-tls-cert>
−
            The path of the certificate to be used when serving the HTTP API server over TLS.
+
            The path of the certificate to be used when serving the HTTP API server over TLS.
  
−
        --http-tls-key <http-tls-key>
+
        --http-tls-key <http-tls-key>
−
            The path of the private key to be used when serving the HTTP API server over TLS. Must not be password-
+
            The path of the private key to be used when serving the HTTP API server over TLS. Must not be password-
−
            protected.
+
            protected.
−
        --libp2p-addresses <MULTIADDR>
+
        --libp2p-addresses <MULTIADDR>
−
            One or more comma-delimited multiaddrs to manually connect to a libp2p peer without an ENR.
+
            One or more comma-delimited multiaddrs to manually connect to a libp2p peer without an ENR.
  
−
        --listen-address <ADDRESS>
+
        --listen-address <ADDRESS>
−
            The address lighthouse will listen for UDP and TCP connections. [default: 0.0.0.0]
+
            The address lighthouse will listen for UDP and TCP connections. [default: 0.0.0.0]
  
−
        --log-format <FORMAT>
+
        --log-format <FORMAT>
−
            Specifies the log format used when emitting logs to the terminal. [possible values: JSON]
+
            Specifies the log format used when emitting logs to the terminal. [possible values: JSON]
  
−
        --logfile <FILE>
+
        --logfile <FILE>
−
            File path where the log file will be stored. Once it grows to the value specified in `--logfile-max-size` a
+
            File path where the log file will be stored. Once it grows to the value specified in `--logfile-max-size` a
−
            new log file is generated where future logs are stored. Once the number of log files exceeds the value
+
            new log file is generated where future logs are stored. Once the number of log files exceeds the value
−
            specified in `--logfile-max-number` the oldest log file will be overwritten.
+
            specified in `--logfile-max-number` the oldest log file will be overwritten.
−
        --logfile-debug-level <LEVEL>
+
        --logfile-debug-level <LEVEL>
−
            The verbosity level used when emitting logs to the log file. [default: debug]  [possible values:
+
            The verbosity level used when emitting logs to the log file. [default: debug]  [possible values: info,
−
            info, debug, trace, warn, error, crit]
+
            debug, trace, warn, error, crit]
−
        --logfile-max-number <COUNT>
+
        --logfile-max-number <COUNT>
−
            The maximum number of log files that will be stored. If set to 0, background file logging is disabled.
+
            The maximum number of log files that will be stored. If set to 0, background file logging is disabled.
−
            [default: 5]
+
            [default: 5]
−
        --logfile-max-size <SIZE>
+
        --logfile-max-size <SIZE>
−
            The maximum size (in MB) each log file can grow to before rotating. If set to 0, background file logging is
+
            The maximum size (in MB) each log file can grow to before rotating. If set to 0, background file logging is
−
            disabled. [default: 200]
+
            disabled. [default: 200]
−
        --max-skip-slots <NUM_SLOTS>
+
        --max-skip-slots <NUM_SLOTS>
−
            Refuse to skip more than this many slots when processing a block or attestation. This prevents nodes on
+
            Refuse to skip more than this many slots when processing a block or attestation. This prevents nodes on
−
            minority forks from wasting our time and disk space, but could also cause unnecessary consensus failures, so
+
            minority forks from wasting our time and disk space, but could also cause unnecessary consensus failures, so
−
            is disabled by default.
+
            is disabled by default.
−
        --metrics-address <ADDRESS>
+
        --metrics-address <ADDRESS>
−
            Set the listen address for the Prometheus metrics HTTP server. [default: 127.0.0.1]
+
            Set the listen address for the Prometheus metrics HTTP server. [default: 127.0.0.1]
  
−
        --metrics-allow-origin <ORIGIN>
+
        --metrics-allow-origin <ORIGIN>
−
            Set the value of the Access-Control-Allow-Origin response HTTP header. Use * to allow any origin (not
+
            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
+
            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).
+
            this server (e.g., http://localhost:5054).
−
        --metrics-port <PORT>
+
        --metrics-port <PORT>
−
            Set the listen TCP port for the Prometheus metrics HTTP server. [default: 5054]
+
            Set the listen TCP port for the Prometheus metrics HTTP server. [default: 5054]
  
−
        --monitoring-endpoint <ADDRESS>
+
        --monitoring-endpoint <ADDRESS>
−
            Enables the monitoring service for sending system metrics to a remote endpoint. This can be used to monitor
+
            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
+
            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
+
            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
+
            your validators, IP address and other personal information. Always use a HTTPS connection and never provide
−
            an untrusted URL.
+
            an untrusted URL.
−
        --network <network>
+
        --network <network>
−
            Name of the Eth2 chain Lighthouse will sync and follow. [possible values: mainnet, prater,
+
            Name of the Eth2 chain Lighthouse will sync and follow. [possible values: mainnet, prater, goerli, gnosis,
−
            goerli, gnosis, kiln, ropsten, sepolia]
+
            kiln, ropsten, sepolia]
−
        --network-dir <DIR>
+
        --network-dir <DIR>
−
            Data directory for network keys. Defaults to network/ inside the beacon node dir.
+
            Data directory for network keys. Defaults to network/ inside the beacon node dir.
  
−
        --port <PORT>
+
        --port <PORT>
−
            The TCP/UDP port to listen on. The UDP port can be modified by the --discovery-port flag. [default:
+
            The TCP/UDP port to listen on. The UDP port can be modified by the --discovery-port flag. [default: 9000]
−
            9000]
 
−
        --safe-slots-to-import-optimistically <INTEGER>
 
−
            Used to coordinate manual overrides of the SAFE_SLOTS_TO_IMPORT_OPTIMISTICALLY parameter. This flag should
 
−
            only be used if the user has a clear understanding that the broad Ethereum community has elected to override
 
−
            this parameter in the event of an attack at the PoS transition block. Incorrect use of this flag can cause
 
−
            your node to possibly accept an invalid chain or sync more slowly. Be extremely careful with this flag.
 
−
        --slasher-att-cache-size <COUNT>
 
−
            Set the maximum number of attestation roots for the slasher to cache
 
  
−
        --slasher-backend <slasher-backend>
+
        --safe-slots-to-import-optimistically <INTEGER>
−
            Set the database backend to be used by the slasher. [possible values: mdbx, disabled]
+
            Used to coordinate manual overrides of the SAFE_SLOTS_TO_IMPORT_OPTIMISTICALLY parameter. This flag should
 +
            only be used if the user has a clear understanding that the broad Ethereum community has elected to override
 +
            this parameter in the event of an attack at the PoS transition block. Incorrect use of this flag can cause
 +
            your node to possibly accept an invalid chain or sync more slowly. Be extremely careful with this flag.
 +
        --slasher-att-cache-size <COUNT>
 +
            Set the maximum number of attestation roots for the slasher to cache
  
−
        --slasher-chunk-size <EPOCHS>
+
        --slasher-backend <slasher-backend>
−
            Number of epochs per validator per chunk stored on disk.
+
            Set the database backend to be used by the slasher. [possible values: mdbx, disabled]
  
−
        --slasher-dir <PATH>
+
        --slasher-chunk-size <EPOCHS>
−
            Set the slasher's database directory.
+
            Number of epochs per validator per chunk stored on disk.
  
−
        --slasher-history-length <EPOCHS>
+
        --slasher-dir <PATH>
−
            Configure how many epochs of history the slasher keeps. Immutable after initialization.
+
            Set the slasher's database directory.
  
−
        --slasher-max-db-size <GIGABYTES>
+
        --slasher-history-length <EPOCHS>
−
            Maximum size of the MDBX database used by the slasher.
+
            Configure how many epochs of history the slasher keeps. Immutable after initialization.
  
−
        --slasher-slot-offset <SECONDS>
+
        --slasher-max-db-size <GIGABYTES>
−
            Set the delay from the start of the slot at which the slasher should ingest attestations. Only effective if
+
            Maximum size of the MDBX database used by the slasher.
−
            the slasher-update-period is a multiple of the slot duration.
 
−
        --slasher-update-period <SECONDS>
 
−
            Configure how often the slasher runs batch processing.
 
  
−
        --slasher-validator-chunk-size <NUM_VALIDATORS>
+
        --slasher-slot-offset <SECONDS>
−
            Number of validators per chunk stored on disk.
+
            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.
 +
        --slasher-update-period <SECONDS>
 +
            Configure how often the slasher runs batch processing.
  
−
        --slots-per-restore-point <SLOT_COUNT>
+
        --slasher-validator-chunk-size <NUM_VALIDATORS>
−
            Specifies how often a freezer DB restore point should be stored. Cannot be changed after initialization.
+
            Number of validators per chunk stored on disk.
−
            [default: 8192 (mainnet) or 64 (minimal)]
 
−
    -s, --spec <DEPRECATED>
 
−
            This flag is deprecated, it will be disallowed in a future release. This value is now derived from the
 
−
            --network or --testnet-dir flags.
 
−
        --suggested-fee-recipient <SUGGESTED-FEE-RECIPIENT>
 
−
            Once the merge has happened, this address will receive transaction fees collected from any blocks produced
 
−
            by this node. Defaults to a junk address whilst the merge is in development stages. THE DEFAULT VALUE WILL
 
−
            BE REMOVED BEFORE THE MERGE ENTERS PRODUCTION
 
−
        --target-peers <target-peers>
 
−
            The target number of peers. [default: 80]
 
−
 
 
−
        --terminal-block-hash-epoch-override <EPOCH>
 
−
            Used to coordinate manual overrides to the TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH parameter. This flag should
 
−
            only be used if the user has a clear understanding that the broad Ethereum community has elected to override
 
−
            the terminal PoW block. Incorrect use of this flag will cause your node to experience a consensus
 
−
                                  failure. Be extremely careful with this flag.
 
−
        --terminal-block-hash-override <TERMINAL_BLOCK_HASH>
 
−
            Used to coordinate manual overrides to the TERMINAL_BLOCK_HASH parameter. This flag should only be used if
 
−
            the user has a clear understanding that the broad Ethereum community has elected to override the terminal
 
−
            PoW block. Incorrect use of this flag will cause your node to experience a consensus
 
−
                                  failure. Be extremely careful with this flag.
 
−
        --terminal-total-difficulty-override <INTEGER>
 
−
            Used to coordinate manual overrides to the TERMINAL_TOTAL_DIFFICULTY parameter. Accepts a 256-bit decimal
 
−
            integer (not a hex value). This flag should only be used if the user has a clear understanding that the
 
−
            broad Ethereum community has elected to override the terminal difficulty. Incorrect use of this flag will
 
−
            cause your node to experience a consensus
 
−
                                  failure. Be extremely careful with this flag.
 
−
    -t, --testnet-dir <DIR>
 
−
            Path to directory containing eth2_testnet specs. Defaults to a hard-coded Lighthouse testnet. Only effective
 
−
            if there is no existing database.
 
−
        --trusted-peers <TRUSTED_PEERS>
 
−
            One or more comma-delimited trusted peer ids which always have the highest score according to the peer
 
−
            scoring system.
 
−
        --validator-monitor-file <PATH>
 
−
            As per --validator-monitor-pubkeys, but the comma-separated list is contained within a file at the given
 
−
            path.
 
−
        --validator-monitor-pubkeys <PUBKEYS>
 
−
            A comma-separated list of 0x-prefixed validator public keys. These validators will receive special
 
−
            monitoring and additional logging.
 
−
        --wss-checkpoint <WSS_CHECKPOINT>
 
−
            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.
 
−
</pre>
 
  
 +
        --slots-per-restore-point <SLOT_COUNT>
 +
            Specifies how often a freezer DB restore point should be stored. Cannot be changed after initialization.
 +
            [default: 8192 (mainnet) or 64 (minimal)]
 +
    -s, --spec <DEPRECATED>
 +
            This flag is deprecated, it will be disallowed in a future release. This value is now derived from the
 +
            --network or --testnet-dir flags.
 +
        --suggested-fee-recipient <SUGGESTED-FEE-RECIPIENT>
 +
            Once the merge has happened, this address will receive transaction fees collected from any blocks produced
 +
            by this node. Defaults to a junk address whilst the merge is in development stages. THE DEFAULT VALUE WILL
 +
            BE REMOVED BEFORE THE MERGE ENTERS PRODUCTION
 +
        --target-peers <target-peers>
 +
            The target number of peers. [default: 80]
  
 +
        --terminal-block-hash-epoch-override <EPOCH>
 +
            Used to coordinate manual overrides to the TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH parameter. This flag should
 +
            only be used if the user has a clear understanding that the broad Ethereum community has elected to override
 +
            the terminal PoW block. Incorrect use of this flag will cause your node to experience a consensus
 +
                                    failure. Be extremely careful with this flag.
 +
        --terminal-block-hash-override <TERMINAL_BLOCK_HASH>
 +
            Used to coordinate manual overrides to the TERMINAL_BLOCK_HASH parameter. This flag should only be used if
 +
            the user has a clear understanding that the broad Ethereum community has elected to override the terminal
 +
            PoW block. Incorrect use of this flag will cause your node to experience a consensus
 +
                                    failure. Be extremely careful with this flag.
 +
        --terminal-total-difficulty-override <INTEGER>
 +
            Used to coordinate manual overrides to the TERMINAL_TOTAL_DIFFICULTY parameter. Accepts a 256-bit decimal
 +
            integer (not a hex value). This flag should only be used if the user has a clear understanding that the
 +
            broad Ethereum community has elected to override the terminal difficulty. Incorrect use of this flag will
 +
            cause your node to experience a consensus
 +
                                    failure. Be extremely careful with this flag.
 +
    -t, --testnet-dir <DIR>
 +
            Path to directory containing eth2_testnet specs. Defaults to a hard-coded Lighthouse testnet. Only effective
 +
            if there is no existing database.
 +
        --trusted-peers <TRUSTED_PEERS>
 +
            One or more comma-delimited trusted peer ids which always have the highest score according to the peer
 +
            scoring system.
 +
        --validator-monitor-file <PATH>
 +
            As per --validator-monitor-pubkeys, but the comma-separated list is contained within a file at the given
 +
            path.
 +
        --validator-monitor-pubkeys <PUBKEYS>
 +
            A comma-separated list of 0x-prefixed validator public keys. These validators will receive special
 +
            monitoring and additional logging.
 +
        --wss-checkpoint <WSS_CHECKPOINT>
 +
            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.
  
 
== 2.4.0 ==
 
== 2.4.0 ==

Revision as of 06:45, 25 August 2022

lighthouse beacon node

3.0.0

lighthouse-beacon_node 3.0.0
Sigma Prime <[email protected]>
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.

USAGE:
    lighthouse beacon_node [FLAGS] [OPTIONS]

FLAGS:
        --builder-fallback-disable-checks    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.
        --compact-db                         If present, apply compaction to the database on start-up. Use with caution.
                                             It is generally not recommended unless auto-compaction is disabled.
        --disable-discovery                  Disables the discv5 discovery protocol. The node will not search for new
                                             peers or participate in the discovery protocol.
    -x, --disable-enr-auto-update            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.
        --disable-lock-timeouts              Disable the timeouts applied to some internal locks by default. This can
                                             lead to less spurious failures on slow hardware but is considered
                                             experimental as it may obscure performance issues.
        --disable-malloc-tuning              If present, do not configure the system allocator. Providing this flag will
                                             generally increase memory usage, it should only be provided when debugging
                                             specific memory allocation issues.
        --disable-packet-filter              Disables the discovery packet filter. Useful for testing in smaller
                                             networks
        --disable-upnp                       Disables UPnP support. Setting this will prevent Lighthouse from attempting
                                             to automatically establish external port mappings.
        --dummy-eth1                         If present, uses an eth1 backend that generates static dummy data.Identical
                                             to the method used at the 2019 Canada interop.
        --enable-private-discovery           Lighthouse by default does not discover private IP addresses. Set this flag
                                             to enable connection attempts to local addresses.
    -e, --enr-match                          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.
        --eth1                               If present the node will connect to an eth1 node. This is required for
                                             block production, you must use this flag if you wish to serve a validator.
        --eth1-purge-cache                   Purges the eth1 block and deposit caches
    -h, --help                               Prints help information
        --http                               Enable the RESTful HTTP API server. Disabled by default.
        --http-allow-sync-stalled            Forces the HTTP to indicate that the node is synced when sync is actually
                                             stalled. This is useful for very small testnets. TESTING ONLY. DO NOT USE
                                             ON MAINNET.
        --http-enable-tls                    Serves the RESTful HTTP API server over TLS. This feature is currently
                                             experimental.
        --import-all-attestations            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.
        --logfile-compress                   If present, compress old log files. This can help reduce the space needed
                                             to store old logs.
        --merge                              Deprecated. The feature activates automatically when --execution-endpoint
                                             is supplied.
        --metrics                            Enable the Prometheus metrics HTTP server. Disabled by default.
        --private                            Prevents sending various client identification information.
        --purge-db                           If present, the chain database will be deleted. Use with caution.
        --reconstruct-historic-states        After a checkpoint sync, reconstruct historic states in the database.
        --shutdown-after-sync                Shutdown beacon node as soon as sync is completed. Backfill sync will not
                                             be performed before shutdown.
        --slasher                            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.
        --slasher-broadcast                  Broadcast slashings found by the slasher to the rest of the network
                                             [disabled by default].
        --staking                            Standard option for a staking beacon node. Equivalent to `lighthouse bn
                                             --http --eth1 `. This will enable the http server on localhost:5052 and try
                                             connecting to an eth1 node on localhost:8545
        --subscribe-all-subnets              Subscribe to all subnets regardless of validator count. This will also
                                             advertise the beacon node as being long-lived subscribed to all subnets.
        --validator-monitor-auto             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.
    -V, --version                            Prints version information
    -z, --zero-ports                         Sets all listening TCP/UDP ports to 0, allowing the OS to choose some
                                             arbitrary free ports.

OPTIONS:
        --auto-compact-db <auto-compact-db>
            Enable or disable automatic compaction of the database on finalization. [default: true]

        --block-cache-size <SIZE>
            Specifies how many blocks the database should cache in memory [default: 5]

        --boot-nodes <ENR/MULTIADDR LIST>
            One or more comma-delimited base64-encoded ENR's to bootstrap the p2p network. Multiaddr is also supported.

        --builder <builder>
            The URL of a service compatible with the MEV-boost API.

        --builder-fallback-epochs-since-finalization <builder-fallback-epochs-since-finalization>
            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: 3]
        --builder-fallback-skips <builder-fallback-skips>
            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: 3]
        --builder-fallback-skips-per-epoch <builder-fallback-skips-per-epoch>
            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: 8]
        --checkpoint-block <BLOCK_SSZ>
            Set a checkpoint block to start syncing from. Must be aligned and match --checkpoint-state. Using
            --checkpoint-sync-url instead is recommended.
        --checkpoint-state <STATE_SSZ>
            Set a checkpoint state to start syncing from. Must be aligned and match --checkpoint-block. Using
            --checkpoint-sync-url instead is recommended.
        --checkpoint-sync-url <BEACON_NODE>
            Set the remote beacon node HTTP endpoint to use for checkpoint sync.

    -d, --datadir <DIR>
            Used to specify a custom root data directory for lighthouse keys and databases. Defaults to
            $HOME/.lighthouse/{network} where network is the value of the `network` flag Note: Users should specify
            separate custom datadirs for different networks.
        --debug-level <LEVEL>
            Specifies the verbosity level used when emitting logs to the terminal. [default: info]  [possible values:
            info, debug, trace, warn, error, crit]
        --discovery-port <PORT>
            The UDP port that discovery will listen on. Defaults to `port`

        --enr-address <ADDRESS>
            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. Discovery will automatically find your external address, if possible.
        --enr-tcp-port <PORT>
            The TCP port of the local ENR. Set this only if you are sure other nodes can connect to your local node on
            this port.The --port flag is used if this is not set.
        --enr-udp-port <PORT>
            The UDP port of the local ENR. Set this only if you are sure other nodes can connect to your local node on
            this port.
        --eth1-blocks-per-log-query <BLOCKS>
            Specifies the number of blocks that a deposit log query should span. This will reduce the size of responses
            from the Eth1 endpoint. [default: 1000]
        --eth1-cache-follow-distance <BLOCKS>
            Specifies the distance between the Eth1 chain head and the last block which should be imported into the
            cache. Setting this value lower can help compensate for irregular Proof-of-Work block times, but setting it
            too low can make the node vulnerable to re-orgs.
        --eth1-endpoint <HTTP-ENDPOINT>
            Deprecated. Use --eth1-endpoints.

        --eth1-endpoints <HTTP-ENDPOINTS>
            One or more comma-delimited server endpoints for web3 connection. If multiple endpoints are given the
            endpoints are used as fallback in the given order. Also enables the --eth1 flag. Defaults to
            http://127.0.0.1:8545.
        --execution-endpoint <EXECUTION-ENDPOINT>
            Server endpoint for an execution layer jwt authenticated HTTP JSON-RPC connection. Uses the same endpoint to
            populate the deposit cache. Also enables the --merge flag.If not provided, uses the default value of
            http://127.0.0.1:8551
        --execution-jwt <EXECUTION-JWT>
            File path which contains the hex-encoded JWT secret for the execution endpoint provided in the --execution-
            endpoint flag.
        --execution-jwt-id <EXECUTION-JWT-ID>
            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
        --execution-jwt-version <EXECUTION-JWT-VERSION>
            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
        --fork-choice-before-proposal-timeout <fork-choice-before-proposal-timeout>
            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: 250]
        --freezer-dir <DIR>
            Data directory for the freezer database.

        --graffiti <GRAFFITI>
            Specify your custom graffiti to be included in blocks. Defaults to the current version and commit, truncated
            to fit in 32 bytes.
        --http-address <ADDRESS>
            Set the listen address for the RESTful HTTP API server. [default: 127.0.0.1]

        --http-allow-origin <ORIGIN>
            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).
        --http-port <PORT>
            Set the listen TCP port for the RESTful HTTP API server. [default: 5052]

        --http-spec-fork <http-spec-fork>
            Serve the spec for a specific hard fork on /eth/v1/config/spec. It should not be necessary to set this flag.

        --http-tls-cert <http-tls-cert>
            The path of the certificate to be used when serving the HTTP API server over TLS.

        --http-tls-key <http-tls-key>
            The path of the private key to be used when serving the HTTP API server over TLS. Must not be password-
            protected.
        --libp2p-addresses <MULTIADDR>
            One or more comma-delimited multiaddrs to manually connect to a libp2p peer without an ENR.

        --listen-address <ADDRESS>
            The address lighthouse will listen for UDP and TCP connections. [default: 0.0.0.0]

        --log-format <FORMAT>
            Specifies the log format used when emitting logs to the terminal. [possible values: JSON]

        --logfile <FILE>
            File path where the log file will be stored. Once it grows to the value specified in `--logfile-max-size` a
            new log file is generated where future logs are stored. Once the number of log files exceeds the value
            specified in `--logfile-max-number` the oldest log file will be overwritten.
        --logfile-debug-level <LEVEL>
            The verbosity level used when emitting logs to the log file. [default: debug]  [possible values: info,
            debug, trace, warn, error, crit]
        --logfile-max-number <COUNT>
            The maximum number of log files that will be stored. If set to 0, background file logging is disabled.
            [default: 5]
        --logfile-max-size <SIZE>
            The maximum size (in MB) each log file can grow to before rotating. If set to 0, background file logging is
            disabled. [default: 200]
        --max-skip-slots <NUM_SLOTS>
            Refuse to skip more than this many slots when processing a block or 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.
        --metrics-address <ADDRESS>
            Set the listen address for the Prometheus metrics HTTP server. [default: 127.0.0.1]

        --metrics-allow-origin <ORIGIN>
            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).
        --metrics-port <PORT>
            Set the listen TCP port for the Prometheus metrics HTTP server. [default: 5054]

        --monitoring-endpoint <ADDRESS>
            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.
        --network <network>
            Name of the Eth2 chain Lighthouse will sync and follow. [possible values: mainnet, prater, goerli, gnosis,
            kiln, ropsten, sepolia]
        --network-dir <DIR>
            Data directory for network keys. Defaults to network/ inside the beacon node dir.

        --port <PORT>
            The TCP/UDP port to listen on. The UDP port can be modified by the --discovery-port flag. [default: 9000]

        --safe-slots-to-import-optimistically <INTEGER>
            Used to coordinate manual overrides of the SAFE_SLOTS_TO_IMPORT_OPTIMISTICALLY parameter. This flag should
            only be used if the user has a clear understanding that the broad Ethereum community has elected to override
            this parameter in the event of an attack at the PoS transition block. Incorrect use of this flag can cause
            your node to possibly accept an invalid chain or sync more slowly. Be extremely careful with this flag.
        --slasher-att-cache-size <COUNT>
            Set the maximum number of attestation roots for the slasher to cache

        --slasher-backend <slasher-backend>
            Set the database backend to be used by the slasher. [possible values: mdbx, disabled]

        --slasher-chunk-size <EPOCHS>
            Number of epochs per validator per chunk stored on disk.

        --slasher-dir <PATH>
            Set the slasher's database directory.

        --slasher-history-length <EPOCHS>
            Configure how many epochs of history the slasher keeps. Immutable after initialization.

        --slasher-max-db-size <GIGABYTES>
            Maximum size of the MDBX database used by the slasher.

        --slasher-slot-offset <SECONDS>
            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.
        --slasher-update-period <SECONDS>
            Configure how often the slasher runs batch processing.

        --slasher-validator-chunk-size <NUM_VALIDATORS>
            Number of validators per chunk stored on disk.

        --slots-per-restore-point <SLOT_COUNT>
            Specifies how often a freezer DB restore point should be stored. Cannot be changed after initialization.
            [default: 8192 (mainnet) or 64 (minimal)]
    -s, --spec <DEPRECATED>
            This flag is deprecated, it will be disallowed in a future release. This value is now derived from the
            --network or --testnet-dir flags.
        --suggested-fee-recipient <SUGGESTED-FEE-RECIPIENT>
            Once the merge has happened, this address will receive transaction fees collected from any blocks produced
            by this node. Defaults to a junk address whilst the merge is in development stages. THE DEFAULT VALUE WILL
            BE REMOVED BEFORE THE MERGE ENTERS PRODUCTION
        --target-peers <target-peers>
            The target number of peers. [default: 80]

        --terminal-block-hash-epoch-override <EPOCH>
            Used to coordinate manual overrides to the TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH parameter. This flag should
            only be used if the user has a clear understanding that the broad Ethereum community has elected to override
            the terminal PoW block. Incorrect use of this flag will cause your node to experience a consensus
                                   failure. Be extremely careful with this flag.
        --terminal-block-hash-override <TERMINAL_BLOCK_HASH>
            Used to coordinate manual overrides to the TERMINAL_BLOCK_HASH parameter. This flag should only be used if
            the user has a clear understanding that the broad Ethereum community has elected to override the terminal
            PoW block. Incorrect use of this flag will cause your node to experience a consensus
                                   failure. Be extremely careful with this flag.
        --terminal-total-difficulty-override <INTEGER>
            Used to coordinate manual overrides to the TERMINAL_TOTAL_DIFFICULTY parameter. Accepts a 256-bit decimal
            integer (not a hex value). This flag should only be used if the user has a clear understanding that the
            broad Ethereum community has elected to override the terminal difficulty. Incorrect use of this flag will
            cause your node to experience a consensus
                                   failure. Be extremely careful with this flag.
    -t, --testnet-dir <DIR>
            Path to directory containing eth2_testnet specs. Defaults to a hard-coded Lighthouse testnet. Only effective
            if there is no existing database.
        --trusted-peers <TRUSTED_PEERS>
            One or more comma-delimited trusted peer ids which always have the highest score according to the peer
            scoring system.
        --validator-monitor-file <PATH>
            As per --validator-monitor-pubkeys, but the comma-separated list is contained within a file at the given
            path.
        --validator-monitor-pubkeys <PUBKEYS>
            A comma-separated list of 0x-prefixed validator public keys. These validators will receive special
            monitoring and additional logging.
        --wss-checkpoint <WSS_CHECKPOINT>
            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.

2.4.0

lighthouse-beacon_node 2.4.0
Sigma Prime <[email protected]>
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.

USAGE:
    lighthouse beacon_node [FLAGS] [OPTIONS]

FLAGS:
        --compact-db                     If present, apply compaction to the database on start-up. Use with caution. It
                                         is generally not recommended unless auto-compaction is disabled.
        --disable-discovery              Disables the discv5 discovery protocol. The node will not search for new peers
                                         or participate in the discovery protocol.
    -x, --disable-enr-auto-update        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.
        --disable-lock-timeouts          Disable the timeouts applied to some internal locks by default. This can lead
                                         to less spurious failures on slow hardware but is considered experimental as it
                                         may obscure performance issues.
        --disable-malloc-tuning          If present, do not configure the system allocator. Providing this flag will
                                         generally increase memory usage, it should only be provided when debugging
                                         specific memory allocation issues.
        --disable-packet-filter          Disables the discovery packet filter. Useful for testing in smaller networks
        --disable-upnp                   Disables UPnP support. Setting this will prevent Lighthouse from attempting to
                                         automatically establish external port mappings.
        --dummy-eth1                     If present, uses an eth1 backend that generates static dummy data.Identical to
                                         the method used at the 2019 Canada interop.
        --enable-private-discovery       Lighthouse by default does not discover private IP addresses. Set this flag to
                                         enable connection attempts to local addresses.
    -e, --enr-match                      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.
        --eth1                           If present the node will connect to an eth1 node. This is required for block
                                         production, you must use this flag if you wish to serve a validator.
        --eth1-purge-cache               Purges the eth1 block and deposit caches
    -h, --help                           Prints help information
        --http                           Enable the RESTful HTTP API server. Disabled by default.
        --http-allow-sync-stalled        Forces the HTTP to indicate that the node is synced when sync is actually
                                         stalled. This is useful for very small testnets. TESTING ONLY. DO NOT USE ON
                                         MAINNET.
        --http-disable-legacy-spec       Disable serving of legacy data on the /config/spec endpoint. May be disabled by
                                         default in a future release.
        --http-enable-tls                Serves the RESTful HTTP API server over TLS. This feature is currently
                                         experimental.
        --import-all-attestations        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.
        --logfile-compress               If present, compress old log files. This can help reduce the space needed to
                                         store old logs.
        --merge                          Deprecated. The feature activates automatically when --execution-endpoint is
                                         supplied.
        --metrics                        Enable the Prometheus metrics HTTP server. Disabled by default.
        --private                        Prevents sending various client identification information.
        --purge-db                       If present, the chain database will be deleted. Use with caution.
        --reconstruct-historic-states    After a checkpoint sync, reconstruct historic states in the database.
        --shutdown-after-sync            Shutdown beacon node as soon as sync is completed. Backfill sync will not be
                                         performed before shutdown.
        --slasher                        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.
        --slasher-broadcast              Broadcast slashings found by the slasher to the rest of the network [disabled
                                         by default].
        --staking                        Standard option for a staking beacon node. Equivalent to `lighthouse bn --http
                                         --eth1 `. This will enable the http server on localhost:5052 and try connecting
                                         to an eth1 node on localhost:8545
        --subscribe-all-subnets          Subscribe to all subnets regardless of validator count. This will also
                                         advertise the beacon node as being long-lived subscribed to all subnets.
        --validator-monitor-auto         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.
    -V, --version                        Prints version information
    -z, --zero-ports                     Sets all listening TCP/UDP ports to 0, allowing the OS to choose some arbitrary
                                         free ports.

OPTIONS:
        --auto-compact-db <auto-compact-db>
            Enable or disable automatic compaction of the database on finalization. [default: true]

        --block-cache-size <SIZE>
            Specifies how many blocks the database should cache in memory [default: 5]

        --boot-nodes <ENR/MULTIADDR LIST>
            One or more comma-delimited base64-encoded ENR's to bootstrap the p2p network. Multiaddr is also supported.

        --builder <builder>
            The URL of a service compatible with the MEV-boost API.

        --checkpoint-block <BLOCK_SSZ>
            Set a checkpoint block to start syncing from. Must be aligned and match --checkpoint-state. Using
            --checkpoint-sync-url instead is recommended.
        --checkpoint-state <STATE_SSZ>
            Set a checkpoint state to start syncing from. Must be aligned and match --checkpoint-block. Using
            --checkpoint-sync-url instead is recommended.
        --checkpoint-sync-url <BEACON_NODE>
            Set the remote beacon node HTTP endpoint to use for checkpoint sync.

    -d, --datadir <DIR>
            Used to specify a custom root data directory for lighthouse keys and databases. Defaults to
            $HOME/.lighthouse/{network} where network is the value of the `network` flag Note: Users should specify
            separate custom datadirs for different networks.
        --debug-level <LEVEL>
            Specifies the verbosity level used when emitting logs to the terminal. [default: info]  [possible values:
            info, debug, trace, warn, error, crit]
        --discovery-port <PORT>
            The UDP port that discovery will listen on. Defaults to `port`

        --enr-address <ADDRESS>
            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. Discovery will automatically find your external address,if possible.
        --enr-tcp-port <PORT>
            The TCP port of the local ENR. Set this only if you are sure other nodes can connect to your local node on
            this port.The --port flag is used if this is not set.
        --enr-udp-port <PORT>
            The UDP port of the local ENR. Set this only if you are sure other nodes can connect to your local node on
            this port.
        --eth1-blocks-per-log-query <BLOCKS>
            Specifies the number of blocks that a deposit log query should span. This will reduce the size of responses
            from the Eth1 endpoint. [default: 1000]
        --eth1-cache-follow-distance <BLOCKS>
            Specifies the distance between the Eth1 chain head and the last block which should be imported into the
            cache. Setting this value lower can help compensate for irregular Proof-of-Work block times, but setting it
            too low can make the node vulnerable to re-orgs.
        --eth1-endpoint <HTTP-ENDPOINT>                                                Deprecated. Use --eth1-endpoints.
        --eth1-endpoints <HTTP-ENDPOINTS>
            One or more comma-delimited server endpoints for web3 connection. If multiple endpoints are given the
            endpoints are used as fallback in the given order. Also enables the --eth1 flag. Defaults to
            http://127.0.0.1:8545.
        --execution-endpoint <EXECUTION-ENDPOINT>
            Server endpoint for an execution layer jwt authenticated HTTP JSON-RPC connection. Uses the same endpoint to
            populate the deposit cache. Also enables the --merge flag.If not provided, uses the default value of
            http://127.0.0.1:8551
        --execution-jwt <EXECUTION-JWT>
            File path which contains the hex-encoded JWT secret for the execution endpoint provided in the --execution-
            endpoint flag.
        --execution-jwt-id <EXECUTION-JWT-ID>
            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 deafult
        --execution-jwt-version <EXECUTION-JWT-VERSION>
            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 deafult
        --fork-choice-before-proposal-timeout <fork-choice-before-proposal-timeout>
            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: 250]
        --freezer-dir <DIR>
            Data directory for the freezer database.

        --graffiti <GRAFFITI>
            Specify your custom graffiti to be included in blocks. Defaults to the current version and commit, truncated
            to fit in 32 bytes.
        --http-address <ADDRESS>
            Set the listen address for the RESTful HTTP API server. [default: 127.0.0.1]

        --http-allow-origin <ORIGIN>
            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).
        --http-port <PORT>
            Set the listen TCP port for the RESTful HTTP API server. [default: 5052]

        --http-tls-cert <http-tls-cert>
            The path of the certificate to be used when serving the HTTP API server over TLS.

        --http-tls-key <http-tls-key>
            The path of the private key to be used when serving the HTTP API server over TLS. Must not be password-
            protected.
        --libp2p-addresses <MULTIADDR>
            One or more comma-delimited multiaddrs to manually connect to a libp2p peer without an ENR.

        --listen-address <ADDRESS>
            The address lighthouse will listen for UDP and TCP connections. [default: 0.0.0.0]

        --log-format <FORMAT>
            Specifies the log format used when emitting logs to the terminal. [possible values: JSON]

        --logfile <FILE>
            File path where the log file will be stored. Once it grows to the value specified in `--logfile-max-size` a
            new log file is generated where future logs are stored. Once the number of log files exceeds the value
            specified in `--logfile-max-number` the oldest log file will be overwritten.
        --logfile-debug-level <LEVEL>
            The verbosity level used when emitting logs to the log file. [default: debug]  [possible values: info,
            debug, trace, warn, error, crit]
        --logfile-max-number <COUNT>
            The maximum number of log files that will be stored. If set to 0, background file logging is disabled.
            [default: 5]
        --logfile-max-size <SIZE>
            The maximum size (in MB) each log file can grow to before rotating. If set to 0, background file logging is
            disabled. [default: 200]
        --max-skip-slots <NUM_SLOTS>
            Refuse to skip more than this many slots when processing a block or 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.
        --metrics-address <ADDRESS>
            Set the listen address for the Prometheus metrics HTTP server. [default: 127.0.0.1]

        --metrics-allow-origin <ORIGIN>
            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).
        --metrics-port <PORT>
            Set the listen TCP port for the Prometheus metrics HTTP server. [default: 5054]

        --monitoring-endpoint <ADDRESS>
            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.
        --network <network>
            Name of the Eth2 chain Lighthouse will sync and follow. [possible values: mainnet, prater, goerli, gnosis,
            kiln, ropsten, sepolia]
        --network-dir <DIR>
            Data directory for network keys. Defaults to network/ inside the beacon node dir.

        --port <PORT>
            The TCP/UDP port to listen on. The UDP port can be modified by the --discovery-port flag. [default: 9000]

        --safe-slots-to-import-optimistically <INTEGER>
            Used to coordinate manual overrides of the SAFE_SLOTS_TO_IMPORT_OPTIMISTICALLY parameter. This flag should
            only be used if the user has a clear understanding that the broad Ethereum community has elected to override
            this parameter in the event of an attack at the PoS transition block. Incorrect use of this flag can cause
            your node to possibly accept an invalid chain or sync more slowly. Be extremely careful with this flag.
        --slasher-att-cache-size <COUNT>
            Set the maximum number of attestation roots for the slasher to cache

        --slasher-chunk-size <EPOCHS>
            Number of epochs per validator per chunk stored on disk.

        --slasher-dir <PATH>
            Set the slasher's database directory.

        --slasher-history-length <EPOCHS>
            Configure how many epochs of history the slasher keeps. Immutable after initialization.

        --slasher-max-db-size <GIGABYTES>
            Maximum size of the MDBX database used by the slasher.

        --slasher-slot-offset <SECONDS>
            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.
        --slasher-update-period <SECONDS>
            Configure how often the slasher runs batch processing.

        --slasher-validator-chunk-size <NUM_VALIDATORS>
            Number of validators per chunk stored on disk.

        --slots-per-restore-point <SLOT_COUNT>
            Specifies how often a freezer DB restore point should be stored. Cannot be changed after initialization.
            [default: 8192 (mainnet) or 64 (minimal)]
    -s, --spec <DEPRECATED>
            This flag is deprecated, it will be disallowed in a future release. This value is now derived from the
            --network or --testnet-dir flags.
        --suggested-fee-recipient <SUGGESTED-FEE-RECIPIENT>
            Once the merge has happened, this address will receive transaction fees collected from any blocks produced
            by this node. Defaults to a junk address whilst the merge is in development stages. THE DEFAULT VALUE WILL
            BE REMOVED BEFORE THE MERGE ENTERS PRODUCTION
        --target-peers <target-peers>
            The target number of peers. [default: 80]

        --terminal-block-hash-epoch-override <EPOCH>
            Used to coordinate manual overrides to the TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH parameter. This flag should
            only be used if the user has a clear understanding that the broad Ethereum community has elected to override
            the terminal PoW block. Incorrect use of this flag will cause your node to experience a consensus
                                   failure. Be extremely careful with this flag.
        --terminal-block-hash-override <TERMINAL_BLOCK_HASH>
            Used to coordinate manual overrides to the TERMINAL_BLOCK_HASH parameter. This flag should only be used if
            the user has a clear understanding that the broad Ethereum community has elected to override the terminal
            PoW block. Incorrect use of this flag will cause your node to experience a consensus
                                   failure. Be extremely careful with this flag.
        --terminal-total-difficulty-override <INTEGER>
            Used to coordinate manual overrides to the TERMINAL_TOTAL_DIFFICULTY parameter. Accepts a 256-bit decimal
            integer (not a hex value). This flag should only be used if the user has a clear understanding that the
            broad Ethereum community has elected to override the terminal difficulty. Incorrect use of this flag will
            cause your node to experience a consensus
                                   failure. Be extremely careful with this flag.
    -t, --testnet-dir <DIR>
            Path to directory containing eth2_testnet specs. Defaults to a hard-coded Lighthouse testnet. Only effective
            if there is no existing database.
        --trusted-peers <TRUSTED_PEERS>
            One or more comma-delimited trusted peer ids which always have the highest score according to the peer
            scoring system.
        --validator-monitor-file <PATH>
            As per --validator-monitor-pubkeys, but the comma-separated list is contained within a file at the given
            path.
        --validator-monitor-pubkeys <PUBKEYS>
            A comma-separated list of 0x-prefixed validator public keys. These validators will receive special
            monitoring and additional logging.
        --wss-checkpoint <WSS_CHECKPOINT>
            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.


See also

Retrieved from "https://www.wikieduonline.com/index.php?title=Lighthouse_beacon_node_--help&oldid=170965"

Advertising: