ERPC

Avalanche RPC Quickstart | ERPC

Início rápido do Avalanche RPC

Este guia leva você do zero até sua primeira resposta Avalanche JSON-RPC com a ERPC.

1. Obtenha sua API key

Você pode obter e verificar sua API key no ERPC Web Dashboard: ERPC Web Dashboard
Já usa a ERPC para Solana ou Ethereum? Você pode usar a mesma RPC key.

2. Faça sua primeira requisição

Envie uma requisição JSON-RPC 2.0 como um HTTP POST, com sua API key no parâmetro 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"
}'
A resposta retorna o número do bloco C-Chain mais recente em hexadecimal:
json
{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }
Você pode verificar qual chain o endpoint atende com eth_chainId. O resultado é 0xa86a — 43114, o chain ID da mainnet da 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"
}'
O mesmo endpoint também atende às APIs nativas da Avalanche. A API upstream é selecionada pelo nome exato do método, portanto as chamadas para X-Chain (avm.*) e P-Chain (platform.*) não precisam de caminho ou host adicional:
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":{}
}'

3. Assine via WebSocket

O endpoint WebSocket aceita as assinaturas eth_subscribe padrão da 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"]}
Para os tipos de assinatura disponíveis, consulte a documentação oficial da Avalanche C-Chain referenciada abaixo.

4. Requisições em lote

Você pode enviar até 256 chamadas JSON-RPC em uma única requisição HTTP para métodos EVM da C-Chain. Cada chamada em um lote é medida como uma chamada individual.
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"}
]'

Próximos passos

Anterior

Documentação do Ethereum RPC endpoint | ERPC

Próximo

Documentação do Avalanche RPC endpoint | ERPC