Logo
Nuevos usuarios de RPC: 35% de descuento el primer mesVer oferta
OnFinality Learn
Guías de redes y protocolos11 min de lectura

Cómo hacer un puente a Hyperliquid: HyperCore, HyperEVM y verificación de rutas

Un recorrido técnico para transferir activos a Hyperliquid, que cubre la separación entre HyperCore y HyperEVM, las rutas nativas y de terceros, y cómo verificar saldos y transacciones en la cadena.

TL;DR

Hacer un puente a Hyperliquid no es una sola acción: Hyperliquid ejecuta dos entornos de ejecución distintos, HyperCore (la capa de trading con libro de órdenes) y HyperEVM (la cadena de contratos inteligentes), y cada uno acepta activos mediante mecanismos diferentes. La ruta nativa deposita USDC desde Arbitrum en HyperCore, mientras que los puentes de terceros y los agregadores suelen entregar activos a direcciones de HyperEVM. Este artículo explica el modelo mental, ofrece un procedimiento reproducible para elegir y verificar una ruta, y muestra cómo confirmar saldos y transacciones con llamadas RPC en lugar de confiar en una interfaz. Separa el comportamiento documentado del protocolo de las decisiones de ruta que debes evaluar por tu cuenta.

Respuesta directa y alcance

Para hacer un puente a Hyperliquid, primero decide qué destino necesitas realmente. Si quieres operar con perpetuos en el libro de órdenes, necesitas USDC acreditado en HyperCore. Si quieres usar aplicaciones DeFi, mantener HYPE como un activo tipo ERC-20 o interactuar con contratos inteligentes, necesitas activos en HyperEVM (ID de cadena 999). Ambos forman parte de la misma L1, pero son entornos de ejecución separados con contabilidad de saldos independiente.

La ruta documentada más directa para colateral de trading es el flujo de depósito nativo de Hyperliquid, que acepta USDC desde Arbitrum. Los puentes de terceros, agregadores y enrutadores basados en intenciones pueden mover activos desde muchas cadenas, pero generalmente llegan a HyperEVM, no a HyperCore. Este artículo cubre cómo razonar sobre esa separación, cómo ejecutar una transferencia y cómo verificarla de forma independiente. No recomienda un proveedor de puente específico; para la selección de endpoints y proveedores, usa el Asistente de RPC.

  • HyperCore: trading con libro de órdenes, colateral en USDC, flujo nativo de depósito/retiro.
  • HyperEVM: cadena compatible con EVM (ID 999), contratos inteligentes, HYPE y tokens transferidos.
  • Las transferencias internas entre HyperCore y HyperEVM las gestiona Hyperliquid mismo, no un puente externo.

Requisitos previos y supuestos

Antes de empezar, confirma que tienes una billetera de autocustodia que pueda firmar en la cadena de origen y, si es necesario, en HyperEVM. Necesitas el token de gas de la cadena de origen (por ejemplo, ETH en Arbitrum o Ethereum, SOL en Solana) y suficiente para cubrir la transacción del puente. También necesitas conocer el formato de tu dirección de destino: los depósitos en HyperCore se acreditan a la dirección de tu cuenta de Hyperliquid, mientras que HyperEVM usa una dirección EVM estándar 0x.

Esta guía supone que estás transfiriendo una stablecoin como USDC para trading, o activos relacionados con HYPE para DeFi. Supone que puedes leer un explorador de bloques y ejecutar un comando curl. No supone que ningún puente en particular sea seguro o esté disponible en tu jurisdicción; el riesgo del puente, el riesgo del contrato inteligente y el riesgo de contraparte son tuyos para evaluar.

Modelo mental: por qué el destino importa más que el origen

La mayor parte de la confusión al usar puentes viene de tratar a Hyperliquid como una sola cadena con un solo saldo. En la práctica, una transacción de puente tiene una cadena de origen, un entorno de destino y un activo entregado. La cadena de origen suele ser la parte fácil; el entorno de destino es donde los fondos quedan atrapados o mal enrutados.

El flujo de depósito nativo de Hyperliquid está diseñado en torno a USDC en Arbitrum. Históricamente este fue el punto de entrada dominante, y la documentación de Hyperliquid señala que el puente heredado de Arbitrum ahora contiene una minoría del suministro de USDC en HyperCore a medida que han crecido otras rutas. Eso no hace obsoleta la ruta nativa; significa que debes verificar los activos y las tarifas admitidos actualmente en la documentación oficial antes de asumir que es la más barata.

Los puentes de terceros y los agregadores suelen acuñar o liberar activos en HyperEVM. Si tu objetivo es operar con perpetuos, llegar a HyperEVM significa que aún necesitas una transferencia interna o un paso de depósito compatible para llegar a HyperCore. Si tu objetivo es DeFi, llegar a HyperCore significa que necesitas mover activos a HyperEVM. Identifica siempre el entorno de destino antes de firmar.

