Wie füge ich benutzerdefinierte Token zu MetaMask hinzu? (Leitfaden zur Vertragsadresse)

Grundlegendes zur benutzerdefinierten Token-Integration

1. MetaMask unterstützt Ethereum-kompatible Token über die Standards ERC-20, ERC-721 und ERC-1155. Benutzer können nicht einfach in der Benutzeroberfläche nach unbekannten Token suchen – viele müssen sie manuell unter Verwendung präziser Vertragsadressen hinzufügen.

2. Die Vertragsadresse eines Tokens ist eine eindeutige 42-stellige Hexadezimalzeichenfolge, die auf einer bestimmten Blockchain bereitgestellt wird. Diese Adresse dient als definitive Kennung für die Smart-Contract-Logik und die Kontostandverfolgung des Tokens.

3. Das Hinzufügen eines benutzerdefinierten Tokens ohne Überprüfung des richtigen Netzwerks kann zu Nullsalden oder Phantom-Assets führen. Jeder Token existiert nur in der Kette, in der sein Vertrag bereitgestellt wurde – Ethereum Mainnet, Polygon, BSC, Arbitrum und andere sind völlig separate Umgebungen.

4. MetaMask validiert die Legitimität von Token nicht. Betrüger setzen häufig gefälschte Verträge ein, deren Namen beliebte Projekte nachahmen. Bevor Sie fortfahren, müssen Sie Vertragsadressen über Etherscan, Polygonscan oder BscScan vergleichen.

5. Das Token-Symbol und die Dezimalstellen müssen mit den im Vertrag definierten übereinstimmen. Falsche Dezimalzahlen führen zu einer falschen Darstellung des Saldos. Wenn Sie beispielsweise 18 Dezimalstellen für einen Token eingeben, der 9 verwendet, werden Salden angezeigt, die 1 Milliarde Mal kleiner sind als die Realität.

Navigieren im manuellen Zugabefluss

1. Öffnen Sie MetaMask und stellen Sie sicher, dass im Dropdown-Menü oben links das richtige Netzwerk ausgewählt ist – dieses muss mit dem Speicherort des Token-Vertrags übereinstimmen.

2. Klicken Sie auf die Registerkarte „Assets“, scrollen Sie dann nach unten und wählen Sie „Token importieren“. Es erscheint ein Modal mit drei Registerkarten: „Benutzerdefiniertes Token“, „Token-Listen“ und „NFTs“.

3. Wählen Sie „Benutzerdefiniertes Token“ und fügen Sie die verifizierte Vertragsadresse in das dafür vorgesehene Feld ein. MetaMask ruft automatisch Namen, Symbol und Dezimalstellen ab, wenn der Vertrag korrekt auf Standard-ERC-Aufrufe reagiert.

4. Wenn die automatische Erkennung fehlschlägt, geben Sie den Tokennamen, das Symbol und die Dezimalstellen manuell ein. Diese Werte müssen aus der offiziellen Projektdokumentation oder verifizierten Block-Explorer-Seiten stammen – nicht aus Community-Chats oder nicht verifizierten Websites.

5. Klicken Sie auf „Weiter“, überprüfen Sie die Details und klicken Sie dann auf „Token hinzufügen“. Der Token wird sofort unter „Vermögenswerte“ angezeigt, wenn das Wallet einen Saldo davon ungleich Null aufweist.

Häufige Fallstricke bei Vertragsadressen

1. Fehler beim Kopieren und Einfügen führen zu unsichtbaren Unicode-Zeichen oder zusätzlichen Leerzeichen. Fügen Sie die Datei immer zuerst in einen Nur-Text-Editor ein und kopieren Sie dann die saubere 42-stellige Zeichenfolge erneut.

2. Einige Token existieren über mehrere Ketten mit identischen Namen, aber unterschiedlichen Verträgen – USDT auf Ethereum verwendet 0xdAC17F958D2ee523a2206206994597C13D831ec7, während USDT auf Polygon 0xc2132D05D31c914a87C6611C10748AEb04B58e8F verwendet.

3. Auf Testnetzen bereitgestellte Verträge funktionieren nicht auf Hauptnetzen. Der Versuch, einen Goerli-basierten Token zum Ethereum Mainnet hinzuzufügen, führt zu einem nicht erkannten Vermögenswert ohne Sichtbarkeit des Kontostands.

4. Umbenannte oder aktualisierte Token behalten häufig alte Vertragsadressen in inoffiziellen Auflistungen bei. Projekte wie ChainLink wurden von 0xa0b73e1ff0b80914ab6fe04447664353ee79dff5 auf 0x514910771AF9Ca656af840dff83E8264EcF986CA migriert – die Verwendung veralteter Adressen führt zu leeren Salden.

Überprüfung der Token-Authentizität nach dem Import

1. Klicken Sie nach dem Import auf den Namen des Tokens in der Assets-Liste, um dessen Detailansicht zu öffnen. MetaMask zeigt die Vertragsadresse an – klicken Sie darauf, um den Standardblock-Explorer für dieses Netzwerk zu öffnen.

2. Überprüfen Sie auf Etherscan oder einem gleichwertigen Gerät die Registerkarte „Vertrag“, um zu bestätigen, dass sie verifiziert ist. Nicht verifizierte Verträge zeigen nur Bytecode an und stellen ein ernstes Risiko dar.

3. Sehen Sie sich den Abschnitt „Vertrag lesen“ an, um totalSupply() und decimals() aufzurufen. Vergleichen Sie die zurückgegebenen Werte mit den beim Import eingegebenen Werten.

4. Untersuchen Sie die Registerkarte „Transaktionen“ auf aktuelle eingehende Überweisungen an bekannte Inhaberadressen. Plötzliche Spitzen von unbekannten Absendern können auf Liquiditätsmanipulationen oder Rug Pulls hinweisen.

5. Überprüfen Sie den Abschnitt „Analytics“ oder „Token Holders“. Legitime Token haben normalerweise Hunderte oder Tausende von Inhabern; Token mit weniger als zehn aktiven Adressen erfordern eine sofortige Prüfung.

Häufig gestellte Fragen

F: Warum zeigt MetaMask nach dem Hinzufügen der Vertragsadresse „Unbekanntes Token“ an? MetaMask zeigt dies an, wenn der Vertrag über keine Standard-ERC-Schnittstellen verfügt oder nicht im Block-Explorer verifiziert wurde. Dies bedeutet nicht, dass das Token ungültig ist – nur, dass Metadaten nicht automatisch abgerufen werden können.

F: Kann ich einen Token hinzufügen, indem ich statt der Vertragsadresse nur seinen Namen oder sein Symbol verwende? Nein. MetaMask benötigt die genaue Vertragsadresse. Name und Symbol allein reichen nicht aus und sind nicht global eindeutig – mehrere Verträge können identische Identifikatoren verwenden.

F: Was passiert, wenn ich denselben Token zweimal mit leicht unterschiedlichen Vertragsadressen hinzufüge? MetaMask behandelt jede Adresse als eigenständigen Vermögenswert. Doppelte Einträge werden separat in der Assets-Liste angezeigt, auch wenn sie denselben Wirtschaftstoken in der Kette darstellen.

F: Werden durch das Hinzufügen eines benutzerdefinierten Tokens meine privaten Schlüssel oder meine Startphrase offengelegt? Nein. MetaMask führt alle Vorgänge clientseitig aus. Die Vertragsinteraktion erfolgt über signierte Nachrichten, die über RPC-Endpunkte weitergeleitet werden – keine sensiblen Daten verlassen die Browsererweiterung.