Modifier la metadata d'un token Solana : nom, symbole, logo
Le nom est sur la blockchain, le logo dans un fichier. Ce que coûte chaque modification, dans quel ordre procéder et quand le verrouillage se justifie.
Modifier la metadata d'un token Solana ressemble à une seule tâche et en fait il y en a deux. La metadata, c'est la fiche publique du token : nom, symbole, logo, description, liens. Ces informations ne vivent pas au même endroit, elles vivent à deux, et chacune se modifie séparément.
D'où le message le plus fréquent après un lancement : le logo a changé depuis une semaine et Solscan affiche toujours l'ancien nom.
- Le nom, le symbole et l'adresse web sont sur la blockchain. Les changer coûte des frais.
- Le logo, la description et les liens sociaux sont dans un fichier. Les changer est gratuit.
- Modifier une couche ne touche jamais l'autre.
- Le verrouillage est la seule décision qui ne se rattrape pas.
Les deux couches de la metadata
Au moment du mint, la plupart des tokens reçoivent leurs informations via Metaplex Token Metadata, le standard que suit presque tout token Solana. C'est ce qui crée la première couche. La façon dont ce compte est rattaché au mint est décrite dans la documentation Solana sur Metaplex Metadata.
La couche une est sur la blockchain. Elle contient exactement trois choses : le nom, le symbole (le ticker) et une adresse web qui pointe vers un fichier. Les portefeuilles et les explorateurs lisent d'abord ici. Toucher à l'un de ces trois champs est une écriture on-chain, avec des frais.
La couche deux est le fichier situé à cette adresse. Dedans : le logo, la description, le site et les liens sociaux. En changer un revient à téléverser à nouveau le fichier à la même adresse. Aucune transaction, aucun frais.
Donc quand quelqu'un remplace un logo et que le nom ne bouge pas, rien n'est cassé. Le logo est dans le fichier, le nom est sur la blockchain, et modifier l'un ne déplace jamais l'autre.
| Champ | Couche | Comment le changer | Coût |
|---|---|---|---|
| Nom du token | On-chain | Outil de mise à jour | 0,2 SOL |
| Symbole (ticker) | On-chain | Outil de mise à jour | 0,2 SOL |
| Adresse web (URI) | On-chain | Outil de mise à jour | 0,2 SOL |
| Logo | Le fichier | Téléverser à la même adresse | gratuit |
| Description | Le fichier | Téléverser à la même adresse | gratuit |
| Site et réseaux | Le fichier | Téléverser à la même adresse | gratuit |
Quand faut-il vraiment y toucher
- Un nouveau logo. Le design a livré une meilleure version. Comme le logo vit dans le fichier, il suffit de le téléverser à la même adresse. Gratuit.
- Un lien a changé. Le Discord a déménagé, le compte X a changé, le site est sur un autre domaine. Même chose : on modifie le fichier.
- Le nom ou le symbole est faux. Le lancement s'est fait sous un nom provisoire, ou le ticker contient une faute. Ça, c'est la face scellée, donc l'outil de mise à jour.
- Le fichier part vers un stockage permanent. Puisque l'adresse elle-même change, c'est aussi une écriture on-chain. Cette étape passe toujours avant le moindre verrouillage.
Les deux premiers cas ne touchent jamais la blockchain et ne coûtent rien, et ils se répètent autant de fois que nécessaire. Les deux derniers passent par le même formulaire, qu'il s'agisse du nom, du ticker ou de l'adresse. Autrement dit : le cosmétique est gratuit, et seuls les trois champs scellés ont un prix.
Modifier la metadata d'un token Solana, étape par étape
Pour un logo ou des liens, rien de tout cela n'est nécessaire. Pour le nom, le symbole ou l'adresse, le parcours tient en quatre étapes.
- Regarder l'état d'abord. Ouvrir l'outil de snapshot et coller l'adresse du token. Il lit les valeurs actuelles et indique si l'autorisation de modification est encore détenue par un portefeuille. C'est gratuit, et si elle a déjà été abandonnée, inutile de payer quoi que ce soit.
- Connecter le bon portefeuille. Seul celui qui détient cette autorisation peut signer. Avec un autre, la modification ne passe tout simplement pas.
- Saisir les nouvelles valeurs et signer. Dans l'outil de mise à jour de la metadata, coller l'adresse, écrire ce qui change et approuver dans le portefeuille. Les frais du moment s'affichent sur la page avant la confirmation.
- Vérifier ensuite. Repasser le snapshot. Pour le logo, un peu de patience : les portefeuilles gardent l'image en cache dix à trente minutes.
Avant de verrouiller, le fichier doit se trouver dans un endroit permanent. Le désastre qui revient sans arrêt : une équipe le dépose sur un hébergement gratuit au lancement, verrouille la metadata quelques semaines plus tard, et des mois après l'hébergement expire. L'adresse renvoie alors une erreur 404. Le nom reste visible parce qu'il est scellé sur la blockchain, mais le logo et la description disparaissent, et comme l'autorisation n'existe plus, personne ne peut pointer le token vers un nouveau fichier.
Verrouiller ou laisser ouvert
À un moment, quelqu'un dira qu'il faut verrouiller sa metadata. Verrouiller veut dire abandonner définitivement l'autorisation de modification, de sorte que plus personne ne puisse rien changer, y compris l'équipe elle-même. Les acheteurs aiment le voir, et certaines listes de contrôle pour un listing le demandent.
C'est l'ordre des opérations qui décide. D'abord déplacer le fichier vers Arweave ou vers IPFS avec pinning, ensuite pointer l'adresse on-chain vers ce nouveau lien, puis vérifier depuis deux machines différentes pendant quelques jours, et seulement là verrouiller.
Au moment de verrouiller, il faut choisir jusqu'où. L'outil de révocation de l'autorité de mise à jour retire uniquement le droit sur le nom, le symbole et l'adresse. L'outil make immutable abandonne d'un coup les autorisations de modification, d'émission et de gel. Les trois sont comparées côte à côte dans le guide pour révoquer les autorités d'un token.
Comme règle simple : verrouiller quand la marque est posée, quand le token tourne depuis six mois sans changement de nom en vue, quand le fichier est déjà sur un stockage permanent, ou quand une plateforme le demande explicitement. Attendre tant qu'un changement de marque reste possible, tant que l'hébergement peut être perdu, tant qu'une version deux flotte dans l'air. C'est la seule porte du processus qui ne s'ouvre que dans un sens.
Pourquoi la modification ne passe parfois pas
Deux raisons couvrent presque tous les cas. Soit l'autorisation a déjà été révoquée, souvent dès la création, et le nom, le symbole et l'adresse sont scellés définitivement. Soit le portefeuille connecté n'est pas celui qui détient l'autorisation.
Le second cas ressemble à un bug de l'outil et n'en est pas un. Le snapshot indique quel portefeuille détient l'autorisation ; il suffit de connecter celui-là. Si l'autorisation est réellement partie, il n'y a pas de retour possible et la seule voie est un nouveau mint.
Un troisième cas y ressemble et reste inoffensif : la modification est passée depuis longtemps et le portefeuille affiche encore l'ancienne image. Les raisons pour lesquelles un token s'affiche mal ou pas du tout sont rassemblées dans token Solana invisible dans Phantom, les sept causes. Et faire apparaître un token dans la recherche de l'explorateur est une démarche à part, avec ses propres conditions, décrite dans le guide de vérification des tokens de Solana.
Les erreurs qui reviennent le plus
- Modifier le fichier en pensant que le nom suit. Le logo est dans le fichier, le nom sur la blockchain. Chacun se vérifie de son côté.
- Verrouiller avec le fichier sur un hébergement temporaire. L'erreur la plus coûteuse de la liste, et elle ne se répare pas.
- Ne pas attendre le cache. Dix à trente minutes, c'est normal. Avant de relancer l'opération, lire le snapshot.
- Vouloir renommer via le fichier. Le champ nom du fichier est ignoré par les portefeuilles. Un vrai renommage passe par l'outil.
- Signer avec le mauvais portefeuille. Cela ne coûte pas de frais, mais quelques minutes de confusion à chaque fois.
Questions fréquentes sur la metadata
Peut-on changer le nom d'un token après le lancement ?
Oui, tant que l'autorisation de modification est encore détenue par un portefeuille. Le snapshot le dit gratuitement, puis le changement coûte 0,2 SOL.
Pourquoi mon token affiche-t-il encore l'ancien logo ?
Soit la mauvaise couche a été modifiée, soit le portefeuille garde l'image en cache. Téléverser le logo à la même adresse, lire le snapshot, puis laisser passer le cache.
Combien coûte une mise à jour ?
Modifier le fichier ne coûte rien. Changer le nom, le symbole ou l'adresse coûte 0,2 SOL plus une petite dépense réseau, et le montant s'affiche avant la confirmation.
Faut-il rendre son token immuable ?
Quand la marque est stable, que le token a un peu d'historique et que le fichier est sur un stockage permanent, oui. Tant qu'un changement de marque reste possible, il vaut mieux attendre.
Qu'est-ce que l'autorité de mise à jour ?
C'est l'autorisation, détenue par un portefeuille précis, de modifier plus tard la metadata inscrite sur la blockchain. Une fois abandonnée, l'inscription est scellée pour toujours.
Est-ce que cela vaut aussi pour Token-2022 ?
En partie seulement. Token-2022 peut porter sa metadata à l'intérieur du token et suit alors un autre chemin. Ce guide couvre le flux classique SPL avec Metaplex.
Ce qu'il faut retenir
Mettre à jour coûte peu et se répète, donc rien n'oblige à être parfait le premier jour. Un nom se corrige, un logo se remplace, des liens se déplacent autant de fois qu'il le faut. Seul le verrouillage est définitif : déplacer le fichier vers un stockage permanent, pointer l'adresse dessus, vérifier qu'il se charge, et seulement ensuite abandonner l'autorisation.
