Thread by @0xNekr

[#CALENDRIER DE L'AVENT 23/25]

25 jours pour apprendre à développer des Smart Contracts en #Solidity 🔥

Jour 23 / 25 :

Staking : Comment récupérer la liste des tokens stakés par un utilisateur ? C'est ce que nous allons mettre en place aujourd'hui 💪

🧵

Tweet précédent

🔽

https://twitter.com/0xNekr/status/1605986638454149120

Avant de commencer, vous pouvez repartir du code développé hier.

Il est présent dans le répertoire "Jour23/Staking_Jour23.sol".

N’oubliez pas de modifier les noms et les imports.

Si vous n'avez pas ce répertoire : git pull.

Lorsqu'on définit un contrat de staking, il est super important de bien informer l'utilisateur via une interface, par exemple, via un dashboard sur une dApp.

Mais pour cela il faut pouvoir accéder aux informations du contrat.

Si on résume, nous avons comme informations aujourd'hui :

- Le nombre de NFTs stakés.
- Pour chaque ID staké, une structure avec le propriétaire et le timestamp de staking.
- Les récompenses récupérables pour un propriétaire + sa liste d'IDs.

En l'état, il nous manque quelque chose de très important si on souhaite afficher à l'utilisateur quelles sont ses NFTs qu'il a en staking :

Une liste d'IDs stakés par adresse !

Nous allons voir comment faire, et ce n’est pas si simple que ça...

On commence donc par définir une fonction "tokensByOwner" qui prend en paramètre une adresse.

C'est une vue externe qui va retourner un tableau de "uint" car nous voulons récupérer une liste d'IDs !

La gestion des tableaux est un peu particulière en Solidity.

Pour gérer correctement vos tableaux, il faut en définir la taille en amont.

Nous allons récupérer le nombre de NFTs existant sur le contrat ERC721 grâce à la fonction "totalSupply" afin de pouvoir créer le tableau.

La variable nous permet de créer un tableau avec en taille le nombre de NFTs du contrat.

Nous sommes sûrs d'avoir un tableau assez grand qui puisse donc gérer le cas où un seul propriétaire stake tous les NFTs !

C'est un tableau de "uint", le "(supply)" défini la taille !

Nous devons utiliser un tableau temporaire ("tmpList"), car à ce stade, il est impossible de définir une taille précise sur le nombre de tokens que notre adresse d'entrée a staké !

Nous allons devoir créer un deuxième tableau pour retourner nos valeurs par la suite !

Nous allons ensuite créer une variable "stakedCount" et l'initialiser à zéro.

Cette variable va permettre d'incrémenter le nombre de NFTs stakés par l'adresse pour les enregistrer dans notre tableau temporaire, mais aussi pour pouvoir créer un tableau à la bonne taille !

Nous allons ensuite parcourir une boucle "for" sur l'ensemble des NFTs existant sur le contrat ERC721 en regardant si, pour chaque ID, il est staké par notre utilisateur.

Si c'est le cas, on stocke dans "tmpList" à l'index "stakeCount" le numéro du NFT (i).

Après ce traitement, nous avons donc une liste "tmpList" qui contient bien la liste des tokens que l'utilisateur a stakés !

Mais elle n'est pas retournable en l'état au vu de la taille prédéfinie.

Nous devons créer une nouvelle liste.

C'est pourquoi nous créons une nouvelle liste, que j'ai appelée "tokensList" et qui est définie de la taille de "stakeCount" qui correspond pile au nombre de NFTs stakés.

C'est cette liste que nous allons retourner à l'utilisateur !

Ensuite, on défini une boucle "for" qui va parcourir autant de fois que de NFTs stakés afin d'alimenter notre nouvelle liste avec ce les infos de notre liste temporaire.

Avec ceci, nous avons une liste de taille exacte contenant la liste des NFTs stakés par l'utilisateur !

Dernière étape, il ne reste qu'à retourner la liste à l'utilisateur !

La fonction va donc retourner un tableau de "uint" contenant les IDs de NFT.

Ce tableau devrait ressembler à quelque chose comme :

[0, 12, 16, 18]

dépendant des NFTs de l'utilisateur.

Et c'est déjà fini !

Vous avez donc développé :

- Un contrat ERC721 complet.
- Un token ERC20.
- Un contrat de staking/destaking avec votre token en récompense.

Je pense que vous pouvez être fier de vous si vous êtes arrivé jusqu'ici ! 💪

On se retrouve demain pour le déploiement de toute la solution !

Je vais vous préparer un script qui permet de déployer l'ensemble des contrats d'un seul coup et dans le bon ordre afin que vous puissiez bien comprendre comment cela fonctionne !

À demain, même heure👋