Primeros pasos en Sui

Introducción

Sui es una plataforma de blockchain y contratos inteligentes de capa 1 diseñada para que la propiedad de activos digitales sea rápida, privada, segura y accesible.

Move es un lenguaje de código abierto para escribir paquetes seguros para manipular objetos en blockchain. Permite bibliotecas, herramientas y comunidades de desarrolladores comunes en blockchains con modelos de datos y ejecución muy diferentes.

Instalando un editor de código

Para este tutorial intalaremos Visual Studio Code.

1. Descarga el instalador para tu sistema operativo en la página oficial de Visual Studio
2. (Opcional) Recomendamos instalar las siguientes extensiones:
   • Move (Extension) es una extensión de servidor de lenguaje para Move mantenida por Mysten Labs.
   • Move Formatter es un formateador de código para Move, desarrollado y mantenido por Mysten Labs.
   • Move Syntax una simple extensión de resaltado de sintaxis para Move por Damir Shamanaev.

Clonando este repositorio

ℹ️ Asegurate de tener acceso a una consola en tu equipo con permisos para instalación de software.

1. Instalación de Git

1. Instalación en Mac
2. Instalación en Windows
3. Instalación en Linux

Instalación en Mac

1. Asegurate de tener Homebrew instalado: https://brew.sh/.
2. Abre una terminal e introduce los siguientes comandos:

brew update
brew install git

3. Si requieres más información sobre la instalación, puedes encontrarla en la documentación oficial de Git.

Instalación en Windows

1. Descarga el instalador de la página oficial de Git: https://www.git-scm.com/download/win.
2. Sigue las instrucciones indicadas. Las opciones que el instalador por defecto suelen ser suficientes, pero si quieres customizar tu instalación de alguna manera y sabes lo que estás haciendo, sientete libre de cambiar lo que necesites.

Instalación en Linux

1. Para distribuciones basadas en Debian, cómo Ubuntu, puedes correr los siguientes comandos:

sudo apt update
sudo apt install git-all

2. Si requieres información sobre la instalación en alguna otra distribución específica, puedes encontrarla en la documentación oficial de Git.

2. Configurando Git

Es buena idea configurar los valores globales de tu usuario antes de comenzar a utilizar Git. Puedes hacerlo con los siguientes comandos.

ℹ️ Recuerda sustituir los ejemplos con tus datos personales.

git config --global user.name "Nombre Ejemplo"
git config --global user.email nombre@ejemplo.com

3. Clonando el repositorio de manera local

En tu terminal, corre el siguiente comando:

git clone https://github.com/Zona-Tres/sui-first-steps.git

ℹ️ Recuerda que puedes cambiar el directorio donde se clonará el repositorio. Utiliza cd para moverte entre los directorios de tu equipo, y mkdir para crear uno nuevo.

Más información: Tutorial comandos básicos.

Una vez clonado el repositorio, puedes navegar a él:

cd sui-first-steps

Para visualizar los contenidos puedes correr el comando:

ls -a

Y para abrirlo en el editor de código (en nuestro caso, VS Code), puedes correr:

code .

3. Instalación de la Sui CLI

Para poder interactuar con los contenidos de los tutoriales, es necesario instalar la Sui CLI.

1. Instalación en Mac
2. Instalación en Windows
3. Instalación en Linux

Instalación en Mac

Podemos instalar Sui de dos maneras. Una usando la herramienta desarrollada por MystenLabs suiup y otra utilizando Hombrew. La recomendada para dar tus primeros pasos si necesidad de hacer muchas configuraciones es suiup, sin embargo, esta herramienta no se debe utilizar para entornos productivos. Vamos a explorar ambas opciones.

suiup

• Ejecuta el siguiente comando en tu terminal:

curl -sSfL https://raw.githubusercontent.com/Mystenlabs/suiup/main/install.sh | sh

• Ó puedes descargar los binarios e instalarlo manualmente directamente desde el repositorio oficial de suiup. Esta opción es algo más avanzada por lo que si nunca haz instalado algo de forma similar, recomendamos usar el comando de arriba.

ℹ️ Si no sabes que arquitectura tienes puedes correr el siguiente comando:

uname -m

• Si dice arm64 → Descarga suiup-macOS-arm64.tar.gz.
• Si dice x86_64 → Descarga suiup-macOS-x86_64.tar.gz.

1. Puedes probar que la instalación de suiup se realizó de manera correcta corriendo el siguiente comando:

suiup --version

2. Una vez que instales suiup, sin importar cual opción escogiste, ejecuta el siguiente comando para instalar la Sui CLI:

