La chaîne des étapes
Six étapes séparent un dollar posé sur une autre chaîne d'une position sur Hyperliquid.
- L'USDC arrive sur HyperCore. Il est émis nativement sur la L1 Hyperliquid, et le Cross-Chain Transfer Protocol de Circle le fait venir d'Arbitrum.
- Il est crédité à votre adresse. Les dépôts sont crédités d'abord au solde de marge croisée de cette adresse, dans la chambre de compensation des perpétuels.
- Vous signez un ordre. Un marché, un sens, une taille, un prix et un levier, signés par la clé du compte ou par un portefeuille d'API qu'il a approuvé.
- L'ordre rejoint le carnet de cet actif, à un prix multiple du pas de cotation, et il est apparié par prix puis par ordre d'arrivée.
- L'exécution change votre position dans la chambre de compensation, et le funding se règle chaque heure tant que la position reste ouverte.
- Un retrait est une signature sur Hyperliquid seule : les validateurs signent et envoient la demande au contrat du pont.
Faire entrer des dollars
L'USDC est émis nativement sur la L1 Hyperliquid, et la route depuis Arbitrum est le protocole de Circle lui-même, que Circle documente. L'ancien pont Arbitrum est déprécié : la documentation dit qu'il tient aujourd'hui moins de 10 % de l'USDC en circulation sur HyperCore.
Les mécanismes de l'ancien pont valent d'être connus, parce que la plupart des guides les décrivent encore. L'USDC qui lui est envoyé est crédité en moins d'une minute à l'adresse qui l'a envoyé, le dépôt minimal est de 5 USDC, et la documentation dit sans détour qu'un montant plus petit n'est pas crédité et est perdu pour toujours.
Ce qui arrive atterrit dans le solde de marge croisée, où il soutient toutes les positions ouvertes dans ce mode. Une position s'ouvre en marge croisée par défaut ; la marge isolée est un choix que vous faites position par position.
Un ordre sur le carnet
Le carnet d'ordres marche pour l'essentiel comme celui d'un exchange centralisé, et il est entièrement onchain. Un prix doit être un multiple entier du pas de cotation et une taille un multiple entier du lot, et les ordres s'apparient par prix puis par ordre d'arrivée.
La marge est vérifiée deux fois. Elle l'est à l'ouverture d'un nouvel ordre, et de nouveau pour l'ordre au repos au moment de l'appariement, pour que le système de marge reste cohérent même si le prix oracle a bougé après que l'ordre au repos a été placé.
La chaîne elle-même sait ce qu'est un ordre. Dans un bloc, les actions sont triées en trois groupes : d'abord celles qui n'envoient aucun ordre GTC ou IOC sur un carnet, puis les annulations, puis celles qui envoient au moins un ordre GTC ou IOC, chaque groupe gardant l'ordre que le proposeur du bloc lui a donné. Un bloc tient d'habitude un ou deux lots d'actions du consensus.
À quelle vitesse elle répond
De bout en bout, mesurée de l'envoi d'une demande à la réception d'une réponse engagée, la documentation donne une médiane de 0,2 seconde et 0,9 seconde au 99e centile, pour un ordre passé depuis un client géographiquement colocalisé. Le mainnet tient environ 200 000 ordres par seconde, et la documentation dit que le goulet est l'exécution plutôt que le consensus.
Deux conséquences pour tout ce qui est automatisé. Une décision est confirmée bien en dessous de la seconde, donc un programme n'a pas à deviner si son ordre est arrivé ; et un programme loin d'un serveur d'API est borné par son propre réseau avant de l'être par la chaîne.
Signatures, portefeuilles d'API et nonces
Chaque action est signée. À côté de la clé propre du compte, un compte maître peut approuver des portefeuilles d'API, que la documentation appelle aussi des portefeuilles d'agent, pour signer pour le compte ou pour ses sous-comptes. Un compte peut tenir un portefeuille approuvé sans nom et jusqu'à trois nommés, avec deux agents nommés de plus par sous-compte, et une échéance fixée par valid_until peut aller au plus à 180 jours.
Un portefeuille d'API signe, et ne fait rien d'autre. Les données d'un compte se lisent avec l'adresse réelle du compte, et la documentation nomme comme piège courant le fait d'interroger l'adresse de l'agent : elle renvoie un résultat vide, pas une erreur.
Les nonces ne sont pas ceux d'Ethereum, parce qu'un carnet d'ordres ne peut pas attendre une transaction à la fois. Hyperliquid garde les 100 nonces les plus élevés par signataire ; une nouvelle action doit porter un nonce au-dessus du plus petit de cet ensemble et jamais employé avant, et dans les deux jours avant et le jour après l'horodatage de son bloc.
L'état des nonces d'un portefeuille d'API peut être élagué : quand il est désenregistré par l'approbation d'un nouveau, quand il expire, ou quand le compte qui l'a enregistré se vide de ses fonds. La documentation avertit que des actions signées auparavant peuvent alors être rejouées. Générez un nouveau portefeuille d'API plutôt que de ranimer une ancienne adresse.
Faire sortir des dollars
Un retrait commence par une signature sur Hyperliquid et ne demande aucune transaction de votre part sur l'autre chaîne : les validateurs signent et envoient la demande au contrat du pont. La documentation donne des frais de 1 $ au moment où elle est écrite, et environ cinq minutes pour finaliser.
Ce qui peut envoyer cette demande compte plus que le temps qu'elle prend. Un portefeuille d'API approuvé ne peut pas : mesuré sur le mainnet le 28 septembre 2026 avec une clé d'agent neuve, withdraw3, usdSend, spotSend, sendAsset et usdClassTransfer ont tous été refusés sur le signataire, là où les mêmes demandes signées par le compte lui-même ont rencontré une erreur de solde.
C'est pour cela qu'on peut confier une clé à un agent. La clé qui trade et la clé qui déplace l'argent sont deux clés différentes.