Primeros pasos en Aptos

Introducción

Aptos es una red de Layer-1 segura y con alta escalabilidad. Permite la creación de smart contracts con Move, un lenguaje de programación diseñado específicamente para garantizar la seguridad y el control de acceso de los recursos computacionales de esta blockchain.

Gracias a la ejecución paralela de transacciones mediante su entorno de ejecución MoveVM, Aptos tiene la capacidad de procesar +100,000 TPS convirtiéndolo en una plataforma preparada para la aceleración de DApps a nivel global.

Instalando un editor de código

Para este tutorial intalaremos Visual Studio Code.

Puedes simplemente descargar el instalador para tu sistema operativo en la página oficial de Visual Studio

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.

git config --global user.name "Nombre Ejemplo"
git config --global user.email [email protected]

ℹ️ Recuerda sustituir los ejemplos con tus datos personales.

3. Clonando el repositorio de manera local

En tu terminal, corre el siguiente comando:

git clone https://github.com/Zona-Tres/aptos-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 aptos-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 .

Instalación de la Aptos CLI

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

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 aptos

3. Abre otra terminal y ejecuta el comando aptos help para verificar que la instalación fue correcta:

aptos help

Actualizar la CLI

Actualizar la CLI con brew requiere de 2 comandos:

brew update
brew upgrade aptos

Instalación en Windows

Para la instalación en Windows vamos a utilizar Python.

ℹ️ Importante: En Widows es necesario utilizar PowerShell para ejecutar los comandos. No utilices cmd.

1. Asegurate de tener instalado Python 3.6 o superior. Para esto puedes abrir una terminal y correr el siguiente comando:

python3 --version

Si el comando anterior arroja un error, es necesario instalar Python. Puedes hacerlo desde: https://www.python.org/.

2. Una vez instalado Python, correr el siguiente comando:

iwr "https://aptos.dev/scripts/install_cli.py" -useb | Select-Object -ExpandProperty Content | python3

⚠️ Si recibes un error como ModuleNotFoundError: No module named packaging puedes instalar la herramienta faltante packaging usando el comando:

pip3 install packaging

3. Una vez finalizada la instalación, deberías ver un mensaje diciendo Execute the following command to update your PATH:. Y un comando como este:

setx PATH "%PATH%;C:\Users\<your_account_name>\.aptoscli\bin"

⚠️ NO EJECUTES ESTE COMANDO. El uso de las comillas dobles en %PATH% puede causar que el valor actual de PATH no se expanda correctamente, lo que lleva a la sobrescritura del PATH en lugar de su extensión.

Te recomiendo usar el siguiente comando en vez del anterior:

[System.Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Users\<your_account_name>\.aptoscli\bin", "User")

ℹ️ Recuerda sustituir <your_account_name> con el nombre real de tu cuenta en Windows. Si no sabes cuál es, puedes obtenerlo con el siguiente comando:

$env:USERNAME

4. Finalmente, valida tu instalación corriendo:

aptos help

Instalación en Linux

1. Asegurate de tener instalado Python 3.6 o superior. Para esto puedes abrir una terminal y correr el siguiente comando:

python3 --version

Si el comando anterior arroja un error, es necesario instalar Python. Si estás usando Ubuntu, y sólo quieres instalar la versión necesaria para este Bootcamp, puedes correr los siguientes comandos:

sudo apt update
sudo apt install python3.6

Si en vez de lo anterior, deseas personalizar tu instalación o instalar la versión más reciente de Python, puedes hacerlo desde la página oficial: https://www.python.org/.

2. Una vez instalado Python, correr el siguiente comando:

curl -fsSL "https://aptos.dev/scripts/install_cli.py" | python3

ℹ️ Si el comando de arriba da error, es necesario instalar curl. Puedes hacerlo con los siguientes comandos:

sudo apt update
sudo apt install curl

3. Verifica la instalación utilizando:

aptos help

ℹ️ Si el comando de arriba da error, simplemente cierra tu terminal, abrela de nuevo y vuelve a intentar.

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.