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

# OrbitFlare Jetstream

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

<Success>
  Jetstream создан для того, чтобы обеспечить вам **надёжный поток транзакций Solana с низкой задержкой** — чтобы вы могли создавать приложения реального времени (оповещения, трейдинг, аналитику, мониторинг) без необходимости запускать собственный конвейер индексации.
</Success>

<Frame>
  <img src="https://mintcdn.com/orbitflare/oYFPcWR1PY_9HTel/images/jetstream.png?fit=max&auto=format&n=oYFPcWR1PY_9HTel&q=85&s=151463a42bcc71c7e8625de0efd8c760" alt="OrbitFlare Jetstream Architecture" width="4000" height="2250" data-path="images/jetstream.png" />
</Frame>

## Обзор

OrbitFlare Jetstream — высокопроизводительный gRPC-сервис, обеспечивающий потоковую передачу транзакций Solana в реальном времени. Он предоставляет разработчикам надёжный и эффективный способ мониторинга и обработки транзакций блокчейна Solana с минимальной задержкой.

## Возможности

* Потоковая передача транзакций в реальном времени через gRPC
* Гибкие возможности фильтрации транзакций
* Фильтрация по аккаунтам (включение, исключение, обязательные)
* Высокая пропускная способность и низкая задержка
* Надёжная обработка ошибок и переподключение
* Простая интеграция с существующими приложениями Solana

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

### Установка

Чтобы начать работу с OrbitFlare Jetstream, выберите пример для клонирования:

<CardGroup cols={2}>
  <Card title="jetstream-client-example" icon="code" href="https://github.com/orbitflare/jetstream-client-example">
    Минимальный Rust-клиент, демонстрирующий подключение gRPC, фильтрацию и потоковую передачу транзакций.
  </Card>

  <Card title="solana-wallet-tracker" icon="wallet" href="https://github.com/orbitflare/solana-wallet-tracker">
    Готовый к production трекер кошельков с декодированием PumpFun, оповещениями о китах и YAML-конфигурацией фильтров.
  </Card>
</CardGroup>

Склонируйте базовый пример клиента:

```bash theme={null}
git clone https://github.com/orbitflare/jetstream-client-example
cd jetstream-client-example
```

Соберите клиент:

```bash theme={null}
cargo build --release
```

### Базовое использование

Запустите клиент с настройками по умолчанию:

```bash theme={null}
./target/release/jetstream-client-example
```

Подключитесь к собственному gRPC-эндпоинту JetStream:

```bash theme={null}
./target/release/jetstream-client-example -j http://fra.jetstream.orbitflare.com
```

### Фильтрация транзакций

OrbitFlare Jetstream поддерживает различные параметры фильтрации, помогающие сосредоточиться на нужных транзакциях:

1. **Фильтрация через командную строку**:

```bash theme={null}
# Включить конкретные аккаунты
./target/release/jetstream-client-example -i <pubkey1>,<pubkey2>

# Исключить аккаунты
./target/release/jetstream-client-example -e <pubkey1>,<pubkey2>

# Обязательные аккаунты
./target/release/jetstream-client-example -r <pubkey1>,<pubkey2>
```

2. **JSON-конфигурация**:
   Создайте файл `filters.json`:

```json theme={null}
{
  "filters": {
    "my-filter": {
      "account_include": ["pubkey1", "pubkey2"],
      "account_exclude": ["pubkey3"],
      "account_required": ["pubkey4"]
    }
  }
}
```

Примените JSON-конфигурацию:

```bash theme={null}
./target/release/jetstream-client-example -f filters.json
```

## Параметры конфигурации

| Параметр               | Описание                                | Пример                                                                     |
| ---------------------- | --------------------------------------- | -------------------------------------------------------------------------- |
| `--jetstream-grpc-url` | URL gRPC-эндпоинта JetStream            | [http://fra.jetstream.orbitflare.com](http://fra.jetstream.orbitflare.com) |
| `--filter-config-path` | Путь к JSON-файлу конфигурации фильтров | Нет                                                                        |
| `--include-accounts`   | Аккаунты для включения (через запятую)  | Нет                                                                        |
| `--exclude-accounts`   | Аккаунты для исключения (через запятую) | Нет                                                                        |
| `--required-accounts`  | Обязательные аккаунты (через запятую)   | Нет                                                                        |

## Логирование

Управляйте уровнем логирования с помощью переменной окружения `RUST_LOG`:

```bash theme={null}
RUST_LOG=debug ./target/release/jetstream-client-example
```

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

1. **Обработка ошибок**: Реализуйте корректную обработку ошибок для проблем с подключением и обработкой транзакций
2. **Фильтрация**: Используйте фильтры аккаунтов для сокращения ненужной обработки данных
3. **Мониторинг**: Устанавливайте подходящие уровни логирования для мониторинга и отладки
4. **Управление ресурсами**: Правильно управляйте gRPC-соединениями и ресурсами

## Смотрите также

<CardGroup cols={3}>
  <Card title="Справочник протокола" icon="book" href="/ru/data-streaming/jetstream-reference">
    Полная спецификация Protocol Buffer, типы сообщений и руководства по генерации кода.
  </Card>

  <Card title="Журнал изменений" icon="clock-rotate-left" href="/ru/data-streaming/jetstream-changelog">
    История версий, обновления производительности и изменения протокола.
  </Card>

  <Card title="Yellowstone gRPC" icon="wave-pulse" href="/ru/data-streaming/yellowstone">
    Потоковая передача на основе Geyser с поддержкой внутренних инструкций и полных метаданных.
  </Card>
</CardGroup>

## Поддержка

По вопросам технической поддержки или о OrbitFlare Jetstream обратитесь в нашу службу поддержки или посетите наш [репозиторий на GitHub](https://github.com/orbitflare/jetstream-client-example) для получения дополнительной информации.