Документация Base RPC endpoint | ERPC
Документация Base RPC endpoint
Используйте ERPC как ваш Base RPC endpoint для HTTP JSON-RPC запросов и WebSocket подписок. Base RPC является частью RPC APIs ERPC в рамках нашей Global Edge Blockchain Infrastructure, а управление API key доступно через ERPC Web Dashboard.
Вы можете использовать тот же RPC key, что и для Solana, Ethereum и Avalanche.
Пожалуйста, добавьте ваш API key в параметр
api-key.Endpoints
Отправляйте запросы JSON-RPC 2.0 как HTTP POST на:
text
https://base.erpc.global?api-key=<YOUR_API_KEY>https://base.erpc.global?api-key=<YOUR_API_KEY>Для подписок подключайтесь через WebSocket к:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>wss://base.erpc.global?api-key=<YOUR_API_KEY>Запросы принимаются только по пути
/.Примеры
Пример HTTP-запроса.
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'Получить и проверить ваш API key можно на ERPC Web Dashboard: ERPC Web Dashboard
Batch-запросы
Поддерживаются batch-пакеты JSON-RPC до 256 вызовов на один HTTP-запрос. Каждый вызов в batch тарифицируется как отдельный вызов.
Тарификация использования
Использование тарифицируется в токенах за каждый вызов JSON-RPC. Каждая запись в HTTP batch и каждый вызов JSON-RPC, отправленный через соединение WebSocket, тарифицируются отдельно.
Ограничения тарифа Free
На тарифе Free ваш аккаунт может отправлять один запрос в 10 секунд. Лимит считается по аккаунту, а не по endpoint, поэтому запрос к другой сети тоже может засчитываться в этот лимит. На запрос, отправленный раньше, возвращается HTTP
429, а заголовок retry-after указывает время ожидания в секундах.На тарифе Free на запрос, содержащий два или более вызова JSON-RPC, возвращается HTTP
429, и ни один из его вызовов не отправляется: каждый вызов получает ошибку JSON-RPC с кодом -32041. Отправляйте такие вызовы по одному.На тарифе Free соединения WebSocket недоступны, и на них возвращается HTTP
403.Поддерживаемые методы
Base — EVM-совместимая сеть, которая использует те же методы JSON-RPC, что и Ethereum. ERPC не применяет к endpoint Base фиксированный allowlist методов. Семейства методов Ethereum описаны здесь: Документация Ethereum RPC endpoint.
Коды состояния ответа
| HTTP статус | Значение |
|---|---|
| 200 | Ответ вышестоящего JSON-RPC. |
| 400 | Missing API key, Invalid JSON-RPC request или JSON-RPC batch exceeds 256 calls. |
| 401 | Unauthorized API KEY. |
| 403 | Соединение WebSocket на тарифе Free. |
| 404 | Любой путь, кроме /. |
| 429 | Ограничение скорости, включая описанные выше ограничения тарифа Free: более одного запроса в 10 секунд или два и более вызова в одном запросе. Заголовок retry-after указывает время ожидания в секундах. |
| 502 | Не удалось выполнить upstream RPC-запрос. |
| 503 | Сервис временно недоступен. |
Для соединений WebSocket, помимо указанных выше кодов, используется
101 (обновление протокола принято).Методы Base RPC и документация
Полный список стандартных методов, параметров и спецификаций см. в официальной документации.