Ce répertoire contient la démo pour la semaine des étudiants du gymnase Sismondi. Pendant cette semaine, les étudiants vont passer une journée à l'EPFL pour apprendre plus sur les blockchains et les NFTs.
Transparents de la journée: Blockchains et NFTs
Le code original a été préparé pour être utilisé dans des machines virtuelles Linux. Pour une utilisation plus simple, le code a été re-écrit pour être utilisé avec Docker. Si vous voulez suivre les exercices proposés ici, il vous faudra donc installer Docker:
Pour éditer le code vous pouvez utiliser n'importe quel editeur de code. Je vous suggère d'utiliser Visual Studio Code:
Installation Visual Studio Code
Il faut installer les extensions suivantes:
Soliditypour le smart contractPythonpour changer la création du smart contrat
Puis, on va faire un portefeuille pour vos jetons, et commencer à remplir le portefeuille. Vu que cette opération va prendre pas mal de temps, on y va avant d'avoir vu ce que ça fait vraiment.
On verra que les jetons sur la blockchain sont protégés par une "clé privée". Cette clé privée est stockée dans un portefeuille, ou "Wallet" en Anglais. Ces clés privées sont comme un mot de passe, mais beaucoup plus long, et avec des propriétés mathématiques intéressantes pour les blockchains. Si quelqu'un réussi à copier vos clés privées, cette personne a le même accès que vous à votre portefeuille. Donc ne donnez votre clé privée à personne! Le portefeuille Metamask demande un mot de passe qui protègera vos clés privées. Pour sécuriser, il est conseillé d'écrire le "recovery phrase" quelque part.
On utilisera ici le portefeuille le plus connu: Metamask.
Il faut être très prudent dans le monde des blockchains sur les scams (tricheries) et vols. Vu que la clé privée est la seule chose qui protège vos jetons, du moment que quelqu'un la possède, cette personne peut faire ce qu'elle veut avec vos jetons. Donc, il est impératif de:
- ne jamais partager sa clé privée
- ne pas installer des logiciels d'une source douteuse
Aller sur le site de Metamask et suivre les instructions d'installation:
- On va faire confiance à Firefox pour stocker le mot de passe
- Sécurisez l'installation
- Copiez TOUS LES 12 mots de récupération dans un éditeur de texte
- Pour confirmer, remplissez les espaces vides - ceci est pour vérifier que vous avez bien noté votre phrase de récupération
- Suivez les instructions pour
pinMetamask - Choisissez le réseau "Sepolia": cliquez en haut à gauche dans
Ethereum Mainnet, puis cochezShow test networks, ensuite choisissez "Sepolia".
Pour la prochaine étape, vous avez besoin de quelques jetons. Les réseaux blockchains de test vous permettent de recevoir des jetons gratuits. Bien sûr que vous ne pouvez pas revendre ces jetons, ils ne valent rien.
Afin de recevoir quelques jetons, vous pouvez copier votre adresse depuis Metamask dans le robinet suivant:
L'adresse PUBLIQUE commence avec un 0x et contient des chiffres et des lettres a-f.
Une fois le robinet ouvert, on va continuer la présentation. Assurez-vous que le "minage" continue en arrière-plan, parce qu'il vous faudra 1 SepoliaETH pour le reste de la journée.
Assurez-vous que vous avez au moins 1 SepoliaETH jusqu'à maintenant. Puis continuez sur l'étape suivante.
Quand le montant est atteint, cliquez sur Stop Mining, puis Claim Rewards et attendez que vos jetons
se trouvent sur votre compte.
Maintenant, on va utiliser Etherscan pour voir ce qui s'est passé.
Entrez votre adresse publique sur le site suivant, afin de
suivre les transactions sur votre compte et depuis votre compte:
Si vous ne voyez pas votre transaction, assurez-vous que vous êtes connecté au réseau "Sepolia".
Pour finir cette partie, vous allez transférer quelques jetons à vos voisins. Ne mettez pas trop de jetons, quelque chose comme 0.01 est très bien.
- Demandez à vos voisins leur adresse privée de leur portefeuille
- Assurez-vous qu'ils ne vous la donnent pas! Sinon, vous pouvez créer un nouveau portefeuille et transférer tous leurs jetons chez vous!
- Demandez à vos voisins leur adresse publique de leur portefeuille. Vous pouvez utiliser "Chatzy"
- Ouvrez "Metamask" dans Firefox
- Cliquez sur "Send"
- Entrez l'adresse que vous avez reçu de vos voisins
- Entrez 0.001 SepETH et confirmez
Utilisez de nouveau Etherscan pour visualiser votre compte. Cherchez quel lien il faut cliquer pour voir le compte de vos voisins.
Brownie est un outil de développement et de teste pour écrire des smart contracts pour Ethereum. Brownie réunit tous les outils nécessaires pour intéragir avec Ethereum:
- un compilateur pour traduire un smart contract dans un format convenable pour Ethereum
- une blockchain de test locale pour faire les premiers pas
- les outils nécessaires pour envoyer et intéragir avec un smart contract
Ici, on va configurer cet outil avec la clé privée et un accès supplémentaire nécessaire pour le bon fonctionnement.
Pour commencer, il faut télécharger le répertoire github sur votre ordinateur. Suivez ces étapes:
- Ouvrez un terminal de commande sur votre ordinateur a. Pour Linux et MacOS, c'est simple. Pour Windows, il faut s'assurer que c'est un terminal du WSL: https://learn.microsoft.com/en-us/windows/wsl/install
- Copiez la commande suivante dans votre terminal - attention, tous les caractères doivent être copiés/collés tel quel! Vous pouvez faire un copier/coller depuis Firefox:
git clone https://github.com/c4dt/sismondi_nft_2024Une fois que c'est téléchargé, vous pouvez changer dans ce répertoire avec la commande suivante:
cd sismondi_nft_2024
lsCeci devrait vous montrer les fichiers dans le répertoire. Garder le terminal ouvert, on en aura encore besoin!
Ouvrez maintenant le fichier NOTES.md dans Visual Studio Code (VSCode) et commencez
à le remplir:
- Copiez la phrase de récupération depuis votre éditeur de texte dans ce fichier
- Recopiez votre adresse PUBLIQUE depuis Metamask dans le fichier
NOTES.md - Faites de même pour la clé privée. Elle est protégée par Metamask:
- Cliquez sur les trois petits points à droite du nom de votre compte
- Choisissez "Account details", puis "Show private key"
- Confirmez avec votre mot de passe
- Appuyez longuement sur le bouton
- Copiez/collez la clé privée depuis la fenêtre dans le fichier
NOTES.md
Afin de pouvoir envoyer des commandes à la chaîne de teste "Sepolia", il faut configurer
le fichier .env.
Le plus simple est de copier le fichier env.example dans le fichier .env.
- Ouvrez le fichier
env.exampleavec VSCode Fichier->Enregistrer sous- Changer le nom en
.env - Enregistrez avec
OK - Confirmer que vous voulez faire un fichier caché
- Vérifiez dans le terminal que le fichier s'affiche en lançant la commande suivante:
cat .envMaintenant, vous pouvez copier la clé privée dans votre fichier .env.
Vous la trouvez dans votre fichier NOTES.md.
Copiez/collez la clé privée dans le fichier .env
Pour communiquer avec la blockchain, il vous faut un intermédiaire. Ici, on va choisir Infura, et il faut créer un compte. Allez sur
et entrez votre nom (vous pouvez mettre n'importe quoi) et votre email. Il est important que l'email soit correcte, parce qu'ils vous envoient un lien qu'il faut pour confirmer.
Une fois la régistration confirmée, vous pouvez activer la clé d'accès. Cette clé vous permet de vous identifier auprès d'Infura pour créer votre contrat.
- Cliquez sur
API Keysen haut - Choisissez la clé existante
My First Key. - Dans la page qui s'ouvre, cochez la case
SepoliasousEthereumet appuyez surSave Changes. - En haut, vous trouvez la clé d'accès que vous pouvez Copier/coller dans votre
.env.
Votre .env doit maintenant contenir quelque chose comme ça.
Bien sûr que la clé privée et la clé d'accès auront des valeurs différentes!
PRIVATE_KEY = 0x41ede96cc603bf0d7a0e0bd67819ebaf5802ae8ea1060a4f6f3d8b9d723a24ea
WEB3_INFURA_PROJECT_ID = a691dd6311fb41eb6f3d8b9d723a24ea
Faites le test suivant pour voir si tout a bien fonctionné. Lancez la commande suivante:
./brownie.sh run test_env.pyCeci coûte à peu près 0.007 SepoliaETH. Le test devrait prendre autour de 30 seconds et il va vous côuter quelques jetons.
Avant d'installer le contrat Sismondi_NFT sur la blockchain, il faut le configurer avec vos images. Il faut commencer par copier vos images sur l'ordinateur de l'EPFL. Puis, il faut transformer les images pour qu'elles soient compatibles avec le smart contract. A la fin, il faut copier les images dans le smart contract.
Il y a trois types d'images, avec deux versions pour chaque type:
- Background (fond) qui peut être une image simple
- Shoe (chaussure) qui représente la chaussure, mais avec un arrière-plan transparent
- Sole (semelle) qui représente la semelle, mais avec un arrière-plan transparent
Toutes les six images doivent avoir la même dimension! Et les images de la chaussure et de la semelle doivent être transparent en-dehors de là où il y a le contenu. Vous trouvez un exemple dans le dossier images.
- Copier les images dans les sous-répertoires de
./imagesen remplaçant les images qui y sont déjà présentes - Ouvrez le fichier
./scripts/images.py - Modifiez le nom des fichiers - faites attention au chemin d'accès
- Lancez le script suivant dans le terminal qui va créer le contrat
./contracts/SismondiNFT.sol:
./mk_contract.sh- Vérifiez que les images résultantes sont bonnes en visualisant le répertoire
./images/results - Vous pouvez aussi modifier la liste des mots qui est utilisé pour nommer vos NFTs. Essayez de montrer de la maturité dans le choix de vos mots...
Chaque NFT se verra attribuer aléatoirement une des images et aussi aléatoirement un des mots de la liste.
Avant d'installer le contrat sur la blockchain Sepolia, on va d'abord le tester localement. Ceci peut assurer que vous n'avez pas fait d'erreur dans le copier/coller des images dans le contrat. Lancez la commande suivante:
./brownie.sh run sismondi_test.py --network developmentSi tout va bien, vous devriez voir un total de 3 blocs:
- block 0: installation du contrat
- block 1: mint d'un premier NFT
- block 2: mint d'un deuxième NFT
Il se peut qu'il y a une erreur qui se termine avec
Terminating local RPC client
Ce n'est pas grave, si ou moins, il y a trois blocs qui s'affichent.
Maintenant que vous avez mis à jour le contrat SismondiNFT.sol, et que vous
avez créé le fichier .env, vous êtes prêt·e·s!
Pour installer votre contrat SismondiNFT.sol sur la chaîne, vous pouvez
lancer la commande suivante:
./brownie.sh run sismondi.py deploySi tout se passe bien, vous devrez voir un commentaire qui se termine avec quelque chose comme ceci:
Running 'scripts/sismondi.py::deploy'...
Transaction sent: 0x84096187a70ccfbdbb16546bbc250e72db949af3e726a5d0156222b7f7dc6f6d
Gas price: 0.0 gwei Gas limit: 12000000 Nonce: 0
SismondiNFT.constructor confirmed Block: 1 Gas used: 2816575 (23.47%)
SismondiNFT deployed at: 0x3194cBDC3dbcd3E11a07892e7bA5c3394048Cc87
contract has been deployed successfully to : 0x3194cBDC3dbcd3E11a07892e7bA5c3394048Cc87
Terminating local RPC client...
Ce qui est le plus important, c'est le dernier long numéro, dans notre cas le
0x3194cBDC3dbcd3E11a07892e7bA5c3394048Cc87.
C'est l'adresse de votre contrat sur la blockchain.
Copiez cette adresse dans le fichier NOTES.md.
Vous trouvez tous les messages d'exécution dans le fichier operations.log.
Donc si vous avez oublié l'adresse de votre contrat, vous pouvez y jeter un coup
d'œil.
Avec l'aide de l'outil Etherscan, vous pouvez maintenant vérifier que votre contrat est bel et bien installé sur la chaîne. Entrez l'adresse du contrat que vous avez reçu en 2.1.3, et regardez ce que Etherscan sait de votre contrat. On verra qu'une fois que vous faites un "mint" sur ce contrat, Etherscan va ajouter plus d'information.
Maintenant, vous êtes prêt·e·s pour faire un mint de votre premier NFT! Parce que le contrat lui-même n'a encore rien minté, il n'y a pas encore de NFT stocké dans le contrat!
Lancez la commande:
./brownie.sh run sismondi.py mint 0xADRESSE_CONTRATVous devez remplacer 0xADRESSE_CONTRAT par l'adresse que vous avez trouvé dans l'étape
Création d'un contrat NFT.
Si tout va bien, vous devez voir quelque chose comme ça:
Transaction sent: 0xb267bdc54994fe92746c21ca45853ae0d0f6d5d36461f92040462fae3558c407
Gas price: 0.0 gwei Gas limit: 12000000 Nonce: 1
SismondiNFT.makeSismondiNFT confirmed Block: 2 Gas used: 1493155 (12.44%)
A new NFT with id 0 has been successfully created in block 2 with transaction 0xb267bdc54994fe92746c21ca45853ae0d0f6d5d36461f92040462fae3558c407
Les numéros sont sûrement différents des vôtres.
Ce qu'il faut noter ici, c'est le id 0, qui signifie que c'est le premier NFT
créé par ce contrat.
Allez regarder de nouveau sur Etherscan l'adresse de votre smart contract et vérifiez
qu'il y a bien une deuxième transaction.
Vous pouvez aussi cliquer sur le Token Tracker pour voir combien de NFTs ont
été émis.
Prenez l'adresse d'un contrat d'un autre groupe, afin de faire
du mint sur leur contrat à eux.
Vous pouvez utiliser "Chatzy" pour échanger les adresses.
Quand ils vous donnent leur adresse, il faut d'abord vérifier que c'est bien
un contrat de mintage, à l'aide de Etherscan.
Dans la partie More Info, il faudrait une mention de Token Tracker.
Si ce n'est pas le cas, ça peut être à cause de:
- une erreur dans la transmission de l'adresse
- que l'autre groupe n'a pas encore fait un premier mint
La visualisation avec le site OpenSea est possible même sans inscription. Allez sur le site ici:
et entrez l'adresse de votre contrat NFT en haut dans la barre de recherche. Si vous avez déjà minté un NFT, il devrait s'afficher ici.
Afin de transmettre le NFT, on peut utiliser Metamask:
- Dans votre page de Metamask, cliquez sur
NFTs, puis surImport NFT - Ajoutez l'adresse de votre contrat, ainsi que le
idde votre NFT
Vous ne pouvez pas ajouter un NFT que vous n'avez pas minté!
Pour envoyer votre NFT vers un autre utilisateur, vous devez d'abord
ajouter le NFT comme dans la section précédente.
Maintenant, vous pouvez cliquer sur le NFT, et choisir Send.
On vous demande l'adresse du destinataire.
ATTENTION: une fois envoyé, il n'est pas possible de récupérer le NFT! Donc si vous envoyez à une mauvaise adresse, le NFT est perdu!
Si vous avez des questions ou des retours, n'hésitez pas d'entrer en contact avec nous:
- Transparents de la journée: Blockchains et NFTs
- Howto qui a été utilisé pour préparer la journée: Deploy Your First NFT With Python - Github with contract
- Contract utilisé pour le NFT: openzeppelin-contracts Definition of ERC 721
- Réseaux de test Ethereum: https://ethereum.org/en/developers/docs/networks/