Определение
Главный счёт может одобрить API-кошельки, чтобы те подписывали от его собственного имени или для любого из его субсчётов. Их используют только для подписи: данные счёта нужно запрашивать по настоящему адресу счёта, и документация называет запрос по адресу агента частой ошибкой, поскольку он возвращает пустой результат, а не ошибку. Счёт может держать один одобренный кошелёк без имени и до трёх именованных, ещё два именованных агента разрешены на каждый субсчёт, а срок, заданный через valid_until, может быть не дальше 180 дней вперёд.
Что такой ключ может и чего не может, не предположили, а измерили. 28 сентября 2026 года, в основной сети, тестовый счёт одобрил свежего агента на один час и дал ему подписать каждое действие, которое двигает деньги, на 1 000 USDC при балансе около 60, так что сдвинуться не могло ничто и считалась только причина каждого ответа. Отклонено на подписанте: withdraw3, usdSend, spotSend, sendAsset, usdClassTransfer, второй approveAgent и approveBuilderFee, тогда как сам счёт встречал вместо этого ошибку баланса. Принято: постановка и отмена ордера. И одно движение средств было принято, vaultTransfer, которым подписанные ключом агента 5 USDC дошли до хранилища Hyperliquid.
К определению прилагается одно эксплуатационное предупреждение. Нонсы ведутся по каждому подписанту, и состояние нонсов API-кошелька может быть очищено, когда кошелёк снимают с учёта одобрением нового, когда его срок истекает или когда у счёта, который его зарегистрировал, больше нет средств. Документация говорит, что ранее подписанные действия тогда можно воспроизвести, и настоятельно советует никогда не использовать адрес агента повторно: лучше создать новый.
В нашей собственной схеме ключ агента живёт на компьютере, запечатанный на диске под паролем, и хранитель держит его в памяти лишь пока он разблокирован. Хранитель подписывает закрытый список торговых действий и ничего больше, ключ истекает сам, с предупреждениями за 30, 14, 7, 3 и 1 день, а lpa agent revoke отправляет его на покой с помощью вашего кошелька. Никакой файл на компьютере не остановит вора, у которого есть и ключ, и его пароль, поэтому граница, которая держит, это сам счёт: что в нём лежит, то и есть самое большее, что можно потерять.
Пример
Пример, в круглых числах. Счёт, пополненный на 1 000 USDC, одобряет один ключ агента со сроком на 180 дней вперёд, то есть по потолку, который разрешает Hyperliquid. Этот ключ может открывать и закрывать позиции против тех 1 000 USDC и задавать плечо и режим маржи рынка; он не может вывести из них ни копейки, отправить их на другой адрес или перевести между спотовым и фьючерсным балансом. Всё, до чего он дотягивается, это те самые 1 000 USDC, и потому отдельный счёт и есть та граница, которая имеет значение.