¿Qué es una URL RPC pública de Base y cuándo deberías usar una?

Una URL RPC pública de Base es un endpoint HTTP compartido que permite a cualquier aplicación leer datos de la cadena Base y enviar transacciones sin ejecutar un nodo. La pegas en una billetera, un script o un SDK, y responde a llamadas JSON-RPC como eth_blockNumber, eth_getBalance y eth_sendRawTransaction. Es la forma más rápida de conectarse a Base, y también es el endpoint que la mayoría de los equipos supera primero.

Lo importante no es la definición. Es saber qué trabajos maneja bien un endpoint público, qué trabajos no, y a qué cambiar cuando tu aplicación deja de ser un prototipo. Esta página responde eso directamente, luego te da los detalles de conexión, ejemplos de solicitudes y una ruta de migración.

¿Es una URL RPC pública de Base la elección correcta para tu carga de trabajo?

Usa este triaje rápido antes de conectar algo a un código base que planeas lanzar.

Si estás en las primeras tres filas, un endpoint público es genuinamente la herramienta correcta y puedes dejar de leer después de la sección de conexión. Si estás en las últimas cuatro, el resto de este artículo explica qué cambia y cómo planificar la migración.

Qué significa realmente "público" para un endpoint de Base

Público no significa libre de reglas. Significa que el endpoint se opera para uso general en lugar de aprovisionarse para tu cuenta. De eso se derivan tres propiedades, y explican casi todos los problemas que los desarrolladores encuentran con endpoints públicos.

Es compartido. Tus solicitudes compiten con las de todos los demás. El rendimiento y la latencia varían con la demanda total, no con las necesidades de tu aplicación.

No hay compromiso de disponibilidad. Un endpoint público se ofrece tal cual. Puede limitar la tasa, estrangular ráfagas o devolver errores bajo carga. Eso es aceptable para una demo y riesgoso para un flujo de pago.

No hay ruta de soporte. Si una solicitud falla a las 2 a.m., no hay ticket, no hay página de estado vinculada a tu cuenta y no hay nadie a quien escalar. Lo depuras tú mismo.

Nada de esto hace que los endpoints públicos sean malos. Los convierte en una herramienta específica con un alcance específico.

Configuración de la cadena Base de un vistazo

Estos son los valores que necesitas para agregar Base o Base Sepolia a una billetera, SDK o archivo de configuración. Mantén el ID de cadena y la moneda nativa consistentes con la red que estás apuntando, porque mezclar configuraciones de mainnet y testnet es uno de los errores de configuración más comunes.

Para detalles específicos de la red y soporte de transporte, consulta la página de Base RPC y la página de Base Sepolia RPC.

Agregar Base a una billetera

La mayoría de las billeteras aceptan una red personalizada. Los campos se asignan directamente a la tabla anterior:

Network name:  Base
RPC URL:       https://base.api.onfinality.io/public
Chain ID:      8453
Symbol:        ETH
Explorer:      https://basescan.org

Para trabajo en testnet, cambia a los valores de Base Sepolia y usa el explorador de Sepolia. Si la billetera informa un desajuste de ID de cadena, casi con certeza has pegado una URL RPC de testnet con un ID de cadena de mainnet, o viceversa.

Llamar al endpoint con curl y viem

La verificación más simple es una llamada JSON-RPC sin procesar. Esto devuelve la altura de bloque actual:

curl -s https://base.api.onfinality.io/public \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

Una respuesta exitosa se ve como {"jsonrpc":"2.0","id":1,"result":"0x..."}. Si en su lugar obtienes un objeto de error JSON-RPC, lee los campos error.code y error.message antes de asumir que el endpoint está caído.

En el código de la aplicación, el mismo endpoint se conecta a cualquier cliente EVM. Con viem:

import { createPublicClient, http } from 'viem'
import { base } from 'viem/chains'

const client = createPublicClient({
  chain: base,
  transport: http('https://base.api.onfinality.io/public'),
})

const block = await client.getBlockNumber()
const balance = await client.getBalance({
  address: '0x0000000000000000000000000000000000000000',
})

console.log({ block, balance })

Debido a que el transporte es una URL HTTP simple, puedes cambiarlo por un endpoint gestionado o dedicado más adelante cambiando una cadena. Esa es la razón principal para mantener la URL RPC en una variable de entorno desde el primer día en lugar de codificarla en varios archivos.

Dónde empiezan a fallar los endpoints públicos

Las URL RPC públicas de Base fallan de manera predecible. Reconocer el síntoma te dice si tienes un error de código o un límite de infraestructura.

