Cómo usar isBlockhashValid

​

Casos de uso comunes

• Reenvío de transacciones: Antes de volver a intentar una transacción fallida, comprueba si su hash de bloque original sigue siendo válido. Si no lo es, debes obtener uno nuevo.
• Firma diferida de transacciones: Si preparas una transacción, pero la firmas y envías más tarde, verifica la validez del hash de bloque justo antes de enviarla.
• Procesamiento optimista de transacciones: Determina si es probable que la red acepte un hash de bloque cuando se envía una transacción inmediatamente.

​

Parámetros de la solicitud

1. blockhash (cadena, obligatorio): El hash de bloque que se comprobará, como una cadena codificada en base 58.
2. options (objeto, opcional): Un objeto de configuración opcional que puede incluir:
   • commitment (cadena, opcional): Especifica el nivel de compromiso de la consulta (por ejemplo, "finalized", "confirmed", "processed"). Si se omite, se usa el nivel de compromiso predeterminado del nodo.
   • minContextSlot (u64, opcional): El slot mínimo en el que se puede evaluar la solicitud. Esto garantiza que el nodo RPC no responda con el estado de un slot anterior a minContextSlot.

​

Estructura de la respuesta

• context (objeto): Un objeto que contiene:
  • slot (u64): El slot en el que el nodo RPC evaluó la validez del hash de bloque.
• value (booleano): true si el hash de bloque aún es válido; de lo contrario, false.

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

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

​

Ejemplos de código

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

​

Consejos para desarrolladores

• Los hashes de bloque caducan: Los hashes de bloque solo son válidos durante un periodo limitado (alrededor de 150 slots o aproximadamente 30 segundos). Obtén siempre un hash de bloque nuevo si tienes dudas o si ha transcurrido bastante tiempo.
• Uso de minContextSlot: Usa minContextSlot para evitar consultar un nodo RPC desactualizado que podría devolver una respuesta de «válido» obsoleta para un hash de bloque que, desde la perspectiva del resto del clúster, ya es demasiado antiguo.
• Alternativa para nodos más antiguos: Para los nodos que ejecutan versiones de Solana anteriores a la 1.9, usa getFeeCalculatorForBlockhash("<YOUR_BLOCKHASH>"). Si este método devuelve una respuesta correcta, el hash de bloque es válido. Si devuelve un error (normalmente porque no se encuentra el hash de bloque o porque es demasiado antiguo), el hash de bloque no es válido.
• Confirmación de la red: Incluso si isBlockhashValid devuelve true, una transacción solo se considera finalizada cuando alcanza el nivel de compromiso deseado en la red después de enviarla.

​

Métodos relacionados