Comment utiliser getBlockCommitment

​

Cas d’utilisation courants

• Évaluer la finalité des blocs : Déterminez le niveau de consensus qu’un bloc a atteint en examinant les votes pondérés selon les enjeux à différentes profondeurs de confirmation.
• Comprendre la santé du cluster : Le totalStake fournit un aperçu du total des enjeux actifs dans le cluster au moment où le bloc a été traité.
• Logique de confirmation avancée : Pour les applications nécessitant des garanties très spécifiques concernant la finalité des blocs au-delà des niveaux d’engagement standard (confirmed, finalized).

​

Paramètres

1. slot (nombre, requis) : Le numéro de slot (u64) du bloc pour lequel interroger les informations d’engagement.

​

Réponse

• commitment (tableau d’entiers u64 | null) :
  • Un tableau d’entiers u64, où chaque entier représente la quantité d’enjeux du cluster (en lamports) qui a voté pour le bloc à une profondeur de confirmation spécifique.
  • Le tableau a généralement 32 éléments (représentant les profondeurs de 0 à MAX_LOCKOUT_HISTORY, qui est 31).
  • L’index i du tableau montre les enjeux qui ont voté pour le bloc, en tenant compte des votes sur le bloc lui-même et ses descendants jusqu’à i niveaux de profondeur.
  • Si le bloc n’est pas trouvé ou si ses informations d’engagement ne sont pas disponibles (par exemple, s’il est trop ancien et supprimé du suivi de l’engagement), ce champ sera null.
• totalStake (nombre) :
  • Le total des enjeux actifs dans le cluster (en lamports) au slot où ce bloc a été traité. Cette valeur est utilisée pour calculer le pourcentage d’enjeux qui se sont engagés sur le bloc.

​

Conseils pour les développeurs

• Interpréter le tableau commitment :
  • Le tableau commitment montre les enjeux (en lamports) qui ont voté pour le bloc à différentes profondeurs de confirmation. Des valeurs plus élevées à des indices plus profonds signifient une finalité plus forte.
  • Un tableau null commitment signifie souvent que le nœud n’a pas de données pour le slot, possiblement parce qu’il est trop ancien ou a été sauté.
  • Vous pouvez évaluer la finalité à la profondeur i si commitment[i] / totalStake >= 2/3 (supermajorité).
• Cas d’utilisation avancés : getBlockCommitment est utilisé pour une analyse nuancée de la finalité. Pour la plupart des scénarios courants, s’appuyer sur les niveaux d’engagement standard (processed, confirmed ou finalized) avec d’autres méthodes RPC (comme getTransaction ou getBlock) est plus simple et suffisant.
• Comprendre l’engagement : Pour tirer pleinement parti de getBlockCommitment, une compréhension solide des niveaux d’engagement de Solana est essentielle. Consultez Solana Commitment Levels pour des informations détaillées.
• Élagage : Soyez conscient que les nœuds RPC peuvent élaguer les anciennes informations d’engagement, entraînant des résultats null pour les slots plus anciens.

​

Exemple : Récupérer des informations d’engagement de bloc

# Replace 250000000 with a valid, recent slot number on Devnet/Mainnet
curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY -X POST -H "Content-Type: application/json" -d \
'{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlockCommitment",
  "params": [
    250000000 
  ]
}'

const { Connection } = require('@solana/web3.js');

async function getBlockCommitmentDetails() {
  const rpcUrl = 'https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY'; // Replace YOUR_API_KEY
  const connection = new Connection(rpcUrl, 'confirmed');
  
  // Replace with a valid, recent slot number on your target network
  const slotToQuery = 250000000; 

  try {
    // Note: getBlockCommitment is not directly available in @solana/web3.js Connection object.
    // You typically need to make a direct RPC call for this method.
    // The example below shows how to construct and send such a raw request.
    const response = await fetch(rpcUrl, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        jsonrpc: '2.0',
        id: 1,
        method: 'getBlockCommitment',
        params: [slotToQuery],
      }),
    });
    const result = await response.json();

    if (result.error) {
      console.error(`Error fetching block commitment for slot ${slotToQuery}:`, result.error.message);
      return;
    }

    const blockCommitment = result.result;

    if (blockCommitment) {
      console.log(`Block Commitment for Slot ${slotToQuery}:`);
      console.log(`   Total Stake (Lamports): ${blockCommitment.totalStake}`);
      console.log(`   Commitment Array:`, blockCommitment.commitment ? blockCommitment.commitment : 'Not available/Unknown block');
      // The commitment array shows lamports committed at different depths.
      // A null commitment array usually means the block is not found or too old.
      // A non-null array where later entries are higher indicates increasing finality.
    } else {
      console.log(`Block commitment data for slot ${slotToQuery} not found.`);
    }
  } catch (error) {
    console.error(`Error fetching block commitment for slot ${slotToQuery}:`, error);
  }
}

getBlockCommitmentDetails();

import { createSolanaRpc } from "@solana/kit";

const rpc_url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
const rpc = createSolanaRpc(rpc_url);

const slot_number = BigInt(5);

let blockCommitment = await rpc.getBlockCommitment(slot_number).send();

console.log("block commitment:", blockCommitment);