Resumen
El endpoint RPC de la red Base es la URL que tu dApp o billetera utiliza para comunicarse con la blockchain de Base. OnFinality proporciona un endpoint HTTPS público en https://base.api.onfinality.io/public, que puedes usar para enviar solicitudes JSON-RPC para leer datos o enviar transacciones. Este artículo explica el endpoint, la configuración de la cadena, cómo configurar tus herramientas y cómo depurar problemas comunes.
Referencia rápida: Configuración de la cadena Base
Antes de conectarte, necesitas los parámetros exactos de la cadena. La siguiente tabla enumera la configuración oficial para la red principal de Base y su red de pruebas Sepolia. Usa estos valores al configurar billeteras, SDK o tu propio nodo.
| Parámetro | Base Mainnet | Base Sepolia Testnet |
|---|---|---|
| ID de cadena | 8453 | 84532 |
| Nombre de la red | Base | Base Sepolia Testnet |
| Moneda nativa | ETH (18 decimales) | Sepolia ETH (18 decimales) |
| URL RPC pública | https://base.api.onfinality.io/public | https://base-sepolia.api.onfinality.io/public |
| Explorador de bloques | https://basescan.org | https://sepolia.basescan.org |
| Transporte | HTTPS | HTTPS |
Estos valores son los mismos que utilizan las billeteras y proveedores de infraestructura populares. Si estás creando una aplicación de producción, probablemente querrás un endpoint RPC gestionado o dedicado en lugar del público, que tiene límites de velocidad y es compartido. OnFinality ofrece precios de RPC para mayor rendimiento y fiabilidad.
Guía de decisión: ¿Qué endpoint deberías usar?
Tu elección de endpoint depende de tu etapa y tráfico:
- Prototipado o hackathon: Usa el endpoint público
https://base.api.onfinality.io/public. Es gratuito y funciona para volúmenes pequeños de solicitudes. - dApp de producción con tráfico moderado: Usa un servicio RPC gestionado como el RPC de la red Base de OnFinality. Obtienes límites de velocidad más altos, múltiples endpoints y conmutación por error.
- Cargas de trabajo de alto rendimiento o intensivas en datos: Considera un nodo dedicado para Base. Esto te da acceso exclusivo a un nodo, evitando vecinos ruidosos y permitiendo consultas pesadas de
eth_getLogso de archivo. - Desarrollo en testnet: Usa el endpoint de Base Sepolia
https://base-sepolia.api.onfinality.io/publicpara probar sin arriesgar fondos de mainnet.
Si no estás seguro, comienza con el endpoint público y monitorea tu volumen de solicitudes. Cuando te acerques a los límites de velocidad o necesites una latencia constante, cambia a un plan de pago.
¿Qué es el endpoint RPC de la red Base?
El endpoint RPC de la red Base es una URL que acepta solicitudes JSON-RPC a través de HTTPS. Permite que tu aplicación lea datos de la blockchain (saldos, recibos de transacciones, estado de contratos) y envíe transacciones. El endpoint es el punto de entrada a la blockchain de Base, que es una red de capa 2 de Ethereum construida con OP Stack.
OnFinality proporciona un endpoint público para la red principal de Base: https://base.api.onfinality.io/public. Este endpoint es gratuito pero tiene límites de velocidad. Para producción, debes usar un endpoint dedicado o gestionado de un proveedor como OnFinality.
Cómo configurar tu billetera
Para agregar Base a una billetera como MetaMask, usa la configuración de la cadena de la tabla anterior. Aquí tienes una configuración típica:
- Nombre de la red: Base
- Nueva URL RPC:
https://base.api.onfinality.io/public - ID de cadena: 8453
- Símbolo de moneda: ETH
- URL del explorador de bloques:
https://basescan.org
Para Base Sepolia, usa los valores de la testnet. Esto te permite interactuar con dApps y probar contratos.
Usar el endpoint con ethers.js
En ethers.js, puedes crear un proveedor usando la URL del endpoint. Aquí tienes un ejemplo:
const { ethers } = require("ethers");
const provider = new ethers.JsonRpcProvider("https://base.api.onfinality.io/public");
async function getBlockNumber() {
const blockNumber = await provider.getBlockNumber();
console.log("Número de bloque actual:", blockNumber);
}
getBlockNumber();
Este proveedor se puede usar para leer datos o firmar y enviar transacciones. Para producción, reemplaza la URL con tu endpoint gestionado.
Usar el endpoint con viem
Viem es una biblioteca moderna de TypeScript. Así es como se crea un cliente:
import { createPublicClient, http } from 'viem';
import { base } from 'viem/chains';
const client = createPublicClient({
chain: base,
transport: http('https://base.api.onfinality.io/public')
});
const blockNumber = await client.getBlockNumber();
console.log(blockNumber);
Viem incluye definiciones de cadena para Base, por lo que solo necesitas proporcionar la URL de transporte.
Enviar una solicitud JSON-RPC sin procesar con curl
Puedes probar el endpoint directamente con curl. Aquí tienes un ejemplo que obtiene el último número de bloque:
curl https://base.api.onfinality.io/public \
-X POST \
-H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
La respuesta será un objeto JSON con el número de bloque en hexadecimal. Esta es una forma rápida de verificar la conectividad.
Depuración de problemas comunes de RPC
Cuando trabajes con Base RPC, puedes encontrar errores. Aquí hay síntomas comunes y soluciones:
| Síntoma | Causa probable | Solución |
|---|---|---|
ECONNREFUSED o tiempo de espera | Endpoint inalcanzable o problema de red | Verifica tu conexión a Internet y la URL. Prueba con un proveedor diferente. |
429 Too Many Requests | Límite de velocidad excedido en el endpoint público | Usa un plan de pago o un nodo dedicado. Reduce la frecuencia de solicitudes. |
Errores -32000 o -32005 | Solicitud no válida o método no compatible | Verifica el método JSON-RPC y los parámetros. Comprueba el ID de cadena. |
nonce too low | El nonce de la transacción está desactualizado | Actualiza el nonce usando eth_getTransactionCount con el último bloque. |
insufficient funds | El saldo de la billetera es demasiado bajo | Financia la billetera con ETH en Base. |
Para obtener más detalles sobre la resolución de problemas, consulta nuestra guía de resolución de problemas de RPC.
Lista de verificación para producción
Antes de implementar en mainnet, revisa esta lista:
- Usa un endpoint RPC gestionado o dedicado, no el público.
- Configura monitoreo para fallos de solicitudes y latencia.
- Implementa lógica de reintento con retroceso exponencial.
- Usa WebSocket para suscripciones en tiempo real si es necesario.
- Prueba primero en Base Sepolia.
- Asegúrate de que tu ID de cadena sea correcto (8453 para mainnet).
- Verifica que tu proveedor admita los métodos que necesitas (por ejemplo,
eth_getLogspara indexación de eventos).
La página de la red Base de OnFinality proporciona más detalles sobre las características y planes disponibles.
Conclusiones clave
- El endpoint RPC de la red principal de Base es
https://base.api.onfinality.io/publiccon ID de cadena 8453. - Para producción, usa un proveedor RPC gestionado o dedicado para evitar límites de velocidad y garantizar la fiabilidad.
- Configura billeteras y SDK con la configuración de cadena correcta.
- Usa curl o bibliotecas como ethers/viem para interactuar con el endpoint.
- Depura problemas comunes verificando límites de velocidad, nonces y conectividad de red.
Preguntas frecuentes
¿Cuál es el endpoint RPC de la red Base?
El endpoint RPC de la red Base es la URL utilizada para enviar solicitudes JSON-RPC a la blockchain de Base. OnFinality proporciona un endpoint público en https://base.api.onfinality.io/public.
¿Es gratuito el endpoint RPC público de Base?
Sí, el endpoint público es gratuito, pero tiene límites de velocidad. Para producción, considera un plan de pago.
¿Cuál es el ID de cadena de Base?
El ID de cadena para la red principal de Base es 8453. Para la red de pruebas Base Sepolia, es 84532.
¿Cómo agrego Base a MetaMask?
Usa la configuración de la cadena de la tabla anterior: URL RPC https://base.api.onfinality.io/public, ID de cadena 8453, símbolo ETH y explorador https://basescan.org.
¿Qué debo hacer si recibo un error 429?
Un error 429 significa que excediste el límite de velocidad. Mejora a un servicio RPC gestionado o dedicado, o reduce la frecuencia de tus solicitudes.
¿Puedo usar WebSocket con Base?
Sí, pero el endpoint público solo admite HTTPS. Para WebSocket, necesitas un proveedor que lo ofrezca, como los nodos dedicados de OnFinality.
¿Dónde puedo encontrar más información sobre Base RPC?
Visita la página de la red Base en OnFinality para obtener detalles sobre endpoints, planes y características.