Connexion d'un abonné Edge

En me connectant à DoubleZero, j'accepte les Conditions d'utilisation de DoubleZero. Veuillez noter que les données sont destinées à votre usage interne uniquement et ne peuvent pas être retransmises (voir Section 2(e)).

Étape 1 : Configuration de DoubleZero

1. Effectuer la configuration

Installez la CLI Solana.

Suivez les instructions de configuration pour installer et configurer le client DoubleZero.

Si vous avez déjà configuré DoubleZero, assurez-vous d'avoir la dernière version de la CLI Doublezero-Solana avec sudo apt update && sudo apt install doublezero-solana

2. Configurer le pare-feu

Autorisez le trafic GRE, BGP, PIM et les shreds.

iptables :

sudo iptables -A OUTPUT -p gre -j ACCEPT
sudo iptables -A INPUT -i doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -p pim -j ACCEPT
sudo iptables -A INPUT -i doublezero1 -p udp --dport 7733 -j ACCEPT
sudo iptables -A INPUT -i doublezero0 -p udp --dport 44880 -j ACCEPT

UFW :

sudo ufw allow proto gre from any to any
sudo ufw allow in on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
sudo ufw allow out on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
sudo ufw allow out on doublezero1 proto pim from any to any
sudo ufw allow in on doublezero1 to any port 7733 proto udp
sudo ufw allow in on doublezero0 to any port 44880 proto udp

3. Activer le réconciliateur

Le réconciliateur surveille l'état onchain et provisionne automatiquement les tunnels lorsque votre siège est attribué. Il n'est pas activé par défaut.

doublezero enable

Étape 2 : Configurer votre portefeuille

1. Créer une paire de clés Solana

La CLI doublezero-solana utilise une paire de clés Solana standard pour la gestion des sièges onchain. Si vous n'en avez pas :

solana-keygen new

Cela écrit dans ~/.config/solana/id.json. Pour utiliser un chemin différent, passez --keypair <path> à n'importe quelle commande doublezero-solana.

Affichez l'adresse de votre portefeuille :

solana address

2. Approvisionner votre portefeuille

Votre portefeuille a besoin de deux jetons :

SOL — pour les frais de transaction Solana. Transférez des SOL vers l'adresse du portefeuille affichée ci-dessus.
USDC — pour le financement du siège. La CLI prélève depuis le compte de jetons associé (ATA) de votre portefeuille pour le mint USDC mainnet (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v).

Étape 3 : Acheter un siège

1. Trouver votre appareil le plus proche

Avant d'acheter un siège, identifiez l'appareil avec la latence la plus faible depuis votre machine :

doublezero latency

Notez le code de l'appareil du résultat avec la latence la plus faible (par ex., <Device_Name>). Vous l'utiliserez lors de l'achat d'un siège.

2. Vérifier les tarifs

Consultez les tarifs actuels des appareils avant d'engager des fonds. La tarification comporte deux composantes : un prix de base métro et une prime par appareil. Les prix sont mis à jour à chaque epoch. Vous pouvez également consulter les tarifs et la disponibilité ici.

Tous les appareils :

doublezero-solana shreds price

Appareil spécifique :

doublezero-solana shreds price --device-code <Device_Name>
doublezero-solana shreds price --device <PUBKEY>

Tous les appareils d'un métro :

doublezero-solana shreds price --metro <PUBKEY>

Colonnes de sortie : Device Code, Metro Code, Metro Name, Status, Settled Seats, Available Seats, Base Price (USDC), Premium (USDC), Epoch Price (USDC).

Le prix par epoch est le coût total par epoch pour un siège sur cet appareil (base + prime). Utilisez --wide pour afficher les clés publiques complètes, ou --json pour une sortie JSON.

3. Acheter un siège

Achetez un siège avec une seule commande. Cela initialise votre siège, finance le séquestre et demande l'attribution :

doublezero-solana shreds pay \
  --device-code <Device_Name> \
  --client-ip <Target_IP> \
  --amount <Cost_Of_Seat>

Paramètres :

