Resumen
Una URL RPC es la dirección HTTP o WebSocket que tu aplicación utiliza para enviar solicitudes JSON-RPC a un nodo de blockchain. Es la cadena de conexión que permite a billeteras, dApps, scripts y servicios backend leer el estado de la cadena, enviar transacciones y suscribirse a eventos. La URL en sí es solo la mitad de la configuración: también necesitas el ID de cadena correcto, el símbolo de la moneda y el explorador de bloques para configurar la billetera, y debes comprender qué métodos y cargas de trabajo admite el endpoint antes de confiar en él en producción.
Esta página explica qué es una URL RPC, cómo elegir entre endpoints públicos y gestionados, y cómo integrarla en herramientas comunes. También cubre los modos de fallo que aparecen cuando una URL RPC es incorrecta, está limitada por tasa o le faltan datos de archivo, y señala dónde encontrar endpoints para redes compatibles y opciones de nodos dedicados cuando las URL públicas compartidas ya no son suficientes.
Puntos clave
- Una URL RPC es el endpoint al que tu aplicación llama para leer y escribir datos de blockchain a través de JSON-RPC.
- Las URL RPC públicas son adecuadas para prototipos y configuración de billeteras, pero generalmente carecen de los límites de tasa, datos de archivo y soporte WebSocket que necesitan las aplicaciones en producción.
- La configuración de la billetera requiere más que una URL: el ID de cadena, el símbolo de la moneda y la URL del explorador deben coincidir con la red.
- La mayoría de los errores de URL RPC provienen de ID de cadena incorrectos, claves API caducadas, límites de tasa o métodos de archivo/trace faltantes.
- Los servicios RPC gestionados y los nodos dedicados te brindan capacidad predecible y soporte cuando los endpoints compartidos se convierten en un cuello de botella.
- OnFinality proporciona acceso a la API RPC e infraestructura de nodos dedicados en las redes compatibles; consulta la página de la red para conocer los endpoints y características exactas.
El significado de URL RPC en un minuto
RPC significa llamada a procedimiento remoto. En el desarrollo de blockchain, una URL RPC es la dirección de un nodo que acepta solicitudes JSON-RPC. Tu código envía una solicitud como eth_blockNumber o eth_getBalance a esa URL, y el nodo devuelve el resultado. La misma URL también puede aceptar conexiones WebSocket si el proveedor admite suscripciones.
Una URL RPC típica se ve como https://provider.example.com/v1/<api-key> o wss://provider.example.com/ws. El esquema indica si es HTTP o WebSocket, el host apunta al proveedor o a tu propio nodo, y la ruta a menudo contiene una clave API o ID de proyecto. Trata la URL completa como un secreto cuando incluya una clave: cualquiera que la tenga puede consumir tu cuota.
- URL RPC HTTP: se utiliza para llamadas de solicitud/respuesta como leer saldos, enviar transacciones y consultar registros.
- URL RPC WebSocket: se utiliza para suscripciones como nuevos bloques, transacciones pendientes y eventos de contratos.
- ID de cadena: no forma parte de la URL, pero es requerido por billeteras y muchos SDK para confirmar qué red sirve el endpoint.
Pública, gestionada o dedicada: qué URL RPC se adapta a tu carga de trabajo
La URL RPC adecuada depende de quién la usa y qué sucede cuando falla. Un endpoint público es conveniente para un script rápido o la configuración de una billetera, pero se comparte con muchos otros usuarios y puede no admitir consultas de archivo, métodos trace o suscripciones WebSocket. Un servicio RPC gestionado te proporciona un endpoint con clave, límites documentados y soporte. Un nodo dedicado te brinda infraestructura aislada cuando necesitas capacidad predecible o configuración personalizada.
Utiliza la siguiente tabla para adaptar tu carga de trabajo al tipo de endpoint. Si no estás seguro, comienza con un endpoint gestionado y pasa a un nodo dedicado cuando puedas medir una presión constante en los límites de tasa o cuando necesites datos de archivo que los endpoints compartidos no proporcionan.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Prototipos y scripts | URL RPC pública o nivel gratuito de un servicio gestionado | Bajo costo de configuración y sin compromiso mientras validas la idea |
| Configuración de billetera y dApp | Endpoint gestionado estable con ID de cadena y explorador documentados | Los usuarios necesitan una URL confiable que no cambie inesperadamente |
| Tráfico de dApp en producción | Plan RPC gestionado con límites de tasa, acceso a archivo y soporte WebSocket | Los endpoints públicos compartidos pueden limitar o descartar solicitudes bajo carga |
| Indexadores y analítica | Acceso a nodo de archivo y límites de eth_getLogs | Las consultas históricas fallan en nodos podados o endpoints con límites estrictos de registros |
| Sistemas de alto volumen o sensibles a la latencia | Nodo dedicado con recursos aislados | El aislamiento reduce los efectos de vecinos ruidosos y te da control sobre las actualizaciones |
Configuración de la cadena de un vistazo
Cuando agregas una red a una billetera o configuras un SDK, la URL RPC es solo un campo. El ID de cadena debe coincidir con la red, o las transacciones se firmarán para la cadena incorrecta. El símbolo de la moneda se usa para mostrar, y la URL del explorador de bloques ayuda a los usuarios a verificar transacciones. Para redes EVM, estos valores están estandarizados por cadena; para redes no EVM, el modelo de configuración es diferente y debes seguir la documentación específica de la red.
La siguiente tabla muestra los campos que la mayoría de las billeteras solicitan. Siempre confirma los valores con la documentación oficial de la red o la página de red de OnFinality antes de guardar una configuración.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| URL RPC | Endpoint HTTP de tu proveedor o nodo | La dirección que tu billetera o aplicación usa para llamadas JSON-RPC |
| ID de cadena | ID de cadena numérico para la red | Evita que las transacciones se firmen para la cadena incorrecta |
| Símbolo de la moneda | Símbolo del token nativo de gas | Utilizado por las billeteras para mostrar saldos y comisiones |
| URL del explorador de bloques | Explorador oficial de la red | Permite a los usuarios inspeccionar transacciones y direcciones |
Conectar una URL RPC en el código
La mayoría de las bibliotecas JavaScript aceptan una URL RPC como una cadena. El siguiente ejemplo utiliza un marcador de posición genérico porque el endpoint exacto depende de la red y el proveedor que elijas. Reemplaza el marcador de posición con la URL RPC HTTP de tu proveedor o tu propio nodo, y mantén las claves API en variables de entorno en lugar de en el control de código fuente.
Para llamadas de solo lectura, un único proveedor HTTP suele ser suficiente. Para aplicaciones que necesitan suscripciones a eventos, utiliza una URL WebSocket y maneja las reconexiones. Si usas ethers o viem, la abstracción del proveedor maneja el formato JSON-RPC, pero no oculta los límites de tasa ni las restricciones de métodos.
- Almacena la URL RPC en una variable de entorno como RPC_URL.
- Utiliza una URL WebSocket separada para suscripciones si tu proveedor ofrece una.
- Registra los códigos y mensajes de error JSON-RPC para distinguir los límites de tasa de las solicitudes inválidas.
- Configura tiempos de espera y reintentos con retroceso exponencial para errores de red transitorios.
Ruta de depuración: fallos comunes de URL RPC
Cuando una URL RPC deja de funcionar, el síntoma generalmente apunta a una causa específica. Una respuesta 401 o 403 a menudo significa que la clave API falta, ha caducado o está restringida por origen. Una respuesta 429 significa que alcanzaste un límite de tasa. Un error de método no encontrado significa que el endpoint no admite ese método JSON-RPC, lo cual es común para llamadas de archivo o trace en endpoints compartidos. Una discrepancia en el ID de cadena se manifiesta como transacciones fallidas o saldos que aparecen vacíos en una billetera.
Revisa los síntomas en orden. Primero confirma que la URL es accesible con una simple solicitud curl. Luego verifica la autenticación, los límites de tasa, el soporte de métodos y finalmente la configuración de la cadena. Si el endpoint es una URL pública, asume que puede estar limitada por tasa o obsoleta sin previo aviso y pasa a un endpoint gestionado para cualquier cosa más allá de pruebas.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| 401 o 403 | Clave API presente, correcta y permitida para este origen | Los fallos de autenticación bloquean todas las solicitudes |
| 429 | Tasa de solicitudes y límites del plan | Los límites de tasa causan fallos intermitentes bajo carga |
| Método no encontrado | Soporte de métodos de archivo, trace o debug | Los endpoints compartidos a menudo deshabilitan métodos costosos |
| Saldos incorrectos o transacciones fallidas | ID de cadena y configuración de red | Un ID de cadena incorrecto apunta la aplicación a la red equivocada |
| Tiempos de espera | Salud del endpoint y ruta de red | Los nodos lentos o inaccesibles interrumpen los flujos de usuario |
Cuándo pasar de una URL RPC pública a infraestructura gestionada
Las URL RPC públicas son útiles para aprender y hacer pruebas rápidas, pero no están diseñadas para tráfico de producción. A medida que tu aplicación crece, es probable que necesites límites de solicitudes más altos, datos de archivo para consultas históricas, suscripciones WebSocket y un canal de soporte cuando algo falla. Un servicio RPC gestionado proporciona estas características con un endpoint con clave y límites documentados. Un nodo dedicado va más allá al aislar recursos para tu carga de trabajo.
OnFinality proporciona acceso a la API RPC e infraestructura de nodos dedicados en las redes compatibles. Puedes revisar las redes compatibles para encontrar el endpoint y el conjunto de características de tu cadena, comparar los precios de RPC para el volumen de solicitudes y el acceso a archivo, y elegir nodos dedicados cuando necesites capacidad aislada. La elección correcta depende de tus patrones de solicitud, requisitos de datos y cuánto control operativo desees.
- Pasa a un endpoint gestionado cuando veas respuestas 429 repetidas o necesites métodos de archivo.
- Considera un nodo dedicado cuando necesites rendimiento predecible o configuración personalizada del nodo.
- Consulta la página de la red para obtener configuraciones específicas de la cadena y métodos admitidos antes de migrar.
- Mantén una URL RPC de respaldo configurada para que el fallo de un solo endpoint no derribe tu aplicación.
Preguntas frecuentes
¿Qué es una URL RPC en términos simples?
Una URL RPC es la dirección web de un nodo de blockchain al que tu aplicación llama para leer datos o enviar transacciones. Funciona como un endpoint de API: envías una solicitud JSON-RPC a la URL y recibes una respuesta.
¿Es una URL RPC lo mismo que una clave API?
No. La URL RPC es la dirección del endpoint. Una clave API es una credencial que puede incluirse en la ruta de la URL o enviarse como encabezado. Algunos endpoints públicos no requieren clave, mientras que los servicios gestionados suelen emitir una clave para rastrear el uso y aplicar límites.
¿Puedo usar una URL RPC pública en producción?
Las URL RPC públicas son mejores para pruebas y uso de bajo volumen. A menudo son compartidas, tienen límites de tasa y pueden no admitir métodos de archivo o WebSocket. Para producción, utiliza un servicio RPC gestionado o un nodo dedicado con límites documentados y soporte.
¿Por qué mi billetera dice que la URL RPC no es válida?
Las causas comunes incluyen una clave API faltante o caducada, una URL HTTP donde se requiere una URL WebSocket, un error tipográfico en el host o la ruta, o un ID de cadena que no coincide con la red. Verifica la URL con una simple solicitud curl y confirma la configuración de la cadena con la documentación oficial de la red.
¿Cómo encuentro la URL RPC para una red específica?
Consulta la documentación oficial para desarrolladores de la red o la página de redes compatibles de OnFinality. Para redes EVM, los detalles del ID de cadena y del explorador suelen aparecer junto con la URL RPC. Evita copiar endpoints de fuentes no oficiales sin verificarlos.
Ethereum
Solana
Polygon
Base
Arbitrum
BNB Chain
Polkadot
Optimism
