Параметры Whitechain: ID сети, RPC, WebSocket и Explorer API

RPC endpoints и ID сети

  L2 mainnet Whitechain Sepolia Legacy L1 mainnet Legacy L1 testnet
RPC https://rpc.whitechain.io/ https://rpc.testnet.whitechain.io https://legacy.rpc.whitechain.io Stopped, not available
Chain ID 1875 (0x753) 1874 (0x752) 1875 (0x753) 2625 (0xa41)
Explorer https://explorer.whitechain.io/ https://explorer.testnet.whitechain.io/ https://legacy.explorer.whitechain.io/ Stopped, not available
WebSocket wss://rpc.whitechain.io/ws wss://rpc.testnet.whitechain.io/ws n/a n/a
Explorer API https://explorer.whitechain.io/api-docs https://explorer.testnet.whitechain.io/api-docs n/a n/a

RPC и эксплорер старой сети L1 доступны только для чтения и предоставляют доступ к истории L1 вплоть до блока-снэпшота 50961389. Старый RPC возвращает тот же идентификатор цепочки, что и L2, — 1875, поэтому не добавляйте его в кошелек как отдельную сеть. Старая тестовая сеть L1 (идентификатор 2625) прекратила работу 26 октября 2026 года, а её конечные точки были удалены 30 октября 2026 года.

Публичные конечные точки RPC https://rpc.whitechain.io (Mainnet) и https://rpc.testnet.whitechain.io (Whitechain Sepolia) имеют одинаковые ограничения на IP-адрес клиента: 50 запросов в секунду в стабильном режиме, плюс разрешение на пиковые нагрузки до 500 запросов сверх этого лимита. Один HTTP-запрос может содержать до 100 вызовов JSON-RPC в пакете. Партнёры могут получить более высокий уровень — 200 запросов в секунду с пиковой нагрузкой до 2 000 — по согласованию с Whitechain.

В случае превышения ограничения конечная точка возвращает статус HTTP 429 «Too Many Requests» с заголовком Retry-After: 1. Лимитер подсчитывает каждый HTTP-запрос, поэтому объединение нескольких вызовов JSON-RPC в один запрос может помочь. Ограничения скорости для WebSocket будут опубликованы после их окончательного утверждения.

Что делать моему клиенту, когда он достигнет лимита частоты запросов?

В этом случае повторяйте попытку с экспоненциальной задержкой, начиная со значения параметра Retry-After; клиент, повторяющий попытку сразу, как и раньше, будет получать ошибки.

Объедините связанные вызовы в один запрос JSON-RPC. Подпишитесь на событие newHeads через WebSocket вместо опроса eth_blockNumber и кэшируйте квитанции и финализированные блоки на своей стороне.

FAQ

Как определить, что endpoint не работает или на запрос наложено ограничение по частоте?

Вы можете проверить это на сайте https://status.whitechain.io для RPC, Explorer и Faucet. Здесь отображается состояние RPC-интерфейсов Mainnet и Testnet, блокчейн-браузера и API-интерфейса блокчейн-браузера, а также тестового faucet и моста тестовой сети. Ответ с кодом 429 означает, что на вас наложено ограничение по частоте запросов, а не то, что конечная точка не работает; это сообщение исчезнет, как только частота ваших запросов снизится.

Нужен ли ключ API для общедоступного RPC?

Нет. Для общедоступных endpoints RPC и WebSocket не требуется ни ключ API, ни список разрешенных IP-адресов.

Есть ли endpoint WebSocket?

Да. Сеть Whitechain Mainnet предоставляет доступ к wss://rpc.whitechain.io/ws, а Whitechain Sepolia — к wss://rpc.testnet.whitechain.io/ws. Обе сети предоставляют стандартный JSON-RPC-API Ethereum и поддерживают eth_subscribe для newHeads и logs. Whitechain Sepolia также предоставляет доступ к newPendingTransactions, в отличие от Whitechain Mainnet. Мы рекомендуем использовать одно соединение для нескольких подписок, а не открывать отдельное соединение для каждого запроса.

Существуют ли общедоступные RPC endpoints сторонних поставщиков?

Пока нет. Whitechain рассматривает возможности партнерства с коммерческими поставщиками RPC, и endpoints партнеров будут опубликованы в справочнике сети после их запуска. До тех пор https://rpc.whitechain.io и wss://rpc.whitechain.io/ws остаются единственными общедоступными endpoints для Whitechain Mainnet, а https://rpc.testnet.whitechain.io и wss://rpc.testnet.whitechain.io/ws – единственными для Whitechain Sepolia. Пожалуйста, считайте любые другие endpoints утверждающие, что они обслуживают цепочки с ID 1875 или 1874, неофициальными.

Является ли API блок-эксплорера общедоступным?

Да. Whitechain использует Blockscout, и его API является общедоступным, доступным только для чтения и не требует ключа API. Он предоставляет интерфейсы REST, Ethereum RPC, RPC, совместимый с Etherscan, и GraphQL; справочник по API доступен по адресу explorer.whitechain.io/api-docs для Mainnet и explorer.testnet.whitechain.io/api-docs для Whitechain Sepolia. На него наложено ограничение по частоте запросов на IP-адрес, поэтому рекомендуется выполнять поиск пакетами и кэшировать результаты. Вы можете запустить собственный индексатор или экземпляр Blockscout для непрерывного запроса данных по всей истории сети.

Была ли эта статья полезной?

Пользователи, считающие этот материал полезным: 0 из 0

Еще есть вопросы? Отправить запрос