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 для непрерывного запроса данных по всей истории сети.