Drapeau	Description
`--device <PUBKEY>`	Appareil cible par clé publique (mutuellement exclusif avec `--device-code`)
`--device-code <CODE>`	Appareil cible par code lisible (par ex., `<Device_Name>`)
`--client-ip <IP>`	L'adresse IPv4 publique de votre machine
`--amount <USDC>`	USDC à financer (format décimal, par ex. `100` = 100 USDC). Doit atteindre le prix minimum par epoch.
`--source-token-account <PUBKEY>`	Compte source USDC personnalisé (par défaut l'ATA de votre portefeuille)
`--accept-partial-epoch`	Ignorer l'avertissement d'epoch restante (voir ci-dessous)
`--fee-payer <PATH>`	Utiliser un portefeuille différent pour les frais de transaction SOL
`--dry-run`	Simuler la transaction sans l'exécuter
`--with-compute-unit-price <PRICE>`	Définir un prix d'unité de calcul pour une inclusion plus rapide en cas de congestion

Une fois votre siège attribué, le démon établit automatiquement le tunnel GRE. Vérifiez votre connexion avec :

doublezero status

Timing des epochs

Les sièges sont attribués par epoch Solana (~2 jours). S'il reste moins de 10 % de l'epoch en cours lorsque vous payez, la CLI vous avertit que votre siège sera attribué immédiatement mais ne couvre que le reste de l'epoch en cours. Un paiement séparé sera déduit de votre séquestre au début de l'epoch suivante.

Il est conseillé de financer pour plus d'une epoch à la fois afin de ne pas perdre votre siège. Vous pouvez vérifier le temps restant dans une epoch ici.

Vous pouvez ignorer cet avertissement avec --accept-partial-epoch.

Maintenir votre séquestre approvisionné

Si le solde de votre séquestre est inférieur au prix de l'epoch au moment du règlement, votre siège ne sera pas attribué, le tunnel sera démonté et vous perdrez votre ancienneté accumulée. L'ancienneté détermine votre priorité pour les epochs futures — la perdre signifie que vous êtes en concurrence comme un nouvel arrivant.

Vous pouvez sur-approvisionner ce compte pour financer plusieurs epochs. Chaque règlement déduit le prix d'une epoch de votre séquestre, et le solde restant est reporté. Par exemple, financer 5 fois le prix par epoch maintient votre siège actif pendant jusqu'à 5 epochs sans réapprovisionnement.

Pour compléter votre séquestre, exécutez shreds pay à nouveau à tout moment :

doublezero-solana shreds pay \
  --device-code <Device_Name> \
  --client-ip <Target_IP> \
  --amount 500

Notez que le Target_IP doit être une adresse IPv4 publique sur la machine qui recevra les shreds. Vous pouvez la trouver en exécutant une commande comme curl -4 ifconfig.me sur la machine cible.

Surveiller les sièges

Cette section détaille comment visualiser les sièges via la CLI. Vous pouvez également utiliser https://data.malbeclabs.com/api/v1/docs pour surveiller les sièges et vous aider à gérer votre compte séquestre.

Consultez vos sièges actifs et les soldes de séquestre :

Tous vos sièges :

doublezero-solana shreds list

Filtrer par appareil :

doublezero-solana shreds list --device-code <Device_Name>

Filtrer par IP client :

doublezero-solana shreds list --client-ip <Target_IP>

Filtrer par portefeuille :

doublezero-solana shreds list --withdraw-authority <PUBKEY>

Colonnes de sortie : Device Code, Client IP, Tenure, Balance (USDC), Est. Epochs Paid.

La colonne « Est. Epochs Paid » indique combien d'epochs votre solde actuel couvre aux tarifs en vigueur. Si les prix changent, cette estimation s'ajuste.

Retirer des fonds

Fermez votre séquestre et remboursez les USDC restants vers votre portefeuille :

doublezero-solana shreds withdraw \
  --device-code <Device_Name> \
  --client-ip <Target_IP>

Vous pouvez identifier l'appareil par --device <PUBKEY> ou --device-code <CODE>, comme pour les autres commandes.

Pour envoyer le remboursement vers un compte de jetons différent :

doublezero-solana shreds withdraw \
  --device-code <Device_Name> \
  --client-ip <Target_IP> \
  --refund-token-account <PUBKEY>

Retirer signifie que vous perdez votre siège et l'ancienneté accumulée.

Adresses des shreds (IP vs Port)

Les shreds de leader et les shreds de retransmission à haute participation arriveront sur le port 7733, via l'interface doublezero1. L'interface doublezero0 est destinée au trafic unicast. Le port 5765 est un moniteur de battement de cœur des éditeurs de shreds — il ne contiendra pas de shreds.

Pour la consommation des shreds, l'adresse IP identifie le flux multicast et le port identifie le service UDP sur ce flux.
Tous les flux de shreds ci-dessous utilisent le port UDP 7733 sur doublezero1.

Vous pouvez examiner les IP de n'importe quel groupe multicast avec :

doublezero multicast group list

Shreds de leader

edge-solana-shreds: 233.84.178.1:7733

Shreds de racine

edge-solana-root: 233.84.178.16:7733

Shreds de retransmission

edge-solana-retrans-eu: 233.84.178.12:7733
edge-solana-retrans-apac: 233.84.178.13:7733
edge-solana-retrans-amer: 233.84.178.14:7733

En-tête du tunnel GRE — XDP

Le trafic de shreds livré sur le réseau est encapsulé en GRE. Vous devrez peut-être supprimer l'en-tête GRE avant d'injecter les données dans votre pipeline existant (par ex. un deshredder basé sur XDP).

Outils et tableaux de bord

Tableau des scores Edge

Le tableau des scores compare la vitesse de livraison des shreds entre DoubleZero Edge et d'autres fournisseurs, en utilisant des données au niveau des slots pour comparer les performances en temps réel. Utilisez ce tableau de bord pour voir les taux de victoire des shreds Edge par rapport aux autres fournisseurs. Vous pouvez consulter les résultats pour les shreds de leader uniquement, en plus de la comparaison du flux complet. Vous pouvez également explorer par région pour voir les performances attendues.

Éditeurs Edge

La métrique « Publishing Shreds » en haut à gauche du tableau de bord affiche le pourcentage total du poids de participation de tous les validateurs Solana publiant des shreds de leader sur DoubleZero Edge. Vous pouvez voir les détails de chaque éditeur sur le réseau.

Abonnés, appareils et activité Edge

Vous pouvez facilement rechercher votre IP client sur cette page pour les sièges souscrits et consulter le statut. Cliquez sur des abonnements de sièges spécifiques pour voir l'historique des paiements et l'activité. Vous pouvez également consulter les appareils disponibles sur la page Appareils et toute l'activité récente sur la page Activité.

Documentation de l'API de données

Pour un accès programmatique aux points de terminaison de données, consultez la documentation de l'API : https://data.malbeclabs.com/api/v1/docs.

Dépannage

Si vous rencontrez un problème non couvert ici, veuillez nous contacter via votre canal existant avant de chercher une solution de contournement. Si vous n'avez pas de canal, veuillez rechercher sur Discord et ouvrir un ticket si nécessaire.

Assurez-vous que votre client est à jour :

Exécutez : sudo apt update && sudo apt install doublezero-solana

Solde de séquestre insuffisant

Si le solde de votre séquestre est inférieur au prix de l'epoch au moment du règlement, le siège n'est pas attribué, le tunnel est démonté et l'ancienneté est perdue. Complétez avec shreds pay avant le prochain règlement.

Siège non attribué après paiement

Vous avez peut-être payé tard dans l'epoch — le siège prend effet à l'epoch suivante.
Tous les sièges sur l'appareil peuvent être occupés par des titulaires ayant une ancienneté supérieure. Vérifiez les sièges disponibles avec shreds price.
Si vous avez retiré avant le règlement, le siège n'était pas éligible.

Le tunnel ne s'établit pas

Vérifiez que le démon est en cours d'exécution : sudo systemctl status doublezerod
Vérifiez que le réconciliateur est activé : doublezero enable
Vérifiez que les règles de pare-feu sont en place (GRE, BGP, PIM, trafic de shreds sur doublezero1, port 44880 sur doublezero0)
Vérifiez que votre siège est actif pour l'epoch en cours : doublezero-solana shreds list
Vérifiez l'état de votre connexion : doublezero status

L'IP client du démon est découverte automatiquement à partir de l'IP publique de votre hôte — vérifiez qu'elle correspond au --client-ip utilisé dans vos commandes de siège.

Avertissement de prompt d'epoch

La CLI vous avertit lorsqu'il reste moins de 10 % de l'epoch. Vos options :

Accepter avec --accept-partial-epoch si vous voulez le siège immédiatement
Attendre l'epoch suivante pour obtenir une couverture complète d'epoch

« Amount is below the current price »

La commande pay valide votre montant par rapport au prix minimum par epoch (base métro + prime appareil). Utilisez shreds price pour vérifier les tarifs actuels et augmenter votre montant.

« Multicast user already exists »

Vous avez déjà un abonnement actif via un chemin différent. Déconnectez-vous d'abord avec doublezero disconnect, puis réessayez shreds pay.