Документация Ethereum RPC endpoint | ERPC
Документация Ethereum RPC endpoint
Используйте ERPC как ваш Ethereum RPC endpoint для HTTP JSON-RPC запросов и WebSocket подписок. Ethereum RPC является частью RPC APIs ERPC в рамках нашей Global Edge Blockchain Infrastructure, а управление API key доступно через ERPC Web Dashboard.
Вы можете использовать тот же RPC key, что и для Solana.
Пожалуйста, добавьте ваш API key в параметр 'api-key'.
Endpoints
Отправляйте запросы JSON-RPC 2.0 как HTTP POST на:
text
https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Для подписок подключайтесь через WebSocket к:
text
wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Примеры
Пример HTTP-запроса.
bash
curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'Пример подписки через WebSocket.
bash
wscat -c "wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}wscat -c "wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}Получить и проверить ваш API key можно на ERPC Web Dashboard: ERPC Web Dashboard
Batch-запросы
Поддерживаются batch-пакеты JSON-RPC до 256 вызовов на один HTTP-запрос, а также принимаются JSON-RPC notifications. Каждый вызов в batch тарифицируется как отдельный вызов.
Тарификация использования
Использование тарифицируется в токенах по фиксированной ставке за вызов JSON-RPC — одинаковой для любого метода Ethereum RPC. Каждая запись в HTTP batch и каждый вызов JSON-RPC, отправленный через соединение WebSocket, тарифицируются отдельно. Текущую ставку токенов за вызов можно проверить в Справочник Ethereum RPC API.
Поддерживаемые методы
Endpoint охватывает стандартные семейства методов Ethereum JSON-RPC —
eth_*, net_*, txpool_* и web3_* — включая чтение аккаунтов и блоков (eth_getBalance, eth_getBlockByNumber, eth_getLogs), поток транзакций (eth_sendRawTransaction, eth_getTransactionReceipt), данные о комиссиях (eth_feeHistory, eth_maxPriorityFeePerGas), симуляцию вызовов (eth_call, eth_callMany, eth_simulateV1), доказательства состояния (eth_getProof), фильтры (eth_newFilter, eth_getFilterChanges), инспекцию txpool (txpool_status, txpool_content) и подписки WebSocket (eth_subscribe, eth_unsubscribe).Полный список методов с форматами запросов и ответов см. в Справочник Ethereum RPC API.
Коды состояния ответа
| HTTP статус | Значение |
|---|---|
| 200 | Ответ вышестоящего JSON-RPC. |
| 400 | Некорректный запрос JSON-RPC. |
| 401 | Отсутствующий или неавторизованный API key. |
| 429 | Ограничение скорости политикой нижестоящего RPC. |
| 502 | Proxy недоступен. |
| 503 | Нижестоящий сервис RPC недоступен. |
Соединения WebSocket дополнительно используют коды
101 (обновление протокола принято) и 426 (требуется handshake WebSocket Upgrade) в дополнение к указанным выше кодам.Методы Ethereum RPC и документация
Полный список стандартных методов, параметров и спецификаций подписок см. в официальной документации. Она охватывает использование как HTTP, так и WebSocket.