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.
• Gestión de la vigencia de las transacciones: Usa lastValidBlockHeight para saber durante cuánto tiempo seguirá siendo válida una transacción que haga referencia al hash de bloque obtenido.
• Comprobaciones previas: Aunque simulateTransaction puede hacerlo de forma implícita, las aplicaciones pueden obtener 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 las transacciones, es común usar confirmed o finalized para garantizar que el hash de bloque provenga de una parte razonablemente estable de la cadena.
• minContextSlot (entero, opcional): El slot mínimo en el que se puede evaluar la solicitud. Esto garantiza que la consulta se realice en 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 haga referencia a este blockhash es 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. Obtener el hash de bloque más reciente con el compromiso ‘confirmed’

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

​

Consejos para desarrolladores

• Validez del hash de bloque: Un hash de bloque es válido durante un tiempo limitado, aproximadamente 2 minutos, aunque esto 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 último.
• Elección del compromiso: Para transacciones críticas, usar el compromiso finalized ofrece la mayor garantía de que el hash de bloque proviene de la bifurcación principal de la cadena, pero puede ser un poco más antiguo. confirmed ofrece un buen equilibrio. Consulta más información sobre los niveles de compromiso.
• 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 reintento: Si una transacción vence porque se ha superado su lastValidBlockHeight, debes volver a firmarla con un hash de bloque nuevo y más reciente, y enviarla de nuevo.

​

Métodos relacionados