Documentación del endpoint RPC de Base | ERPC

Documentación del endpoint RPC de Base

Usa ERPC como tu endpoint RPC de Base para solicitudes HTTP JSON-RPC y suscripciones WebSocket. Base 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, Ethereum y Avalanche.
Añade tu API key al parámetro api-key.

Endpoints

Envía solicitudes JSON-RPC 2.0 como HTTP POST a:
text
https://base.erpc.global?api-key=<YOUR_API_KEY>
Para suscripciones, conéctate por WebSocket a:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>
Las solicitudes solo se aceptan en /.

Ejemplos

Este es un ejemplo de solicitud HTTP.
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
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. Cada llamada en un lote se mide como una llamada individual.

Uso de tokens

El uso se mide en tokens por llamada JSON-RPC. Cada entrada en un lote HTTP y cada llamada JSON-RPC enviada por una conexión WebSocket se mide por separado.

Límites del Plan Free

En el Plan Free, tu cuenta puede enviar una solicitud cada 10 segundos. El límite se contabiliza por cuenta, no por endpoint, así que una solicitud a otra chain también puede contar para él. Una solicitud enviada antes se responde con HTTP 429, y el header retry-after indica la espera en segundos.
En el Plan Free, una solicitud que lleva dos o más llamadas JSON-RPC se responde con HTTP 429, y ninguna de sus llamadas se envía: cada llamada recibe un error JSON-RPC con el código -32041. Envía estas llamadas de una en una.
En el Plan Free, las conexiones WebSocket no están disponibles y se responden con HTTP 403.

Métodos compatibles

Base es compatible con EVM y usa los mismos métodos JSON-RPC que Ethereum. ERPC no aplica una lista fija de métodos permitidos al endpoint de Base. Para las familias de métodos de Ethereum, consulta la Documentación del endpoint RPC de Ethereum.

Códigos de estado de respuesta

Estado HTTPSignificado
200Respuesta JSON-RPC del upstream.
400Missing API key, Invalid JSON-RPC request o JSON-RPC batch exceeds 256 calls.
401Unauthorized API KEY.
403Una conexión WebSocket en el Plan Free.
404Una ruta distinta de /.
429Limitado por tasa, incluidos los límites del Plan Free indicados arriba: más de una solicitud cada 10 segundos, o dos o más llamadas en una solicitud. El header retry-after indica el tiempo de espera en segundos.
502No se pudo completar la solicitud RPC upstream.
503El servicio no está disponible temporalmente.
Las conexiones WebSocket usan 101 (actualización de protocolo aceptada) además de los códigos anteriores.

Métodos y documentación de Base RPC

Para la lista completa de métodos estándar, parámetros y especificaciones, consulta la documentación oficial.