Command line options
The reference describes the syntax of Hildr command line interface(CLI) options.
The command-line help listing is reproduced below for your convenience. The same information can be obtained at any time from your Hildr instance by running:
java --enable-preview -cp hildr-node.jar io.optimism.Hildr --help
Options
devnet
- Syntax
--devnet
Specify whether to start up a Hildr devnet node.
network
- Syntax
- Example
--network=<String|FILE>
--network=optimism-sepolia
When using the --network option, you can specify a network name or a path to a rollup configuration file.
l1-rpc-url
- Syntax
- Example
--l1-rpc-url=<URL>
--l1-rpc-url=https://eth-sepolia.g.alchemy.com/v2/Qmy...
The URL of the L1 Ethereum node that your Hildr node will connect to.
l1-ws-rpc-url
- Syntax
- Example
--l1-ws-rpc-url=<URL>
--l1-ws-rpc-url=wss://eth-sepolia.g.alchemy.com/v2/Qmy...
The URL of the L1 Ethereum node that your Hildr node will connect to via Websocket.
l1-beacon-url
- Syntax
- Example
--l1-beacon-url=<URL>
--l1-beacon-url=https://few-sleek-sound.ethereum-sepolia.quiknode.pro/8e8...2e1
The URL of the L1 Ethereum beacon node that your Hildr node will request to.
--l1-beacon-archiver-url
- Syntax
- Example
--l1-beacon-url=<URL>
--l1-beacon-url=https://few-sleek-sound.ethereum-sepolia.quiknode.pro/8e8...2e1
When the current blob data has been cleared by the beacon node and cannot be queried, the Hildr node will request this URL.
l2-rpc-url
- Syntax
- Example
--l2-rpc-url=<URL>
--l2-rpc-url=http://localhost:8545
The URL of the L2 Optimism Execution Client node that your Hildr node will connect to.
jwt-secret
- Syntax
- Example
--jwt-secret=<HEX>
--jwt-secret=2b3c0b6f...2a12ff2caaf90a
Engine API JWT Secret. This is used to authenticate with the Engine JSON-RPC API.Contents of file must be at least 32 hex-encoded bytes and not begin with 0x.
jwt-file
- Syntax
- Example
--jwt-file=<FILE>
--jwt-file=./jwt-secret.txt
Engine API JWT Secret File used to Hildr node when using the Engine JSON-RPC API (both HTTP and WebSocket). Contents of file must be at least 32 hex-encoded bytes and not begin with 0x.
l2-engine-url
- Syntax
- Example
--l2-engine-url=<URL>
--l2-engine-url=http://localhost:8551
sync-mode
- Syntax
- Example
--sync-mode=<full|checkpoint|execution-layer>
--sync-mode=full
Specifies how hildr node should sync the L2 chain.
checkpoint-hash
- Syntax
- Example
--checkpoint-hash=<BLOCK HASH>
--checkpoint-hash=0x102de6ffb001480cc...9393db90ea0409887d
A L2 checkpoint block hash to use for checkpoint syncing.
checkpoint-sync-url
- Syntax
- Example
--checkpoint-sync-url=<URL>
--checkpoint-sync-url=https://opt-sepolia.g.alchemy.com/v2/Qmy...
A trusted L2 RPC URL to use for checkpoint syncing.
disc-boot-nodes
- Syntax
- Example
--disc-boot-nodes=<enode://id@host:port>[,<enr://id@host:port>...]
--disc-boot-nodes=enode://node://c35c3...d615f@1.2.3.4:30303,enr:-J24Q...TNjgufplG4N0Y3CCJAaDdWRwgiQG
A list of comma-separated enode URLs for P2P discovery(v4/v5) bootstrap.
When connecting to Mainnet or public testnets, the default is a predefined list of enode URLs.
disc-port
- Syntax
- Example
--disc-port=<PORT>
--disc-port=30303
The P2P listening ports (UDP and TCP). The default is 9876.
rpc-addr
- Syntax
- Example
--rpc-addr=<IP>
--rpc-addr=0.0.0.0
The IP of RPC server listening. The default is 0.0.0.0.
rpc-port
- Syntax
- Example
--rpc-port=<PORT>
--rpc-port=9545
The port of RPC server listening. The default is 9545.
log-level
- Syntax
- Example
--log-level=<INFO|DEBUG|TRACE|WARN|ERROR>
--log-level=INFO
The log level of the Hildr node. The default is INFO.