A resposta curta
Aprove uma carteira de API da Hyperliquid, também chamada de chave de agente, com um vencimento, e guarde a chave da própria conta onde o computador não alcança. Depois limite os tamanhos, a alavancagem, os mercados e as ordens por dia em limites que um programa de confiança confere antes de cada ordem: a aprovação não leva nenhum deles.
São dois trabalhos separados. A Hyperliquid decide que tipo de ação a segunda chave pode assinar, não de que tamanho, com quanta alavancagem, com que frequência nem em qual mercado.
Aprovar uma chave de agente, com data de fim
A aprovação é uma única ação assinada, ApproveAgent, enviada pela própria conta. Ela nomeia o endereço da chave e, se você quiser, um nome; um vencimento se escreve acrescentando valid_until e um horário depois desse nome, no máximo 180 dias no futuro.
Uma conta pode ter uma carteira aprovada sem nome e até três com nome, mais duas a mais por subconta. A carteira de API não guarda dinheiro: a documentação diz que ela serve só para assinar.
O lpa init fabrica uma chave assim no seu computador, sela ela no disco sob uma senha que você escolhe, e faz a sua carteira assinar a aprovação: o Locker Vault, num celular offline, como um código QR, ou a sua extensão ou carteira de celular. O fim padrão dela fica uma hora antes do teto dos 180 dias.
O que uma chave de agente sozinha não limita
Uma chave aprovada consegue colocar, mudar e cancelar ordens, e definir a alavancagem e a margem de um mercado. A aprovação não nomeia nenhuma ordem máxima, nenhuma alavancagem máxima, nenhum mercado e nenhum número de ordens por dia.
- O tamanho. Nenhum nocional, nem por ordem nem por dia.
- A alavancagem. Qualquer número inteiro de 1 até o máximo do mercado.
- Os mercados e os dexes. Qualquer mercado que a conta alcance, dexes de builders inclusive.
- O tempo. Só o vencimento, e uma revogação que você mesmo assina.
O mandato: limites assinados pela sua carteira
Um arquivo de limites no computador é um começo, e o lpa mantém um: a maior ordem, a alavancagem mais alta, os dexes e os mercados, as ordens por dia. Os padrões dele são US$ 100 por ordem, alavancagem de três, o dex principal, vinte ordens por dia. Qualquer pessoa com um terminal ali pode editá-lo, então um limite mais largo espera a sua senha no próximo lpa unlock, enquanto um mais estreito vale na hora.
O mandato é o mesmo tipo de limites, assinado uma vez pela sua carteira, onde nenhum programa do computador alcança. O Locker Vault, no celular offline, decodifica o pedido ele mesmo e mostra cada limite na linha dele antes de você assinar; com uma extensão ou uma carteira de celular, a página deste computador explica antes cada campo bruto.
| Limite | O que ele segura |
|---|---|
| Maior ordem, alavancagem, mercados, ordens por dia | os limites do computador como estão na hora em que você assina |
| Aberto por dia, no máximo | um teto em nocional que os limites locais não têm |
| Taxa de serviço, no máximo, e quem a recebe | a única alíquota e o único endereço que o agente pode pagar |
| Usos permitidos | trade, copy, pilot: se as ordens saem sem te perguntar |
| Traders copiados, e o orçamento de cópia | dez no máximo, e os dólares que as cópias reais dividem |
| Válido até | no mais tarde o fim da própria chave, 180 dias |
Antes de cada abertura, o guardião confere a assinatura, o prazo, a revogação, que o mandato não seja mais antigo que o último assinado aqui, que o uso seja permitido, que o nocional do dia fique abaixo do teto e que a taxa levada seja a que foi nomeada. Ele aplica o mais estreito dos dois, e fechar uma posição é sempre permitido.
Manter o acesso estreito
- Termina com a chave. 180 dias no máximo, o prazo mais longo que a Hyperliquid permite a uma chave de trading. Assinar um mandato mais curto fica com você, e cada renovação faz você voltar a ler os limites.
- Tranque a chave quando parar. O
lpa unlocka segura oito horas por padrão, vinte e quatro no máximo; olpa lockencerra isso. - Duas formas de parar. O
lpa mandate revokenão precisa da carteira e recusa todo mandato até aquele; olpa agent revokeretira a própria chave. - Uma conta para isto. Não a que guarda a sua poupança: uma com o que você está disposto a perder.
O mandato amarra o guardião, não a chave. Um programa que lê a memória do guardião, ou que rouba o arquivo de chave selado com a senha dele, consegue falar com a Hyperliquid sem o lpa, e nenhum arquivo do seu computador o para. O que segura então são as recusas da plataforma, o vencimento e uma conta pequena.