Documentación del endpoint RPC de Avalanche | ERPC
Documentación del endpoint RPC de Avalanche
Usa ERPC como tu endpoint RPC de Avalanche para solicitudes HTTP JSON-RPC y suscripciones WebSocket. Avalanche RPC forma parte de las RPC APIs de ERPC dentro de nuestra Global Edge Blockchain Infrastructure, y la API key se puede gestionar desde ERPC Web Dashboard.
Puedes usar la misma RPC key que Solana y Ethereum.
Añade tu API key al parámetro 'api-key'.
Endpoints
Envía solicitudes JSON-RPC 2.0 como HTTP POST a:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>Para suscripciones, conéctate por WebSocket a:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>La API upstream se selecciona según el nombre exacto del método JSON-RPC, así que las llamadas a C-Chain, X-Chain y P-Chain van todas al mismo endpoint.
Ejemplos
Este es un ejemplo de solicitud 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"
}'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"
}'Este es un ejemplo de suscripción 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"]}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"]}Puedes obtener y comprobar tu API key en ERPC Web Dashboard: ERPC Web Dashboard
Solicitudes por lotes
Se admiten lotes JSON-RPC de hasta 256 llamadas por solicitud HTTP para los métodos EVM de C-Chain, y también se aceptan notificaciones JSON-RPC. Los namespaces nativos de Avalanche —
avax.*, avm.*, platform.*, proposervm.* y info.upgrades — se llaman de uno en uno. Cada llamada en un lote se mide como una llamada individual.Uso de tokens
El uso se mide en tokens a una tarifa fija por llamada JSON-RPC — la misma tarifa para todos los métodos de Avalanche RPC. Cada entrada en un lote HTTP y cada llamada JSON-RPC enviada por una conexión WebSocket se mide por separado. Puedes consultar la tarifa actual de tokens por llamada en la Referencia de la API de Avalanche RPC.
Métodos compatibles
El endpoint cubre las familias de métodos JSON-RPC EVM de C-Chain —
eth_*, net_*, txpool_* y web3_* — incluyendo lecturas de cuentas y bloques (eth_getBalance, eth_getBlockByNumber, eth_getLogs), flujo de transacciones (eth_sendRawTransaction, eth_getTransactionReceipt), datos de comisiones (eth_gasPrice, eth_maxPriorityFeePerGas), simulación de llamadas (eth_call, eth_estimateGas), filtros (eth_newFilter, eth_getFilterChanges), inspección del txpool (txpool_status, txpool_content), las extensiones de C-Chain (eth_getAssetBalance, eth_baseFee), y suscripciones WebSocket (eth_subscribe, eth_unsubscribe).Las APIs nativas de Avalanche se sirven desde el mismo endpoint: operaciones atómicas de C-Chain (
avax.getAtomicTx, avax.getUTXOs, avax.issueTx), la X-Chain (avm.getBalance, avm.getTx, avm.issueTx), la P-Chain (platform.getCurrentValidators, platform.getStake, platform.getHeight, platform.issueTx, proposervm.getProposedHeight), y los tiempos de actualización de red (info.upgrades).Para la lista completa de métodos con los formatos de solicitud y respuesta, consulta la Referencia de la API de Avalanche RPC.
Códigos de estado de respuesta
| Estado HTTP | Significado |
|---|---|
| 200 | Respuesta JSON-RPC del upstream. |
| 400 | API key ausente, o solicitud JSON-RPC inválida. |
| 401 | API key no autorizada. |
| 429 | Limitado por tasa. El header retry-after indica el tiempo de espera en segundos. |
| 502 | No se pudo completar la solicitud RPC upstream. |
| 503 | El servicio no está disponible temporalmente. |
Un método JSON-RPC fuera del catálogo publicado se responde con HTTP
400 y error JSON-RPC -32601 (Method not found), y un lote de más de 256 llamadas se responde con HTTP 400.Las conexiones WebSocket usan
101 (actualización de protocolo aceptada) y 426 (se requiere un handshake de WebSocket Upgrade) además de los códigos anteriores.Métodos y documentación de Avalanche RPC
Para la lista completa de métodos estándar, parámetros y especificaciones de suscripción, consulta la documentación oficial. Cubre tanto el uso de HTTP como WebSocket.
- C-Chain (EVM JSON-RPC): https://build.avax.network/docs/rpcs/c-chain
- X-Chain (
avm.*): https://build.avax.network/docs/rpcs/x-chain - P-Chain (
platform.*): https://build.avax.network/docs/rpcs/p-chain