¿Cuál es el endpoint RPC de Unichain y cómo lo uso?

Lista de verificación para decisiones RPC de Unichain

Antes de apuntar una wallet, indexador o dApp a Unichain, confirma estos detalles:

• ID de cadena: mainnet es 130 (0x82). Los IDs de testnet son diferentes y deben confirmarse con la documentación de Uniswap o Chainlist.
• Tipo de endpoint: los endpoints públicos son adecuados para prototipos; las aplicaciones de producción necesitan un endpoint RPC gestionado o dedicado.
• Soporte de WebSocket: si necesitas eth_subscribe para transacciones pendientes o logs, verifica que el proveedor exponga una URL wss://.
• Datos de archivo: las consultas de estado histórico requieren un nodo con capacidad de archivo. Verifica si el proveedor ofrece acceso de archivo.
• Límites de tasa: los endpoints públicos pueden limitar las solicitudes por segundo. Revisa la política de uso del proveedor antes del lanzamiento.
• Token de gas y explorador: ETH es el token de gas. Usa el explorador oficial o Blockscout para verificación.

Después de la lista de verificación, ten esta referencia a mano: eth_chainId debería devolver 0x82 en mainnet de Unichain.

¿Qué es Unichain?

Unichain es un rollup de Capa 2 de Ethereum construido por Uniswap Labs sobre OP Stack. Está diseñado para cargas de trabajo DeFi, con bloques rápidos, costos de transacción más bajos y acceso más fácil a liquidez entre cadenas. Debido a que es parte de Superchain, comparte el mismo modelo de seguridad amplio que otras cadenas OP Stack y puede interoperar con ellas con el tiempo.

Para los consumidores de RPC, el detalle más relevante es que Unichain es compatible con EVM. Expone la misma superficie JSON-RPC que Ethereum, Optimism y Base. Un contrato que se ejecuta en Ethereum se comportará de la misma manera en Unichain, sujeto al propio mercado de tarifas y producción de bloques del rollup. La red usa ETH como moneda nativa, por lo que la configuración de la wallet es simple: ID de cadena 130, símbolo ETH y una URL de explorador.

Los aspectos técnicos destacados de Unichain incluyen tiempos de bloque de 1 segundo, con ciertos mecanismos de preconfirmación disponibles a través de Flashblocks. Esto lo hace adecuado para aplicaciones donde la latencia importa, como agregadores, bots de arbitraje e interfaces DEX. La compensación es que estas cargas de trabajo también necesitan un proveedor de RPC que pueda mantenerse al día con el sondeo frecuente y las suscripciones WebSocket.

Configuración de red de Unichain

Usa estos valores al agregar Unichain a una wallet, subgrafo o dApp.

El ID de cadena hexadecimal es útil al configurar redes que esperan valores hexadecimales. Verifica la red llamando a eth_chainId y comprobando que el resultado sea 0x82.

Para implementaciones de testnet, usa la documentación para desarrolladores de Uniswap para encontrar el ID de cadena de Sepolia actual, la URL RPC y cualquier detalle de token de prueba. La configuración de testnet puede cambiar durante el desarrollo, así que no la codifiques sin verificar primero.

Endpoints RPC públicos y gestionados de Unichain

Puedes comenzar a llamar a Unichain en minutos con un endpoint RPC público. Estas URL son mantenidas por diferentes proveedores y son útiles para pruebas:

• https://unichain.api.onfinality.io/public — endpoint público de Unichain de OnFinality
• https://mainnet.unichain.org — endpoint público oficial de Unichain
• https://unichain-rpc.publicnode.com — endpoint HTTP de PublicNode
• wss://unichain-rpc.publicnode.com — endpoint WebSocket de PublicNode
• https://unichain.drpc.org — endpoint HTTP de dRPC

Los endpoints públicos son compartidos por muchos usuarios. Son una forma rápida de validar un script o ejecutar una demo de hackathon, pero no son una base confiable para un servicio de producción. Los límites de uso, la latencia de solicitudes y la disponibilidad de datos pueden variar.

Una API RPC gestionada te brinda una clave de API dedicada, límites configurables y una ruta de soporte consistente. El servicio API de OnFinality proporciona acceso RPC a Unichain junto con muchas otras redes. Si tu carga de trabajo necesita capacidad aislada, un nodo dedicado te brinda tu propia instancia en lugar de un endpoint compartido.

Antes de comprometerte con un proveedor, consulta la página de redes RPC compatibles para ver qué está habilitado actualmente para Unichain y qué funciones están disponibles, como WebSocket, datos de archivo y métodos de rastreo.

Haz tu primera llamada RPC a Unichain

Comienza con eth_chainId para confirmar que el endpoint apunta a Unichain.

curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' https://unichain.api.onfinality.io/public

La respuesta debería ser:

{"jsonrpc":"2.0","id":1,"result":"0x82"}

A continuación, obtén el número de bloque más reciente:

curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":2}' https://unichain.api.onfinality.io/public

El resultado es un número de bloque codificado en hexadecimal. También puedes leer el saldo de una cuenta con eth_getBalance:

curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x0000000000000000000000000000000000000000","latest"],"id":3}' https://unichain.api.onfinality.io/public

Para aplicaciones más grandes, usa una biblioteca de JavaScript como viem para mantener el código legible:

import { createPublicClient, http } from 'viem'

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

const chainId = await client.getChainId()
const blockNumber = await client.getBlockNumber()

console.log({ chainId, blockNumber })

Estas llamadas funcionan con cualquier herramienta compatible con Ethereum. El mismo patrón se aplica a eth_call, eth_sendRawTransaction y eth_getLogs.

Qué verificar al elegir un proveedor de RPC de Unichain

Una sola URL RPC no es una decisión de infraestructura completa. La tabla a continuación proporciona un punto de partida para comparar proveedores.

Los precios de RPC de OnFinality enumeran los planes actuales, y la página de redes RPC compatibles muestra el conjunto de funciones para Unichain. Si estás evaluando múltiples proveedores, ejecuta las mismas llamadas JSON-RPC anteriores en cada endpoint y compara latencia, tasas de error y forma de respuesta.

Errores comunes de RPC de Unichain y solución de problemas

La wallet muestra la red incorrecta

Verifica que la configuración de tu wallet use el ID de cadena 130. Llamar a eth_chainId debería devolver 0x82. La mayoría de los errores de wallet provienen de mezclar los ID de cadena de testnet y mainnet.

Las solicitudes fallan aleatoriamente

Los endpoints públicos compartidos pueden rechazar solicitudes cuando se alcanzan los límites de tasa. Reintenta con retroceso, o cambia a una API RPC gestionada antes del lanzamiento.

Las conexiones WebSocket se caen

Si usas eth_subscribe, asegúrate de que el proveedor admita WebSocket y de que te estés reconectando con una estrategia de retroceso. No intentes reutilizar una URL RPC HTTPS para suscripciones WebSocket.

Las transacciones se atascan o se descartan

En redes L2, la estimación de tarifas puede ser diferente a la de Ethereum. Usa eth_estimateGas antes de enviar transacciones y monitorea las condiciones de la red a través de una suscripción WebSocket.

Errores de nonce

Al enviar transacciones en paralelo, usa un administrador de transacciones local y actualiza el nonce después de cada confirmación. Los errores comunes incluyen "nonce too low" y "replacement transaction underpriced".

Faltan datos históricos

Si tu consulta no devuelve nada para bloques antiguos, el nodo puede no mantener datos de archivo. Elige un proveedor con soporte de archivo cuando necesites estado histórico.

Explorador de bloques incorrecto en la aplicación

Unichain tiene múltiples exploradores, incluidos Uniscan y Blockscout. Usa la URL de explorador correcta en tus enlaces de interfaz para que los usuarios lleguen a la transacción correcta.

Conclusiones clave

• Unichain es un L2 de Ethereum basado en OP Stack con soporte estándar de JSON-RPC de Ethereum.
• El ID de cadena de mainnet es 130 (0x82), y la moneda nativa es ETH.
• Usa un endpoint RPC público para pruebas rápidas, pero planea migrar a una API gestionada para producción.
• Valida el soporte de WebSocket, datos de archivo, límites de tasa y precios del proveedor antes de comprometerte.
• OnFinality ofrece un endpoint RPC público de Unichain, acceso a API RPC gestionada y opciones de nodos dedicados; consulta precios de RPC y redes RPC compatibles para obtener detalles actuales.

Preguntas frecuentes

¿Unichain soporta JSON-RPC de Ethereum?

Sí. Unichain soporta los mismos métodos JSON-RPC principales que Ethereum, incluyendo eth_call, eth_getBalance, eth_getLogs y eth_sendRawTransaction. Los métodos de rollup de OP Stack también están disponibles.

¿Cuál es la URL RPC para mainnet de Unichain?

Hay varias opciones públicas. Una es https://unichain.api.onfinality.io/public, y otra es https://mainnet.unichain.org. Para cargas de trabajo de producción, usa una API RPC gestionada o un nodo dedicado.

¿Cuál es el ID de cadena de Unichain?

Mainnet de Unichain usa el ID de cadena 130. En hexadecimal, esto es 0x82. La configuración de testnet es diferente, así que confírmala en la documentación para desarrolladores de Uniswap.

¿Puedo llamar a Unichain con viem o ethers.js?

Sí. Ambas bibliotecas soportan Unichain porque es compatible con EVM. Obtén un proveedor con cualquier URL RPC de Unichain y comienza a llamar métodos estándar.

¿Necesito una clave de API para usar RPC de Unichain?

El endpoint público de OnFinality acepta solicitudes anónimas. Los productos de API gestionada requieren una clave y ofrecen límites más altos. Consulta precios de RPC para opciones actuales.

¿Cómo obtengo ETH de testnet de Unichain?

Los faucets y la distribución de tokens de prueba cambian con el tiempo. Consulta la documentación oficial para desarrolladores de Unichain para obtener el faucet de testnet actual o pregunta en la comunidad de desarrolladores de Uniswap.