Cómo usar getBlockHeight

​

Casos de uso comunes

• Monitorear el avance de la cadena: Llama a este método periódicamente para comprobar el avance de la cadena.
• Obtener una instantánea de la longitud de la cadena: Determina la cantidad total de bloques procesados hasta un punto determinado (según el nivel de compromiso).
• Cruzar referencias con otros datos: Usa la altura de bloque como punto de referencia cuando analices otros datos o eventos en cadena.

​

Parámetros

1. config (objeto, opcional): Un objeto de configuración con los siguientes campos:
   • commitment (cadena, opcional): Especifica el nivel de compromiso que se usará para la consulta. El valor predeterminado es finalized.
     • finalized: El nodo consultará el bloque confirmado permanentemente más reciente. Usa preferentemente este valor para código nuevo.
     • confirmed: En Alpenglow, equivale a finalized; se conserva por compatibilidad.
     • processed: El nodo consultará su bloque más reciente. Ten en cuenta que el bloque podría no estar completo.
   • minContextSlot (número, opcional): El slot mínimo en el que se puede evaluar la solicitud. Esto garantiza que la altura de bloque devuelta provenga de un slot igual o mayor que minContextSlot.

​

Consejos para desarrolladores

• Los niveles de compromiso importan: processed puede devolver una altura más reciente, pero transitoria. En Alpenglow, confirmed e finalized devuelven la misma altura confirmada permanentemente; usa preferentemente finalized para código nuevo.
• minContextSlot para mantener la coherencia: Usa minContextSlot si necesitas garantizar que la altura de bloque se consulte desde un estado que sea al menos tan reciente como un slot específico del que realizas seguimiento.
• No es un número de slot: Recuerda que la altura de bloque es diferente del número de slot. Un slot es un período de tiempo y no todos los slots producen un bloque (estos se denominan slots omitidos). La altura de bloque es la cantidad de bloques que se produjeron realmente.
• Comprobación básica del estado de la cadena: Aunque es sencillo, getBlockHeight puede formar parte de una comprobación básica del estado o la sincronización de la cadena para tu aplicación o sistema de monitoreo.

​

Respuesta

• blockHeight (número): La altura de bloque actual (u64) del nodo según el nivel de compromiso especificado.

{
  "jsonrpc": "2.0",
  "result": 275123456, // Example block height
  "id": 1
}

​

Ejemplo: obtener la altura de bloque actual

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY -X POST -H "Content-Type: application/json" -d \
'{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlockHeight",
  "params": [] 
}'

const { Connection } = require('@solana/web3.js');

async function getCurrentBlockHeight() {
  const rpcUrl = 'https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY'; // Replace YOUR_API_KEY
  const connection = new Connection(rpcUrl, 'confirmed');

  try {
    const blockHeight = await connection.getBlockHeight();
    console.log(`Current Block Height: ${blockHeight}`);

  } catch (error) {
    console.error('Error fetching block height:', error);
  }
}

getCurrentBlockHeight();

import { createSolanaRpc } from "@solana/kit";

const rpc_url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
const rpc = createSolanaRpc(rpc_url);

let blockHeight = await rpc.getBlockHeight().send();

console.log("block height:", blockHeight);

use anyhow::Result;
use solana_client::nonblocking::rpc_client::RpcClient;
use solana_sdk::commitment_config::CommitmentConfig;

#[tokio::main]
async fn main() -> Result<()> {
    let client = RpcClient::new_with_commitment(
        String::from("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"),
        CommitmentConfig::finalized(),
    );

    let block_height = client.get_block_height().await?;

    println!("Block height: {:#?}", block_height);

    Ok(())
}