ERPC

Avalanche RPC - Quickstart

Avalanche RPC - Quickstart

Esta guía te lleva de cero a tu primera respuesta Avalanche JSON-RPC con ERPC.

1. Obtén tu API key

Puedes obtener y comprobar tu API key en ERPC Web Dashboard: ERPC Web Dashboard
¿Ya usas ERPC para Solana o Ethereum? Puedes usar la misma RPC key.

2. Realiza tu primera solicitud

Envía una solicitud JSON-RPC 2.0 como HTTP POST, con tu API key en el 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"
}'
La respuesta devuelve el último número de bloque de C-Chain en hexadecimal:
json
{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }
Puedes comprobar qué chain sirve el endpoint con eth_chainId. El resultado es 0xa86a — 43114, el chain ID de la mainnet de 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"
}'
El mismo endpoint también sirve las APIs nativas de Avalanche. La API upstream se selecciona según el nombre exacto del método, así que las llamadas a X-Chain (avm.*) y P-Chain (platform.*) no necesitan una ruta ni un 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. Suscríbete por WebSocket

El endpoint WebSocket acepta suscripciones eth_subscribe estándar de 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 los tipos de suscripción disponibles, consulta la documentación oficial de Avalanche C-Chain enlazada abajo.

4. Solicitudes por lotes

Puedes enviar hasta 256 llamadas JSON-RPC en una sola solicitud HTTP para los métodos EVM de C-Chain. Cada llamada en un lote se mide como una llamada 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 pasos

Anterior

Documentación del endpoint RPC de Ethereum | ERPC

Siguiente

Documentación del endpoint RPC de Avalanche | ERPC