Solana Token Metadata ändern: Name, Symbol und Logo

Wer Solana Token Metadata ändern will, stolpert fast immer über dieselbe Trennung. Metadata ist nur 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.

Daher die häufigste Nachricht 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 bewegt 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 an. Wie dieses Konto an den Mint gehängt wird, beschreibt Solana in seiner Doku zu Metaplex Metadata.

Ebene eins liegt on-chain, also direkt im Netzwerk. Dort stehen genau drei Dinge: 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: dieselbe Datei unter derselben Adresse neu hochladen. Kein Netzwerkzugriff, keine Gebühr.

Feld	Ebene	So änderst du es	Kosten
Token-Name	On-chain	Update-Tool	0,2 SOL
Symbol (Ticker)	On-chain	Update-Tool	0,2 SOL
Webadresse (URI)	On-chain	Update-Tool	0,2 SOL
Logo	Datei	Neu hochladen, gleiche Adresse	kostenlos
Beschreibung	Datei	Neu hochladen, gleiche Adresse	kostenlos
Website und Socials	Datei	Neu hochladen, gleiche Adresse	kostenlos

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 ist die versiegelte Seite, also 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 versiegelten 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. Es 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 der Host aus. Die Adresse liefert dann einen 404. Der Name bleibt sichtbar, Logo und Beschreibung verschwinden, und weil die Berechtigung weg ist, kann sie niemand 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 etwas ä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 on-chain Adresse darauf zeigen lassen, ein paar Tage von zwei Rechnern 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 auf Namen, Symbol und Adresse. 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, die Datei dauerhaft liegt oder eine Börse ausdrücklich danach fragt. Warten, solange ein Rebrand denkbar ist, der Host wackelt oder eine zweite Version im Raum steht. Es ist die einzige Tür in diesem Ablauf, die nur in eine Richtung aufgeht.

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, dann bleibt nur ein neuer Mint.

Ein Sonderfall sieht ähnlich aus, ist aber harmlos: Die Änderung ist längst durch, das Wallet zeigt weiter das alte Bild. Warum ein Token falsch oder gar nicht auftaucht, sammelt 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 den Namen mitmeinen. 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, dann kostet die Änderung 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 etwas Historie hat 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 sind günstig und wiederholbar, am ersten Tag muss also nichts perfekt sein. Nur das Sperren ist endgültig: erst die Datei dauerhaft ablegen, dann die Adresse umbiegen, prüfen, und zuletzt die Berechtigung abgeben.