So verwendest du isBlockhashValid

​

Häufige Anwendungsfälle

• Erneutes Übermitteln einer Transaktion: Bevor du eine fehlgeschlagene Transaktion erneut versuchst, prüfe, ob ihr ursprünglicher Blockhash noch gültig ist. Falls nicht, musst du einen neuen Blockhash abrufen.
• Verzögertes Signieren von Transaktionen: Wenn du eine Transaktion vorbereitest, aber erst später signierst und übermittelst, prüfe die Gültigkeit des Blockhashes unmittelbar vor dem Übermitteln.
• Optimistische Transaktionsverarbeitung: Ermittle, ob das Netzwerk einen Blockhash wahrscheinlich akzeptiert, wenn du sofort eine Transaktion sendest.

​

Parameter des Requests

1. blockhash (String, erforderlich): Der zu prüfende Blockhash als Base58-codierter String.
2. options (Objekt, optional): Ein optionales Konfigurationsobjekt, das Folgendes enthalten kann:
   • commitment (String, optional): Legt das commitment-Level für die Abfrage fest, z. B. "finalized", "confirmed" oder "processed". Wenn du es weglässt, wird das standardmäßige commitment des nodes verwendet.
   • minContextSlot (u64, optional): Der minimale slot, für den der request ausgewertet werden kann. Dadurch antwortet der RPC node nicht mit einem Status aus einem slot, der älter als minContextSlot ist.

​

Struktur der Response

• context (Objekt): Ein Objekt mit folgendem Inhalt:
  • slot (u64): Der slot, für den der RPC node die Gültigkeit des Blockhashes ausgewertet hat.
• value (boolescher Wert): true, wenn der Blockhash noch gültig ist, andernfalls false.

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "slot": 180000500 },
    "value": true
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "slot": 180000800 },
    "value": false
  },
  "id": 1
}

​

Codebeispiele

# Check validity of a blockhash (replace <YOUR_BLOCKHASH>):
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "isBlockhashValid",
    "params": [
      "<YOUR_BLOCKHASH>"
    ]
  }' \
  <YOUR_RPC_URL>

# Check with commitment and minContextSlot (replace <YOUR_BLOCKHASH>):
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "isBlockhashValid",
    "params": [
      "<YOUR_BLOCKHASH>",
      {
        "commitment": "confirmed",
        "minContextSlot": 170000000
      }
    ]
  }' \
  <YOUR_RPC_URL>

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

async function checkBlockhash(blockhashToCheck) {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');

  try {
    console.log(`Checking validity of blockhash: ${blockhashToCheck}`);
    const result = await connection.isBlockhashValid(blockhashToCheck);
    
    console.log(`  Blockhash is valid: ${result.value}`);
    console.log(`  Checked at slot: ${result.context.slot}`);

    // Example with options
    // const resultWithOptions = await connection.isBlockhashValid(
    //   blockhashToCheck,
    //   { commitment: 'confirmed', minContextSlot: result.context.slot - 100 }
    // );
    // console.log(`\nWith options - Valid: ${resultWithOptions.value}, Slot: ${resultWithOptions.context.slot}`);

  } catch (error) {
    console.error(`Error checking blockhash ${blockhashToCheck}:`, error);
  }
}

// Example usage: First, get a recent blockhash
async function getRecentBlockhashAndCheck() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const { blockhash } = await connection.getLatestBlockhash();
    await checkBlockhash(blockhash); 
    
    // Example with a known old/invalid blockhash (will likely be false)
    // This blockhash is just an example and will be invalid.
    const oldBlockhash = 'J7rBdM6AecPDEZp8aPq5iPSNKVkU5Q76F3oAV4eW5wsW'; 
    // await checkBlockhash(oldBlockhash);

  } catch (error) {
    console.error('Error in example execution:', error);
  }
}

getRecentBlockhashAndCheck();

​

Tipps für Entwickler

• Blockhashes laufen ab: Blockhashes sind nur für begrenzte Zeit gültig, etwa 150 slots beziehungsweise ungefähr 1–2 Minuten. Rufe immer einen neuen Blockhash ab, wenn du unsicher bist oder längere Zeit vergangen ist.
• minContextSlot verwenden: Verwende minContextSlot, um Abfragen an einen veralteten RPC node zu vermeiden. Dieser könnte für einen Blockhash eine veraltete „gültige“ response liefern, obwohl er aus Sicht des restlichen cluster bereits zu alt ist.
• Alternative für ältere nodes: Verwende für nodes mit Solana-Versionen vor 1.9 getFeeCalculatorForBlockhash("<YOUR_BLOCKHASH>"). Wenn diese Methode erfolgreich eine response liefert, ist der Blockhash gültig. Gibt sie einen Fehler zurück – typischerweise, weil der Blockhash nicht gefunden wurde oder zu alt ist –, ist der Blockhash ungültig.
• Bestätigung durch das Netzwerk: Selbst wenn isBlockhashValid den Wert true zurückgibt, ist eine Transaktion erst finalisiert, wenn sie nach dem Übermitteln das gewünschte commitment-Level im Netzwerk erreicht.

​

Verwandte Methoden