ERPC

Документация Avalanche RPC endpoint | ERPC

Документация Avalanche RPC endpoint

Используйте ERPC как ваш Avalanche RPC endpoint для HTTP JSON-RPC запросов и WebSocket подписок. Avalanche RPC является частью RPC APIs ERPC в рамках нашей Global Edge Blockchain Infrastructure, а управление API key доступно через ERPC Web Dashboard.
Вы можете использовать тот же RPC key, что и для Solana и Ethereum.
Пожалуйста, добавьте ваш API key в параметр 'api-key'.

Endpoints

Отправляйте запросы JSON-RPC 2.0 как HTTP POST на:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Для подписок подключайтесь через WebSocket к:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Upstream API выбирается по точному имени метода JSON-RPC, поэтому вызовы для C-Chain, X-Chain и P-Chain все направляются на один и тот же endpoint.

Примеры

Пример HTTP-запроса.
bash
curl https://edge.erpc.global/ava?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/ava?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-запрос для EVM-методов C-Chain, а также принимаются JSON-RPC notifications. Нативные пространства имён Avalanche — avax.*, avm.*, platform.*, proposervm.* и info.upgrades — вызываются по одному. Каждый вызов в batch тарифицируется как отдельный вызов.

Тарификация использования

Использование тарифицируется в токенах по фиксированной ставке за вызов JSON-RPC — одинаковой для любого метода Avalanche RPC. Каждая запись в HTTP batch и каждый вызов JSON-RPC, отправленный через соединение WebSocket, тарифицируются отдельно. Текущую ставку токенов за вызов можно проверить в Справочник Avalanche RPC API.

Поддерживаемые методы

Endpoint охватывает семейства методов JSON-RPC EVM C-Chain — eth_*, net_*, txpool_* и web3_* — включая чтение аккаунтов и блоков (eth_getBalance, eth_getBlockByNumber, eth_getLogs), поток транзакций (eth_sendRawTransaction, eth_getTransactionReceipt), данные о комиссиях (eth_gasPrice, eth_maxPriorityFeePerGas), симуляцию вызовов (eth_call, eth_estimateGas), фильтры (eth_newFilter, eth_getFilterChanges), инспекцию txpool (txpool_status, txpool_content), расширения C-Chain (eth_getAssetBalance, eth_baseFee) и подписки WebSocket (eth_subscribe, eth_unsubscribe).
Нативные API Avalanche обслуживаются с того же endpoint: атомарные операции C-Chain (avax.getAtomicTx, avax.getUTXOs, avax.issueTx), X-Chain (avm.getBalance, avm.getTx, avm.issueTx), P-Chain (platform.getCurrentValidators, platform.getStake, platform.getHeight, platform.issueTx, proposervm.getProposedHeight) и сроки обновления сети (info.upgrades).
Полный список методов с форматами запросов и ответов см. в Справочник Avalanche RPC API.

Коды состояния ответа

HTTP статусЗначение
200Ответ вышестоящего JSON-RPC.
400Отсутствующий API key, или некорректный запрос JSON-RPC.
401Неавторизованный API key.
429Ограничение скорости. Заголовок retry-after указывает время ожидания в секундах.
502Не удалось выполнить upstream RPC-запрос.
503Сервис временно недоступен.
Метод JSON-RPC вне опубликованного каталога получает ответ HTTP 400 и ошибку JSON-RPC -32601 (Method not found), а batch из более чем 256 вызовов получает ответ HTTP 400.
Соединения WebSocket дополнительно используют коды 101 (обновление протокола принято) и 426 (требуется handshake WebSocket Upgrade) в дополнение к указанным выше кодам.

Методы Avalanche RPC и документация

Полный список стандартных методов, параметров и спецификаций подписок см. в официальной документации. Она охватывает использование как HTTP, так и WebSocket.

Назад

Быстрый старт Avalanche RPC | ERPC

Далее

SLV AI