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 | https://rpc-testnet.whitechain.io |
| 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/ | https://testnet.whitechain.io/ |
На общедоступном HTTPS-endpoint https://rpc.testnet.whitechain.io установлено ограничение в 50 запросов в секунду на IP-адрес клиента, а также допускается кратковременный всплеск до 500 запросов сверх этого лимита.
В случае превышения этого лимита endpoint возвращает HTTP-статус 429 «Too Many Requests» с заголовком Retry-After: 1. Лимитер учитывает каждый HTTP-запрос, поэтому рекомендуется объединять несколько вызовов JSON-RPC в один запрос. Лимиты скорости для WebSocket будут опубликованы после их окончательного утверждения, а лимиты для Mainnet — до запуска Mainnet.
Что делать моему клиенту, когда он достигнет лимита частоты запросов?
В этом случае повторяйте попытку с экспоненциальной задержкой, начиная со значения параметра Retry-After; клиент, повторяющий попытку сразу, как и раньше, будет получать ошибки.
Объедините связанные вызовы в один запрос JSON-RPC. Подпишитесь на событие newHeads через WebSocket вместо опроса eth_blockNumber и кэшируйте квитанции и финализированные блоки на своей стороне.
FAQ
Как определить, что endpoint не работает или на запрос наложено ограничение по частоте?
Вы можете проверить это на сайте https://status.whitechain.io для RPC, Explorer и Faucet. На данный момент там отслеживаются только компоненты тестовой сети (Testnet); мониторинг основной сети (Mainnet) будет добавлен после запуска.
Нужен ли ключ API для общедоступного RPC?
Нет. Для общедоступных endpoints RPC и WebSocket не требуется ни ключ API, ни список разрешенных IP-адресов.
Есть ли endpoint WebSocket?
Да. Whitechain Sepolia предоставляет доступ по адресу wss://rpc.testnet.whitechain.io/ws. Он предоставляет стандартный JSON-RPC-API Ethereum и поддерживает eth_subscribe, включая newHeads, logs и newPendingTransactions. Рекомендуется использовать одно соединение для нескольких подписок, а не открывать новое соединение для каждого запроса.
Существуют ли общедоступные RPC endpoints сторонних поставщиков?
Пока нет. Whitechain рассматривает возможности партнерства с коммерческими поставщиками RPC, и endpoints партнеров будут опубликованы в справочнике сети после их запуска. До тех пор https://rpc.testnet.whitechain.io и его WebSocket являются единственными общедоступными endpoints для Whitechain Sepolia. Пожалуйста, считайте любые другие endpoints, утверждающие, что обслуживают сеть с ID 1874, неофициальными.
Является ли API блок-эксплорера общедоступным?
Да. Whitechain использует Blockscout, и его API является общедоступным, доступным только для чтения и не требует ключа API. Он предоставляет интерфейсы REST, Ethereum RPC, RPC, совместимый с Etherscan, и GraphQL; справочник по API доступен по адресу explorer.testnet.whitechain.io/api-docs. На него наложено ограничение по частоте запросов на IP-адрес, поэтому рекомендуется выполнять поиск пакетами и кэшировать результаты. Вы можете запустить собственный индексатор или экземпляр Blockscout для непрерывного запроса данных по всей истории сети.