suiup install sui

3. Y de nuevo, puedes probar que todo salió bien usando:

sui --version

Hombrew

1. Asegurate de tener Homebrew instalado: https://brew.sh/.
2. Abre una terminal e introduce los siguientes comandos:

brew update
brew install sui

3. Puedes probar que todo se haya instalado correctamente corriendo:

sui --version

Instalación en Windows

Podemos instalar Sui de dos maneras. Una usando la herramienta desarrollada por MystenLabs suiup y otra utilizando un administrador de paquetes como Chocolatey. La recomendada para dar tus primeros pasos si necesidad de hacer muchas configuraciones es suiup, sin embargo, esta herramienta no se debe utilizar para entornos productivos. Vamos a explorar ambas opciones.

suiup

1. Descarga el instalador directamente desde el repositorio oficial de suiup.

ℹ️ Si no sabes que arquitectura tienes simplemente descarga el archivo suiup-Windows-msvc-x86_64.zip.

2. Una vez instalado, abre una terminal y corre el siguiente comando para verificar que todo salió bien:

suiup --version

ℹ️ Recomendamos usar Powershell como terminal para ejecutar todos los comandos de este repositorio en Windows.

3. Una vez que instales suiup ejecuta el siguiente comando para instalar la Sui CLI:

suiup install sui

4. Y de nuevo, puedes probar que todo salió bien usando:

sui --version

choco

1. Asegurate de tener Chocolatey instalado: https://chocolatey.org/install.
2. Abre una terminal e introduce el siguiente comando:

choco install sui

3. Puedes probar que todo se haya instalado correctamente corriendo:

sui --version

Instalación en Linux

Podemos instalar Sui de dos maneras. Una usando la herramienta desarrollada por MystenLabs suiup y otra utilizando el administrador de paquetes para Rust llamado cargo. La recomendada para dar tus primeros pasos si necesidad de hacer muchas configuraciones es suiup, sin embargo, esta herramienta no se debe utilizar para entornos productivos. Vamos a explorar ambas opciones.

suiup

• Ejecuta el siguiente comando en tu terminal:

curl -sSfL https://raw.githubusercontent.com/Mystenlabs/suiup/main/install.sh | sh

• Ó puedes descargar los binarios e instalarlo manualmente directamente desde el repositorio oficial de suiup. Esta opción es algo más avanzada por lo que si nunca haz instalado algo de forma similar, recomendamos usar el comando de arriba.

ℹ️ Si no sabes que arquitectura tienes puedes correr el siguiente comando:

uname -m

• Si dice arm64 → Descarga suiup-Linux-musl-arm64.tar.gz.
• Si dice x86_64 → Descarga suiup-Linux-musl-x86_64.tar.gz.

1. Puedes probar que la instalación de suiup se realizó de manera correcta corriendo el siguiente comando:

suiup --version

2. Una vez que instales suiup, sin importar cual opción escogiste, ejecuta el siguiente comando para instalar la Sui CLI:

suiup install sui

3. Y de nuevo, puedes probar que todo salió bien usando:

sui --version

cargo

1. Asegurate de tener rustup instalado: https://www.rust-lang.org/tools/install.
2. Abre una terminal e introduce los siguientes comandos:

rustup update stable
cargo install --git https://github.com/MystenLabs/sui.git sui --branch devnet

3. Puedes probar que todo se haya instalado correctamente corriendo:

sui --version

4. Instalación de MVR

Move Registry (MVR) es un gestor de paquetes para Move. Permite a cualquiera publicar y utilizar paquetes publicados en nuevas aplicaciones desarrolladas con Move.

1. Dependiendo de como hayas instalado la sui CLI es como instalarás mvr.

• Si instalaste suiup (sin importar tu sistema operativo), corre el siguiente comando:

suiup install mvr

• Si instalaste sui utilizando cargo, corre el siguiente comando:

cargo install --locked --git https://github.com/mystenlabs/mvr --branch release mvr

• Por último, si realizaste la instalación de manera manual descargando el instalador y no instalaste suiup, puedes descargar el instalador de mvr desde el repositorio oficial.

2. Sin importar cual opción elegiste, recuerda revisar que la instalación se haya realizado de manera correcta:

mvr --version

5. Interactuando con el repositorio.

El repositorio está compuesto de varias carpetas con archivos para cada tutorial, simplemente navega a ellas usando cd y sigue las instrucciones dentro.

Cada tutorial cuenta con un archivo README.md con instrucciones claras de cómo interactuar con ellos.