Procedimiento de selección de ruta

Usa una lista de verificación repetible en lugar de elegir el primer puente que aparezca en los resultados de búsqueda. El objetivo es comparar rutas según la corrección del destino, el activo entregado, la tarifa y la finalidad, y luego verificar después de la ejecución.

Registra cada ruta candidata en una tabla antes de firmar nada. No completes las cifras con páginas de marketing; usa la cotización que devuelve el puente en el momento de la transferencia y anota la marca de tiempo. Una ruta que cotiza una tarifa baja pero entrega un activo envuelto que no puedes usar no es más barata en la práctica.

  • Entorno de destino: ¿HyperCore o HyperEVM? ¿El puente lo admite explícitamente?
  • Activo entregado: ¿USDC nativo, USDC transferido, HYPE o una representación envuelta?
  • Compatibilidad con la cadena de origen y token de gas requerido.
  • Tarifa cotizada, tolerancia al deslizamiento y tiempo estimado hasta la finalidad.
  • Si el puente es custodial, de bloqueo y acuñación o basado en intenciones.
  • Ruta de retiro de vuelta a tu cadena de origen y su costo.

Plantilla de tabla de resultados para comparar rutas

Usa la siguiente tabla Markdown para registrar tus propias mediciones. Las columnas son deliberadamente genéricas para que puedas comparar un depósito nativo, un agregador y un puente directo en los mismos términos. Deja las celdas en blanco hasta tener una cotización en vivo; nunca copies cifras de una guía, incluida esta.

| Route | Source chain | Destination env | Delivered asset | Quoted fee | Est. time | Tx hash | Verified balance delta |
|---|---|---|---|---|---|---|---|
| Native deposit | Arbitrum | HyperCore | USDC |  |  |  |  |
| Aggregator A | Ethereum | HyperEVM | USDC |  |  |  |  |
| Direct bridge B | Solana | HyperEVM | USDC |  |  |  |  |

Ejecutar un depósito nativo de USDC en HyperCore

El flujo nativo es conceptualmente simple: envías USDC en Arbitrum al contrato del puente de Hyperliquid y Hyperliquid acredita tu cuenta de HyperCore. La dirección exacta del contrato, el depósito mínimo y los activos admitidos cambian con el tiempo, así que cópialos siempre de la documentación oficial de Hyperliquid en lugar de una página de terceros.

Una secuencia típica es: adquirir USDC en Arbitrum, aprobar el contrato del puente si es necesario, llamar a la función de depósito con la dirección de tu cuenta de Hyperliquid y esperar a que finalice la transacción de Arbitrum y a que Hyperliquid acredite el saldo. El crédito no es instantáneo a nivel de EVM; depende de que el conjunto de validadores de Hyperliquid observe el depósito.

  • Confirma la dirección del contrato del puente en la documentación oficial antes de aprobar.
  • Deposita en la dirección de tu propia cuenta de Hyperliquid, no en una dirección aleatoria.
  • Guarda el hash de la transacción de Arbitrum; lo necesitarás para la verificación.
  • Verifica el monto mínimo de depósito; los depósitos pequeños pueden ser rechazados o no ser rentables.

Verificar una transferencia a HyperEVM con RPC

Si tu ruta entrega en HyperEVM, puedes verificar el resultado sin confiar en la interfaz del puente. Consulta el saldo de la dirección de destino y el recibo de la transacción mediante JSON-RPC. Reemplaza RPC_URL con un endpoint que controles o con el endpoint de un proveedor; consulta la guía de proveedores RPC de HyperEVM para conocer los criterios de selección y la página de precios de RPC para planificar la capacidad.

Los siguientes comandos curl verifican el ID de cadena, el saldo nativo y el recibo de una transacción. Un endpoint correcto de HyperEVM devuelve el ID de cadena 0x3e7 (999). Si devuelve un ID de cadena diferente, estás apuntando a la red equivocada.

curl -s -X POST RPC_URL \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

curl -s -X POST RPC_URL \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"eth_getBalance","params":["0xYOUR_ADDRESS","latest"]}'

curl -s -X POST RPC_URL \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"eth_getTransactionReceipt","params":["0xYOUR_TX_HASH"]}'

Verificar el saldo de un ERC-20 después del puente

Las comprobaciones de saldo nativo solo indican si llegó el gas. Para confirmar un token transferido, consulta el balanceOf del contrato del token para tu dirección. El siguiente ejemplo usa Python con la biblioteca estándar para que se ejecute sin dependencias adicionales. Reemplaza TOKEN_CONTRACT y YOUR_ADDRESS con los valores de la documentación del puente o del explorador.

Decodifica el valor hexadecimal devuelto usando los decimales del token (comúnmente 6 para USDC, 18 para muchos otros). Una discrepancia entre la cantidad esperada y la cantidad decodificada suele indicar una tarifa, una representación diferente del token o una entrega fallida.

