Как использовать getBlockHeight

​

Распространенные сценарии использования

• Мониторинг продвижения цепочки: Периодически вызывайте этот метод, чтобы отслеживать продвижение цепочки.
• Получение снимка длины цепочки: Определите общее количество блоков, обработанных к определенному моменту с учетом уровня подтверждения.
• Сопоставление с другими данными: Используйте высоту блока как ориентир при анализе других данных или событий в блокчейне.

​

Параметры

1. config (объект, необязательно): объект конфигурации со следующими полями:
   • commitment (строка, необязательно): задает уровень подтверждения для запроса. Значение по умолчанию — finalized.
     • finalized: узел запросит последний блок, который сверхбольшинство кластера подтвердило как достигший максимального периода блокировки.
     • confirmed: узел запросит последний блок, за который проголосовало сверхбольшинство кластера.
     • processed: узел запросит свой последний блок. Обратите внимание, что блок может быть неполным.
   • minContextSlot (число, необязательно): минимальный слот, на котором можно обработать запрос. Это гарантирует, что возвращенная высота блока получена из слота, равного minContextSlot или превышающего его.

​

Рекомендации разработчикам

• Уровень подтверждения имеет значение: возвращаемая высота блока может различаться в зависимости от указанного уровня commitment. finalized возвращает наиболее стабильную высоту, а processed — более актуальную, но потенциально временную.
• minContextSlot для согласованности: используйте minContextSlot, если нужно гарантировать, что высота блока запрашивается из состояния не старше определенного отслеживаемого слота.
• Не номер слота: помните, что высота блока отличается от номера слота. Слот — это период времени, и блок создается не в каждом слоте. Такие слоты называют пропущенными. Высота блока — это количество фактически созданных блоков.
• Базовая проверка состояния цепочки: несмотря на простоту, getBlockHeight можно использовать для базовой проверки состояния или синхронизации цепочки в вашем приложении или системе мониторинга.

​

Ответ

• blockHeight (число): текущая высота блока (u64) узла в соответствии с указанным уровнем подтверждения.

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

​

Пример: получение текущей высоты блока

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(())
}