Aller au contenu

Accès au peering

Le peering offre aux nœuds non-validateurs un flux gossip Hyperliquid à faible latence et dédupliqué via un Block Proxy, incluant le mempool. Il n'inclut pas les flux de données de marché Edge. Pour ceux-ci, consultez S'abonner à Hyperliquid (Edge). Vue d'ensemble : Hyperliquid.

À qui c'est destiné Les nœuds non-validateurs que vous exploitez
Ce que vous obtenez Un flux gossip arbitré via Block Proxy (blocs + mempool)
Hôtes récepteurs 1 IP incluse
Tarif 999 $/mois (pas de données de marché Edge)
Objectif de disponibilité 99,9 % mensuel

Demander le peering

Plus d'informations sur le peering sont disponibles via Telegram. Incluez l'IP publique statique de votre nœud (et la région). Comptez sur la réception des détails du pair sous 1 à 3 jours ouvrables après que nous ayons les détails de votre nœud et que le paiement soit effectué.

Connecter votre nœud

Une fois approuvé, nous vous envoyons l'IP de votre pair. Dirigez votre nœud non-validateur vers celle-ci, ouvrez votre pare-feu pour cette IP, et redémarrez le nœud.

1. Configurer le gossip

Remplacez ~/override_gossip_config.json par ceci, en utilisant l'IP de votre pair :

{
  "root_node_ips": [{"Ip": "<PEER_IP>"}],
  "try_new_peers": false,
  "split_client_blocks": true,
  "chain": "Mainnet"
}
Paramètre Pourquoi
root_node_ips Votre pair DoubleZero est votre seul upstream.
try_new_peers: false Maintient le nœud sur le pair DoubleZero. Il ne basculera pas vers les pairs publics.
split_client_blocks: true Diffuse les transactions du mempool vers ~/hl/data/mempool_txs/.

Prévoyez l'espace disque et la bande passante

Avec split_client_blocks: true, le nœud écrit l'intégralité du mempool sur disque. Prévoyez plusieurs centaines de Go à environ 1 To d'écritures par jour depuis le mempool, et à peu près autant provenant des autres sorties du nœud. La bande passante entrante est moindre car le gossip est compressé sur le réseau ; notre nœud de test recevait environ 110 Go/jour. Définissez une politique de rétention pour ~/hl/data/ (par exemple, supprimer les fichiers de plus de quelques heures) sinon le disque se remplira en une journée.

2. Ouvrir votre pare-feu vers le pair

Autorisez les connexions entrantes TCP et UDP 4001–4002 depuis <PEER_IP>. Faites-le dans votre groupe de sécurité cloud et sur le pare-feu de l'hôte.

Lorsque votre nœud se connecte, le pair se reconnecte à votre nœud sur les ports 4001 et 4002 pour vérifier qu'il est joignable. Si cette vérification est bloquée, la connexion s'ouvre mais aucune donnée n'arrive. Autorisez également les connexions sortantes vers le pair sur les ports 4001–4002.

3. Redémarrer le nœud

sudo systemctl restart hl-node   # or however you run hl-visor

Le nœud lit ce fichier au démarrage. Les modifications effectuées pendant son exécution peuvent ne pas prendre pleinement effet, redémarrez donc après chaque changement. La synchronisation prend généralement 5 à 15 minutes.

4. Vérifier que ça fonctionne

ss -tn state established '( dport = :4001 )'     # one connection, to <PEER_IP>
journalctl -u hl-node -f | grep 'applied block'  # blocks are being applied
ls -l ~/hl/data/mempool_txs/                     # mempool files are growing

Connecté mais pas de données

Le pair ne peut pas atteindre votre nœud sur les ports 4001–4002. Vérifiez les règles entrantes de l'étape 2.

Pas de repli vers les pairs publics

Avec try_new_peers: false, votre nœud attend le pair DoubleZero s'il est injoignable. Il ne bascule pas vers les pairs publics. Contactez-nous si vous voyez des messages Peer full répétés ou des délais de connexion dépassés.

Pourquoi le peering payant

Les pairs racines publics d'Hyperliquid sont partagés : les emplacements sont disputés, les pairs changent ou limitent le débit, et beaucoup ne relaient pas le mempool. Un emplacement de peering réservé vous donne un upstream stable sur DoubleZero au lieu de rivaliser pour cette capacité publique.

