Node Command
The node command starts the anchor client as a SSV operator node.
anchor node [OPTIONS]Options
External APIs
| Option | Description | Default |
|---|---|---|
--beacon-nodes <NETWORK_ADDRESSES> | Comma-separated beacon node HTTP URLs | http://localhost:5052 |
--execution-rpc <NETWORK_ADDRESSES> | Comma-separated execution node RPC URLs | http://localhost:8545 |
--execution-ws <NETWORK_ADDRESSES> | Execution node websocket URL | ws://localhost:8546 |
--beacon-nodes-tls-certs <CERTIFICATE-FILES> | Comma-separated paths to custom TLS certificates for beacon nodes (PEM format) | None |
--execution-nodes-tls-certs <CERTIFICATE-FILES> | Comma-separated paths to custom TLS certificates for execution nodes (PEM format) | None |
HTTP API
| Option | Description | Default |
|---|---|---|
--http | Enable the HTTP API sever | Disabled |
--http-address <ADDRESS> | Listen address for HTTP API | None |
--http-port <PORT> | Listen port for HTTP API | 5062 if --http is set |
--http-allow-origin <ORIGIN> | Set CORS allowed origin | None |
--unencrypted-http-transport | Safety flag to acknowledge HTTP is unencrypted | Required if --http-address is set |
Metrics Options
| Option | Description | Default |
|---|---|---|
--metrics | Enable metrics server | Disabled |
--metrics-address <ADDRESS> | Listen address for metrics server | 127.0.0.1 if --metrics is set |
--metrics-port <PORT> | Listen port for metrics server | 5164 if --metrics is set |
Network Options
| Option | Description | Default |
|---|---|---|
--listen-addresses [<ADDRESS>...] | Network addresses to listen for UDP & TCP connections (can be set multiple times for IPv4 and IPv6) | 0.0.0.0 |
--port <PORT> | TCP/UDP ports for IPv4 (discovery and TCP will use this value, QUIC will use this + 1) | 12001 (discovery), 13001 (TCP) |
--port6 <PORT> | TCP/UDP ports for IPv6 when listening over both IPv4 and IPv6 (QUIC will use this + 1) | Same as --port |
--discovery-port <PORT> | UDP port for discovery | Same as --port if specified, otherwise 12001 |
--discovery-port6 <PORT> | UDP port for IPv6 discovery | Same 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 <BOOT_NODES> | Comma-separated ENRs or Multiaddrs to bootstrap the network | None |
--enr-address <ADDRESS> | IPv4 address to broadcast in the node's ENR | None |
--enr-address6 <ADDRESS> | IPv6 address to broadcast in the node's ENR | None |
--enr-udp-port <PORT> | UDP port to advertise in the node's ENR | None |
--enr-tcp-port <PORT> | TCP port to advertise in the node's ENR | None |
--enr-quic-port <PORT> | QUIC port to advertise in the node's ENR | None |
--enr-udp6-port <PORT> | IPv6 UDP port to advertise in the node's ENR | None |
--enr-tcp6-port <PORT> | IPv6 TCP port to advertise in the node's ENR | None |
--enr-quic6-port <PORT> | IPv6 QUIC port to advertise in the node's ENR | None |
--disable-enr-auto-update | Disable discovery from automatically updating the ENR with external addresses | Disabled |
--subscribe-all-subnets | Subscribe to all subnets regardless of committee membership | Disabled |
Security Options
| Option | Description | Default |
|---|---|---|
--key-file <PATH> | Path to the operator key file (.txt for unencrypted, .json for encrypted) | Detected in data dir |
--password-file <PATH> | Path to a file containing the key password for decryption | None |
Payload Building Options
| Option | Description | Default |
|---|---|---|
--builder-proposals | Query Beacon Node for only block headers during proposals and sign over headers | Disabled |
--builder-boost-factor <UINT64> | Percentage multiplier to apply to builder's payload value | None |
--prefer-builder-proposals | Always prefer builder blocks regardless of payload value | Disabled |
--gas-limit <INTEGER> | Gas limit for all builder proposals for all validators | 36000000 |
Logging Options
| Option | Description | Default |
|---|---|---|
--debug-level <DEBUG_LEVEL> | Verbosity for terminal logs | INFO |
--logfile-debug-level <LOGFILE_DEBUG_LEVEL> | Verbosity for file logs | DEBUG |
--logfile-max-size <SIZE> | Maximum size of each log file in MB (set to 0 to disable) | 50 |
--logfile-max-number <NUMBER> | Maximum number of log files to keep (set to 0 to disable) | 10 |
--logfile-dir <DIR> | Directory to store log files | Same as --data-dir |
--logfile-compression | Compress old log files | Disabled |
--logfile-color | Enable colors in logfile | Disabled |
--discv5-log-level <DISCV5_LOG_LEVEL> | Verbosity level for discv5 dependency log file | DEBUG |
--libp2p-log-level <LIBP2P_LOG_LEVEL> | Verbosity level for libp2p dependency log file | DEBUG |
Additional Network and Performance Options
| Option | Description | Default |
|---|---|---|
--disable-gossipsub-peer-scoring | Disable gossipsub peer scoring | Enabled |
--disable-latency-measurement-service | Disable the latency measurement service | Enabled |
--enable-high-validator-count-metrics | Enable per validator metrics for > 64 validators | Auto-enabled for ≤ 64 validators |
Examples
anchor node \
--network hoodi \
--data-dir /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