Перейти к основному содержанию

Параметры

config
object
Объект конфигурации, содержащий следующие необязательные поля:

Ответ

result
number
Текущая высота блока

Примеры кода

Базовый запрос

curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlockHeight"
}'

Запрос с commitment

curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlockHeight",
  "params": [
    {
      "commitment": "finalized"
    }
  ]
}'

Использование web3.js

import { Connection } from '@solana/web3.js';

const connection = new Connection('https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY');

const blockHeight = await connection.getBlockHeight('finalized');
console.log(`Current block height: ${blockHeight}`);

Примечания

  1. Высота блока монотонно увеличивается с каждым новым блоком
  2. Высота блока может отличаться от номера слота из-за пропущенных слотов
  3. Разные узлы могут возвращать несколько разные высоты в зависимости от их представления о сети
  4. Ответ приходит немедленно, поскольку считывается из текущего состояния

Лучшие практики

  1. Используйте подходящий уровень commitment в зависимости от ваших потребностей:
    • processed для максимально возможной высоты
    • confirmed для высокой вероятности финальности
    • finalized для гарантированной финальности
  2. Рассмотрите использование getSlot, если вам нужны номера слотов вместо высоты блока
  3. Для исторических запросов используйте getBlock с конкретными слотами

Распространённые ошибки

КодСообщениеРешение
-32601Method not foundУбедитесь, что вы подключены к узлу Solana RPC
-32007Block height not availableУзел может выполнять начальную загрузку или синхронизацию