TokenizeArt

Tutoriel complet pour créer votre premier NFT BEP-721 sur la BNB Smart Chain, de l'image jusqu'à un jeton non fongible miné, hébergé sur IPFS et vérifié sur BSCScan.

1. Comprendre avant de coder

On ne part pas écrire du Solidity sans comprendre ce qu'est un NFT et où vivent ses données.

1.1 Qu'est-ce qu'un NFT ?

Un NFT (non-fungible token, ou jeton non fongible) est un certificat numérique d'authenticité et de propriété enregistré sur une blockchain.

Contrairement à un jeton fongible comme un token BEP-20 où un jeton en vaut un autre, chaque NFT est unique et non interchangeable : il porte un identifiant (tokenId) qui lui est propre.

Pour aller plus loin : NFT & ERC-721.

1.2 Le standard ERC-721 (et BEP-721)

ERC-721 est la norme Ethereum qui définit l'API d'un jeton non fongible : ownerOf, transferFrom, approve… BEP-721 en est le strict équivalent sur la BNB Smart Chain (même interface, autre réseau).

On ne réécrit pas cette norme à la main : on hérite de l'implémentation ERC721URIStorage d'OpenZeppelin, qui gère pour nous la propriété, les transferts et l'URI des métadonnées.

1.3 Où sont stockées les données ?

Il y a deux étages dans un NFT, et c'est la clé du projet :

Le contrat ne contient donc que l'adresse du JSON de métadonnées (tokenURI) ; c'est le wallet qui va chercher l'image à cette adresse pour l'afficher.

Pour aller plus loin : IPFS & Pinata.

1.4 Le vocabulaire à connaître

