Comment utiliser getSlot

​

Cas d’utilisation courants

• Obtention de l’avancement actuel du réseau : Déterminez le slot le plus récent traité ou confirmé par le nœud.
• Vérification de la synchronisation des nœuds : Comparer le slot de différents nœuds peut donner une indication de leur état de synchronisation.
• Horodatage des opérations : Utiliser le slot actuel comme point de référence pour les opérations ou pour comprendre l’âge de certaines données.
• Entrée pour d’autres appels RPC : Certaines méthodes RPC peuvent utiliser un numéro de slot comme point de référence.

​

Paramètres de requête

1. options (object, optionnel) : Un objet de configuration optionnel avec les champs suivants :
   • commitment (string, optionnel) : Spécifie le niveau d’engagement pour la requête. Les valeurs prises en charge sont finalized, confirmed, ou processed. Si omis, l’engagement par défaut du nœud RPC est utilisé (généralement finalized).
     • processed : Le nœud interrogera son slot le plus récent. Notez que ce slot peut ne pas être confirmé par le cluster et pourrait potentiellement être ignoré.
     • confirmed : Le nœud interrogera le slot le plus récent qui a été voté par une supermajorité du cluster.
     • finalized : Le nœud interrogera le slot le plus récent confirmé par la supermajorité du cluster comme ayant atteint le verrouillage maximal (ne peut pas être annulé).
   • minContextSlot (number, optionnel) : Le slot minimum auquel la requête peut être évaluée. Cela définit le slot minimum pour le contexte du nœud. Si l’état du nœud est antérieur à ce slot, il peut retourner une erreur ou un numéro de slot qui reflète son état actuel (plus ancien) par rapport à ce minimum.

​

Structure de la réponse

{
  "jsonrpc": "2.0",
  "result": 123456789,
  "id": 1
}

​

Exemples

​

1. Obtenir le slot actuel (Engagement par défaut)

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSlot"
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function getCurrentSlot() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const slot = await connection.getSlot();
    console.log('Current slot (default commitment):', slot);
  } catch (error) {
    console.error('Error fetching current slot:', error);
  }
}

getCurrentSlot();

​

2. Obtenir le slot actuel avec un engagement spécifique

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSlot",
    "params": [
      {
        "commitment": "confirmed"
      }
    ]
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function getConfirmedSlot() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const slot = await connection.getSlot('confirmed');
    console.log('Current slot (confirmed commitment):', slot);
    // Note: For @solana/web3.js v1.30.0 and later, you can pass commitment directly.
    // For older versions or more complex options, use an object:
    // const slot = await connection.getSlot({ commitment: 'confirmed' });
  } catch (error) {
    console.error('Error fetching confirmed slot:', error);
  }
}

getConfirmedSlot();

​

Conseils pour les développeurs

• L’engagement est important : Le numéro de slot retourné dépend fortement du niveau commitment spécifié. Référez-vous aux niveaux d’engagement Solana pour des informations détaillées. processed sera le slot le plus élevé (le plus récent) que le nœud connaît, tandis que finalized sera un slot plus ancien confirmé par l’ensemble du réseau. Choisissez le niveau d’engagement approprié en fonction de vos besoins en matière de finalité des données.
• Variabilité des nœuds : Différents nœuds RPC peuvent renvoyer des numéros de slot légèrement différents pour le même niveau d’engagement en raison des délais de propagation du réseau ou de leur propre état de traitement. Cela est particulièrement vrai pour les niveaux processed et confirmed.
• minContextSlot : Ce paramètre garantit que le nœud traitant votre requête a atteint au moins minContextSlot. Si le nœud est derrière ce slot, le comportement peut varier (par exemple, une erreur ou le slot le plus élevé actuel du nœud qui est inférieur à minContextSlot). Il est généralement utilisé dans des scénarios avancés où vous devez garantir qu’une requête est effectuée par rapport à un état suffisamment récent.