La respuesta corta
Aprueba un wallet de API de Hyperliquid, llamado también clave de agente, con un vencimiento, y guarda la clave propia de la cuenta donde el ordenador no pueda alcanzarla. Luego acota los tamaños, el apalancamiento, los mercados y las órdenes al día en límites que un programa de confianza comprueba antes de cada orden: la aprobación no lleva ninguno.
Son dos trabajos separados. Hyperliquid decide qué tipo de acción puede firmar la segunda clave, no de qué tamaño, con cuánto apalancamiento, cada cuánto ni en qué mercado.
Aprobar una clave de agente, con fecha de fin
La aprobación es una sola acción firmada, ApproveAgent, enviada por la propia cuenta. Nombra la dirección de la clave y, opcionalmente, un nombre; un vencimiento se escribe añadiendo valid_until y una marca de tiempo después de ese nombre, como máximo 180 días en el futuro.
Una cuenta puede tener un wallet aprobado sin nombre y hasta tres con nombre, más dos más por subcuenta. El wallet de API no custodia fondos: la documentación dice que solo se usa para firmar.
lpa init fabrica una clave así en tu ordenador, la sella en el disco bajo una contraseña que eliges, y hace que tu wallet firme la aprobación: Locker Vault, en un móvil sin conexión, como un código QR, o tu extensión o tu wallet móvil. Su fin por defecto queda una hora antes del techo de los 180 días.
Lo que una clave de agente sola no acota
Una clave aprobada puede poner, cambiar y cancelar órdenes, y fijar el apalancamiento y el margen de un mercado. La aprobación no nombra ninguna orden máxima, ningún apalancamiento máximo, ningún mercado y ningún número de órdenes al día.
- El tamaño. Ningún nocional, ni por orden ni por día.
- El apalancamiento. Cualquier número entero de 1 al máximo del mercado.
- Los mercados y los dexes. Cualquier mercado que la cuenta alcance, dexes de builders incluidos.
- El tiempo. Solo el vencimiento, y una revocación que firmas tú.
El mandato: límites firmados por tu wallet
Un archivo de límites en el ordenador es un comienzo, y lpa tiene uno: la orden más grande, el apalancamiento más alto, los dexes y los mercados, las órdenes al día. Sus valores por defecto son 100 $ por orden, apalancamiento de tres, el dex principal, veinte órdenes al día. Cualquiera con una terminal allí puede editarlo, así que un límite más amplio espera tu contraseña en el siguiente lpa unlock, mientras que uno más estrecho aguanta de inmediato.
El mandato es el mismo tipo de límites, firmado una vez por tu wallet, donde ningún programa del ordenador puede alcanzarlos. Locker Vault, en el móvil sin conexión, decodifica la petición por sí misma y muestra cada límite en su propia fila antes de que firmes; con una extensión o una wallet móvil, la página de este ordenador explica antes cada campo en bruto.
| Límite | Qué retiene |
|---|---|
| Orden más grande, apalancamiento, mercados, órdenes al día | los límites del ordenador tal como están cuando firmas |
| Abierto por día, como máximo | un techo en nocional que los límites locales no tienen |
| Comisión de servicio, como máximo, y su destinatario | la única tasa y la única dirección que el agente puede pagar |
| Usos permitidos | trade, copy, pilot: si las órdenes salen sin preguntarte |
| Traders copiados, y el presupuesto de copia | diez como máximo, y los dólares que comparten las copias reales |
| Válido hasta | a más tardar el fin de la propia clave, 180 días |
Antes de cada apertura, el guardián comprueba la firma, el plazo, la revocación, que el mandato no sea más antiguo que el último firmado aquí, que el uso esté permitido, que el nocional del día se quede bajo el techo y que la comisión que lleva sea la nombrada. Aplica el más estrecho de los dos, y cerrar una posición siempre está permitido.
Mantener el acceso estrecho
- Acaba con la clave. 180 días como máximo, lo más largo que Hyperliquid permite a una clave de trading. Firmar un mandato más corto queda en tus manos, y cada renovación te hace volver a leer los límites.
- Bloquea la clave cuando pares.
lpa unlockla mantiene ocho horas por defecto, veinticuatro como máximo;lpa lockpone fin a eso. - Dos formas de parar.
lpa mandate revokeno necesita la wallet y rechaza todos los mandatos hasta ese;lpa agent revokeretira la clave misma. - Una cuenta para esto. No la que tiene tus ahorros: una con lo que estás dispuesto a perder.
El mandato ata al guardián, no a la clave. Un programa que lee la memoria del guardián, o que roba el archivo de clave sellado con su contraseña, puede hablar con Hyperliquid sin lpa, y ningún archivo de tu ordenador lo para. Lo que aguanta entonces son los rechazos de la plataforma, el vencimiento y una cuenta pequeña.