Definição
Uma conta mestre pode aprovar carteiras de API para assinar em nome dela própria ou de qualquer uma das subcontas dela. Elas só servem para assinar: os dados da conta precisam ser consultados com o endereço real da conta, e a documentação chama a consulta ao endereço do agente de uma armadilha comum, já que ela devolve um resultado vazio em vez de um erro. Uma conta pode ter uma carteira aprovada sem nome e até três com nome, mais dois agentes com nome por subconta, e um vencimento definido com valid_until fica no máximo 180 dias no futuro.
O que uma chave assim pode e não pode fazer foi medido em vez de suposto. Em 28 de setembro de 2026, na mainnet, uma conta de teste aprovou uma chave de agente nova por uma hora e a fez assinar cada ação que move dinheiro no valor de 1.000 USDC contra um saldo de cerca de 60, então nada podia se mover e só contava o motivo de cada resposta. Recusados no assinante: withdraw3, usdSend, spotSend, sendAsset, usdClassTransfer, um segundo approveAgent e approveBuilderFee, onde a própria conta encontrava um erro de saldo. Aceitos: colocar e cancelar uma ordem. E um movimento de fundos foi aceito, vaultTransfer, com o qual 5 USDC assinados pela chave de agente chegaram a um vault da Hyperliquid.
Um aviso de operação vem junto com a definição. Os nonces são acompanhados por assinante, e o estado de nonces de uma carteira de API pode ser apagado quando a carteira sai do registro pela aprovação de uma nova, quando ela vence, ou quando a conta que a registrou não tem mais fundos. A documentação diz que ações assinadas antes podem então ser repetidas, e recomenda com força nunca reusar um endereço de agente: é preciso gerar um novo.
No nosso próprio arranjo a chave de agente vive no computador, selada no disco sob uma senha e guardada na memória pelo guardião só enquanto está destrancada. O guardião assina uma lista fechada de ações de trading e nada mais, a chave vence por conta própria com avisos 30, 14, 7, 3 e 1 dias antes, e o lpa agent revoke a recolhe com a sua carteira. Nenhum arquivo em um computador detém um ladrão que tem a chave e a senha dela, então o limite que segura é a conta: o que ela guarda é o máximo que pode ser perdido.
Exemplo
Um exemplo, em números redondos. Uma conta com 1.000 USDC aprova uma chave de agente, com vencimento em 180 dias, o teto que a Hyperliquid permite. Essa chave pode abrir e fechar posições contra os 1.000 USDC e definir a alavancagem e o modo de margem de um mercado; ela não pode sacar um centavo, enviar para outro endereço nem mover entre o saldo de spot e o de perpétuos. Tudo o que ela alcança são esses 1.000 USDC, e é por isso que uma conta dedicada é o limite que importa.