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 для безперервного запиту даних за всією історією мережі.