La implementación de contratos inteligentes en la cadena de bloques de SUI normalmente implica compilar el código Move en un bytecode y publicarlo en la red. Si bien la CLI de la SUI automatiza gran parte de este proceso, los desarrolladores de vez en cuando buscan orientación sobre cómo manejar manualmente el código de bytes sin procesar, especialmente en entornos de pruebas locales comoLocalnet. En este artículo se describen los pasos para publicar código de bytes sin procesar en SUI Localnet, aprovechando la CLI de SUI y las herramientas de desarrollo.

---

Requisitos previos en SUI Localnet

Antes de comenzar con la implementación, asegúrese de contar con lo siguiente:

1. suiSUI CLI instalada: Siga la [guía de instalación] oficial (https://docs.sui.io/) para configurar la herramienta de línea de comandos. 2.Localnet Running: utilice el sui-test-validatorbinario para lanzar una red SUI local para realizar pruebas (https://docs.sui.io/). 3.Move Package: un paquete Move funcional con módulos y dependencias configurados.

---

Qué es SUI Localnet

SUI Localnet es un entorno aislado para probar contratos inteligentes sin poner en riesgo activos reales. Permite a los desarrolladores simular interacciones, depurar la lógica y verificar las implementaciones antes de pasar a Devnet o Mainnet. Para iniciar Localnet, ejecute:

sui-test-validator  

Esto inicializa un nodo validador local, lo que proporciona un nuevo campo de pruebas con cuentas prefinanciadas (https://docs.sui.io/)(https://scaf.gitbook.io/scaf/).

---

¿Cómo preparar tu paquete de mudanza?

sources/Un paquete Move se compone de código fuente (deps/), dependencias (build/) y artefactos de compilación (). Para compilar código de bytes sin procesar, céntrate en el builddirectorio, que contiene los .mvarchivos: el código de bytes de Move compilado.

1.Cree el paquete:

  sui client build <package_path>  

<package_path>Sustitúyalo por el directorio que contiene Move.tomlel archivo. build/Esto genera un código de bytes en la carpeta.

2.Localice el código de byte: Navegue hasta build/<package_name>/bytecode/encontrar los .mvarchivos de cada módulo. Estos representan el código de bytes sin procesar que se publicará.

---

Publicar código de bytes sin procesar en Localnet

sui client publishSi bien la CLI de la SUI resume la administración del código de bytes, puede publicar manualmente el código de bytes sin procesar mediante el comando. Este comando acepta códigos de bytes prediseñados en lugar de volver a compilar el paquete.

Guía paso a paso

1.Inicie Localnet: Asegúrese de que el validador local esté funcionando:

  sui-test-validator  

2.Publicar código de byte: Usa el publishcomando con la --bytecodebandera para especificar el directorio de códigos de bytes sin procesar:

  sui client publish --bytecode <bytecode_path>  

<bytecode_path>Sustitúyalo por la ruta a su build/<package_name>/bytecode/directorio.

Ejemplo:

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

La CLI enviará el código de bytes a Localnet, creando un nuevo objeto de paquete en cadena (https://thelib.to/move-book)(https://sui.io/).

3.Verificar la implementación: Compruebe los detalles de la transacción en la salida de la CLI. Utilice el SUI Explorer (si está disponible para Localnet) o consulte el paquete a través de:

  sui client get-package <package_id>  

---

Error típico con la CLI de Sui

1.**La versión de la CLI no coincide

Si la CLI no reconoce los comandos, actualícela mediante el método recomendado para su sistema operativo. Para evitar cargoconflictos de dependencia, evite las actualizaciones manuales (https://discord.gg/sui).

2.Errores de ruta de código de byte

--bytecodeAsegúrese de que la .mvbandera apunte directamente al directorio que contiene los archivos. Las rutas incorrectas generarán errores de compilación.

3.Fallos de conexión a Localnet

Confirme que sui-test-validatorestá activo y que la configuración de la CLI apunta a Localnet. Utilice:

sui client envs  

para verificar el entorno activo (https://docs.sui.io/).

Conclusión

publishLa publicación del código de bytes sin procesar en SUI Localnet es un proceso básico cuando se utiliza el --bytecodecomando de la CLI de SUI con la bandera. Al aprovechar el entorno aislado de Localnet, los desarrolladores pueden probar los contratos de forma iterativa sin incurrir en costos ni riesgos. Si bien es posible manipular manualmente los códigos de bytes, el diseño de la plataforma prioriza la automatización, lo que garantiza la confiabilidad y la simplicidad en la mayoría de los casos de uso.