Skip to main content
La méthode RPC getHighestSnapshotSlot renvoie des informations sur le slot le plus élevé pour lequel le nœud Solana interrogé dispose de snapshots de registre. Cela inclut à la fois le dernier slot de snapshot complet et, si disponible, le dernier slot de snapshot incrémentiel basé sur ce snapshot complet. Les snapshots sont cruciaux pour que les nœuds puissent rapidement se synchroniser avec le réseau et pour la maintenance du registre. Remarque sur la version : Cette méthode est disponible dans solana-core v1.9 ou plus récent. Pour les versions plus anciennes (v1.8 et inférieures), utilisez getSnapshotSlot.

Cas d’utilisation courants

  • Surveillance des nœuds : Déterminer à quel point les snapshots d’un nœud sont à jour.
  • Compréhension de l’état des nœuds : Obtenez des informations sur la rétention des registres et le processus de snapshot d’un nœud.
  • Débogage des problèmes de synchronisation : Aider à diagnostiquer si un nœud prend du retard dans la génération ou la récupération de snapshots.

Paramètres de la requête

Cette méthode ne prend aucun paramètre.

Structure de la réponse

Le champ result de la réponse JSON-RPC sera un objet avec les champs suivants :
  • full (u64): Le numéro de slot du snapshot complet le plus élevé disponible sur le nœud.
  • incremental (u64 | null): Le numéro de slot du snapshot incrémentiel le plus élevé qui se base sur le snapshot full. Cela peut être null si aucun snapshot incrémentiel n’est disponible pour le dernier snapshot complet ou si les snapshots incrémentiels ne sont pas activés/générés.
Si le nœud ne dispose d’aucun snapshot, le comportement peut varier (par exemple, une erreur ou des valeurs spécifiques de type null, selon l’implémentation du fournisseur RPC).

Exemples

1. Obtenir les informations du slot de snapshot le plus élevé

Cet exemple récupère les détails du slot de snapshot le plus élevé depuis le point de terminaison RPC.

Conseils pour les développeurs

  • Spécifique au nœud : Les informations de snapshot sont spécifiques au nœud interrogé. Différents nœuds dans le cluster peuvent avoir des slots de snapshot les plus élevés différents en fonction de leur configuration et de leur état opérationnel.
  • Fréquence de snapshot : Les nœuds créent des snapshots à des intervalles configurés. Le slot de snapshot le plus élevé avancera à mesure que de nouveaux snapshots sont générés.
  • Snapshots complets vs incrémentiels :
    • Un snapshot complet contient tout l’état du registre jusqu’à un certain slot.
    • Un snapshot incrémentiel contient uniquement les modifications depuis un snapshot précédent (généralement complet), ce qui les rend plus petits et plus rapides à créer et restaurer, à condition que le snapshot complet de base soit disponible.
  • Disponibilité : Cette méthode est disponible sur les versions solana-core 1.9 et plus récentes. Assurez-vous que votre nœud ou fournisseur RPC prend en charge cette version si vous avez l’intention de l’utiliser.
Ce guide explique comment utiliser la méthode RPC getHighestSnapshotSlot pour récupérer des informations sur les derniers snapshots disponibles sur un nœud Solana.