Peering Setup 🔗

Point your Hyperliquid node at your dedicated Purroof peer in a few minutes. This guide covers non-validator nodes run with hl-visor.

Before you start 🐾

An active Purroof Peering subscription
A Hyperliquid non-validator node (the official node software, run via hl-visor)
Gossip ports 4001 and 4002 open on your machine

1. Get your dedicated peer IP

After subscribing, we send your dedicated peer IP to the email you used at checkout. That peer is reserved for your node — nobody else connects to it. Haven’t received it? Meow at us.

2. Configure your gossip overrides

On the machine running your node, create (or edit) ~/override_gossip_config.json and add your Purroof peer as a root node IP:

{
  "root_node_ips": [{ "Ip": "YOUR_PURROOF_PEER_IP" }],
  "try_new_peers": false,
  "chain": "Mainnet",
  "reserved_peer_ips": []
}

Replace YOUR_PURROOF_PEER_IP with the IP we sent you.

⚠️ About try_new_peers: "try_new_peers": false pins your node exclusively to your dedicated peer for a deterministic, low-latency path. If you’d rather your node also discover public peers as a fallback, set it to true — you’ll keep the dedicated peer as your primary root.

3. Restart your node

Restart so the gossip overrides take effect:

~/hl-visor run-non-validator

4. Verify the connection

Confirm your node has an established connection to your peer:

ss -tn | grep YOUR_PURROOF_PEER_IP

You should see established connections on the gossip ports. Blocks and full mempool data stream over this connection — no extra configuration needed.

Stuck? We’ve got your back 😸

Peering subscribers get priority support. Send us a message and we’ll pounce on it.