Si ves las primeras tres filas, el endpoint es la restricción, no tu código. Esa es la señal para planificar una migración en lugar de ajustar más tu aplicación.

Qué cambia cuando pasas a RPC gestionado o dedicado

El RPC gestionado te da un endpoint vinculado a tu cuenta, con una ruta de soporte y capacidad que no se comparte con tráfico anónimo. La infraestructura de nodo dedicado va más allá: obtienes un nodo aprovisionado para tu carga de trabajo, lo cual importa para indexación, sondeo de alta frecuencia, consultas de archivo y cualquier cosa que necesite un comportamiento consistente bajo carga.

OnFinality proporciona tanto acceso a la API RPC como infraestructura de nodo dedicado en una variedad de redes, incluida Base. Si estás evaluando opciones, la página de precios de RPC muestra cómo se estructuran los planes, y la lista de redes compatibles muestra lo que está disponible. Para un método de evaluación estructurado, consulta cómo elegir un proveedor de RPC.

Una lista de verificación práctica para la migración:

1. Mueve la URL RPC a una variable de entorno si aún no lo está.
2. Agrega un endpoint de respaldo y una política de reintentos con retroceso exponencial.
3. Registra la latencia de las solicitudes y las tasas de error para que puedas comparar antes y después.
4. Prueba consultas de archivo y registros contra el nuevo endpoint antes de hacer el cambio.
5. Ejecuta ambos endpoints en paralelo brevemente, luego cambia el tráfico.

Trabajo en testnet en Base Sepolia

Base Sepolia se comporta como mainnet para fines de herramientas, con un ID de cadena diferente y un faucet para gas. Usa el endpoint de testnet para CI, staging y ensayos de despliegue de contratos, y mantenlo separado de tu configuración de mainnet para que una variable de entorno mal configurada no pueda enviar transacciones de prueba a producción.

Un patrón útil es un único objeto de configuración indexado por entorno:

const RPC = {
  mainnet: 'https://base.api.onfinality.io/public',
  testnet: 'https://base-sepolia.api.onfinality.io/public',
}

const rpcUrl = RPC[process.env.CHAIN_ENV ?? 'testnet']

Esto mantiene el endpoint público como un valor predeterminado sensato para el trabajo local mientras hace que el endpoint de producción sea una elección explícita.

Puntos clave

• Una URL RPC pública de Base es un endpoint HTTP compartido para leer datos de Base y enviar transacciones, sin registro y sin compromiso de disponibilidad.
• Es la elección correcta para billeteras, scripts, prototipos e iteración en testnet.
• Es la elección incorrecta para dApps en producción, indexadores, bots y consultas pesadas de registros o archivo.
• Base mainnet usa el ID de cadena 8453; Base Sepolia usa 84532. Mantenlos en configuraciones separadas.
• Mantén la URL RPC en una variable de entorno para que migrar a RPC gestionado o dedicado sea un cambio de una línea.
• OnFinality ofrece acceso a la API RPC e infraestructura de nodo dedicado para Base y otras redes; consulta precios de RPC y redes compatibles.

Preguntas frecuentes

¿Es gratuita una URL RPC pública de Base? Se ofrece para uso general sin una cuenta, por lo que es conveniente para el desarrollo. Es infraestructura compartida, por lo que no está destinada a tráfico de producción o cargas de trabajo que necesitan capacidad consistente.

¿Cuál es el ID de cadena de Base? Base mainnet usa el ID de cadena 8453. Base Sepolia testnet usa el ID de cadena 84532. Usar el ID de cadena incorrecto con una URL RPC dada es una causa común de errores de conexión de billetera.

¿Puedo usar una URL RPC pública de Base en producción? Puedes, pero no deberías confiar en ella. Los endpoints compartidos pueden limitar la tasa o estrangular bajo carga, y no hay ruta de soporte si algo falla. Las aplicaciones en producción típicamente pasan a RPC gestionado o dedicado.

¿Por qué falla eth_getLogs en un endpoint público? Las consultas de registros son costosas. Los endpoints públicos a menudo restringen el rango de bloques que puedes consultar en una sola llamada. Reduce tu rango o usa un proveedor que admita consultas de archivo y de registros de rango amplio.

¿Cómo cambio de un endpoint público a uno gestionado? Cambia la URL RPC en tu configuración. Si la mantuviste en una variable de entorno y agregaste lógica de reintentos, la migración es un cambio de configuración en lugar de un cambio de código.

¿OnFinality admite Base? Sí. OnFinality proporciona acceso a la API RPC e infraestructura de nodo dedicado para Base y Base Sepolia, junto con muchas otras redes. Consulta la página de red Base para más detalles.