La risposta breve
Approva un wallet di API Hyperliquid, chiamato anche chiave di agente, con una scadenza, e tieni la chiave propria del conto dove il computer non può arrivare. Poi delimita le dimensioni, la leva, i mercati e gli ordini al giorno in limiti che un programma di cui ti fidi verifica prima di ogni ordine: l'approvazione non ne porta nessuno.
Sono due lavori distinti. Hyperliquid decide che tipo di azione la seconda chiave può firmare, non di quale dimensione, con quanta leva, quanto spesso o su quale mercato.
Approvare una chiave di agente, con una data di fine
L'approvazione è una sola azione firmata, ApproveAgent, mandata dal conto stesso. Nomina l'indirizzo della chiave e, facoltativamente, un nome; una scadenza si scrive aggiungendo valid_until e un'ora dopo quel nome, al massimo 180 giorni nel futuro.
Un conto può tenere un wallet approvato senza nome e fino a tre con nome, più due in più per ogni sottoconto. Il wallet di API non custodisce fondi: la documentazione dice che serve solo a firmare.
lpa init fabbrica una chiave così sul tuo computer, la sigilla sul disco sotto una password che scegli tu, e fa firmare l'approvazione al tuo wallet: Locker Vault, su un telefono offline, come un codice QR, oppure la tua estensione o il tuo wallet mobile. La sua fine di default sta un'ora prima del tetto dei 180 giorni.
Quel che una chiave di agente da sola non delimita
Una chiave approvata può piazzare, cambiare e annullare ordini, e impostare la leva e il margine di un mercato. L'approvazione non nomina alcun ordine massimo, alcuna leva massima, alcun mercato e alcun numero di ordini al giorno.
- La dimensione. Nessun nozionale, né per ordine né per giorno.
- La leva. Qualunque numero intero da 1 al massimo del mercato.
- I mercati e i dex. Qualunque mercato il conto possa raggiungere, dex di builder compresi.
- Il tempo. Solo la scadenza, e una revoca che firmi tu.
Il mandato: limiti firmati dal tuo wallet
Un file di limiti sul computer è un inizio, e lpa ne tiene uno: l'ordine più grande, la leva più alta, i dex e i mercati, gli ordini al giorno. I suoi valori di default sono 100 $ per ordine, leva tre, il dex principale, venti ordini al giorno. Chiunque abbia un terminale lì può modificarlo, così un limite più largo aspetta la tua password al prossimo lpa unlock, mentre uno più stretto tiene subito.
Il mandato è lo stesso tipo di limiti, firmato una volta dal tuo wallet, dove nessun programma del computer può arrivarci. Locker Vault, sul telefono offline, decodifica la richiesta da sé e mostra ogni limite sulla propria riga prima che tu firmi; con un'estensione o un wallet mobile, la pagina di questo computer spiega prima ogni campo grezzo.
| Limite | Che cosa trattiene |
|---|---|
| Ordine più grande, leva, mercati, ordini al giorno | i limiti del computer come stanno quando firmi |
| Aperto al giorno, al massimo | un tetto in nozionale che i limiti locali non hanno |
| Commissione di servizio, al massimo, e il suo destinatario | il solo tasso e il solo indirizzo che l'agente può pagare |
| Usi permessi | trade, copy, pilot: se gli ordini partono senza chiedertelo |
| Trader copiati, e il budget di copia | dieci al massimo, e i dollari che le copie reali condividono |
| Valido fino al | al più tardi la fine della chiave stessa, 180 giorni |
Prima di ogni apertura, il guardiano verifica la firma, il termine, la revoca, che il mandato non sia più vecchio dell'ultimo firmato qui, che l'uso sia permesso, che il nozionale del giorno resti sotto il tetto e che la commissione portata sia quella nominata. Applica il più stretto dei due, e chiudere una posizione è sempre permesso.
Tenere stretto l'accesso
- Finisce con la chiave. 180 giorni al massimo, il periodo più lungo che Hyperliquid consente a una chiave di trading. Firmare un mandato più corto resta a te, e ogni rinnovo ti riporta a rileggere i limiti.
- Blocca la chiave quando smetti.
lpa unlockla tiene otto ore di default, ventiquattro al massimo;lpa lockmette fine a questo. - Due modi di fermare.
lpa mandate revokenon ha bisogno del wallet e rifiuta ogni mandato fino a quello;lpa agent revokeritira la chiave stessa. - Un conto per questo. Non quello con i tuoi risparmi: uno alimentato con quello che accetti di perdere.
Il mandato lega il guardiano, non la chiave. Un programma che legge la memoria del guardiano, o che ruba il file di chiave sigillato con la sua password, può parlare con Hyperliquid senza lpa, e nessun file del tuo computer lo ferma. Quel che tiene allora sono i rifiuti della piattaforma, la scadenza e un conto piccolo.