For the complete documentation index, see llms.txt. This page is also available as Markdown.

Héberger votre NFT sur IPFS

Hébergez les fichiers médias NFT et les métadonnées JSON sur IPFS pour un stockage tokenURI permanent et décentralisé en utilisant Pinata ou d'autres fournisseurs IPFS pour les projets NFT sur Chiliz

Si vous ne le savez pas encore, posséder un NFT ne signifie pas que le fichier du NFT est téléversé tel quel sur la blockchain. Au contraire, un NFT correspond à un bloc de blockchain qui contient un certain token. Ce token stocke un "pointeur" ou lien, appelé tokenURI, qui contient l'adresse en ligne d'un fichier de métadonnées, lequel référence lui-même le fichier multimédia en utilisant un autre URI.

En raison de la nature pair à pair de la blockchain, vous ne pouvez pas simplement héberger votre fichier NFT et son fichier de métadonnées sur n'importe quel service d'hébergement web. Votre tokenURI doit rester permanent (ou "immuable") et portable entre les applications et les marketplaces, aussi longtemps que possible, éventuellement pour toujours.

C'est là qu'intervient IPFS.

À propos d'IPFS

IPFS, pour InterPlanetary File System (Système de Fichiers InterPlanétaire), est un réseau de fichiers décentralisé qui a pour but d'héberger et de partager des données sur des réseaux distribués. Les plateformes NFT peuvent récupérer des données depuis IPFS au lieu de dépendre d'un seul serveur, et le protocole IPFS donne l'impression que tous les fichiers hébergés sont locaux.

Le site IPFS propose une page détaillée sur les bonnes pratiques de stockage NFT.

Détails du téléversement NFT

Lors du téléversement de votre NFT, vous devez effectuer deux téléversements vers le Content Identifier (CID) qu'IPFS génère pour vous :

  • Le contenu lui-même, pour lequel IPFS retourne une URL IPFS pour le fichier hébergé.

  • Le fichier de métadonnées, qui référence le CID du fichier multimédia, et doit contenir l'URL IPFS du fichier.

Les deux doivent être téléversés sur IPFS sous le même CID.

Idéalement, votre ensemble d'outils prend cela en charge afin que vous n'ayez pas à tout faire manuellement.

À titre d'information, voici à quoi ressemblerait un fichier metadata.json minimal :

Pour en savoir plus sur la structure des métadonnées NFT (par exemple, pourquoi vous devriez utiliser image pour les images et animation_url pour les vidéos), nous vous conseillons de lire ce document d'OpenSea :

Note : Vous n'êtes pas censé écrire le fichier de métadonnées from scratch ! Votre ensemble d'outils devrait être capable de le générer pour vous.

Cette documentation n'ayant pas pour but de tout décrire sur IPFS, nous vous conseillons d'approfondir le sujet via des recherches en ligne. Vous pouvez commencer par ce guide explicatif de Pinata :

... ou ce billet de blog de thirdweb :

Mis à jour

Ce contenu vous a-t-il été utile ?