Wie man getLatestBlockhash verwendet

​

Häufige Anwendungsfälle

• Transaktionserstellung: Abrufen eines aktuellen Blockhashes zur Einbeziehung in eine neue Transaktion vor dem Signieren und Versenden.
• Verwaltung der Transaktionslebensdauer: Verwenden Sie lastValidBlockHeight, um zu verstehen, wie lange eine Transaktion, die den abgerufenen Blockhash referenziert, voraussichtlich gültig bleibt.
• Preflight-Checks: Während simulateTransaction dies implizit tun kann, könnten Anwendungen einen Blockhash abrufen, um manuell eine Transaktion zur Simulation vorzubereiten.

​

Anfrageparameter

• commitment (string, optional): Gibt das Commitment Level für die Anfrage an. Wenn es weggelassen wird, wird das Standard-Commitment des Knotens verwendet. Für Transaktionen ist es üblich, confirmed oder finalized zu verwenden, um sicherzustellen, dass der Blockhash aus einem vernünftig stabilen Teil der Kette stammt.
• minContextSlot (integer, optional): Der Mindestslot, bei dem die Anfrage ausgewertet werden kann. Dies stellt sicher, dass die Abfrage gegen einen Ledger-Zustand erfolgt, der bis mindestens zu diesem Slot verarbeitet wurde.

​

Antwortstruktur

• blockhash (string): Eine base-58 kodierte Zeichenkette, die den neuesten Blockhash darstellt.
• lastValidBlockHeight (u64): Die Blockhöhe, bei der der blockhash abläuft. Eine Transaktion, die diesen blockhash zitiert, ist gültig, bis das Netzwerk diese lastValidBlockHeight erreicht.

​

Beispiele

​

1. Abrufen des neuesten Blockhashes mit Standard-Commitment

# 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. Abrufen des neuesten Blockhashes mit ‘bestätigtem’ Commitment

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

​

Entwicklertipps

• Blockhash-Gültigkeit: Ein Blockhash ist nur für eine begrenzte Zeit gültig, etwa 2 Minuten (obwohl dies variieren kann). Transaktionen müssen vom Netzwerk bestätigt werden, bevor ihr lastValidBlockHeight erreicht wird. Holen Sie immer einen neuen Blockhash, wenn seit dem letzten Abruf erhebliche Zeit vergangen ist.
• Wahl des Commitments: Für kritische Transaktionen bietet das Verwenden von finalized-Commitment die stärkste Garantie, dass der Blockhash von der Hauptkette stammt, kann aber etwas älter sein. confirmed bietet einen guten Kompromiss. Weitere Informationen finden Sie unter Commitment Levels.
• Transaktionsgebühren: Denken Sie auch daran, geeignete Transaktionsgebühren zu berechnen und einzuschließen. Der Blockhash selbst bestimmt nicht die Gebühr.
• Retry-Logik: Wenn eine Transaktion abläuft, weil ihr lastValidBlockHeight erreicht wurde, müssen Sie sie mit einem neuen, aktuelleren Blockhash neu signieren und erneut einreichen.

​

Verwandte Methoden