SHUI水
DeFi · Pédagogie

Farm SHUI/SOL : ce qui se passe on-chain, du dépôt aux récompenses

L'article d'introduction explique pourquoi la liquidité compte. Celui-ci ouvre le capot : programmes, comptes, transactions et calculs qui interviennent entre le dépôt de SHUI et de SOL et le retrait des récompenses.

Par l'équipe SHUIPublié le Mis à jour le Lecture : 10 min
Cycle on-chain de la Farm SHUI/SOL : dépôt dans le pool CPMM, jetons LP, dépôt dans la Farm v6, récompenses réclamées par un retrait de 0 LP, puis retrait complet.
Quatre étapes, quatre transactions. Chacune est signée par l'utilisateur ; aucun taux n'est représenté car il dépend de la campagne en cours.

Farmer, c'est enchaîner plusieurs opérations on-chain distinctes, chacune avec ses comptes et ses règles. Comprendre cet enchaînement aide à savoir ce que l'on signe, ce que l'on détient à chaque étape et comment en sortir. Les bases (pourquoi la liquidité compte, ce qu'est une Farm) sont traitées dans l'article d'introduction ; ici, on reste au niveau des transactions.

01Les programmes utilisés

Deux programmes publics de Raydium interviennent, sans aucun programme propriétaire SHUI :

Programmes et comptes utilisés par la Farm SHUI/SOL
RôleAdresse
Programme Raydium CPMM (pools à produit constant)CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C
Pool SHUI/SOL52w19QzFSHPYTqJWk4akyhVsoeyg4A6iVn2bRsGAAXEC
Mint du jeton LP SHUI/SOLFwTPGe7q8teWCppWCXT1pQixQtDsaMrCNTrYBPPWfrrn
Programme Raydium Farm v6FarmqiPv5eAj3j1GMdMCMUGXqPUvmquZtMy86QH6rzhG
Farm SHUI/SOLD2EvBpd92yGxTpT39PxV8S5NLisGfJmzEfTUwRkzVpXu

Toutes ces adresses peuvent être consultées sur un explorateur comme Solscan. Le site les utilise comme liste fixe : une transaction qui ferait intervenir un autre programme serait refusée avant même d'être proposée au wallet.

02Fournir de la liquidité au pool CPMM

Un pool CPMM détient deux réserves, ici SHUI et SOL, dans des comptes appelés vaults. Son prix découle d'une règle simple : le produit des deux réserves, x × y = k, reste constant lors d'un échange (aux frais près). Quand quelqu'un achète du SHUI, la réserve de SHUI baisse, celle de SOL monte, et le prix du SHUI augmente.

Pour ajouter de la liquidité, il faut déposer les deux actifs au ratio actuel du pool. Déposer dans un autre ratio modifierait le prix. En échange, le pool émet des jetons LP, qui représentent la part détenue.

Cette étape se fait sur l'interface de Raydium, un service tiers distinct de SHUI. Les jetons LP arrivent dans le wallet de l'utilisateur ; ils sont des tokens SPL ordinaires.

03Déposer ses LP dans la Farm

La Farm est un second programme, indépendant du pool. Déposer ses jetons LP, c'est les transférer dans le vault de LP de la Farm, contrôlé par une autorité du programme, et non par SHUI.

Pour suivre la position de chaque utilisateur, la Farm v6 utilise un compte dédié, appelé ledger, dérivé de l'adresse de la Farm et de celle du wallet. Il enregistre le nombre de LP déposés et une « dette de récompense », qui sert au calcul décrit plus bas. Lors du premier dépôt, ce compte est créé ; sa création immobilise une petite quantité de SOL pour la location d'espace sur Solana.

04Comment les récompenses s'accumulent

Une campagne de Farm émet des récompenses à un rythme fixé par seconde, pendant une période donnée. Ces récompenses ne sont pas envoyées en continu : elles sont calculées au moment où l'on interagit.

Le programme maintient un compteur cumulé, la récompense par part. À chaque interaction, il l'augmente de la quantité émise depuis la dernière mise à jour, divisée par le total de LP déposés. La récompense en attente d'un utilisateur vaut alors :

en attente = LP déposés × récompense cumulée par part − dette de récompense

La dette de récompense est mise à jour à chaque dépôt ou retrait, pour que l'utilisateur ne perçoive que ce qui a été émis pendant qu'il était présent. Deux conséquences en découlent : plus le total déposé est élevé, plus la part de chacun est faible ; et aucune récompense n'est émise en dehors des dates de la campagne. La page Farm du site affiche une estimation de la récompense en attente calculée à partir de ces données on-chain.

05Réclamer ses récompenses

La Farm v6 ne possède pas d'instruction « réclamer » distincte. Réclamer revient à effectuer un retrait de 0 LP : le programme met à jour les compteurs, verse les récompenses en attente depuis le vault de récompenses vers le compte SHUI du wallet, et laisse les LP en place. C'est ce que faisait l'onglet « Réclamer » de l'interface Farm du site, aujourd'hui désactivée.

06Retirer

Retirer se fait en deux temps. D'abord, retirer les LP de la Farm : le programme rend les LP au wallet et verse au passage les récompenses en attente. Ensuite, si on le souhaite, retirer la liquidité du pool CPMM : les LP sont brûlés et le pool rend la part correspondante de SHUI et de SOL, au ratio du moment. Cette seconde étape se fait sur l'interface de Raydium.

07Côté site : ce qui se passe avant la signature

Les étapes d'une transaction sur le site SHUI : préparation, récapitulatif, simulation, signature dans le wallet, confirmation.
Même chaîne que le Swap. Si la simulation échoue, rien n'est proposé au wallet.

Lorsque l'interface Farm était accessible, pour chaque action (déposer, retirer, réclamer), le site construisait la transaction, vérifiait qu'elle ne faisait intervenir que les programmes et comptes attendus, puis la simulait. Il vérifiait aussi que l'instruction construite était bien celle demandée : un dépôt ne pouvait pas se transformer en retrait. Il contrôlait enfin les soldes : on ne peut pas déposer plus de LP qu'on en détient, ni retirer plus qu'on en a déposé.

08Erreurs possibles et frais

  • SOL insuffisant : chaque transaction coûte des frais réseau payés en SOL, et la création du ledger ou d'un compte de token immobilise un peu de SOL.
  • Blockhash expiré : si la signature tarde, la transaction n'est plus valide ; il suffit de la reconstruire.
  • Campagne terminée : les dépôts restent possibles techniquement, mais aucune récompense nouvelle n'est émise.
  • Simulation en échec : le site affiche l'erreur et ne propose rien au wallet.

09Perte non permanente et risques

Fournir de la liquidité expose à la perte non permanente. Quand le prix relatif entre SHUI et SOL change, le pool rééquilibre ses réserves : l'utilisateur récupère alors plus de l'actif qui a baissé et moins de celui qui a monté. La valeur retirée peut être inférieure à celle qu'il aurait eue en conservant simplement ses deux actifs.

Les récompenses éventuelles d'une campagne ne compensent pas nécessairement cet écart. S'y ajoutent les risques propres aux cryptoactifs : volatilité, dépendance à des programmes tiers, et irréversibilité des transactions. La Farm on-chain reste consultable sur Solscan (l'interface Farm du site est désactivée) ; l'Explorer rassemble les adresses publiques du projet.

Partager cet article

Cet article est publié à titre d'information. Il ne constitue ni un conseil en investissement, ni une incitation à acheter, vendre ou déposer des cryptoactifs. Les cryptoactifs sont volatils et comportent un risque de perte en capital. Vérifiez toujours les informations par vous-même.

À lire aussi

Adresse copiée