Skip to content

Node Command

The node command starts the anchor client as a SSV operator node.

anchor node [OPTIONS]

Options

External APIs

OptionDescriptionDefault
--beacon-nodes <URLS>Comma-separated beacon node HTTP URLshttp://localhost:5052
--execution-rpc <URLS>Comma-separated execution node RPC URLshttp://localhost:8545
--execution-ws <URL>Execution node websocket URLws://localhost:8546
--beacon-node-tls-certs <FILES>Certificate files for beacon node connectionsNone
--execution-node-tls-certs <FILES>Certificate files for execution node connectionsNone

HTTP API

OptionDescriptionDefault
--httpEnable the HTTP API severDisabled
--http-address <ADDRESS>Listen address for HTTP APINone
--http-port <PORT>Listen port for HTTP API5062 if --http is set
--http-allow-origin <ORIGIN>Set CORS allowed originNone
--unencrypted-http-transportSafety flag to acknowledge HTTP is unencryptedRequired if --http-address is set

Metrics Options

OptionDescriptionDefault
--metricsEnable metrics serverDisabled
--metrics-address <ADDRESS>Listen address for metrics server127.0.0.1 if --metrics is set
--metrics-port <PORT>Listen port for metrics server5164 if --metrics is set

Network Options

OptionDescriptionDefault
--listen-address <ADDRESS>Network address to listen for UDP & TCP connections0.0.0.0
--port <PORT>Base port for all network connections13001
--port6 <PORT>Base port for IPv6 network connectionsSame as --port
--discovery-port <PORT>UDP port for discoverySame as --port if specified, otherwise 12001
--discovery-port6 <PORT>UDP port for IPv6 discoverySame as --discovery-port
--quic-port <PORT>UDP port for QUIC protocol--port + 1
--quic-port6 <PORT>UDP port for IPv6 QUIC protocol--port6 + 1
--boot-nodes <NODES>Comma-separated ENRs or Multiaddrs to bootstrap the networkNone
--enr-address <ADDRESS>IPv4 address to broadcast in the node's ENRNone
--enr-address6 <ADDRESS>IPv6 address to broadcast in the node's ENRNone
--enr-udp-port <PORT>UDP port to advertise in the node's ENRNone
--enr-tcp-port <PORT>TCP port to advertise in the node's ENRNone
--enr-quic-port <PORT>QUIC port to advertise in the node's ENRNone
--enr-udp6-port <PORT>IPv6 UDP port to advertise in the node's ENRNone
--enr-tcp6-port <PORT>IPv6 TCP port to advertise in the node's ENRNone
--enr-quic6-port <PORT>IPv6 QUIC port to advertise in the node's ENRNone
--subscribe-all-subnetsSubscribe to all subnets regardless of committee membershipDisabled

Security Options

OptionDescriptionDefault
--key-file <PATH>Path to the operator keyDetected in data dir
--password-file <PATH>Path to a file containing the key passwordNone
--disable-slashing-protectionDisable slashing protection (NOT RECOMMENDED)None

Payload Building Options

OptionDescriptionDefault
--builder-proposalsUse external block buildingDisabled
--builder-boost-factor <FACTOR>Percentage multiplier for builder payload valueNone
--prefer-builder-proposalsAlways prefer builder blocks regardless of valueDisabled

Logging Options

OptionDescriptionDefault
--debug-level <LEVEL>Verbosity for terminal logsinfo
--logfile-debug-level <LEVEL>Verbosity for file logsdebug
--logfile-max-size <SIZE>Maximum size of each log file in MB50
--logfile-max-number <NUMBER>Maximum number of log files to keep100
--logfile-dir <DIR>Directory to store log filesSame as --datadir
--logfile-compressionCompress old log filesDisabled

Examples

anchor node \
  --network hoodi \
  --datadir /data/anchor \
  --beacon-nodes https://beacon1.example.com,https://beacon2.example.com \
  --execution-rpc https://execution1.example.com,https://execution2.example.com \
  --execution-ws wss://execution1.example.com \
  --listen-addresses 10.0.0.10 \
  --port 9100 \
  --http \
  --http-address 127.0.0.1 \
  --http-port 9200 \
  --unencrypted-http-transport \
  --metrics \
  --metrics-address 127.0.0.1 \
  --metrics-port 9300 \
  --password-file /path/to/your/password