Documentación del endpoint RPC de Ethereum | ERPC
Documentación del endpoint RPC de Ethereum
Usa ERPC como tu endpoint RPC de Ethereum para solicitudes HTTP JSON-RPC y suscripciones WebSocket. Ethereum 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.
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/eth?api-key=<YOUR_API_KEY>https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Para suscripciones, conéctate por WebSocket a:
text
wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Ejemplos
Este es un ejemplo de solicitud HTTP.
bash
curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl https://edge.erpc.global/eth?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/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}wscat -c "wss://edge.erpc.global/eth?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, y también se aceptan notificaciones JSON-RPC. 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 Ethereum 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 Ethereum RPC.
Métodos compatibles
El endpoint cubre las familias de métodos JSON-RPC de Ethereum estándar —
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_feeHistory, eth_maxPriorityFeePerGas), simulación de llamadas (eth_call, eth_callMany, eth_simulateV1), pruebas de estado (eth_getProof), filtros (eth_newFilter, eth_getFilterChanges), inspección del txpool (txpool_status, txpool_content), y suscripciones WebSocket (eth_subscribe, eth_unsubscribe).Para la lista completa de métodos con los formatos de solicitud y respuesta, consulta la Referencia de la API de Ethereum RPC.
Códigos de estado de respuesta
| Estado HTTP | Significado |
|---|---|
| 200 | Respuesta JSON-RPC del upstream. |
| 400 | Solicitud JSON-RPC inválida. |
| 401 | API key ausente o no autorizada. |
| 429 | Limitado por la política del RPC downstream. |
| 502 | Proxy no disponible. |
| 503 | Servicio RPC downstream no disponible. |
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 Ethereum 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.