Thread by @0xNekr

[#CALENDRIER DE L'AVENT 13/25]

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

Jour 13 / 25 :

Création #ERC721 : Comment gérer les métadonnées ? Est-ce que les métadonnées sont immuables ? Développons ça !

🧵

Tweet précédent

🔽

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

Dans le thread précédent, nous avons appréhendé le système d'Arbre de Merkle, c'est un gros sujet quand on parle de cryptomonnaie.

Le deuxième gros sujet, plus spécifique aux NFTs, ce sont les métadonnées... mais qu'est-ce que c'est ?

Pour vulgariser simplement, les métadonnées sont des informations que nous pouvons attacher aux IDs de token afin de les définir plus précisément.

C'est grâce à ces métadonnées que nous pouvons spécifier un nom, une image, une description, des attributs, etc.

Car, de base, un token NFT n'est rien d'autre qu'un ID lié à un contrat, en l'état, il ne représente pas grand-chose.

Et c'est sur ce token que nous pouvons attacher des informations (tel que les métadonnées) afin de le définir plus précisément et lui apporter plus d'intérêt !

Il existe un standard de métadonnées pour que les plateformes puissent comprendre vos métadonnées.

#Opensea fournis une bonne documentation sur le sujet, et je vous conseille de la lire si vous souhaitez approfondir le sujet (c'est très important)

docs.opensea.io/docs/metadata-…

En reprenant la documentation ci-dessus, on peut voir que les métadonnées doivent être sous le format "json".

Il est important d'utiliser des mots-clés précis tels que "description", "image", "name", "attributes", etc.

Pour une liste complète, il faut lire la doc d'Opensea !

Vous l'aurez compris, les métadonnées sont des informations supplémentaires que nous attachons à notre ID de Token afin de le définir plus précisément !

C'est ce qui permet aux BAYC, par exemple, de posséder une image et des attributs.

Mais comment et où stocker ces infos ?

Le problème est précisément là !

La plupart du temps, ces métadonnées ne sont pas stockées on-chain...

C'est-à-dire que nous stockons toutes ces informations en dehors de la blockchain, ce qui veut dire que ces informations peuvent disparaître ou peuvent être modifiées!

🔽

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

Il existe donc plusieurs possibilités "classiques" :

- Stocker on-chain
- Stocker off-chain de manière centralisée
- Stocker off-chain de manière décentralisée

Il est même possible de mélanger plusieurs choses.

Voici les avantages et inconvénients de chaque technique.

🔽

> Stocker on-chain :

Avantage : ça ne peut pas disparaitre sans raison ! Si c'est sur la blockchain, c'est immuable tant qu'on ne peut pas le modifier !

Inconvénient : on ne peut pas stocker 10000 images sur la blockchain... cette solution n'est pas viable pour cela.

> Stocker off-chain : centralisée

Avantage : faible coût, le projet peut modifier les NFTs à sa guise sans engendrer de transactions.

Inconvénient : rien d'immuable, le projet peut décider de tout supprimer et vous ne pourrez rien y faire.

> Stocker off-chain : décentralisée

Avantage : faible coût, tout est stocké off-chain mais sur un réseau décentralisé de partage de document.

Inconvénient : il n'est pas impossible que tout ce réseau autre tombe, et que tous vos NFTs perdent leurs métadonnées. Pas de risque 0.

C'est donc cette troisième et dernière solution que la plupart des projets vont mettre en place.

C'est aussi ce que nous allons faire aujourd'hui ! Mais avant tout, il faut comprendre sur quoi repose ce fameux réseau off-chain décentralisé : #IPFS

fr.beincrypto.com/apprendre/ipfs…

Je ne suis pas un expert de la génération d'image pour créer des NFTs, je vais donc vous passer directement un lien vers des métadonnées déjà enregistrées sous IPFS afin que nous puissions avancer pour la suite.

Ce lien, c'est un URI, un identifiant de ressource uniforme !

Et nous n'allons pas utiliser n'importe quel URI.
Nous allons prendre celui-ci :

ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/

Qui est celui du projet #BAYC.

Mais comment cet URI peut lier notre token à nos informations s'il n'est pas directement on-chain?

Une fonction dans le contrat permet de retourner, pour chaque ID de NFT, un URI vers ses métadonnées.

Cette fonction s'appelle "tokenURI" pour ERC721 et nous allons la mettre en place.

Pour l'ID #0 on aura :

"ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/0"

Passons au développement de notre contrat !

Avant tout, si vous n'avez pas fait les jours précédents, vous pouvez récupérer le contrat à jour dans le dossier "contracts/Jour13".

On commence par rajouter une variable.

Cette variable est un booléen qui va nous servir pour définir si les métadonnées peuvent être modifiées ou non.

Le but est de se laisser la possibilité de modifier au début, et une fois que tout est bon et en place, qu'on puisse les figer.

Suite logique, il faut définir la fonction qui va permettre de figer les métadonnées.

Toute simple, c'est une fonction "onlyOwner" qui ne peut donc être appelée que par le propriétaire du contrat.

Elle va simplement passer notre variable à "true".

Et voici la fonction la plus importante. Fonction d'ERC721, c'est elle que les plateformes utilisent pour récupérer les métadonnées.

C'est donc une vue "override" de la fonction de base, on vérifie si le token existe puis en renvoie la concaténation de l'URI et de l'ID.

Pour finir, nous allons définir une fonction pour modifier notre URI.

Disponible que pour le propriétaire, cette fonction permet de modifier la variable "baseTokenURI".

Cependant, il faut que notre variable "metadataFrozen" soit à "false", sinon on ne peut plus rien modifier !

Et c'est fini pour aujourd'hui !

Demain on attaque la dernière étape de notre contrat ERC721...

Le mint ! Après ça, on pourra passer au token ERC20 ! 🔥

Like & Rt le thread si ça ta plu ! 👋

https://twitter.com/0xNekr/status/1602725113761185792?s=20&t=jmIiyoC0JpDBAirIXnsNeA