ERPC

Documentação do Avalanche RPC endpoint | ERPC

Documentação do Avalanche RPC endpoint

Use a ERPC como seu endpoint RPC do Avalanche para requisições HTTP JSON-RPC e assinaturas WebSocket. O Avalanche RPC faz parte das RPC APIs da ERPC dentro da nossa Global Edge Blockchain Infrastructure, e a API key pode ser gerenciada no ERPC Web Dashboard.
Você pode usar a mesma RPC key da Solana e do Ethereum.
Adicione sua API key ao parâmetro 'api-key'.

Endpoints

Envie requisições JSON-RPC 2.0 como HTTP POST para:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Para assinaturas, conecte-se via WebSocket a:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
A API upstream é selecionada pelo nome exato do método JSON-RPC, portanto as chamadas para C-Chain, X-Chain e P-Chain vão todas para o mesmo endpoint.

Exemplos

Aqui está um exemplo de requisição 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"
}'
Aqui está um exemplo de assinatura 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"]}
Você pode obter e verificar sua API key no ERPC Web Dashboard: ERPC Web Dashboard

Requisições em lote

Lotes de JSON-RPC com até 256 chamadas por requisição HTTP são suportados para os métodos EVM da C-Chain, e notificações JSON-RPC também são aceitas. Os namespaces nativos da Avalanche — avax.*, avm.*, platform.*, proposervm.* e info.upgrades — são chamados um de cada vez. Cada chamada em um lote é medida como uma chamada individual.

Medição de uso

O uso é medido em tokens a uma taxa fixa por chamada JSON-RPC — a mesma taxa para todos os métodos do Avalanche RPC. Cada entrada em um lote HTTP e cada chamada JSON-RPC enviada por uma conexão WebSocket é medida separadamente. Você pode verificar a taxa atual de tokens por chamada na Referência da API Avalanche RPC.

Métodos suportados

O endpoint cobre as famílias de métodos JSON-RPC EVM da C-Chain — eth_*, net_*, txpool_* e web3_* — incluindo leituras de contas e blocos (eth_getBalance, eth_getBlockByNumber, eth_getLogs), fluxo de transações (eth_sendRawTransaction, eth_getTransactionReceipt), dados de taxa (eth_gasPrice, eth_maxPriorityFeePerGas), simulação de chamadas (eth_call, eth_estimateGas), filtros (eth_newFilter, eth_getFilterChanges), inspeção do txpool (txpool_status, txpool_content), as extensões da C-Chain (eth_getAssetBalance, eth_baseFee), e assinaturas WebSocket (eth_subscribe, eth_unsubscribe).
As APIs nativas da Avalanche são fornecidas a partir do mesmo endpoint: operações atômicas da C-Chain (avax.getAtomicTx, avax.getUTXOs, avax.issueTx), a X-Chain (avm.getBalance, avm.getTx, avm.issueTx), a P-Chain (platform.getCurrentValidators, platform.getStake, platform.getHeight, platform.issueTx, proposervm.getProposedHeight), e os horários de upgrade de rede (info.upgrades).
Para a lista completa de métodos com os formatos de requisição e resposta, consulte a Referência da API Avalanche RPC.

Códigos de status de resposta

HTTP statusSignificado
200Resposta JSON-RPC do upstream.
400API key ausente, ou requisição JSON-RPC inválida.
401API key não autorizada.
429Limitado por taxa. O cabeçalho retry-after indica o tempo de espera em segundos.
502A requisição RPC upstream não pôde ser concluída.
503O serviço está temporariamente indisponível.
Um método JSON-RPC fora do catálogo publicado é respondido com HTTP 400 e erro JSON-RPC -32601 (Method not found), e um lote acima de 256 chamadas é respondido com HTTP 400.
Conexões WebSocket usam 101 (atualização de protocolo aceita) e 426 (um handshake de WebSocket Upgrade é necessário) além dos códigos acima.

Métodos e Documentação Avalanche RPC

Para a lista completa de métodos padrão, parâmetros e especificações de assinatura, consulte a documentação oficial. Ela cobre tanto o uso HTTP quanto WebSocket.

Anterior

Avalanche RPC Quickstart | ERPC

Próximo

SLV AI