Solana Token Metadata ändern: Name, Symbol und Logo

Wer Solana Token Metadata ändern will, stolpert fast immer über dieselbe Trennung. Die Metadata ist die öffentliche Visitenkarte eines Tokens: Name, Symbol, Logo, Beschreibung, Links. Diese Angaben liegen aber nicht an einem Ort, sondern an zweien, und sie ändern sich getrennt voneinander.

Deshalb lautet die häufigste Meldung nach einem Launch: Logo längst getauscht, Solscan zeigt trotzdem den alten Namen.

• Name, Symbol und Webadresse stehen on-chain. Ändern kostet eine Gebühr.
• Logo, Beschreibung und Social-Links stehen in einer Datei. Ändern ist kostenlos.
• Eine Ebene zu bearbeiten, ändert die andere nie.
• Sperren ist die einzige Entscheidung, die sich nicht zurücknehmen lässt.

Die zwei Ebenen der Solana Token Metadata

Beim Mint bekommen die meisten Tokens ihre Angaben über Metaplex Token Metadata, den Standard, dem fast alle Solana-Tokens folgen. Er legt die erste Ebene als eigenes Konto an. Wie dieses Konto an den Mint gehängt wird, beschreibt die Solana-Doku zu Metaplex Metadata.

Ebene eins liegt on-chain, also direkt im Netzwerk. Dort stehen die drei Angaben, um die es hier geht: der Name, das Symbol und eine Webadresse, die auf eine Datei zeigt. Wallets und Explorer lesen zuerst hier. Jede Änderung daran ist eine Netzwerkänderung und kostet.

Ebene zwei ist die Datei hinter dieser Adresse. Darin stecken Logo, Beschreibung, Website und die Social-Links. Sie zu ändern heißt: die geänderte Datei unter derselben Adresse neu hochladen. Kein Netzwerkzugriff, keine Gebühr.

Wann du überhaupt etwas ändern musst

• Neues Logo. Das Design ist fertig, die alte Grafik soll weg. Datei neu hochladen, fertig. Kostenlos.
• Ein Link hat sich geändert. Discord umgezogen, X-Handle neu, Domain gewechselt. Auch nur die Datei.
• Name oder Symbol stimmen nicht. Der Launch lief unter einem Platzhalter oder im Ticker steckt ein Tippfehler. Das gehört zur On-Chain-Ebene, also ist es eine echte Netzwerkänderung.
• Die Datei zieht auf dauerhaften Speicher um. Damit ändert sich die Adresse selbst, und die steht on-chain. Dieser Schritt gehört immer vor das Sperren.

Die ersten beiden Fälle fassen das Netzwerk nie an und kosten nichts. Die letzten beiden laufen über denselben Ablauf, egal ob Name, Ticker oder Adresse. Praktisch heißt das: Kosmetik ist gratis und beliebig oft wiederholbar, und nur die drei On-Chain-Felder haben einen Preis.

Solana Token Metadata ändern, Schritt für Schritt

Für Logo und Links brauchst du das hier gar nicht. Für Name, Symbol oder Adresse sind es vier Schritte.

• Zustand prüfen. Im kostenlosen Snapshot des Tokens die Mint-Adresse einfügen. Er zeigt die aktuellen Werte und ob die Änderungsberechtigung noch bei einer Wallet liegt.
• Die richtige Wallet verbinden. Nur die Wallet mit dieser Berechtigung kann unterschreiben. Mit einer anderen geht die Änderung schlicht nicht durch.
• Werte eintragen und signieren. Im Tool zum Aktualisieren der Metadata die neuen Angaben eingeben und in der Wallet bestätigen. Die aktuelle Gebühr steht vor der Bestätigung auf der Seite.
• Danach nachlesen. Snapshot noch einmal laufen lassen. Beim Logo gilt: Wallets cachen Bilder etwa zehn bis dreißig Minuten.

Vor dem Sperren muss die Datei auf dauerhaftem Speicher liegen. Der Klassiker: Ein Team lädt sie beim Launch auf einen kostenlosen Host, sperrt Wochen später die Metadata, und Monate danach läuft das kostenlose Hosting aus. Die Adresse liefert dann einen 404. Der Name bleibt sichtbar, Logo und Beschreibung verschwinden, und weil die Berechtigung weg ist, kann niemand die Adresse mehr auf eine neue Datei zeigen lassen.

Sperren oder offen lassen

Irgendwann liest man, man solle seine Metadata sperren. Das heißt: die Änderungsberechtigung dauerhaft abgeben, sodass niemand mehr Name, Symbol und Adresse ändern kann, du eingeschlossen. Käufer sehen das gern, und manche Listing-Checklisten fragen danach.

