dev
CLI Command
Quickly bootstrap a beacon node and multiple validators. Use for development and testing
Examples
Start a single beacon node with 8 interop validators
./lodestar dev --genesisValidators 8 --reset
dev
Options
--dataDir
Lodestar root data directory
type: string
--network
Name of the Ethereum Consensus chain network to join
type: string
choices: "mainnet", "gnosis", "sepolia", "holesky", "hoodi", "chiado", "ephemery", "dev"
default: "mainnet"
--paramsFile
Network configuration file
type: string
--rcConfig
RC file to supplement command line args, accepted formats: .yml, .yaml, .json
type: string
--terminal-total-difficulty-override
Terminal PoW block TTD override
type: string
--terminal-block-hash-override
Terminal PoW block hash override
type: string
--terminal-block-hash-epoch-override
Terminal PoW block hash override activation epoch
type: string
--genesisStateFile
Path or URL to download a genesis state file in ssz-encoded format
type: string
--checkpointSyncUrl
Server url hosting Beacon Node APIs to fetch weak subjectivity state. Fetch latest finalized by default, else set --wssCheckpoint
type: string
--checkpointState
Set a checkpoint state to start syncing from
type: string
--wssCheckpoint
Start beacon node off a state at the provided weak subjectivity checkpoint, to be supplied in <blockRoot>:<epoch> format. For example, 0x1234:100 will sync and start off from the weak subjectivity state at checkpoint of epoch 100 with block root 0x1234.
type: string
--forceCheckpointSync
Force syncing from checkpoint state even if db state is within weak subjectivity period. This helps to avoid long sync times after node has been offline for a while.
type: boolean
--ignoreWeakSubjectivityCheck
Ignore the checkpoint sync state failing the weak subjectivity check. This is relevant in testnets where the weak subjectivity period is too small for even few epochs of non finalization causing last finalized to be out of range. This flag is not recommended for mainnet use.
type: boolean
--persistNetworkIdentity
Whether to reuse the same peer-id across restarts
type: boolean
--private
Do not send implementation details over p2p identify protocol and in builder, execution engine and eth1 requests
type: boolean
--validatorMonitorLogs
Log validator monitor events as info.
type: boolean
--disableLightClientServer
Disable light client server.
type: boolean
--logLevel
Logging verbosity level for emitting logs to terminal
type: string
choices: "error", "warn", "info", "verbose", "debug", "trace"
default: "info"
--logFile
Path to output all logs to a persistent log file, use 'none' to disable
type: string
--logFileLevel
Logging verbosity level for emitting logs to file
type: string
choices: "error", "warn", "info", "verbose", "debug", "trace"
default: "debug"
--logFileDailyRotate
Daily rotate log files, set to an integer to limit the file count, set to 0 (zero) to disable rotation
type: number
default: 5
--rest
Enable/disable HTTP API
type: boolean
default: true
--rest.namespace
Pick namespaces to expose for HTTP API. Set to '*' to enable all namespaces
type: string[]
choices: "beacon", "config", "debug", "events", "lightclient", "lodestar", "node", "proof", "validator", "*"
default: ["beacon","config","debug","events","node","validator","lightclient"]
--rest.cors
Configures the Access-Control-Allow-Origin CORS header for HTTP API
type: string
default: "*"
--rest.address
Set host for HTTP API
type: string
default: "127.0.0.1"
--rest.port
Set port for HTTP API
type: number
default: 9596
--rest.swaggerUI
Enable Swagger UI for API exploration at http://{address}:{port}/documentation
type: boolean
default: true
--suggestedFeeRecipient
Specify fee recipient default for collecting the EL block fees and rewards (a hex string representing 20 bytes address: ^0x[a-fA-F0-9]{40}$). It would be possible (WIP) to override this per validator key using config or key manager API. Only used post merge.
type: string
default: "0x0000000000000000000000000000000000000000"
--emitPayloadAttributes
Flag to SSE emit execution payloadAttributes
before every slot
type: boolean
default: false