Chaves de sessão

Por que um clique basta

Quando você ativa a negociação, sua carteira assina uma mensagem que indica um par de chaves criado no seu navegador e a validade dele: RegisterSessionKeyV2 na primeira vez (ela também pode indicar quem indicou você, um vínculo definitivo) e RegisterSessionKey para cada chave seguinte. O relayer envia a mensagem e o contrato SessionKeyManager registra a chave para a sua conta. Daí em diante, a chave de sessão assina suas aberturas e seus fechamentos, o relayer os envia e os contratos os aceitam como seus.

A chave é gerada e usada dentro de um worker separado do navegador, e guardada criptografada com uma chave que o navegador mantém como não extraível, de modo que a chave bruta nunca fica no armazenamento da página. O worker não assina nada além de mensagens de negociação da sua conta nesta implantação.

O que uma chave de sessão pode fazer

• Abrir posições na sua conta, financiadas pelo seu saldo disponível ou pelo seu saldo na fila (OpenPosition).
• Fechar posições da sua conta (Close).
• Cancelar suas ordens que ainda estão na fila do relayer (CancelIntent).

O que uma chave de sessão não pode fazer

• Sacar: todo saque exige a assinatura da sua própria carteira.
• Colocar em staking, retirar do staking ou resgatar recompensas: isso também é assinado pela carteira.
• Registrar ou revogar chaves.

O pior caso se uma chave de sessão vazar: alguém pode abrir e fechar posições na sua conta, e poderia perder o seu saldo em operações, mas não pode tirá-lo da exchange. Código rodando na página, como uma extensão maliciosa do navegador, poderia usar uma chave desbloqueada enquanto roda, então revogue as chaves de que você não precisa mais.

Taxas de builder

O registro que você assina também traz um endereço de builder e a maior taxa de builder que você aceita, que o app deixa vazios e em zero. Uma chave registrada por outro frontend pode indicar esse frontend; enquanto o dono o mantiver aprovado como builder, as posições que a chave fechar pagam a ele o menor valor entre a taxa dele e o máximo que você assinou, no máximo 0.5% do PnL: do seu ganho, quando você ganha; do ganho do LP, quando você perde. Veja Códigos de builder.

Validade

Uma chave é registrada por 30 dias. Cada ordem que ela assina tem o próprio prazo, de 1 hora, que precisa cair dentro da validade da chave. Uma conta pode ter no máximo 8 chaves ativas ou pendentes.

Revogar

A janela Sessões de negociação do app lista todas as chaves da sua conta, marca a deste dispositivo e revoga uma chave ou todas, inclusive as de dispositivos que você não tem mais. Revogar funciona de duas formas:

• como uma transação da sua carteira para o SessionKeyManager, que exige um pouco de HYPE para o gas;
• como uma mensagem assinada que o relayer envia de graça, para até 32 chaves de uma vez ou para todas. Esse caminho sem gas é um acréscimo proposital, para que você consiga desconectar um dispositivo perdido mesmo sem HYPE na carteira.

Quando uma chave é revogada, toda ordem na fila assinada por ela é cancelada, e qualquer ordem assinada por ela que chegue à rede depois é rejeitada. Todas as mensagens que a exchange pede para a sua carteira assinar estão listadas em assinaturas oficiais.