Comment ajouter un jeton personnalisé à un portefeuille Sui

Comprendre l'intégration des jetons personnalisés

1. Sui Wallet ne détecte ni n'affiche automatiquement tous les jetons déployés sur la blockchain Sui.

2. Les jetons doivent être explicitement enregistrés dans la liste de jetons du portefeuille en utilisant leur identifiant en chaîne, appelé ID d'objet du type de pièce.

3. Le type de pièce suit un format strict : 0x[address]::[module]::[struct] , où chaque segment est dérivé du déploiement du package Move.

4. Les utilisateurs ne peuvent pas ajouter de chaînes arbitraires : seuls les types de pièces valides, déployés et vérifiés reconnus par le réseau Sui sont acceptés.

5. Le fait de ne pas correspondre exactement à la casse, à l'espacement ou au chemin du module entraîne le rejet lors de l'ajout du jeton.

Conditions préalables à l'ajout manuel

1. Une extension Sui Wallet ou une application mobile entièrement synchronisée avec un compte actif.

2. Accès à la documentation officielle du token ou à la page de l'explorateur confirmant son identifiant de type de pièce .

3. Confirmation que le contrat de jeton a été publié sur le réseau principal ou le réseau ciblé, et pas seulement sur le devnet ou le testnet.

4. Propriété d'au moins une instance de l'objet jeton dans l'adresse de l'utilisateur, vérifiée via la commande CLI sui client object .

5. Savoir si le jeton implémente correctement l'interface Coin : les structures personnalisées qui ne respectent pas correctement les traits Coin n'apparaîtront pas dans les soldes.

Enregistrement de jeton étape par étape

1. Ouvrez l'interface Sui Wallet et accédez à l'onglet Jetons .

2. Appuyez ou cliquez sur le bouton + Ajouter un jeton situé dans le coin supérieur droit.

3. Sélectionnez Jeton personnalisé au lieu de rechercher dans la liste par défaut.

4. Collez la chaîne complète du type de pièce dans le champ de saisie (aucune troncature ni alias autorisé).

5. Confirmez la compatibilité du réseau ; le portefeuille validera le type par rapport au réseau actuellement connecté (par exemple, réseau principal ou testnet).

6. Une fois la validation réussie, le symbole du jeton, le nom et la précision décimale sont automatiquement récupérés à partir des métadonnées de la chaîne.

7. Cliquez sur Ajouter pour finaliser l'enregistrement et déclencher la synchronisation du solde.

Problèmes de vérification et de visibilité

1. Après l'ajout, vérifiez la vue Actifs : les jetons peuvent prendre jusqu'à 30 secondes pour indiquer si le nœud est sous charge.

2. Si le jeton reste invisible, vérifiez la propriété de l'objet à l'aide des objets client sui --address [votre-adresse] dans la CLI.

3. Vérifiez le type de pièce avec Sui Explorer en collant l'ID de l'objet dans la barre de recherche et en inspectant la structure du package.

4. Assurez-vous qu'aucun espace de fin ou aucun caractère Unicode invisible n'a été copié à côté de la chaîne de type de pièce.

5. Désactivez toutes les extensions de navigateur tierces qui interfèrent avec l'injection de portefeuille ou l'exécution de scripts.

Foire aux questions

Q : Puis-je ajouter un jeton sans en posséder aucun ? R : Non. Le portefeuille nécessite au moins une instance détenue de l'objet pièce pour renseigner les données de solde. L'ajout d'un jeton sans propriété entraîne un solde nul et aucun historique des transactions.

Q : Pourquoi mon jeton personnalisé affiche-t-il « Inconnu » comme nom ? R : Cela se produit lorsque le package en chaîne ne dispose pas de publication de métadonnées ou que les champs de nom et de symbole sont vides dans la structure CoinMetadata du module Move.

Q : Est-il sécuritaire de coller un type de pièce provenant d’une source non fiable ? R : Ce n'est pas intrinsèquement dangereux (le type de pièce lui-même est immuable et public), mais la vérification de son origine empêche l'ajout accidentel de clones nommés de manière malveillante ou de variantes sujettes à la réentrée.

Q : Dois-je rajouter le jeton après avoir mis à jour la version de mon portefeuille ? R : Non. Les configurations de jetons sont stockées localement dans un stockage de portefeuille crypté et persistent dans toutes les mises à jour, à moins qu'elles ne soient effacées manuellement ou que les données du portefeuille ne soient réinitialisées.