Параметри 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 року, а її endpoint були видалені 30 жовтня 2026 року.

Публічні endpoints 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?

Ні. Для загальнодоступних endpointів 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 вважають статтю корисною

Маєте ще запитання? Надіслати запит