> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getBlockHeight

> Возвращает текущую высоту блока узла

## Параметры

<ParamField query="config" type="object" optional>
  Объект конфигурации, содержащий следующие необязательные поля:

  <Expandable title="поля config">
    <ParamField query="commitment" type="string" optional>
      Уровень commitment для использования:

      * `processed`: Последний блок (неподтверждённый)
      * `confirmed`: Подтверждён супербольшинством
      * `finalized`: Финализирован супербольшинством
    </ParamField>

    <ParamField query="minContextSlot" type="number" optional>
      Минимальный слот, при котором может быть выполнен запрос
    </ParamField>
  </Expandable>
</ParamField>

## Ответ

<ResponseField name="result" type="number">
  Текущая высота блока
</ResponseField>

## Примеры кода

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

```bash theme={null}
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

```bash theme={null}
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

```typescript theme={null}
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` с конкретными слотами

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

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