Resumen
Hyperliquid tiene una testnet pública tanto para su capa de trading (HyperCore) como para su EVM (HyperEVM). Si has buscado "hyperliquid testnet", probablemente necesites una de estas tres cosas: un endpoint RPC de testnet para conectar una billetera o una aplicación, HYPE de testnet o USDC simulado de un faucet, o la configuración correcta de la cadena para HyperEVM testnet (chain ID 998). Esta página te ofrece primero la referencia práctica y después explica cómo depurar problemas comunes de testnet y cuándo merece la pena usar un servicio RPC gestionado.
OnFinality proporciona acceso a la API RPC e infraestructura de nodos dedicados para las redes compatibles. Para Hyperliquid testnet, consulta la página de redes RPC compatibles para ver la disponibilidad actual y los detalles del endpoint, y revisa precios de RPC si necesitas un endpoint gestionado para desarrollo o CI. La aplicación oficial de Hyperliquid testnet y su documentación siguen siendo la fuente de verdad para las reglas del faucet y el comportamiento del protocolo.
Puntos clave
- Hyperliquid testnet abarca dos superficies: la aplicación de trading (HyperCore) y HyperEVM testnet, que usa chain ID 998 y HYPE como moneda nativa.
- El faucet oficial de testnet requiere un depósito en mainnet desde la misma dirección; las billeteras con inicio de sesión por correo electrónico pueden necesitar ser exportadas e importadas primero en una billetera de navegador.
- Para configurar una billetera o aplicación, usa los ajustes de cadena de HyperEVM testnet (chain ID 998, token de gas HYPE) y verifica que la URL RPC que elijas sea accesible antes de depurar el código del contrato.
- Los endpoints RPC públicos de testnet son suficientes para pruebas manuales, pero los pipelines de CI y los equipos con varios desarrolladores normalmente necesitan un endpoint gestionado o dedicado para evitar límites de velocidad compartidos.
- La mayoría de los problemas de "testnet no funciona" se deben a un chain ID incorrecto, una URL RPC incorrecta, una billetera de testnet sin fondos o una billetera que sigue apuntando a mainnet.
- OnFinality ofrece API RPC y opciones de nodo dedicado para las redes compatibles; consulta la página de redes para ver la disponibilidad y los precios de Hyperliquid testnet antes de comprometerte.
Hyperliquid testnet de un vistazo
Hyperliquid testnet es el entorno de pruebas para el ecosistema Hyperliquid. Tiene dos superficies prácticas: la aplicación de trading en app.hyperliquid-testnet.xyz, donde puedes colocar órdenes contra los libros de órdenes de testnet, y HyperEVM testnet, la cadena compatible con EVM a la que los desarrolladores se conectan con un endpoint JSON-RPC estándar.
Si tu objetivo es probar una estrategia de trading o una integración de front-end, trabajarás principalmente con la aplicación de testnet y su API. Si tu objetivo es desplegar contratos Solidity, indexar eventos o conectar una billetera mediante ethers o viem, necesitas la configuración de cadena de HyperEVM testnet y una URL RPC.
- Testnet de trading: app.hyperliquid-testnet.xyz, con su propio faucet y superficie de API.
- HyperEVM testnet: cadena EVM con chain ID 998 y HYPE como token nativo de gas.
- Faucet: el faucet oficial de testnet requiere un depósito en mainnet desde la misma dirección.
- RPC: existen endpoints públicos, pero la disponibilidad y los límites de velocidad varían; los proveedores gestionados son una opción para un uso más intensivo.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Testnet de trading (HyperCore) | Usa la aplicación de testnet oficial y la documentación de la API para la colocación de órdenes, el faucet y la configuración de la cuenta. | El comportamiento del trading y las reglas del faucet son específicos del protocolo y no están cubiertos por la configuración genérica de RPC para EVM. |
| HyperEVM testnet | Chain ID 998, token de gas HYPE y una URL RPC compatible con EVM. | Esto es lo que esperan las billeteras, ethers, viem, Hardhat y Foundry cuando despliegas o lees contratos. |
| Faucet | Requisito de depósito en mainnet y consistencia de la dirección de la billetera. | Sin fondos de testnet no puedes pagar gas ni colocar órdenes de prueba, y las billeteras con inicio de sesión por correo electrónico pueden usar direcciones diferentes según el entorno. |
Configuración de cadena de HyperEVM testnet para billeteras y aplicaciones
Cuando agregas HyperEVM testnet a una billetera o configuras un framework de desarrollo, los valores clave son el chain ID y la moneda nativa. Usa la configuración a continuación como referencia y confírmala con la documentación oficial de Hyperliquid antes de confiar en ella en herramientas de producción.
La URL RPC es la parte que cambia con más frecuencia. Los endpoints públicos son convenientes para pruebas manuales, pero son compartidos y pueden limitar la velocidad o cambiar sin previo aviso. Para un desarrollo repetible, elige un endpoint que controles o un proveedor gestionado que documente su soporte de testnet.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Nombre de la red | Hyperliquid EVM Testnet | Una etiqueta clara te ayuda a evitar mezclar configuraciones de mainnet y testnet en los ajustes de la billetera. |
| Chain ID | 998 (0x3e6) | Las billeteras y bibliotecas rechazan transacciones firmadas para la cadena incorrecta; un chain ID incorrecto es una causa común de despliegues fallidos. |
| Moneda nativa | HYPE | El gas se paga en HYPE en HyperEVM testnet; una billetera vacía no puede enviar transacciones incluso si el código del contrato es correcto. |
| URL RPC | Un endpoint JSON-RPC de EVM accesible para HyperEVM testnet | El endpoint determina si tu billetera o aplicación puede leer el estado y transmitir transacciones. |
| Explorador de bloques | El explorador enlazado desde la aplicación o documentación oficial de Hyperliquid testnet | Necesitas verificar transacciones y contratos durante la depuración. |
Obtener fondos de testnet del faucet de Hyperliquid
El faucet oficial de Hyperliquid testnet no es un faucet genérico de "conectar y reclamar". Según la documentación de Hyperliquid, debes haber depositado en mainnet con la misma dirección antes de poder recibir USDC simulado para uso en testnet. Ese diseño vincula el acceso a testnet con actividad real en mainnet y evita el drenaje anónimo del faucet.
Si usas inicio de sesión por correo electrónico, el proveedor de billetera puede generar direcciones diferentes para mainnet y testnet. En ese caso, exporta la billetera de correo electrónico desde mainnet, impórtala en una billetera de navegador como Rabby o MetaMask y conecta esa billetera a la aplicación de testnet. Luego usa la página del faucet enlazada desde la aplicación de testnet oficial.
- Confirma que estás en la aplicación de testnet oficial antes de conectar una billetera.
- Verifica que la dirección que usas en testnet coincida con la dirección que depositó en mainnet.
- Si usaste inicio de sesión por correo electrónico, exporta e importa la billetera para que ambos entornos compartan la misma dirección.
- Después de reclamar, verifica el saldo en la aplicación de testnet y, para HyperEVM, en la vista de red de testnet de tu billetera.
Ruta de depuración: por qué falla tu conexión a testnet
Una verificación rápida de accesibilidad con curl puede separar los problemas del endpoint de los problemas de la aplicación. Reemplaza la URL con el endpoint de HyperEVM testnet que estés usando:
``bash
curl -s -X POST <YOUR_HYPEREVM_TESTNET_RPC_URL> \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
``
Si la respuesta devuelve 0x3e6, el endpoint es accesible y reporta chain ID 998. Si devuelve un chain ID diferente, estás apuntando a la red incorrecta. Si se agota el tiempo de espera o devuelve un error HTTP, el problema es el endpoint.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| La billetera muestra saldo cero | Elegibilidad del faucet, coincidencia de dirección con el depósito en mainnet y red de testnet correcta seleccionada. | Los fondos reclamados en una dirección o red no aparecerán en otra. |
| Las transacciones fallan inmediatamente | Chain ID 998, saldo de gas HYPE y estado del nonce en la billetera. | Un chain ID incorrecto o la falta de gas provocan el rechazo antes de que la transacción llegue al nodo. |
| Las llamadas RPC se agotan | Accesibilidad del endpoint con una solicitud JSON-RPC simple, luego verifica si hay limitación de velocidad. | Los endpoints públicos compartidos pueden limitar o descartar solicitudes bajo carga. |
| El despliegue del contrato se revierte | Objetivo del compilador, argumentos del constructor y estimación de gas en el endpoint de testnet. | El comportamiento en testnet puede diferir de mainnet en costos de gas y precompilados disponibles. |
| La aplicación funciona localmente pero no en CI | Variables de entorno para la URL RPC y el chain ID, y si CI usa un endpoint público compartido. | CI a menudo alcanza límites de velocidad que un solo desarrollador no ve localmente. |
Cuándo es suficiente un endpoint de testnet público y cuándo no
Los endpoints públicos de testnet son apropiados para pruebas manuales de billeteras, despliegues únicos de contratos y aprendizaje de las herramientas. Son menos apropiados para pipelines de CI, equipos con varios desarrolladores o cualquier flujo de trabajo que envíe ráfagas de solicitudes, porque los endpoints compartidos pueden limitar la velocidad o cambiar sin previo aviso.
Un proveedor RPC gestionado te ofrece un endpoint documentado, acceso predecible y una vía de soporte cuando algo falla. Un nodo dedicado te proporciona infraestructura aislada cuando necesitas configuración personalizada o rendimiento constante. OnFinality ofrece tanto acceso a la API RPC como infraestructura de nodos dedicados para las redes compatibles; consulta la página de redes RPC compatibles para ver la disponibilidad actual de Hyperliquid testnet y revisa precios de RPC para obtener detalles de los planes.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Pruebas manuales de billetera | Un endpoint público suele ser suficiente. | El bajo volumen de solicitudes y la depuración interactiva no sobrecargan la infraestructura compartida. |
| Pipelines de CI/CD | Endpoint RPC gestionado con límites documentados. | Las ejecuciones automatizadas pueden alcanzar límites de velocidad y fallar intermitentemente en endpoints públicos compartidos. |
| Equipo con varios desarrolladores | Endpoint gestionado con claves API separadas o aislamiento de proyectos. | Las claves compartidas dificultan la atribución de fallos y pueden agotar una única cuota. |
| Configuración personalizada de nodo | Infraestructura de nodo dedicado. | Algunos escenarios de prueba necesitan versiones específicas de nodo, registro o redes que los endpoints compartidos no exponen. |
Pasar de testnet a mainnet sin sorpresas
La transición de Hyperliquid testnet a mainnet es principalmente un cambio de configuración, pero los modos de fallo son diferentes. Mainnet tiene fondos reales, una economía de gas distinta y patrones de tráfico de producción. Antes de cambiar, haz explícita la frontera del entorno en tu código y en tu proceso de despliegue.
Mantén el chain ID, la URL RPC y los pasos de faucet o financiación en variables de entorno en lugar de valores codificados. Ejecuta el mismo despliegue de contrato y pruebas de humo contra testnet que planeas ejecutar contra mainnet, y verifica que tu monitoreo pueda distinguir el tráfico de testnet y mainnet.
- Almacena el chain ID y la URL RPC en variables de entorno, no en el código fuente.
- Ejecuta una prueba de humo que lea el estado y envíe una transacción en testnet antes del despliegue en mainnet.
- Confirma que el cambio de red de la billetera funciona tanto para testnet como para mainnet.
- Revisa las suposiciones de gas; los costos de testnet no predicen los costos de mainnet.
- Mantén un plan de reversión para el endpoint RPC en caso de que un proveedor tenga un incidente.
Preguntas frecuentes
Preguntas frecuentes
¿Hyperliquid tiene una testnet?
Sí. Hyperliquid opera una testnet pública con una aplicación de trading y una cadena HyperEVM testnet. Se accede a la testnet de trading a través de la aplicación de testnet oficial, y a HyperEVM testnet a través de un endpoint RPC compatible con EVM con chain ID 998.
¿Cuál es el chain ID de Hyperliquid testnet?
HyperEVM testnet usa chain ID 998 (0x3e6). Confirma esto con la documentación oficial de Hyperliquid antes de configurar billeteras o scripts de despliegue, ya que la configuración de testnet puede cambiar.
¿Cómo obtengo HYPE de testnet o USDC simulado?
Usa el faucet oficial de Hyperliquid testnet enlazado desde la aplicación de testnet. La documentación indica que debes haber depositado en mainnet con la misma dirección antes de poder recibir USDC simulado para uso en testnet. Si usas inicio de sesión por correo electrónico, exporta la billetera de mainnet e impórtala en una billetera de navegador para que ambos entornos compartan la misma dirección.
¿Puedo usar un endpoint RPC público para Hyperliquid testnet?
Sí, para pruebas manuales y trabajo de bajo volumen. Los endpoints públicos son compartidos y pueden limitar la velocidad o cambiar. Para pipelines de CI o uso en equipo, un endpoint gestionado o dedicado suele ser más predecible.
¿Por qué falla mi transacción en HyperEVM testnet?
Las causas comunes son un chain ID incorrecto, falta de HYPE para gas, una billetera de testnet sin fondos o un endpoint RPC inaccesible o con límite de velocidad. Ejecuta primero una solicitud eth_chainId contra tu endpoint para confirmar que reporta 0x3e6.
¿OnFinality es compatible con Hyperliquid testnet?
Consulta la página de redes RPC compatibles para ver la disponibilidad actual. OnFinality proporciona acceso a la API RPC e infraestructura de nodos dedicados para las redes compatibles, y la página de redes es la lista autoritativa.
Ethereum
Solana
Polygon
Base
Arbitrum
BNB Chain
Polkadot
Optimism
