Running a Hyperliquid Node - Docker

Setup

Configure Chain

For testing, configure your chain as follows:

• Mainnet:

  echo '{"chain": "Mainnet"}' > ~/visor.json

Download the Visor Binary

The visor binary spawns and manages the child node process.

• Mainnet:

  curl https://binaries.hyperliquid.xyz/Mainnet/hl-visor > ~/hl-visor && chmod a+x ~/hl-visor

---

Verify Signed Binaries

Binaries are signed for extra security. The public key is found at pub_key.asc in this repo.

1. Import the Key:

   gpg --import pub_key.asc

2. Verify the Binary: Signatures are located at {binary}.asc.

   • Mainnet:

     curl https://binaries.hyperliquid.xyz/Mainnet/hl-visor.asc > hl-visor.asc
     gpg --verify hl-visor.asc hl-visor

hl-visor will also verify hl-node automatically and will not upgrade on verification failure. Important: The public key must be imported as shown above. Optionally, sign the key using gpg --sign-key to avoid warnings when verifying its signatures.

---

Running Non-Validator

To start a non-validator node:

~/hl-visor run-non-validator

It may take a while as the node navigates the network to find an appropriate peer to stream from. Logs such as applied block X indicate that the node is streaming live data.

Note: The same command is used regardless of whether your chain is set to Testnet or Mainnet (as configured in ~/visor.json).

---

Mainnet Non-Validator Seed Peers

To run a non-validator on Mainnet, there must be at least one IP address in ~/override_gossip_config.json.

A list of recently available peers can be queried via the API:

curl -X POST --header "Content-Type: application/json" --data '{ "type": "gossipRootIps" }' https://api.hyperliquid.xyz/info

The validator community also runs several independent root peers for non-validators to connect to on Mainnet.

Operator	Root IP	Location
ASXN	64.31.48.111	Japan
ASXN	64.31.51.137	Japan
B-Harvest	180.189.55.18	South Korea
B-Harvest	180.189.55.19	South Korea
Nansen x HypurrCollective	34.84.25.59	Japan
Nansen x HypurrCollective	34.146.230.150	Japan
Hypurrscan	13.230.78.76	Japan
Hypurrscan	54.248.41.39	Japan
Infinite Field	52.68.71.160	Japan
Infinite Field	13.114.116.44	Japan
LiquidSpirit x Rekt Gang	79.127.159.173	Japan
LiquidSpirit x Rekt Gang	79.127.159.174	Japan
Imperator.co	23.81.40.69	Japan
Imperator.co	157.90.207.92	Germany
Enigma	109.123.230.189	Japan
TMNT	31.223.196.172	Japan
TMNT	31.223.196.238	Japan
HyperStake	91.134.71.237	France
HyperStake	57.129.140.247	United Kingdom
ValiDAO	67.213.123.85	Japan
ValiDAO	72.46.87.141	Singapore
Hyperbeat x P2P.org x Hypio	199.254.199.12	Japan
Hyperbeat x P2P.org x Hypio	199.254.199.54	Japan
Luganodes	45.250.255.111	Japan
Luganodes	109.94.99.131	Japan
HypurrCorea: SKYGG x DeSpread	23.81.41.3	Japan
HypurrCorea: SKYGG x DeSpread	15.235.231.247	Singapore
Purrposeful x HyBridge x PiP	199.254.199.48	Japan
Purrposeful x HyBridge x PiP	199.254.199.52	Japan
Kinetiq x Hyperion	15.235.232.101	Singapore

---