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 є єдиними загальнодоступними кінцевими точками для Whitechain Sepolia. Будь ласка, вважайте будь-які інші кінцеві точки, які стверджують, що обслуговують мережу з ID 1874, неофіційними.
Чи є API блок-експлорера загальнодоступним?
Так. Whitechain використовує Blockscout, і його API є загальнодоступним, доступним лише для читання та не вимагає API-ключа. Він надає інтерфейси REST, Ethereum RPC, RPC, сумісний з Etherscan та GraphQL; довідник щодо API доступний за адресою explorer.testnet.whitechain.io/api-docs. На нього накладено обмеження щодо частоти запитів на IP-адресу, тому рекомендується виконувати пошук пакетами та кешувати результати. Ви можете запустити власний індексатор або екземпляр Blockscout для безперервного запиту даних за всією історією мережі.