La cadena de pasos
Seis pasos separan un dólar puesto en otra cadena de una posición en Hyperliquid.
- El USDC llega a HyperCore. Se emite de forma nativa en la L1 de Hyperliquid, y el Cross-Chain Transfer Protocol de Circle lo trae desde Arbitrum.
- Se acredita a tu dirección. Los depósitos se acreditan primero al saldo de margen cruzado de esa dirección, en la cámara de compensación de los perpetuos.
- Firmas una orden. Un mercado, un sentido, un tamaño, un precio y un apalancamiento, firmados por la clave de la cuenta o por un wallet de API que ella aprobó.
- La orden entra en el libro de ese activo, a un precio múltiplo del tamaño del tick, y se empareja por precio y hora de llegada.
- La ejecución cambia tu posición en la cámara de compensación, y el funding se liquida cada hora mientras la posición siga abierta.
- Una retirada es una firma en Hyperliquid y nada más: los validadores firman y envían la solicitud al contrato del puente.
Meter dólares
El USDC se emite de forma nativa en la L1 de Hyperliquid, y la ruta desde Arbitrum es el protocolo de Circle, que Circle documenta. El puente antiguo de Arbitrum está obsoleto: la documentación dice que hoy guarda menos del 10 % del USDC en circulación en HyperCore.
Vale la pena conocer la mecánica del puente antiguo, porque la mayoría de las guías la siguen describiendo. El USDC que se le envía se acredita en menos de un minuto a la dirección que lo envió, el depósito mínimo es de 5 USDC, y la documentación dice sin rodeos que un importe menor no se acredita y se pierde para siempre.
Lo que llega aterriza en el saldo de margen cruzado, donde respalda todas las posiciones abiertas en ese modo. Una posición se abre en margen cruzado por defecto; el margen aislado es una elección que haces posición por posición.
Una orden en el libro
El libro de órdenes funciona en lo esencial como el de un exchange centralizado, y está enteramente onchain. Un precio tiene que ser un múltiplo entero del tamaño del tick y un tamaño un múltiplo entero del lote, y las órdenes se emparejan por precio y hora de llegada.
El margen se comprueba dos veces. Se comprueba al abrir una orden nueva, y otra vez en el lado que estaba en el libro al emparejarse cada orden, para que el sistema de margen siga siendo coherente aunque el precio oráculo se haya movido después de poner esa orden.
La cadena misma sabe qué es una orden. Dentro de un bloque, las acciones se ordenan en tres grupos: primero las que no envían ninguna orden GTC o IOC a ningún libro, luego las cancelaciones, luego las que envían al menos una orden GTC o IOC, y cada grupo conserva el orden que le dio el proponente del bloque. Un bloque suele llevar uno o dos lotes de acciones del consenso.
Con qué rapidez responde
De punta a punta, medido desde enviar una solicitud hasta recibir una respuesta confirmada, la documentación da una mediana de 0,2 segundos y 0,9 segundos en el percentil 99, para una orden puesta desde un cliente colocado geográficamente al lado. El mainnet aguanta unas 200.000 órdenes por segundo, y la documentación dice que el cuello de botella es la ejecución más que el consenso.
Dos consecuencias para todo lo automatizado. Una decisión se confirma bastante por debajo del segundo, así que un programa no tiene que adivinar si su orden llegó; y un programa lejos de un servidor de API lo limita su propia red antes que la cadena.
Firmas, wallets de API y nonces
Cada acción va firmada. Además de la clave propia de la cuenta, una cuenta maestra puede aprobar wallets de API, que la documentación también llama wallets de agente, para que firmen por la cuenta o por sus subcuentas. Una cuenta puede tener un wallet aprobado sin nombre y hasta tres con nombre, con dos agentes con nombre más por subcuenta, y un vencimiento fijado con valid_until puede llegar como máximo a 180 días.
Un wallet de API firma, y no hace nada más. Los datos de una cuenta se consultan con la dirección real de la cuenta, y la documentación nombra como error habitual consultar la dirección del agente: devuelve un resultado vacío, no un error.
Los nonces no son los de Ethereum, porque un libro de órdenes no puede esperar una transacción a la vez. Hyperliquid guarda los 100 nonces más altos por firmante; una acción nueva tiene que llevar un nonce por encima del más pequeño de ese conjunto y nunca usado antes, y dentro de los dos días anteriores y el día posterior a la marca de tiempo de su bloque.
El estado de los nonces de un wallet de API se puede podar: cuando se le da de baja al aprobar uno nuevo, cuando caduca, o cuando la cuenta que lo registró se queda sin fondos. La documentación advierte de que entonces se pueden repetir acciones firmadas antes. Genera un wallet de API nuevo en vez de revivir una dirección vieja.
Sacar dólares
Una retirada empieza con una firma en Hyperliquid y no te pide ninguna transacción en la otra cadena: los validadores firman y envían la solicitud al contrato del puente. La documentación da una comisión de 1 $ en el momento en que se escribió, y unos cinco minutos para finalizar.
Qué puede enviar esa solicitud importa más que cuánto tarda. Un wallet de API aprobado no puede: medido en el mainnet el 28 de septiembre de 2026 con una clave de agente nueva, withdraw3, usdSend, spotSend, sendAsset y usdClassTransfer fueron todos rechazados en el firmante, mientras que las mismas solicitudes firmadas por la cuenta misma se encontraron con un error de saldo.
Por eso se le puede dar una clave a un agente. La clave que opera y la clave que mueve el dinero son dos claves distintas.