Recompensas e resgates

Em staking na cunhagem

Quando uma perda cunha BACK para você, o contrato Tokenomics entrega os tokens direto ao contrato Staking, que os registra no seu nome. Daquele momento em diante seus tokens participam de toda distribuição. Não há transação de staking, nem saída do staking, nem período de espera, nem bloqueio, nem forma de mover os tokens: transfer, transferFrom e approve do contrato do token sempre falham. O saldo que uma carteira ou um explorador mostra é a contagem viva dos seus tokens feita pelo contrato Staking.

O cronograma de queima

Os tokens queimam em lotes diários às 00:00 UTC. Um token cunhado em t queima na primeira meia-noite UTC igual ou posterior a t + contagem, com a contagem em 7 dias; o dono pode defini-la dentro de 1 dia–30 dias pelo timelock, e uma mudança vale para os tokens cunhados depois dela. Toda cunhagem de uma conta com o mesmo dia de queima forma um lote, e o app mostra seus lotes com os dias.

Exemplo: uma perda liquidada em seg., 5 de jan., 15:30 UTC. A contagem termina em seg., 12 de jan., 15:30 UTC, então os tokens queimam em ter., 13 de jan., 00:00 UTC, a primeira meia-noite depois disso. Uma perda liquidada pouco antes da meia-noite vive pouco mais que a contagem; uma liquidada logo depois, quase um dia a mais.

De a contagem não correr antes de o LP encher seguem duas regras:

• Antes de o LP contábil alcançar $500,000 pela primeira vez, nada queima: os tokens cunhados até então ficam sem data. A liquidação que pela primeira vez leva o LP contábil ao teto dispara todas as contagens de uma vez: cada token sem data recebe o dia de queima que a contagem dá a essa liquidação, e as cunhagens posteriores contam a partir da própria liquidação. Se o LP depois cair abaixo do teto, nada recomeça.
• Nada roda sozinho. Uma queima é aritmética de datas que o contrato aplica na próxima vez que toca uma conta ou distribui: seu saldo e a oferta são calculados como estão agora, sem os lotes que já passaram do dia, tenha ou não uma transação registrado a queima.

Resgates

As recompensas se acumulam sobre seus tokens por um acumulador global e são creditadas na sua conta sempre que ela é liquidada, numa cunhagem ou num resgate; uma leitura calcula o mesmo valor sem gravá-lo. Resgate quando quiser: o resgate move suas recompensas, em USDC, do saldo do contrato de staking no Exchange para o seu, de onde você pode operar com elas ou sacá-las. Um resgate liquida a conta primeiro, então inclui o que cada lote rendeu até a queima.

Dois jeitos de resgatar:

• Pelo app, com uma assinatura da carteira: a mensagem Claim assinada vai para o relayer, que a envia como claimBySig. Uma chave de sessão não pode assiná-la.
• Pela sua carteira, chamando você mesmo claim() no contrato de staking: precisa de um pouco de HYPE para o gás e funciona com os nossos serviços no ar ou não.

Para ver suas recompensas não resgatadas sem uma transação, leia pendingReward(address) no contrato de staking; ele só inclui recompensas já distribuídas. O que você rendeu continua resgatável depois que o seu último token queimou, sem prazo.

Como as recompensas chegam

As recompensas chegam aos stakers em dois passos:

1. O Exchange recolhe a parte dos stakers de cada taxa. Só o contrato de staking pode chamar pushStakerFees nele, o que encaminha essa parte, mais qualquer valor do LP acima de $500,000, para o saldo do contrato de staking.
2. Uma distribuição então reparte o que o contrato de staking acabou de receber entre os tokens vivos naquele momento. Distribuir é reservado à chamada distribute do keeper distribuidor e aos pedidos Distribute assinados enviados pelo relayer; ela sempre repassa as taxas primeiro.

Nosso keeper distribui a cada 30 segundos quando há pelo menos $100 esperando, então ninguém precisa pensar nisso. Enquanto houver menos de 1 BACK vivos no total, as novas recompensas esperam até haver stake suficiente para dividi-las. As recompensas não são distribuídas de forma contínua: cada distribuição é dividida entre os tokens vivos naquele momento, na proporção, então um lote rende toda distribuição até a meia-noite em que queima.

A matemática

O contrato guarda um número, as recompensas por token em staking desde o início, escalado por 10^36: cada distribuição soma a ele os novos USDC divididos pelo stake vivo. Cada conta guarda seu stake, suas recompensas creditadas e o valor do acumulador na última liquidação.

As queimas fazem o stake cair num cronograma, então o acumulador tem um relógio. Cada distribuição primeiro percorre os dias desde a anterior: para cada dia com tokens marcados para queimar, ela registra o acumulador como estava naquela meia-noite (nada o moveu desde então, porque o acumulador só muda nas distribuições) e tira o lote do stake. A liquidação de uma conta percorre depois os próprios dias desde a última liquidação: cada lote que queimou rende do último valor do acumulador da conta até o valor registrado para o seu dia de queima, e o resto do stake rende até o valor atual.

recompensa de um lote queimado no dia d = amount · (accAtDayStart[d] − accThen) / P
recompensa do stake vivo                = stake  · (acc − accThen) / P

Cada parcela arredonda para baixo e cada distribuição arredonda seu passo para baixo, então o total creditado nunca passa do que foi distribuído. O percurso pelos dias é limitado pela contagem mais longa que o dono pode definir, então o gás de uma liquidação não depende de quanto tempo a conta ficou parada.