Die Reihenfolge entscheidet. Erst die Datei auf Arweave oder gepinntes IPFS legen, dann die Adresse on-chain darauf zeigen lassen, ein paar Tage von zwei Geräten aus prüfen, und erst dann sperren.

Beim Sperren wählst du die Tiefe. Das Tool zum Widerruf der Update-Berechtigung nimmt nur das Recht, Namen, Symbol und Adresse zu ändern. Das Tool zum dauerhaften Sperren gibt Update-, Mint- und Freeze-Berechtigung in einem Schritt ab. Alle drei Berechtigungen nebeneinander erklärt der Beitrag zum Widerruf von Mint-, Freeze- und Update-Authority.

Als Faustregel: sperren, wenn die Marke steht, der Token ein halbes Jahr ohne Umbenennung gelaufen ist und die Datei dauerhaft liegt, oder wenn eine Börse ausdrücklich danach fragt. Warten, solange ein Rebrand denkbar ist, der Host unsicher wirkt oder eine zweite Version im Raum steht. Sperren ist die einzige Tür in diesem Ablauf, die sich nur in eine Richtung öffnen lässt.

Warum eine Änderung manchmal gar nicht durchgeht

Zwei Gründe decken fast alle Fälle ab. Entweder wurde die Update-Berechtigung schon abgegeben, oft direkt beim Erstellen, dann sind Name, Symbol und Adresse endgültig versiegelt. Oder die verbundene Wallet ist nicht die, die die Berechtigung hält.

Der zweite Fall sieht aus wie ein Fehler des Tools und ist keiner. Schau im Snapshot nach, welche Wallet die Berechtigung besitzt, und verbinde genau diese. Ist die Berechtigung wirklich weg, führt kein Weg zurück, und es bleibt nur ein neuer Mint.

Ein Sonderfall sieht ähnlich aus, ist aber harmlos: Die Änderung ist längst durch, die Wallet zeigt weiter das alte Bild. Warum ein Token falsch oder gar nicht angezeigt wird, erklärt der Beitrag Solana-Token wird in Phantom nicht angezeigt. Dass ein Token in der Explorer-Suche erscheint, ist übrigens ein eigener Vorgang mit eigenen Bedingungen, beschrieben in Solanas Anleitung zur Token-Verifizierung.

Die Fehler, die sich wiederholen

• Die Datei bearbeiten und glauben, damit sei auch der Name geändert. Das Logo sitzt in der Datei, der Name im Netzwerk. Prüfe beide getrennt.
• Sperren, solange die Datei auf einem befristeten Host liegt. Der teuerste Fehler auf dieser Liste, und er ist endgültig.
• Den Cache nicht abwarten. Zehn bis dreißig Minuten sind normal. Erst der Snapshot sagt, ob wirklich etwas schiefging.
• Den Namen über die Datei ändern wollen. Das Namensfeld in der Datei liest keine Wallet. Umbenennen läuft immer über das Update-Tool.
• Mit der falschen Wallet unterschreiben. Kostet keine Gebühr, aber jedes Mal ein paar Minuten Verwirrung.

Häufige Fragen zu Token Metadata

Kann ich den Namen nach dem Launch noch ändern?

Ja, solange die Änderungsberechtigung noch bei einer Wallet liegt. Prüfe das zuerst kostenlos im Snapshot. Die Änderung selbst kostet 0,2 SOL.

Warum zeigt meine Wallet weiter das alte Logo?

Entweder wurde die falsche Ebene bearbeitet, oder die Wallet cacht das Bild noch. Zehn bis dreißig Minuten warten und den Snapshot lesen.

Was kostet ein Update?

Die Datei zu ändern kostet nichts. Name, Symbol oder Adresse kosten 0,2 SOL plus eine kleine Netzwerkgebühr, und der Betrag steht vor der Bestätigung auf der Toolseite.

Sollte ich meinen Token immutable machen?

Wenn die Marke steht, der Token schon eine Weile gelaufen ist und die Datei dauerhaft liegt: ja. Solange ein Rebrand denkbar ist: warten.

Was ist die Update Authority?

Die Berechtigung einer bestimmten Wallet, die On-Chain-Metadata später noch zu bearbeiten. Wird sie abgegeben, ist der Eintrag für immer versiegelt.

Gilt das auch für Token-2022?

Nur teilweise. Token-2022 kann Metadata direkt im Token tragen und nimmt dann einen anderen Weg. Dieser Text beschreibt den klassischen SPL-Weg über Metaplex.

Kurz gesagt

Updates lassen sich wiederholen, am ersten Tag muss also nichts perfekt sein. Nur das Sperren ist endgültig: erst die Datei dauerhaft ablegen, dann die Adresse umstellen, prüfen, und zuletzt die Berechtigung abgeben.