So fügen Sie einem Sui-Wallet einen benutzerdefinierten Token hinzu

Grundlegendes zur benutzerdefinierten Token-Integration

1. Sui Wallet erkennt oder zeigt nicht automatisch alle auf der Sui-Blockchain bereitgestellten Token an.

2. Token müssen mithilfe ihrer On-Chain-Kennung, der sogenannten Objekt-ID des Münztyps, explizit in der Token-Liste des Wallets registriert werden.

3. Der Münztyp folgt einem strikten Format: 0x[address]::[module]::[struct] , wobei jedes Segment von der Move-Paketbereitstellung abgeleitet wird.

4. Benutzer können keine beliebigen Zeichenfolgen hinzufügen – es werden nur gültige, bereitgestellte und verifizierte Münztypen akzeptiert, die vom Sui-Netzwerk erkannt werden.

5. Wenn die genaue Groß-/Kleinschreibung, der Abstand oder der Modulpfad nicht übereinstimmen, führt dies zur Ablehnung beim Hinzufügen des Tokens.

Voraussetzungen für die manuelle Hinzufügung

1. Eine vollständig synchronisierte Sui Wallet-Erweiterung oder mobile App mit einem aktiven Konto.

2. Zugriff auf die offizielle Dokumentation oder Explorer-Seite des Tokens zur Bestätigung seiner Münztyp-ID .

3. Bestätigung, dass der Token-Vertrag im Mainnet oder Zielnetzwerk veröffentlicht wurde, nicht nur im Devnet oder Testnet.

4. Besitz von mindestens einer Instanz des Token-Objekts in der Adresse des Benutzers, überprüft über den CLI-Befehl sui client object .

5. Wissen darüber, ob der Token die Coin- Schnittstelle korrekt implementiert – benutzerdefinierte Strukturen, denen die ordnungsgemäße Einhaltung der Coin-Eigenschaften fehlt, werden nicht in den Guthaben angezeigt.

Schritt-für-Schritt-Token-Registrierung

1. Öffnen Sie die Sui Wallet-Benutzeroberfläche und navigieren Sie zur Registerkarte „Tokens“ .

2. Tippen oder klicken Sie auf die Schaltfläche + Token hinzufügen in der oberen rechten Ecke.

3. Wählen Sie „Benutzerdefiniertes Token“ aus, anstatt die Standardliste zu durchsuchen.

4. Fügen Sie die vollständige Münztypzeichenfolge in das Eingabefeld ein – Kürzungen oder Aliasing sind nicht zulässig.

5. Bestätigen Sie die Netzwerkkompatibilität. Das Wallet validiert den Typ anhand des aktuell verbundenen Netzwerks (z. B. Mainnet vs. Testnet).

6. Nach erfolgreicher Validierung werden das Token-Symbol, der Name und die Dezimalgenauigkeit automatisch aus den On-Chain-Metadaten abgerufen.

7. Klicken Sie auf „Hinzufügen“ , um die Registrierung abzuschließen und die Kontostandsynchronisierung auszulösen.

Probleme mit der Verifizierung und Sichtbarkeit

1. Überprüfen Sie nach dem Hinzufügen die Assets -Ansicht. Es kann bis zu 30 Sekunden dauern, bis Token angezeigt werden, wenn der Knoten ausgelastet ist.

2. Wenn das Token unsichtbar bleibt, überprüfen Sie den Objektbesitz mithilfe von sui client object --address [your-address] in der CLI.

3. Vergleichen Sie den Münztyp mit dem Sui Explorer, indem Sie die Objekt-ID in die Suchleiste einfügen und die Paketstruktur überprüfen.

4. Stellen Sie sicher, dass keine nachgestellten Leerzeichen oder unsichtbaren Unicode-Zeichen neben der Münztypzeichenfolge kopiert wurden.

5. Deaktivieren Sie alle Browsererweiterungen von Drittanbietern, die die Wallet-Injektion oder die Skriptausführung beeinträchtigen.

Häufig gestellte Fragen

F: Kann ich einen Token hinzufügen, ohne etwas davon zu besitzen? A: Nein. Das Wallet benötigt mindestens eine eigene Instanz des Münzobjekts, um die Kontostanddaten zu füllen. Das Hinzufügen eines Tokens ohne Besitz führt zu einem Nullsaldo und keinem Transaktionsverlauf.

F: Warum wird bei meinem benutzerdefinierten Token „Unbekannt“ als Name angezeigt? A: Dies tritt auf, wenn das On-Chain-Paket keine Metadatenveröffentlichung hat oder die Namens- und Symbolfelder in der CoinMetadata- Struktur des Move-Moduls leer sind.

F: Ist es sicher, einen Münztyp von einer nicht vertrauenswürdigen Quelle einzufügen? A: Nicht von Natur aus unsicher – der Münztyp selbst ist unveränderlich und öffentlich – aber die Überprüfung seiner Herkunft verhindert das versehentliche Hinzufügen von böswillig benannten Klonen oder wiedereintrittsanfälligen Varianten.

F: Muss ich den Token nach der Aktualisierung meiner Wallet-Version erneut hinzufügen? A: Nein. Token-Konfigurationen werden lokal im verschlüsselten Wallet-Speicher gespeichert und bleiben über Aktualisierungen hinweg bestehen, sofern sie nicht manuell gelöscht oder die Wallet-Daten zurückgesetzt werden.