• Wallet (portefeuille) : application comme MetaMask qui détient tes adresses et tes fonds.
• Adresse : une longue chaîne (0x...) qui identifie un compte, un peu comme un numéro de compte bancaire.
• Smart contract : un programme qui vit sur la blockchain - ici, la fabrique qui crée les NFT.
• NFT : un jeton non fongible, unique, régi par la norme ERC-721 / BEP-721.
• Métadonnées : le « dossier » du NFT (nom, description, image, attributs) au format JSON.
• IPFS : un système de stockage distribué de fichiers.
• CID : l'empreinte unique d'un fichier sur IPFS (ipfs://Qm...) - elle permet de le retrouver n'importe où.
• Pinata : le service qui « épingle » (maintient en ligne) tes fichiers sur IPFS.
• Gas : la petite redevance payée pour exécuter une action sur la blockchain.
• Faucet : un site qui distribue gratuitement des jetons de test.
• Testnet : un réseau de test public où la crypto ne vaut rien.
• Block explorer (BSCScan) : un moteur de recherche de la blockchain.

2. Installer MetaMask et ajouter le réseau de test

MetaMask est le portefeuille qui va signer les transactions du contrat.

2.1 Installer l'extension

1. Va sur https://metamask.io et installe l'extension pour ton navigateur (ou l'application mobile).
2. Crée un portefeuille, choisis un mot de passe, puis note la phrase de récupération sur papier.

2.2 Ajouter le réseau BSC Testnet

MetaMask arrive configuré sur Ethereum. Il faut lui ajouter le réseau de test de la BNB Smart Chain.

• Ouvre MetaMask → menu des réseaux → Ajouter un réseau manuellement.

• Renseigne :

  Champ	Valeur
  Nom du réseau	BSC Testnet
  Nouvelle URL RPC	https://data-seed-prebsc-1-s1.binance.org:8545/
  ID de chaîne	97
  Symbole de la monnaie	tBNB
  URL de l'explorateur de blocs	https://testnet.bscscan.com

• Enregistre, puis sélectionne le réseau BSC Testnet.

2.3 Copier ton adresse

1. Clique sur le nom du compte en haut de MetaMask pour copier l'adresse publique (0x...).
2. Garde-la sous la main : c'est elle qui recevra le NFT et qui apparaîtra dans ownerOf(1).

3. Récupérer des tBNB gratuits (faucet)

Chaque transaction coûte du gas, payé en tBNB (BNB de test). Le faucet en distribue gratuitement.

3.1 Utiliser le faucet de BNB Chain

1. Va sur le faucet BNB Chain.
2. Colle ton adresse MetaMask et valide le captcha.
3. Attends la transaction : quelques tBNB arrivent sur ton compte.

4. Écrire le smart contract du NFT

On écrit le programme qui fabrique le NFT en Solidity. On réutilise la bibliothèque OpenZeppelin qui fournit un ERC-721 éprouvé (pas besoin de tout réinventer, c'est plus sûr - et c'est explicitement recommandé par le sujet).

4.1 Le code complet du contrat

Ce fichier doit aller dans le dossier code/ de ton dépôt sous le nom zehd42.sol :

// SPDX-License-Identifier: MIT
// Zehd42 - NFT non fongible (BEP-721 / ERC-721) sur la BNB Smart Chain
pragma solidity ^0.8.20;

// Imports OpenZeppelin v5.1.0 : ERC721 (standard), ERC721URIStorage (URI), Ownable (propriété)
import "https://raw.githubusercontent.com/OpenZeppelin/openzeppelin-contracts/v5.1.0/contracts/token/ERC721/ERC721.sol";
import "https://raw.githubusercontent.com/OpenZeppelin/openzeppelin-contracts/v5.1.0/contracts/token/ERC721/extensions/ERC721URIStorage.sol";
import "https://raw.githubusercontent.com/OpenZeppelin/openzeppelin-contracts/v5.1.0/contracts/access/Ownable.sol";

contract Zehd42 is ERC721URIStorage, Ownable {
    // Compteur des tokens créés (ids à partir de 1) :
    uint256 private _tokenIds;

    // URI de base des métadonnées (IPFS) :
    string public baseURI;

    // Constructeur : nom, symbole et URI de base :
    constructor(string memory _baseURI) ERC721("Zehd42", "Z42") Ownable(msg.sender) {
        baseURI = _baseURI;
    }

    // Miner un NFT, réservé au propriétaire :
    function mintNFT(address recipient) public onlyOwner returns (uint256) {
        _tokenIds += 1;                    // nouvel id
        uint256 newTokenId = _tokenIds;
        _safeMint(recipient, newTokenId);  // vérifie que le destinataire accepte le NFT
        _setTokenURI(newTokenId, baseURI); // associe les métadonnées IPFS
        return newTokenId;
    }

    // Changer l'URI de base des prochains mints (réservé au propriétaire)
    // Fait évoluer l'emplacement des métadonnées sans changer l'adresse du contrat :
    function setBaseURI(string memory _newBaseURI) public onlyOwner {
        baseURI = _newBaseURI;
    }
}

4.2 Expliquer les mots du code

4.3 Mettre à jour ton dépôt

1. Ouvre code/zehd42.sol et colle le code ci-dessus.
2. Assure-toi que chaque fonction a bien un commentaire lisible.

5. Compiler avec Remix

Remix IDE est l'IDE en ligne recommandé par le sujet : il permet d'écrire, compiler et déployer sans rien installer.

5.1 Ouvrir Remix et créer le fichier

1. Va sur https://remix.ethereum.org.
2. Dans l'explorateur de fichiers, crée un dossier contracts s'il n'existe pas, puis un fichier zehd42.sol.
3. Colle le code du contrat et enregistre (Ctrl+S).

5.2 Comprendre les imports

Le contrat importe directement OpenZeppelin v5.1.0 par URL :

import "https://raw.githubusercontent.com/OpenZeppelin/openzeppelin-contracts/v5.1.0/contracts/token/ERC721/ERC721.sol";

Remix télécharge automatiquement les imports lors de la compilation, tu n'as rien à installer manuellement.

5.3 Choisir la version et compiler

1. Ouvre l'onglet Solidity Compiler.
2. Choisis une version 0.8.20 ou supérieure (l'import exige ^0.8.20).
3. Clique sur Compile zehd42.sol.

6. Publier l'image et les métadonnées sur IPFS

On ne met pas l'image dans le contrat (ce serait hors de prix). On la publie sur IPFS via Pinata, puis on met le lien dans les métadonnées.

6.1 Préparer l'œuvre

L'image doit remplir les exigences du sujet :

• une image originale contenant le chiffre 42 clairement lisible ;
• un format .png ou .jpg ;
• aucun terme ni contenu insultant.

Place-la dans images/ de ton dépôt (par exemple images/Zehd42.png).

6.2 Créer un compte Pinata

1. Va sur pinata.cloud et crée un compte gratuit.
2. Une fois connecté, l'onglet Files liste les fichiers épinglés.

6.3 Épingler l'image

1. Onglet Files → Add Files → File.
2. Sélectionne l'image, puis clique sur Upload.
3. Dans la liste, copie la colonne CID : c'est le CID image.

6.4 Écrire les métadonnées (JSON)

Crée code/zehd42.json - c'est le « dossier » du NFT, que les wallets vont lire :

{
  "name": "Zehd42",
  "description": "Un NFT unique créé dans le cadre du projet Zehd42. L'œuvre représente la réponse... et bien sûr, le 42.",
  "image": "https://gateway.pinata.cloud/ipfs/<CID_IMAGE>",
  "attributes": [
    { "trait_type": "Artiste", "value": "alamizan" },
    { "trait_type": "Projet", "value": "Zehd42" }
  ]
}

6.5 Épingler les métadonnées

1. Refaire Add Files → File avec code/zehd42.json.
2. Copier son CID : il diffère de celui de l'image (deux contenus distincts). C'est le CID JSON.
3. Tester l'affichage : https://gateway.pinata.cloud/ipfs/<CID_JSON> doit renvoyer le JSON.

7. Déployer sur la BSC Testnet

On déploie le contrat en lui passant l'URL de passerelle du JSON : c'est le _baseURI du constructeur.

7.1 Connecter Remix à MetaMask

1. Dans Remix, ouvre l'onglet Deploy & Run Transactions.
2. Dans Environment, choisis Injected Provider - MetaMask.

7.2 Lancer le déploiement

1. Dans le champ du constructeur, saisis le _baseURI :

https://gateway.pinata.cloud/ipfs/<CID_JSON>

1. Clique sur Deploy.
2. MetaMask ouvre une fenêtre : vérifie le réseau (BSC Testnet) et confirme.
3. Attends la confirmation : le contrat apparaît dans Deployed Contracts.

7.3 Récupérer l'adresse du contrat

1. Déplie le contrat déployé dans Remix.
2. Copie l'icône « copier » à côté de son adresse.
3. Vérifie que ce sont bien tes métadonnées qui sont référencées en lisant baseURI().

8. Miner le NFT et vérifier la propriété

Le NFT n'existe pas encore : le contrat n'est que la fabrique. Il faut appeler mintNFT.

8.1 Miner le NFT

1. Dans Deployed Contracts, déplie le contrat.
2. Repère la fonction mintNFT et colle ton adresse MetaMask comme recipient.
3. Clique sur transact et confirme dans MetaMask.

8.2 Vérifier en lecture

Un appel transact modifie la chaîne ; un appel bleu (lecture) ne coûte rien et ne nécessite pas de signature.

9. Vérifier et publier sur BSCScan

La vérification rend ton code source public et prouve que le contrat déployé correspond exactement à celui que tu as écrit.

9.1 Trouver le contrat

1. Copie l'adresse du contrat depuis Remix.
2. Ouvre-la sur BSCScan Testnet.
3. L'onglet Contract montre d'abord le bytecode : illisible, donc à vérifier.

9.2 Vérifier le code source

1. Sur la page du contrat → Contract → Verify and Publish.
2. Choisis Solidity (Single file) si le contrat tient en un seul fichier, sinon Standard-Json-Input (obligatoire ici à cause des imports).
3. Renseigne la version du compilateur utilisée dans Remix et l'optimisation activée ou non.
4. Colle le code source et valide.

10. Dépannage et questions fréquentes

10.1 « Not enough funds for gas »

Ton solde en tBNB est vide ou insuffisant. Retourne à l'étape 3 (faucet).

10.2 La transaction reste « pending »

Le testnet est parfois congestionné. Attends une minute, puis vérifie la transaction dans l'onglet Activity de MetaMask : tu peux en afficher le suivi sur BSCScan.

10.3 Le wallet affiche une image cassée

Trois causes possibles, dans l'ordre :

1. tokenURI(1) ne pointe pas vers le JSON (mais vers l'image) ;
2. le JSON contient une URL d'image invalide ou avec un espace parasite ;
3. le fichier n'est plus épinglé sur Pinata.

10.4 « revert » quand j'appelle mintNFT depuis un autre compte

Normal ! mintNFT est protégé par onlyOwner. C'est le comportement attendu et c'est exactement ce qu'il faut montrer à l'évaluation.

10.5 La passerelle Pinata renvoie une page vide

Propagation IPFS : un fichier tout juste publié peut mettre de quelques secondes à quelques minutes à être visible via toutes les passerelles. Attends, puis recharge la page.

10.6 Est-ce que je risque de perdre de l'argent ?

Non. On ne travaille que sur la BSC Testnet avec des tBNB de test qui ne valent rien. N'utilise jamais le Mainnet ni des fonds réels.

10.7 Et si je veux changer les métadonnées après le mint ?

Les métadonnées sont figées par CID : modifier le JSON produit un nouveau CID. setBaseURI(...) (réservé au propriétaire) permet de pointer les prochains mints vers les nouvelles métadonnées, sans redéployer le contrat. Les jetons déjà minés conservent leur tokenURI.

Lien vers source : BNB Chain · Remix IDE · BSCScan Testnet · OpenZeppelin · Pinata