Définition
Un compte maître peut approuver des portefeuilles d'API pour signer à sa propre place ou pour n'importe lequel de ses sous-comptes. Ils ne servent qu'à signer : les données du compte doivent être interrogées avec la vraie adresse du compte, et la documentation nomme l'interrogation de l'adresse de l'agent un piège courant, puisqu'elle renvoie un résultat vide plutôt qu'une erreur. 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 réglée avec valid_until se place à 180 jours au plus dans le futur.
Ce qu'une telle clé peut faire et ne peut pas faire a été mesuré plutôt que supposé. Le 28 septembre 2026, sur le mainnet, un compte de test a approuvé une clé d'agent neuve pour une heure et lui a fait signer chaque action qui déplace de l'argent pour 1 000 USDC contre un solde d'environ 60, si bien que rien ne pouvait bouger et que seule la raison de chaque réponse comptait. Refusés sur le signataire : withdraw3, usdSend, spotSend, sendAsset, usdClassTransfer, un second approveAgent et approveBuilderFee, là où le compte lui-même rencontrait une erreur de solde. Acceptés : passer et annuler un ordre. Et un mouvement de fonds a été accepté, vaultTransfer, avec lequel 5 USDC signés par la clé d'agent ont atteint un vault Hyperliquid.
Un avertissement d'exploitation va avec la définition. Les nonces sont suivis par signataire, et l'état des nonces d'un portefeuille d'API peut être purgé quand le portefeuille est déréférencé par l'approbation d'un nouveau, quand il expire, ou quand le compte qui l'a enregistré n'a plus de fonds. La documentation dit que des actions signées auparavant peuvent alors être rejouées, et conseille fermement de ne jamais réutiliser une adresse d'agent : il faut en générer une nouvelle.
Dans notre propre montage, la clé d'agent vit sur l'ordinateur, scellée sur le disque sous un mot de passe et tenue en mémoire par le gardien seulement pendant qu'elle est déverrouillée. Le gardien signe une liste fermée d'actions de trading et rien d'autre, la clé expire d'elle-même avec des avertissements 30, 14, 7, 3 et 1 jours avant, et lpa agent revoke la retire avec votre portefeuille. Aucun fichier sur un ordinateur n'arrête un voleur qui tient à la fois la clé et son mot de passe, donc la borne qui tient est le compte : ce qu'il contient est le plus qui peut être perdu.
Exemple
Un exemple, en nombres ronds. Un compte approvisionné avec 1 000 USDC approuve une clé d'agent, avec une échéance à 180 jours, le plafond que Hyperliquid permet. Cette clé peut ouvrir et fermer des positions contre les 1 000 USDC et régler le levier et le mode de marge d'un marché ; elle ne peut pas en retirer un centime, l'envoyer à une autre adresse ni le déplacer entre le solde spot et le solde des perpétuels. Tout ce qu'elle peut atteindre est ces 1 000 USDC, et c'est pourquoi un compte dédié est la borne qui compte.