> ## 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.

# Yellowstone gRPC

> Высокопроизводительная потоковая передача данных блокчейна Solana в реальном времени через gRPC с расширенной фильтрацией

## Что такое Yellowstone gRPC?

Yellowstone gRPC — это [плагин Geyser](https://github.com/rpcpool/yellowstone-grpc), который передаёт данные блокчейна Solana непосредственно на ваш сервер с минимальной задержкой. Он использует двунаправленный поток gRPC, позволяя динамически создавать и отменять подписки без переподключения.

С помощью Yellowstone вы можете подписаться на:

* **Аккаунты** — изменения баланса и данных в реальном времени
* **Транзакции** — результаты выполнения по мере их обработки
* **Слоты** — прогресс консенсуса сети по уровням подтверждения
* **Блоки** — полные данные блоков с настраиваемым включением транзакций/аккаунтов
* **Записи** — низкоуровневые единицы выполнения внутри блока

<CardGroup cols={2}>
  <Card title="Высокая производительность" icon="bolt">
    Бинарный протокол с эффективной сериализацией для максимальной пропускной способности.
  </Card>

  <Card title="Потоковая передача в реальном времени" icon="wave-pulse">
    Двунаправленная потоковая передача с мгновенным созданием и отменой подписок без переподключения.
  </Card>

  <Card title="Расширенная фильтрация" icon="filter">
    Точный контроль получаемых данных через фильтры аккаунтов, транзакций и программ.
  </Card>

  <Card title="Несколько типов данных" icon="database">
    Подписка на аккаунты, транзакции, слоты, блоки и записи в одном потоке.
  </Card>
</CardGroup>

## Доступ через OrbitFlare

Yellowstone gRPC доступен через:

* **OrbitFlare Pass** — входит в активную лицензию NFT Pass
* **Подписка gRPC** — отдельный план gRPC
* **Выделенные gRPC-узлы** — полностью изолированные, неограниченная пропускная способность

Подробности о ценах и планах см. на странице [Продукты](/ru/products).

## Структура запроса подписки

Каждая подписка gRPC использует одинаковую базовую структуру запроса:

```typescript theme={null}
const subscriptionRequest: SubscribeRequest = {
  commitment: CommitmentLevel.CONFIRMED, // processed | confirmed | finalized
  accountsDataSlice: [],                 // опционально: запрос конкретных диапазонов байт
  ping: { id: 1 },                       // опционально: поддержание соединения
  accounts: {},
  transactions: {},
  slots: {},
  blocks: {},
  blocksMeta: {},
  entry: {},
};
```

| Параметр            | Обязателен | Описание                                                                             |
| ------------------- | :--------: | ------------------------------------------------------------------------------------ |
| `commitment`        |     Да     | Уровень подтверждения: `processed`, `confirmed` или `finalized`                      |
| `accountsDataSlice` |     Нет    | Массив `{ offset, length }` для получения конкретных диапазонов байт данных аккаунта |
| `ping`              |     Нет    | Отправка ping для поддержания соединения. Сервер отвечает pong каждые 15 секунд      |

<Note>
  Облачные балансировщики нагрузки (например, Cloudflare) обычно закрывают соединения gRPC после 10 минут бездействия. Всегда отправляйте ping каждые 30 секунд для предотвращения отключения.
</Note>

## Типы потоков

<Tabs>
  <Tab title="Аккаунты">
    Мониторинг изменений аккаунтов в реальном времени — обновления баланса, изменения данных, смена владельца. Фильтрация по адресам, программам-владельцам, размеру данных или байтовым паттернам.

    [Руководство по мониторингу аккаунтов →](/ru/data-streaming/yellowstone-account-monitoring)
  </Tab>

  <Tab title="Транзакции">
    Получение результатов выполнения транзакций. Фильтрация по задействованным аккаунтам, статусу голосования и успешности.

    [Руководство по мониторингу транзакций →](/ru/data-streaming/yellowstone-transaction-monitoring)
  </Tab>

  <Tab title="Слоты и блоки">
    Отслеживание прогресса слотов по уровням подтверждения и получение полных данных блоков.

    [Руководство по слотам и блокам →](/ru/data-streaming/yellowstone-slot-block-monitoring)
  </Tab>

  <Tab title="Записи">
    Доступ к базовым единицам выполнения блока — низкоуровневым пакетам транзакций.

    [Руководство по мониторингу записей →](/ru/data-streaming/yellowstone-entry-monitoring)
  </Tab>
</Tabs>

## Начало работы

<CardGroup cols={2}>
  <Card title="Быстрый старт" icon="rocket" href="/ru/data-streaming/yellowstone-quickstart">
    Установите клиент, подключитесь к эндпоинту и отправьте первую подписку.
  </Card>

  <Card title="Мониторинг аккаунтов" icon="user" href="/ru/data-streaming/yellowstone-account-monitoring">
    Потоковая передача обновлений аккаунтов с точной фильтрацией.
  </Card>

  <Card title="Мониторинг транзакций" icon="receipt" href="/ru/data-streaming/yellowstone-transaction-monitoring">
    Мониторинг транзакций с фильтрацией по программам и аккаунтам.
  </Card>

  <Card title="Слоты и блоки" icon="cube" href="/ru/data-streaming/yellowstone-slot-block-monitoring">
    Отслеживание консенсуса сети и производства блоков в реальном времени.
  </Card>
</CardGroup>