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

​
Обзор

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

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

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

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

​
Установка

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

jetstream-client-example

Минимальный Rust-клиент, демонстрирующий подключение gRPC, фильтрацию и потоковую передачу транзакций.

solana-wallet-tracker

Готовый к production трекер кошельков с декодированием PumpFun, оповещениями о китах и YAML-конфигурацией фильтров.
Склонируйте базовый пример клиента: 
git clone https://github.com/orbitflare/jetstream-client-example
cd jetstream-client-example
Соберите клиент: 
cargo build --release

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

Запустите клиент с настройками по умолчанию: 
./target/release/jetstream-client-example
Подключитесь к собственному gRPC-эндпоинту JetStream: 
./target/release/jetstream-client-example -j http://fra.jetstream.orbitflare.com

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

OrbitFlare Jetstream поддерживает различные параметры фильтрации, помогающие сосредоточиться на нужных транзакциях:
  1. Фильтрация через командную строку:
# Включить конкретные аккаунты
./target/release/jetstream-client-example -i <pubkey1>,<pubkey2>

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

# Обязательные аккаунты
./target/release/jetstream-client-example -r <pubkey1>,<pubkey2>
  1. JSON-конфигурация: Создайте файл filters.json:
{
  "filters": {
    "my-filter": {
      "account_include": ["pubkey1", "pubkey2"],
      "account_exclude": ["pubkey3"],
      "account_required": ["pubkey4"]
    }
  }
}
Примените JSON-конфигурацию: 
./target/release/jetstream-client-example -f filters.json

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

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

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

Управляйте уровнем логирования с помощью переменной окружения RUST_LOG: 
RUST_LOG=debug ./target/release/jetstream-client-example

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

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

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

Справочник протокола

Полная спецификация Protocol Buffer, типы сообщений и руководства по генерации кода.

Журнал изменений

История версий, обновления производительности и изменения протокола.

Yellowstone gRPC

Потоковая передача на основе Geyser с поддержкой внутренних инструкций и полных метаданных.

​
Поддержка

По вопросам технической поддержки или о OrbitFlare Jetstream обратитесь в нашу службу поддержки или посетите наш репозиторий на GitHub для получения дополнительной информации.