Обзор
OrbitFlare поддерживает постоянные WebSocket-соединения для получения данных Solana в реальном времени. WebSocket-подписки отправляют обновления вашему клиенту по мере их появления в блокчейне — без необходимости опроса. WebSocket-эндпоинты используют схемуwss:// с теми же кодами регионов, что и HTTP API:
Подключение
Простаивающие соединения со временем разрываются без закрывающего фрейма, и клиент получает код закрытия
1006. Чтобы соединение оставалось открытым, отправляйте ping-фрейм WebSocket каждые 20–30 секунд.Методы подписки
accountSubscribe
Получайте обновления при изменении баланса lamport или данных конкретного аккаунта.logsSubscribe
Получайте сообщения журнала транзакций в реальном времени. Опционально фильтруйте по конкретной программе.slotSubscribe
Получайте уведомление каждый раз при обработке слота.signatureSubscribe
Получайте одноразовое уведомление, когда конкретная подпись транзакции достигает заданного уровня подтверждения.programSubscribe
Получайте обновления для всех аккаунтов, принадлежащих конкретной программе.blockSubscribe
Получайте полные данные блока при его подтверждении. Требует дополнения — обратитесь в поддержку для активации.rootSubscribe
Получайте наивысший подтверждённый корневой слот каждый раз при его продвижении.Отписка
Каждый метод подписки имеет соответствующий методUnsubscribe. Передайте ID подписки, возвращённый в ответе на первоначальную подписку.
accountUnsubscribe, logsUnsubscribe, slotUnsubscribe, signatureUnsubscribe, programUnsubscribe, blockUnsubscribe, rootUnsubscribe.
Поддержание соединения
Простаивающие соединения со временем разрываются без закрывающего фрейма. Отправляйте ping-фрейм протокола WebSocket каждые 20–30 секунд. JSON-RPC-сообщение вроде{"method": "ping"} не подходит: в Solana нет метода ping, и сервер отвечает -32601 Method not found.
Переподключение
Реализуйте автоматическое переподключение с экспоненциальной задержкой для production-приложений:Лимиты соединений
WebSocket-соединения разделяют тот же лимит на IP, что и gRPC-соединения. Подробности см. в разделе Аутентификация и лимиты.Смотрите также
HTTP RPC API
Формат запросов JSON-RPC 2.0, пакетные запросы и все доступные методы.
Коды ошибок
HTTP-статусы, ошибки JSON-RPC и способы их обработки.