La catena dei passi
Sei passi separano un dollaro messo su un'altra catena da una posizione su Hyperliquid.
- L'USDC arriva su HyperCore. È emesso in modo nativo sulla L1 di Hyperliquid, e il Cross-Chain Transfer Protocol di Circle lo porta da Arbitrum.
- Viene accreditato al tuo indirizzo. I depositi sono accreditati prima al saldo di margine incrociato di quell'indirizzo, nella stanza di compensazione dei perpetui.
- Firmi un ordine. Un mercato, un verso, una dimensione, un prezzo e una leva, firmati dalla chiave del conto o da un wallet di API che il conto ha approvato.
- L'ordine entra nel book di quell'asset, a un prezzo multiplo del tick, e viene abbinato per prezzo e ora di arrivo.
- L'esecuzione cambia la tua posizione nella stanza di compensazione, e il funding viene regolato ogni ora finché la posizione resta aperta.
- Un prelievo è una firma su Hyperliquid e nient'altro: i validatori firmano e mandano la richiesta al contratto del ponte.
Far entrare i dollari
L'USDC è emesso in modo nativo sulla L1 di Hyperliquid, e la strada da Arbitrum è il protocollo di Circle, che Circle documenta. Il vecchio ponte di Arbitrum è deprecato: la documentazione dice che oggi tiene meno del 10 % dell'USDC in circolazione su HyperCore.
Vale la pena conoscere la meccanica del vecchio ponte, perché la maggior parte delle guide la descrive ancora. L'USDC mandato là viene accreditato in meno di un minuto all'indirizzo che l'ha mandato, il deposito minimo è di 5 USDC, e la documentazione dice senza giri di parole che un importo più piccolo non viene accreditato ed è perso per sempre.
Quello che arriva finisce nel saldo di margine incrociato, dove sostiene tutte le posizioni aperte in quella modalità. Una posizione si apre in margine incrociato per default; il margine isolato è una scelta che fai posizione per posizione.
Un ordine sul book
Il book degli ordini funziona in sostanza come quello di un exchange centralizzato, ed è interamente onchain. Un prezzo deve essere un multiplo intero del tick e una dimensione un multiplo intero del lotto, e gli ordini si abbinano per prezzo e ora di arrivo.
Il margine viene verificato due volte. Lo è quando un nuovo ordine viene aperto, e di nuovo sul lato già in attesa nel momento dell'abbinamento di ogni ordine, perché il sistema di margine resti coerente anche se il prezzo oracolo si è mosso dopo che quell'ordine era stato piazzato.
La catena stessa sa che cos'è un ordine. Dentro un blocco le azioni sono messe in tre gruppi: prima quelle che non mandano nessun ordine GTC o IOC a un book, poi gli annullamenti, poi quelle che mandano almeno un ordine GTC o IOC, e ogni gruppo tiene l'ordine che gli ha dato chi ha proposto il blocco. Un blocco tiene di solito uno o due lotti di azioni del consenso.
Quanto in fretta risponde
Da un capo all'altro, misurata dall'invio di una richiesta alla ricezione di una risposta confermata, la documentazione dà una mediana di 0,2 secondi e 0,9 secondi al 99esimo percentile, per un ordine inserito da un client collocato geograficamente accanto. Il mainnet regge circa 200.000 ordini al secondo, e la documentazione dice che il collo di bottiglia è l'esecuzione più che il consenso.
Due conseguenze per tutto quello che è automatico. Una decisione è confermata ben sotto il secondo, quindi un programma non deve indovinare se il suo ordine è arrivato; e un programma lontano da un server di API è limitato dalla sua rete prima che dalla catena.
Firme, wallet di API e nonce
Ogni azione è firmata. Oltre alla chiave propria del conto, un conto principale può approvare dei wallet di API, che la documentazione chiama anche wallet di agente, perché firmino per il conto o per i suoi sottoconti. Un conto può tenere un wallet approvato senza nome e fino a tre con nome, con due agenti con nome in più per ogni sottoconto, e una scadenza fissata con valid_until può andare al massimo a 180 giorni.
Un wallet di API firma, e non fa altro. I dati di un conto si leggono con l'indirizzo reale del conto, e la documentazione nomina come trappola comune il chiedere l'indirizzo dell'agente: restituisce un risultato vuoto, non un errore.
I nonce non sono quelli di Ethereum, perché un book degli ordini non può aspettare una transazione alla volta. Hyperliquid tiene i 100 nonce più alti per ogni firmatario; una nuova azione deve portare un nonce sopra il più piccolo di quell'insieme e mai usato prima, e dentro i due giorni prima e il giorno dopo l'ora del suo blocco.
Lo stato dei nonce di un wallet di API può essere potato: quando viene cancellato dall'approvazione di uno nuovo, quando scade, o quando il conto che lo ha registrato resta senza fondi. La documentazione avverte che le azioni firmate prima possono allora essere rigiocate. Genera un nuovo wallet di API invece di far rivivere un vecchio indirizzo.
Far uscire i dollari
Un prelievo comincia con una firma su Hyperliquid e non chiede nessuna transazione tua sull'altra catena: i validatori firmano e mandano la richiesta al contratto del ponte. La documentazione dà una commissione di 1 $ al momento in cui è scritta, e circa cinque minuti per concludere.
Che cosa può mandare quella richiesta conta più di quanto tempo ci vuole. Un wallet di API approvato non può: misurato sul mainnet il 28 settembre 2026 con una chiave di agente nuova, withdraw3, usdSend, spotSend, sendAsset e usdClassTransfer sono stati tutti rifiutati sul firmatario, mentre le stesse richieste firmate dal conto stesso hanno incontrato un errore di saldo.
È per questo che a un agente si può dare una chiave. La chiave che opera e la chiave che sposta i soldi sono due chiavi diverse.