So verwendest du getBlockCommitment

​

Häufige Anwendungsfälle

• Finalität eines Blocks beurteilen: Ermittle den Konsensgrad eines Blocks, indem du die nach Stake gewichteten Stimmen bei verschiedenen Bestätigungstiefen untersuchst.
• Zustand des Clusters verstehen: totalStake gibt Aufschluss über den gesamten aktiven Stake im Cluster zu dem Zeitpunkt, an dem der Block verarbeitet wurde.
• Erweiterte Bestätigungslogik: Für Anwendungen, die sehr spezifische Garantien zur Finalität eines Blocks benötigen, die über die standardmäßigen commitment-Stufen hinausgehen (confirmed, finalized).

​

Parameter

1. slot (number, erforderlich): Die slot-Nummer (u64) des Blocks, dessen commitment-Informationen abgefragt werden sollen.

​

Response

• commitment (Array aus u64-Ganzzahlen | null):
  • Ein Array aus u64-Ganzzahlen. Jede Ganzzahl gibt die Menge des Cluster-Stakes (in Lamports) an, die bei einer bestimmten Bestätigungstiefe für den Block gestimmt hat.
  • Das Array enthält normalerweise 32 Elemente. Sie repräsentieren die Tiefen 0 bis MAX_LOCKOUT_HISTORY, also 31.
  • Index i des Arrays zeigt den Stake, der für den Block gestimmt hat. Dabei werden Stimmen für den Block selbst und seine Nachfolger bis zu einer Tiefe von i Stufen berücksichtigt.
  • Wenn der Block nicht gefunden wird oder seine commitment-Informationen nicht verfügbar sind, ist dieses Feld null. Das kann beispielsweise passieren, wenn der Block zu alt ist und aus der commitment-Verfolgung entfernt wurde.
• totalStake (number):
  • Der gesamte aktive Stake im Cluster (in Lamports) zu dem slot, in dem dieser Block verarbeitet wurde. Dieser Wert dient dazu, den prozentualen Anteil des Stakes zu berechnen, der sich für den Block committed hat.

​

Tipps für Entwickler

• Das Array commitment interpretieren:
  • Das Array commitment zeigt den Stake (in Lamports), der bei verschiedenen Bestätigungstiefen für den Block gestimmt hat. Höhere Werte bei tieferen Indizes weisen auf eine stärkere Finalität hin.
  • Ein null-Array für commitment bedeutet häufig, dass der node keine Daten für den slot hat. Möglicherweise ist er zu alt oder wurde übersprungen.
  • Du kannst die Finalität bei Tiefe i einschätzen, wenn commitment[i] / totalStake >= 2/3 (Supermehrheit).
• Erweiterte Anwendungsfälle: getBlockCommitment dient einer differenzierten Analyse der Finalität. In den meisten gängigen Szenarien ist es einfacher und ausreichend, bei anderen RPC-Methoden wie getTransaction oder getBlock die standardmäßigen commitment-Stufen processed, confirmed oder finalized zu verwenden.
• Commitment verstehen: Um getBlockCommitment effektiv zu nutzen, musst du die commitment-Stufen von Solana gut verstehen. Ausführliche Informationen findest du unter Solana Commitment Levels.
• Bereinigung: Beachte, dass RPC-nodes alte commitment-Informationen möglicherweise entfernen. Dadurch können Abfragen älterer slots null zurückgeben.

​

Beispiel: Commitment-Informationen eines Blocks abrufen

# 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);