Быстрый старт Avalanche RPC | ERPC
Быстрый старт Avalanche RPC
Это руководство проведёт вас от нуля до первого ответа Avalanche JSON-RPC с ERPC.
1. Получите ваш API key
Получить и проверить ваш API key можно на ERPC Web Dashboard: ERPC Web Dashboard
Уже используете ERPC для Solana или Ethereum? Вы можете использовать тот же RPC key.
2. Отправьте ваш первый запрос
Отправьте запрос JSON-RPC 2.0 как HTTP POST, указав ваш API key в параметре
api-key: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"
}'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"
}'Ответ возвращает номер последнего блока C-Chain в шестнадцатеричном формате:
json
{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }Вы можете проверить, какую сеть обслуживает endpoint, с помощью
eth_chainId. Результат — 0xa86a — 43114, ID сети mainnet Avalanche C-Chain: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_chainId"
}'curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_chainId"
}'Тот же endpoint также обслуживает нативные API Avalanche. Upstream API выбирается по точному имени метода, поэтому вызовы X-Chain (
avm.*) и P-Chain (platform.*) не требуют дополнительного пути или хоста:bash
curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"platform.getHeight",
"params":{}
}'curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"platform.getHeight",
"params":{}
}'3. Подпишитесь через WebSocket
WebSocket endpoint принимает стандартные подписки
eth_subscribe C-Chain: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"]}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"]}Список доступных типов подписок приведён в официальной документации Avalanche C-Chain, ссылка на которую указана ниже.
4. Batch-запросы
Вы можете отправить до 256 вызовов JSON-RPC в одном HTTP-запросе для EVM-методов C-Chain. Каждый вызов в batch тарифицируется как отдельный вызов.
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"},
{"jsonrpc":"2.0","id":2,"method":"eth_gasPrice"}
]'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"},
{"jsonrpc":"2.0","id":2,"method":"eth_gasPrice"}
]'Следующие шаги
- Endpoints, тарификация и коды состояния: Документация Avalanche RPC endpoint
- Полный список методов с форматами запросов и ответов: Справочник Avalanche RPC API
- Официальная документация Avalanche C-Chain: https://build.avax.network/docs/rpcs/c-chain