Доступные эндпоинты
Jetstream доступен во всех регионах OrbitFlare. Подключитесь к ближайшему к вашей инфраструктуре региону для минимальной задержки.- США
- Европа
- Азиатско-Тихоокеанский регион
Jetstream использует обычный
http:// (не https://) для gRPC-соединений. gRPC использует собственное согласование безопасности транспорта через HTTP/2. Используйте https:// только если ваш выделенный узел явно требует этого.Спецификация Protocol Buffer
Этот документ описывает спецификацию Protocol Buffer (protobuf), используемую OrbitFlare Jetstream. Полную спецификацию можно найти в нашем репозитории на GitHub.Определение сервиса
Сообщения запросов
SubscribeRequest
Основное сообщение запроса для подписки на обновления данных:Фильтрация транзакций
Фильтрация аккаунтов
Ping-запрос
Сообщения ответов
SubscribeUpdate
Основное сообщение ответа, содержащее обновления:Обновление транзакции
Обновление аккаунта
Обновления Ping/Pong
Общие типы
Поддержка разобранных инструкций
Разобранный запрос
Обновление разобранной транзакции
Типы инструкций
Нестриминговые методы
Использование протокола
При реализации клиента для Jetstream вам потребуется:- Сгенерировать клиентский код из определения protobuf
- Реализовать метод Subscribe RPC для потоковой передачи данных
- Использовать SubscribeParsed для поддержки разобранных инструкций
- Использовать Ping/Pong для проверки работоспособности соединения
- Использовать GetVersion для проверки совместимости с сервером
- Обрабатывать различные типы обновлений (транзакции, аккаунты, pong)
Генерация кода
Для TypeScript/JavaScript:Лучшие практики
-
Совместимость версий
- Используйте GetVersion для проверки совместимости протокола
- Отслеживайте критические изменения в бета-релизах
- Тщательно тестируйте при обновлении
-
Обработка ошибок
- Реализуйте корректную обработку ошибок для всех типов сообщений
- Обрабатывайте сбои соединения без потери данных
- Проверяйте поля сообщений перед обработкой
-
Управление соединением
- Используйте Ping/Pong для проверки работоспособности соединения
- Реализуйте логику автоматического переподключения
- Устанавливайте подходящие тайм-ауты
-
Производительность
- Используйте подходящие фильтры для минимизации ненужных данных
- Рассматривайте использование фильтрации по аккаунтам для больших наборов данных
- Отслеживайте использование ресурсов, особенно при подписках на аккаунты
- Используйте SubscribeParsed для поддержки разобранных инструкций при необходимости
Смотрите также
Обзор Jetstream
Руководство по началу работы, примеры и документация по фильтрации.
Журнал изменений
История версий и обновления протокола.