Resumen
Unichain es una red de capa 2 de Ethereum construida sobre OP Stack, diseñada para transacciones DeFi rápidas y de bajo costo. Para interactuar con ella, necesitas un endpoint RPC, ya sea uno público para pruebas o uno privado y dedicado para cargas de trabajo de producción. Esta guía cubre la configuración de la cadena, ejemplos de conexión y cómo elegir la infraestructura adecuada.
Recomendación rápida: Endpoint de Unichain público vs dedicado
Antes de entrar en la configuración, decide qué tipo de endpoint se adapta a tu caso de uso. Para un prototipo rápido o un hackathon, el endpoint público es suficiente. Para una dApp de producción, un nodo dedicado te ofrece un rendimiento predecible y evita los límites de tasa de la infraestructura compartida.
| Caso de uso | Endpoint recomendado | Por qué |
|---|---|---|
| Pruebas en Sepolia | Endpoint público de testnet | Gratuito, bajo volumen, fácil configuración |
| dApp en mainnet con tráfico ligero | Endpoint público de mainnet | Simple, sin costo, pero compartido |
| dApp de producción con tráfico intenso | Nodo dedicado | Rendimiento consistente, sin vecinos ruidosos |
| Indexación o análisis | Nodo de archivo dedicado | Acceso al estado histórico |
Si necesitas un nodo dedicado, consulta la página de la red Unichain para conocer la disponibilidad y las opciones de aprovisionamiento. Para detalles de precios, consulta precios de RPC.
¿Qué es Unichain y por qué importa el endpoint?
Unichain es una red de capa 2 de Ethereum construida sobre OP Stack, lanzada por Uniswap Labs para proporcionar transacciones rápidas y de bajo costo para aplicaciones DeFi. Utiliza rollups optimistas para escalar Ethereum, con un enfoque en mejorar la liquidez y la eficiencia del comercio.
El endpoint es la URL que tu aplicación utiliza para enviar solicitudes JSON-RPC a la red. Es la puerta de entrada para leer datos de la blockchain, enviar transacciones e interactuar con contratos inteligentes. Elegir el endpoint correcto afecta la latencia, la fiabilidad y el costo.
Configuración de la cadena Unichain de un vistazo
Aquí están los parámetros clave de la red que necesitas para configurar tu billetera o dApp:
| Parámetro | Valor |
|---|---|
| Nombre de la red | Unichain |
| Chain ID | 130 |
| Moneda nativa | ETH (Ether) |
| Explorador de bloques | https://uniscan.xyz |
| URL RPC pública | https://unichain.api.onfinality.io/public |
Para la testnet de Sepolia, usa el Chain ID 1301 y el explorador https://unichain-sepolia.blockscout.com.
Cómo conectarse a Unichain: Configuración de billetera y dApp
Añadir Unichain a MetaMask
- Abre MetaMask y haz clic en el menú desplegable de redes.
- Haz clic en "Añadir red" e introduce los detalles de la tabla anterior.
- Guarda y cambia a la red Unichain.
Usando ethers.js (v6)
import { ethers } from 'ethers';
const provider = new ethers.JsonRpcProvider('https://unichain.api.onfinality.io/public');
// Obtener el número del último bloque
const blockNumber = await provider.getBlockNumber();
console.log('Último bloque:', blockNumber);
Usando viem
import { createPublicClient, http } from 'viem';
const client = createPublicClient({
chain: {
id: 130,
name: 'Unichain',
nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
rpcUrls: { default: { http: ['https://unichain.api.onfinality.io/public'] } },
},
transport: http(),
});
const blockNumber = await client.getBlockNumber();
console.log('Último bloque:', blockNumber);
Métodos JSON-RPC y ejemplos
Unichain admite métodos JSON-RPC estándar de Ethereum. Aquí tienes un ejemplo con curl para obtener el último bloque:
curl -X POST https://unichain.api.onfinality.io/public \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
Respuesta esperada:
{"jsonrpc":"2.0","id":1,"result":"0x1a2b3c"}
Otros métodos comunes incluyen eth_getBalance, eth_call, eth_sendRawTransaction y eth_getLogs. Para una lista completa, consulta la especificación JSON-RPC de Ethereum.
Depuración de problemas comunes de conexión
Si tienes problemas para conectarte, verifica estos errores comunes:
| Síntoma | Causa probable | Solución |
|---|---|---|
| Tiempo de espera agotado | Cortafuegos de red o URL incorrecta | Verifica la URL y revisa la configuración de tu cortafuegos |
| Chain ID no válido | Billetera configurada con un Chain ID incorrecto | Usa 130 para mainnet, 1301 para Sepolia |
| Límite de tasa excedido | Demasiadas solicitudes al endpoint público | Cambia a un nodo dedicado o implementa caché |
| Transacción no minada | Gas insuficiente o problemas de nonce | Revisa el precio del gas y el nonce |
Cuándo pasar a un nodo Unichain dedicado
Los endpoints públicos son convenientes pero compartidos. Si tu aplicación experimenta alguno de los siguientes problemas, considera un nodo dedicado:
- Alto volumen de solicitudes que alcanza los límites de tasa
- Necesidad de baja latencia consistente
- Requisitos de datos de archivo o métodos de rastreo
- Necesidades de cumplimiento o seguridad para infraestructura privada
OnFinality ofrece nodos dedicados para Unichain, brindándote un endpoint privado con recursos dedicados. Visita la página de la red Unichain para obtener más información.
Conclusiones clave
- Unichain es una L2 de Ethereum basada en OP Stack con Chain ID 130.
- Usa el endpoint público
https://unichain.api.onfinality.io/publicpara pruebas y uso ligero. - Para producción, evalúa nodos dedicados para evitar límites de tasa y garantizar el rendimiento.
- Siempre verifica la configuración de la cadena y usa el endpoint correcto para mainnet vs testnet.
Preguntas frecuentes
¿Cuál es el endpoint RPC de Unichain?
El endpoint RPC público es https://unichain.api.onfinality.io/public. Para la testnet de Sepolia, usa https://unichain-sepolia.api.onfinality.io/public.
¿Es Unichain una capa 2 de Ethereum?
Sí, Unichain es una red de capa 2 de Ethereum construida sobre OP Stack, diseñada para transacciones DeFi rápidas y de bajo costo.
¿Cómo obtengo un endpoint dedicado de Unichain?
Puedes aprovisionar un nodo dedicado a través de OnFinality. Visita la página de la red Unichain para más detalles.
¿Cuál es el Chain ID de Unichain?
El Chain ID es 130 para mainnet y 1301 para la testnet de Sepolia.
¿Puedo usar el endpoint público para producción?
Es posible para uso ligero, pero para cargas de trabajo de producción, se recomienda un nodo dedicado para evitar límites de tasa y garantizar la fiabilidad.
Para más información sobre redes compatibles, consulta la página de redes compatibles.