Cómo usar getLatestBlockhash

​

Casos de uso comunes

• Creación de transacciones: Obtén un hash de bloque reciente para incluirlo en una nueva transacción antes de firmarla y enviarla.
• Administración de la vigencia de las transacciones: Usa lastValidBlockHeight para saber cuánto tiempo permanecerá válida una transacción que haga referencia al hash de bloque recuperado.
• Comprobaciones previas: Aunque simulateTransaction puede hacer esto de forma implícita, las aplicaciones pueden recuperar un hash de bloque para preparar manualmente una transacción para su simulación.

​

Parámetros de la solicitud

• commitment (cadena, opcional): Especifica el nivel de compromiso de la consulta. Si se omite, se usa el compromiso predeterminado del nodo. Para código nuevo, usa preferentemente finalized; con Alpenglow, confirmed devuelve el mismo estado permanente y sigue disponible por compatibilidad.
• minContextSlot (entero, opcional): El slot mínimo en el que se puede evaluar la solicitud. Esto garantiza que la consulta se realice sobre un estado del libro mayor que haya procesado al menos hasta este slot.

​

Estructura de la respuesta

• blockhash (cadena): Una cadena codificada en base 58 que representa el hash de bloque más reciente.
• lastValidBlockHeight (u64): La altura de bloque en la que vencerá blockhash. Una transacción que cite este blockhash será válida hasta que la red alcance este lastValidBlockHeight.

​

Ejemplos

​

1. Obtener el hash de bloque más reciente con el compromiso predeterminado

# 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. Obtén el hash de bloque más reciente con el compromiso finalized

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

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

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

fetchFinalizedBlockhash();

​

Consejos para desarrolladores

• Validez del hash de bloque: Un hash de bloque es válido durante un tiempo limitado, aproximadamente 30 segundos, aunque este periodo puede variar. La red debe confirmar las transacciones antes de que se supere su lastValidBlockHeight. Obtén siempre un hash de bloque nuevo si ha transcurrido un tiempo considerable desde que obtuviste el anterior.
• Elección del compromiso: Con Alpenglow, confirmed y finalized devuelven el mismo estado confirmado permanentemente en el mismo punto. Para código nuevo, usa preferentemente finalized porque confirmed se eliminará en una versión futura.
• Comisiones de transacción: Recuerda calcular e incluir también las comisiones de transacción correspondientes. El hash de bloque por sí solo no determina la comisión.
• Lógica de reintentos: Si una transacción vence porque se superó su lastValidBlockHeight, debes volver a firmarla con un hash de bloque nuevo y más reciente, y enviarla de nuevo.

​

Métodos relacionados