Como Usar getBlockHeight

​

Casos de Uso Comuns

• Monitoramento da Progressão da Cadeia: Chame este método periodicamente para ver a cadeia avançando.
• Obtendo um Snapshot do Comprimento da Cadeia: Determine o número total de blocos processados até um certo ponto (com base no compromisso).
• Referenciamento Cruzado com Outros Dados: Use a altura do bloco como ponto de referência ao analisar outros dados ou eventos on-chain.

​

Parâmetros

1. config (objeto, opcional): Um objeto de configuração com os seguintes campos:
   • commitment (string, opcional): Especifica o nível de compromisso a ser usado na consulta. O padrão é finalized.
     • finalized: O nó consultará o bloco mais recente confirmado pela super maioria do cluster como tendo atingido o bloqueio máximo.
     • confirmed: O nó consultará o bloco mais recente que foi votado por uma super maioria do cluster.
     • processed: O nó consultará seu bloco mais recente. Note que o bloco pode não estar completo.
   • minContextSlot (número, opcional): O slot mínimo que a solicitação pode ser avaliada. Isso garante que a altura do bloco retornada seja de um slot igual ou maior que minContextSlot.

​

Dicas para Desenvolvedores

• Os Níveis de Compromisso Importam: A altura do bloco retornada pode variar com base no nível commitment especificado. finalized fornece a altura mais estável, enquanto processed pode dar uma altura mais atual, mas potencialmente transitória.
• minContextSlot para Consistência: Use minContextSlot se precisar garantir que a altura do bloco seja consultada a partir de um estado pelo menos tão recente quanto um slot específico que você está acompanhando.
• Não é um Número de Slot: Lembre-se de que a altura do bloco é diferente do número do slot. Um slot é um período de tempo, e nem todo slot produz um bloco (esses são chamados de slots ignorados). A altura do bloco é a contagem de blocos reais produzidos.
• Verificação Básica de Saúde da Cadeia: Embora simples, getBlockHeight pode ser parte de uma verificação básica de saúde ou sincronização da cadeia para seu aplicativo ou sistema de monitoramento.

​

Resposta

• blockHeight (número): A altura atual do bloco (u64) do nó de acordo com o nível de compromisso especificado.

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

​

Exemplo: Obtendo a Altura Atual do Bloco

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::confirmed(),
    );

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

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

    Ok(())
}