So verwendest du getLatestBlockhash

​

Häufige Anwendungsfälle

• Transaktionen erstellen: Rufe eine aktuelle Blockhash ab und füge sie einer neuen Transaktion hinzu, bevor du diese signierst und sendest.
• Gültigkeitsdauer von Transaktionen verwalten: Ermittle mit lastValidBlockHeight, wie lange eine Transaktion mit der abgerufenen Blockhash voraussichtlich gültig bleibt.
• Prüfungen vor dem Senden: simulateTransaction kann dies implizit erledigen. Anwendungen können jedoch eine Blockhash abrufen, um eine Transaktion manuell für die Simulation vorzubereiten.

​

Parameter des Request

• commitment (string, optional): Gibt das commitment-Level für die Abfrage an. Wenn du es weglässt, wird das standardmäßige commitment des node verwendet. Für Transaktionen werden häufig confirmed oder finalized verwendet. So stellst du sicher, dass die Blockhash aus einem ausreichend stabilen Teil der Chain stammt.
• minContextSlot (integer, optional): Der minimale slot, an dem der Request ausgewertet werden kann. Dadurch wird die Abfrage für einen Ledger-Zustand ausgeführt, der mindestens bis zu diesem slot verarbeitet wurde.

​

Struktur der Response

• blockhash (string): Eine Base58-codierte Zeichenfolge, die die neueste Blockhash darstellt.
• lastValidBlockHeight (u64): Die Blockhöhe, bei der blockhash abläuft. Eine Transaktion, die auf diese blockhash verweist, bleibt gültig, bis das Netzwerk diese lastValidBlockHeight erreicht.

​

Beispiele

​

1. Neueste Blockhash mit dem standardmäßigen commitment abrufen

# 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": "getLatestBlockhash"
  }'

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

async function fetchLatestBlockhash() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
    console.log('Latest Blockhash Info:');
    console.log(`  Blockhash: ${blockhash}`);
    console.log(`  Last Valid Block Height: ${lastValidBlockHeight}`);
    // This blockhash can now be used in a transaction
  } catch (error) {
    console.error('Error fetching latest blockhash:', error);
  }
}

fetchLatestBlockhash();

​

2. Neueste Blockhash mit ‘confirmed’ commitment abrufen

# 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": "getLatestBlockhash",
    "params": [{ "commitment": "confirmed" }]
  }'

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

async function fetchConfirmedBlockhash() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('confirmed');
    console.log('Confirmed Blockhash Info:');
    console.log(`  Blockhash: ${blockhash}`);
    console.log(`  Last Valid Block Height: ${lastValidBlockHeight}`);
  } catch (error) {
    console.error('Error fetching confirmed blockhash:', error);
  }
}

fetchConfirmedBlockhash();

​

Tipps für Entwickler

• Gültigkeit der Blockhash: Eine Blockhash ist nur für eine begrenzte Zeit gültig, ungefähr 2 Minuten. Dieser Zeitraum kann jedoch variieren. Transaktionen müssen vom Netzwerk bestätigt werden, bevor ihre lastValidBlockHeight überschritten wird. Rufe immer eine neue Blockhash ab, wenn seit dem letzten Abruf viel Zeit vergangen ist.
• Commitment auswählen: Bei kritischen Transaktionen bietet finalized commitment die höchste Sicherheit, dass die Blockhash aus dem Hauptzweig der Chain stammt. Sie kann jedoch etwas älter sein. confirmed bietet einen guten Kompromiss. Ausführliche Informationen findest du unter commitment-Levels.
• Transaktionsgebühren: Berechne außerdem die passenden Transaktionsgebühren und füge sie hinzu. Die Blockhash selbst bestimmt die Gebühr nicht.
• Logik für erneute Versuche: Wenn eine Transaktion abläuft, weil ihre lastValidBlockHeight überschritten wurde, musst du sie mit einer neuen, aktuelleren Blockhash erneut signieren und senden.

​

Verwandte Methoden