Lorsque vous créez un token sur Solana, le programme de tokens SPL de base ne stocke que les soldes et les décimales. Il ne stocke pas le nom lisible de votre token, son symbole, sa description, son site web ou l’image de son logo.
Pour afficher les informations du token sur les portefeuilles (comme Phantom et Solflare) et les plateformes DEX (comme Raydium et DexScreener), Solana utilise le Standard de Métadonnées de Tokens Metaplex.
Comprendre comment les comptes de métadonnées on-chain se connectent aux fichiers JSON off-chain garantit que votre token affiche correctement son logo et ses détails sans erreurs d’affichage.
Le standard Metaplex divise les informations du token en deux couches distinctes :
Un compte dédié stocké directement dans la mémoire des validateurs Solana, dérivé de l’adresse de mint de votre token. Il stocke des champs de texte fixes :
- Nom (Name) : Nom du token (jusqu’à 32 caractères).
- Symbole (Symbol) : Symbole du token (jusqu’à 10 caractères).
- URI : Une URL (jusqu’à 200 caractères) pointant vers le fichier JSON off-chain.
- Autorité de mise à jour (Update Authority) : La clé publique autorisée à modifier les métadonnées.
Un fichier JSON structuré hébergé sur un stockage décentralisé permanent (comme Arweave ou IPFS). Ce fichier contient les détails étendus du projet :
image : URL directe vers l’image PNG, JPEG ou SVG du logo.description : Résumé détaillé du projet.external_url : Lien vers le site web officiel.properties.files : Tableau des fichiers multimédias et des types de contenu.
Les spécifications officielles sont maintenues dans la Documentation Développeur Metaplex.
Causes fréquentes des logos de tokens cassés
Les créateurs remarquent souvent que le logo de leur token apparaît dans le portefeuille Phantom mais ne se charge pas sur Solscan, ou inversement. Cela découle d’erreurs de formatage :
- URL d’image non directe : Pointer vers une page web contenant une صورة au lieu d’un lien direct se terminant par
.png ou .svg.
- Restrictions CORS : Héberger l’image sur un serveur web centralisé qui bloque les requêtes CORS des portefeuilles et des DEX.
- Format d’image non carré : Utiliser des images non carrées. Les portefeuilles exigent un format carré (par exemple, 512x512 pixels).
- Hébergeurs temporaires : Héberger les images sur des services gratuits qui suppriment les fichiers après 30 jours.
Pour garantir un affichage universel sur tous les portefeuilles et agrégateurs Solana, suivez ces recommandations :
- Format d’image : PNG ou SVG (fond transparent recommandé).
- Dimensions : Carré de 512x512 pixels (taille inférieure à 1 Mo).
- Hébergement JSON : Stockage décentralisé permanent (passerelle Arweave ou IPFS).
- Protocole HTTPS : Toutes les URI doivent utiliser des protocoles sécurisés
https:// ou ar://.
Créer et lier manuellement des fichiers JSON Metaplex nécessite de configurer des portefeuilles Arweave et des outils de développement.
Le Créateur de Token Solana PumpBolt automatise l’ensemble de la chaîne de métadonnées en une seule étape :
- Vous téléchargez votre logo carré directement dans le formulaire web.
- PumpBolt optimise l’image et la télécharge sur un stockage décentralisé permanent.
- PumpBolt génère un fichier JSON conforme au standard Metaplex et le lie à Arweave.
- Lors du mint, PumpBolt associe l’URI Arweave à votre compte de métadonnées Metaplex on-chain dans la même transaction.
Respecter le standard Metaplex et utiliser un stockage permanent garantit que l’image de votre token reste visible et immuable dans tout l’écosystème Solana.