Le déploiement de contrats intelligents sur la blockchain SUI implique généralement de compiler le code Move en bytecode et de le publier sur le réseau. Bien que la CLI SUI automatise une grande partie de ce processus, les développeurs demandent parfois des conseils sur la gestion manuelle du bytecode brut, en particulier dans les environnements de test locaux tels queLocalnet. Cet article décrit les étapes à suivre pour publier du bytecode brut sur SUI Localnet, en tirant parti de la CLI SUI et des outils de développement.

---

Prérequis sur SUI Localnet

Avant de vous lancer dans le déploiement, assurez-vous de disposer des éléments suivants :

1. suiLa CLI SUI est installée : suivez le [guide d'installation] officiel (https://docs.sui.io/) pour configurer l'outil de ligne de commande. 2.Localnet Running : utilisez le sui-test-validatorbinaire pour lancer un réseau SUI local à des fins de test (https://docs.sui.io/). 3.Move Package : un package Move fonctionnel avec des modules et des dépendances configurés.

---

Qu'est-ce que SUI Localnet

SUI Localnet est un environnement sandbox permettant de tester des contrats intelligents sans risquer des actifs réels. Il permet aux développeurs de simuler des interactions, de déboguer la logique et de vérifier les déploiements avant de passer à Devnet ou Mainnet. Pour démarrer Localnet, exécutez :

sui-test-validator  

Cela initialise un nœud de validation local, fournissant un nouveau terrain d'essai avec des comptes préfinancés (https://docs.sui.io/)(https://scaf.gitbook.io/scaf/).

---

Comment préparer votre colis de déménagement ?

Un package Move comprend le code source (sources/), les dépendances (deps/) et les artefacts de construction (build/). Pour compiler le bytecode brut, concentrez-vous sur le buildrépertoire qui contient les .mvfichiers : le bytecode Move compilé.

1.Créez le package :

  sui client build <package_path>  

<package_path>Remplacez-le par le répertoire contenant votre Move.tomlfichier. build/Cela génère un bytecode dans le dossier.

2.Localisez le bytecode : Naviguez build/<package_name>/bytecode/jusqu'à la recherche .mvde fichiers pour chaque module. Ils représentent le bytecode brut à publier.

---

Publication de bytecode brut sur Localnet

sui client publishAlors que la CLI SUI résume la gestion des bytecodes, vous pouvez publier manuellement le bytecode brut à l'aide de la commande. Cette commande accepte le bytecode prédéfini au lieu de recompiler le package.

Guide étape par étape

1.Démarrez Localnet : Assurez-vous que le validateur local est en cours d'exécution :

  sui-test-validator  

2.Publier le bytecode : Utilisez la publishcommande avec le --bytecodedrapeau pour spécifier le répertoire de bytecode brut :

  sui client publish --bytecode <bytecode_path>  

<bytecode_path>Remplacez-le par le chemin d'accès à votre build/<package_name>/bytecode/répertoire.

Exemple :

  sui client publish --bytecode ./build/my_package/bytecode/  

La CLI soumettra le bytecode au réseau local, créant ainsi un nouvel objet de package en chaîne (https://thelib.to/move-book)(https://sui.io/).

3.Vérifier le déploiement : Vérifiez les détails de la transaction dans la sortie CLI. Utilisez l'explorateur SUI (s'il est disponible pour Localnet) ou interrogez le package via :

  sui client get-package <package_id>  

---

Erreur typique avec l'interface de ligne de commande Sui

1.Incohérences entre les versions de la CLI

Si l'interface de ligne de commande ne reconnaît pas les commandes, mettez-la à jour selon la méthode recommandée pour votre système d'exploitation. Évitez les mises à jour manuelles via cargopour éviter les conflits de dépendances (https://discord.gg/sui).

###2.Erreurs de chemin de bytecode Assurez-vous que le --bytecodedrapeau pointe directement vers le répertoire contenant .mvles fichiers. Des chemins incorrects provoqueront des erreurs de compilation.

3.Défaillances de connexion au réseau local

Vérifiez que le sui-test-validatorest actif et que votre configuration CLI pointe vers Localnet. Utilisation :

sui client envs  

pour vérifier l'environnement actif (https://docs.sui.io/).

Conclusion

publishLa publication du bytecode brut sur SUI Localnet est un processus de base lors de l'utilisation de la --bytecodecommande de la CLI SUI avec le drapeau. En tirant parti de l'environnement isolé de Localnet, les développeurs peuvent tester les contrats de manière itérative sans encourir de coûts ni de risques. Bien que la manipulation manuelle des bytecodes soit possible, la conception de la plateforme donne la priorité à l'automatisation, garantissant fiabilité et simplicité dans la plupart des cas d'utilisation.