Comment ça fonctionne

  • Deux sources de gossip : un flux A provenant du nœud non-validateur de Hyper Foundation, et un flux B provenant d'une sentinelle.
  • Les clients se connectent à un niveau Block Proxy qui évolue horizontalement. Chaque proxy se connecte à nos deux nœuds non-validateurs et apparaît comme un pair gossip ordinaire pour chacun d'eux.
  • Le proxy arbitre les flux A et B en un seul flux gossip dédupliqué pour ses pairs, de sorte que l'une ou l'autre source peut tomber sans interrompre le flux.
  • Ajoutez des proxies pour ajouter de la capacité. La charge sur nos nœuds non-validateurs n'augmente pas avec le nombre de pairs.
  ┌─────────────────────┐                    ┌─────────────────────┐
  │     Foundation      │                    │       Sentry        │
  │ Non-Validating Node │                    │                     │
  └──────────┬──────────┘                    └──────────┬──────────┘
             │                                          │
┈┈┈┈┈┈┈┈┈┈┈┈┈│┈┈┈┈┈┈┈┈┈┈ DOUBLEZERO INFRA ┈┈┈┈┈┈┈┈┈┈┈┈┈┈│┈┈┈┈┈┈┈┈┈┈┈┈
             ▼                                          ▼
  ┌─────────────────────┐                    ┌─────────────────────┐
  │       Primary       │                    │      Secondary      │
  │ Non-Validating Node │                    │ Non-Validating Node │
  └──────────┬──────────┘                    └──────────┬──────────┘
             │                                          │
             │   A feed                        B feed   │
             └──────────────┐              ┌────────────┘
                            ▼              ▼
                    ┌────────────────────────┐         ┌──────────────────┐
                    │      Block Proxy       │◀╌╌╌╌╌╌╌╌│ Snapshot Service │
                    │  (arbitrates A and B)  │         │   (on demand)    │
                    └───────────┬────────────┘         └──────────────────┘
                                │
                                │  one deduplicated gossip feed
                                ▼
                          ┌───────────┐
                          │   Peers   │
                          └───────────┘

Le nœud Hyper Foundation se connecte à notre primaire ; une sentinelle alimente notre secondaire. Chaque Block Proxy se connecte aux deux, fusionne leurs flux pour ses clients, et récupère des snapshots de démarrage depuis le service de snapshots si nécessaire.

Disponibilité

Objectif : 99,9 % de disponibilité mensuelle.

  • Flux redondant. Chaque proxy se connecte à nos deux nœuds non-validateurs. Ces nœuds reçoivent les blocs de sources indépendantes (Foundation et sentinelle). Si une session ou une source tombe, l'autre maintient le flux de blocs pendant que le chemin défaillant se rétablit.
  • Nos nœuds restent derrière le niveau proxy. Les pairs externes n'atteignent que les Block Proxies. Si un proxy tombe en panne, ses pairs se reconnectent à un autre proxy sain. La charge ne retombe jamais sur nos nœuds.
  • Les proxies ne détiennent que des caches jetables (snapshot, fenêtre glissante de blocs, tampons en direct), pas l'état autoritatif de la chaîne. Un proxy défaillant est remplacé automatiquement. Un remplacement n'entre en service qu'après que les sessions upstream et les caches aient passé les vérifications de disponibilité. Nos nœuds non-validateurs ne sont pas redémarrés pour cela.

Mise à l'échelle automatique

  • Montez en charge en ajoutant un proxy. Chaque proxy dessert de nombreux pairs mais compte comme un seul pair sur chacun de nos nœuds non-validateurs.
  • La charge des nœuds suit le nombre de proxies, pas le nombre de pairs.
  • Un nouveau proxy démarre dès que les caches sont chauds et que les vérifications de disponibilité sont validées. Il n'a pas besoin d'une resynchronisation complète de la chaîne.
  • Un pair qui se connecte récupère son snapshot de démarrage depuis le service de snapshots et les blocs de rattrapage depuis le stockage propre du proxy, jamais depuis nos nœuds non-validateurs. Un afflux de nouveaux pairs impacte le niveau proxy à la place.

Tarification

999 $/mois pour le peering. Inclut le mempool. N'inclut pas les flux de données de marché Edge. Un hôte récepteur (IP) est inclus. Le peering n'est ni groupé ni remisé avec les données de marché Edge.