Récompenses et réclamation

Staké à l’émission

Quand une perte émet des BACK pour vous, le contrat Tokenomics remet les jetons directement au contrat Staking, qui les inscrit à votre nom. Dès cet instant, vos jetons participent à chaque distribution. Il n’y a ni transaction de staking, ni déstaking, ni délai d’attente, ni blocage, ni aucun moyen de déplacer les jetons : transfer, transferFrom et approve du contrat du jeton échouent toujours. Le solde qu’affiche un portefeuille ou un explorateur est le décompte vivant de vos jetons tenu par le contrat Staking.

Le calendrier de brûlage

Les jetons brûlent par lots quotidiens à 00:00 UTC. Un jeton émis à t brûle au premier minuit UTC qui suit ou coïncide avec t + compte à rebours, le compte à rebours étant de 7 jours ; le propriétaire peut le régler dans 1 jour–30 jours par le timelock, et un changement s’applique aux jetons émis ensuite. Toutes les émissions d’un compte pour un même jour de brûlage forment un lot, et l’app affiche vos lots avec leurs jours.

Exemple : une perte réglée le lun. 5 janv., 15:30 UTC. Le compte à rebours se termine le lun. 12 janv., 15:30 UTC, donc les jetons brûlent le mar. 13 janv., 00:00 UTC, le premier minuit qui suit. Une perte réglée juste avant minuit vit à peine plus que le compte à rebours ; une perte réglée juste après vit presque un jour de plus.

Du fait que le compte à rebours ne court pas avant que le LP soit rempli, deux règles s’ensuivent :

• Avant que le LP comptable n’atteigne $500,000 pour la première fois, rien ne brûle : les jetons émis jusque-là ne sont pas programmés. Le règlement qui amène pour la première fois le LP comptable au plafond démarre tous les comptes à rebours d’un coup : chaque jeton non programmé reçoit le jour de brûlage que le compte à rebours donne à ce règlement, et les émissions suivantes comptent depuis leur propre règlement. Si le LP retombe ensuite sous le plafond, rien ne redémarre.
• Rien ne tourne tout seul. Un brûlage est un calcul de dates que le contrat applique la prochaine fois qu’il touche un compte ou distribue : votre solde et l’offre sont calculés à l’instant présent, lots passés leur jour exclus, qu’une transaction ait ou non enregistré le brûlage.

Réclamation

Les récompenses s’accumulent sur vos jetons par un accumulateur global et sont créditées à votre compte chaque fois qu’il est réglé, à une émission ou à une réclamation ; une lecture calcule le même montant sans l’écrire. Réclamez quand vous voulez : la réclamation déplace vos récompenses, en USDC, du solde du contrat de staking sur l’Exchange vers le vôtre, d’où vous pouvez trader avec ou les retirer. Une réclamation règle d’abord le compte, donc elle inclut ce que chaque lot a gagné jusqu’à son brûlage.

Deux façons de réclamer :

• Depuis l’app, par une signature du portefeuille : le message Claim signé va au relayer, qui le soumet comme claimBySig. Une clé de session ne peut pas le signer.
• Depuis votre portefeuille, en appelant vous-même claim() sur le contrat de staking : il faut un peu de HYPE pour le gas, et cela fonctionne que nos services soient en ligne ou non.

Pour voir vos récompenses non réclamées sans transaction, lisez pendingReward(address) sur le contrat de staking ; il n’inclut que les récompenses déjà distribuées. Ce que vous avez gagné reste réclamable après que votre dernier jeton a brûlé, sans échéance.

Comment arrivent les récompenses

Les récompenses atteignent les stakers en deux étapes :

1. L’Exchange collecte la part des stakers sur chaque frais. Seul le contrat de staking peut appeler pushStakerFees dessus, ce qui transmet cette part, plus toute valeur du LP au-delà de $500,000, au solde du contrat de staking.
2. Une distribution répartit ensuite ce que le contrat de staking vient de recevoir entre les jetons vivants à cet instant. Distribuer est réservé à l’appel distribute du keeper distributeur et aux requêtes Distribute signées soumises via le relayer ; cela pousse toujours les frais d’abord.

Notre keeper distribue toutes les 30 secondes dès qu’au moins $100 attendent, pour que personne n’ait à y penser. Tant que moins de 1 BACK sont vivants au total, les nouvelles récompenses attendent qu’il y ait assez de mise pour les partager. Les récompenses ne sont pas versées en continu : une distribution est partagée par les jetons vivants à cet instant, au prorata, donc un lot gagne toutes les distributions jusqu’au minuit où il brûle.

Le calcul

Le contrat tient un seul nombre, les récompenses par jeton staké depuis le début, mis à l’échelle par 10^36 : chaque distribution y ajoute les nouveaux USDC divisés par la mise vivante. Chaque compte stocke sa mise, ses récompenses créditées et la valeur de l’accumulateur à son dernier règlement.

Les brûlages font baisser la mise selon un calendrier, donc l’accumulateur a une horloge. Chaque distribution parcourt d’abord les jours écoulés depuis la précédente : pour chaque jour où des jetons sont programmés pour brûler, elle enregistre l’accumulateur tel qu’il était à ce minuit (rien ne l’a déplacé depuis, puisque l’accumulateur ne bouge qu’aux distributions) et retire le lot de la mise. Le règlement d’un compte parcourt ensuite ses propres jours depuis son dernier règlement : chaque lot qui a brûlé gagne depuis la dernière valeur de l’accumulateur du compte jusqu’à la valeur enregistrée pour son jour de brûlage, et le reste de la mise gagne jusqu’à la valeur actuelle.

récompense d’un lot brûlé le jour d = amount · (accAtDayStart[d] − accThen) / P
récompense de la mise vivante       = stake  · (acc − accThen) / P

Chaque morceau arrondit vers le bas et chaque distribution arrondit son pas vers le bas, donc le total crédité ne dépasse jamais ce qui a été distribué. Le parcours des jours est borné par le compte à rebours le plus long que le propriétaire puisse régler, donc le gas d’un règlement ne dépend pas du temps pendant lequel le compte est resté absent.