import json, urllib.request

RPC_URL = "RPC_URL"
TOKEN_CONTRACT = "0xTOKEN_CONTRACT"
YOUR_ADDRESS = "0xYOUR_ADDRESS"

# balanceOf(address) selector = 0x70a08231
padded = YOUR_ADDRESS.lower().replace("0x", "").rjust(64, "0")
data = "0x70a08231" + padded

payload = json.dumps({
    "jsonrpc": "2.0", "id": 1,
    "method": "eth_call",
    "params": [{"to": TOKEN_CONTRACT, "data": data}, "latest"]
}).encode()

req = urllib.request.Request(RPC_URL, data=payload,
    headers={"Content-Type": "application/json"})
resp = json.loads(urllib.request.urlopen(req).read())
raw = int(resp["result"], 16)
print("raw balance:", raw)
print("assuming 6 decimals:", raw / 10**6)

Resultado esperado de la verificación

Un puente exitoso produce tres hechos observables: la transacción en la cadena de origen está confirmada, el saldo de destino aumenta en la cantidad esperada menos las tarifas, y la página de estado o el explorador del puente muestra la transferencia como completada. Si alguno de estos no coincide, trata la transferencia como no resuelta e investiga antes de enviar más fondos.

Para los depósitos en HyperCore, el saldo de destino aparece en la interfaz de trading de Hyperliquid, no en una consulta de saldo EVM. Para las transferencias a HyperEVM, el delta de saldo debería ser visible mediante la llamada balanceOf anterior. Registra los valores antes y después en tu tabla de resultados para tener un registro reproducible.

Solución de problemas comunes al usar puentes

La mayoría de los fallos se deben a unas pocas categorías: entorno de destino incorrecto, gas insuficiente en la cadena de origen, activo no admitido o un puente pausado o limitado en tasa. Revísalos en orden en lugar de reintentar a ciegas.

Si la transacción de origen tuvo éxito pero el saldo de destino no cambió, primero confirma que consultaste el entorno correcto. Una consulta de saldo de HyperEVM no mostrará el colateral de HyperCore. Segundo, verifica si el puente requiere un paso de reclamo manual. Tercero, revisa la página de estado del puente para conocer retrasos conocidos. Solo después de esas comprobaciones deberías contactar al soporte, y nunca compartas tu clave privada o frase semilla con nadie que afirme ayudarte.

  • ID de cadena incorrecto: confirma 0x3e7 para HyperEVM.
  • Depósito atascado: verifica la finalidad en Arbitrum y el crédito del validador de Hyperliquid.
  • Token faltante: verifica la dirección del contrato del token, no solo el símbolo.
  • Puente pausado: revisa los canales de estado oficiales antes de reintentar.
  • Phishing: nunca introduzcas una frase semilla en un sitio de puente.

Limitaciones y compensaciones

Hacer un puente siempre implica compensaciones. Las rutas nativas pueden ser más lentas o admitir menos activos, pero reducen el número de contratos inteligentes en los que confías. Los agregadores pueden encontrar rutas más baratas o rápidas, pero añaden riesgo de enrutamiento y de solucionador. Los puentes directos pueden ser rápidos, pero pueden entregar activos envueltos que son menos útiles en el destino.

También hay una compensación operativa: ejecutar tu propio nodo de HyperEVM te da verificación independiente y menor latencia para estrategias automatizadas, pero requiere mantenimiento. Un endpoint gestionado es más simple, pero introduce una dependencia del proveedor. Para equipos que ejecutan infraestructura de trading, vale la pena evaluar la opción de nodo dedicado y el servicio de API frente a tus requisitos de latencia y tiempo de actividad. El directorio de redes enumera las cadenas admitidas si necesitas confirmar la cobertura antes de comprometerte.

Próximos pasos

Una vez que tus activos estén en el entorno correcto, el siguiente paso es configurar un acceso RPC fiable para lo que planees hacer: trading, interacciones DeFi o monitoreo. Si estás creando automatización, lee la guía de RPC de baja latencia para Hyperliquid y la descripción general de proveedores RPC de Hyperliquid para comparar enfoques. Para una recomendación concreta de endpoint, usa el Asistente de RPC en lugar de adivinar.

Por último, documenta tu ruta y tus pasos de verificación en tu propio runbook. Los puentes cambian, las tarifas cambian y los activos admitidos cambian. Un runbook que registre el entorno de destino, las direcciones de contrato que usaste y las comprobaciones RPC que ejecutaste te ahorrará tiempo la próxima vez que necesites mover fondos.

Nunca te preocupes por la infraestructura nuevamente

OnFinality elimina la carga pesada de DevOps para que puedas construir de forma más inteligente y rápida.

Comenzar