Montaje de nodo validador de Juno

No pretendemos reemplazar la guía oficial en inglés de Juno Network, por el contrario complementar desde nuestra experiencia el proceso; a su vez, de traer esta documentación en lenguaje español.

Requerimientos de hardware

Los requerimientos mínimos que se necesitan para correr juno son:

• 4 vcpu.

• 32GB RAM

• 1TB de storage. (Recomendamos tipo NVME, la base de datos actual de juno no ocupa todo este espacio, pero se recomienda estar sobredimensionado para evitar estar haciendo intervenciones futuras).

Pasos para la instalación y configuración del binario junod

Sistema Operativo

El sistema operativo que nosotros elegimos fue ubuntu 20.04 LTS pero este puede funcionar en la mayoría de distribuciones Linux modernas o con soporte actual, y en las versiones más recientes de macOS.

Instalación de requisitos necesarios

#Actualizar paquetes
sudo apt update && sudo apt upgrade -y 

#Instalar herramientas necesarias para continuar la instalación
sudo apt-get install make build-essential gcc git jq chrony -y

Instalación de Go

Descargue e instale la última versión de Go desde su página oficial https://go.dev/doc/install

en nuestro caso sería la versión 1.18.4. NOTA: Juno necesita la version de Go 1.18 o superior

#Descargar Go 
wget https://go.dev/dl/go1.18.4.linux-amd64.tar.gz
#Eliminar Paquetes anteriores de Go (en caso de existir) 
rm -rf /usr/local/go
#extraer archivos en /usr/local
tar -C /usr/local -xzf go1.18.4.linux-amd64.tar.gz

Configuramos las variables en el archivo ~/.profile

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin

Actualizamos el archivo ~/.profile y verificamos la versión de Go

source ~/.profile
#validar la versión de Go
go version

Construir el binario de juno

Para conocer la versión más actual del binario revisa el repositorio oficial de juno aquí: https://github.com/CosmosContracts/juno

git clone https://github.com/CosmosContracts/juno
cd juno
git fetch
git checkout <version-tag>

En nuestro caso la versión más actual del binario es la v8.0.0 (Como las blockchain se van actualizando constantemente por mejoras ó fallas, la versión va cambiando).

#cambia de versión
git checkout v8.0.0
#revisar versión actual
git status
#Se realiza la compilación del binario
make install
#Se valida que la versión instalada coincida con la que necesitamos
junod version
# salida debe mostrar en este caso v8.0.0

Iniciar y Crear un nodo de validación en MainNet

Variables de entorno

Una forma más sencilla de configurar el entorno es creando variables, esto nos ayudará a agilizar un poco ya que no tendremos que estar buscando siempre el ID de la cadena, o los peers, entre otras, si no que los dejaremos definidos en variables que sean más sencillas de recordar, para ello las definiremos dentro del archivo ~/.profile.

En el archivo pondremos el ID de la cadena y el nombre como se va a reconocer este validador.

# "Decry" es solo un ejemplo de apodo, usted debe poner el de su preferencia.
CHAIN_ID=juno-1
MONIKER_NAME="Decry"

Configuración de Persistent peers

Los peer son los compañeros que necesitamos para poder obtener información de ellos y mantener nuestro nodo en sincronía con los demás. Para obtenerlos podemos crear otras variables de entorno así:

CHAIN_REPO="https://raw.githubusercontent.com/CosmosContracts/mainnet/main/$CHAIN_ID" && \
export PEERS="$(curl -sL "$CHAIN_REPO/persistent_peers.txt")"

Si no está seguro, puede preguntar por el discord oficial de juno network aquí https://discord.gg/RChBuccb para obtener más peers o nodos semilla para sincronizar su nodo

Inicializar la cadena de bloques

Para iniciar una cadena debemos ejecutar el binario compilado con el comando init y argumentos nombre del validador y el id de la cadena

junod init "$MONIKER_NAME" --chain-id $CHAIN_ID
#Si desea modificar el home
junod init "$MONIKER_NAME" --chain-id $CHAIN_ID --home /dirección/.juno

Si quiere cambiar la carpeta por defecto de .juno para usarla en otra partición con más espacio o en otro lado del sistema puedes anexar --home seguido de la dirección deseada. Por defecto utilizará la carpeta del usuario que corre el comando.

Este comando genera 3 archivos necesarios para el funcionamiento del nodo:

• genesis.json

• node_key.json (Necesario para recuperar el nodo, Guardarlo muy bien y no compartirlo)

• priv_validator_key.json (Necesario para recuperar el nodo, Guardarlo muy bien y no compartirlo)

Los dos archivos necesarios para recuperar el validador, se deben guardar muy bien y en lugares seguros igual como cuando almacenamos las semillas de nuestras wallets, ya que esta será nuestra única garantía para poder recuperar el validador en caso de pérdida, o de migración a otra máquina.

Archivo génesis

En el paso anterior se generó un archivo genesis.json, pero este se debe reemplazar por uno actualizado, para esto recurrimos al archivo que tiene alojado Dimi

wget https://download.dimi.sh/juno-phoenix2-genesis.tar.gz
tar -xvf juno-phoenix2-genesis.tar.gz
mv juno-phoenix2-genesis.json $HOME/.juno/config/genesis.json
#Este comando reemplazará el archivo genesis.json tenga en cuenta que está direccionado  a la ruta por defecto de .juno,
#usted debe modificarlo para que coincida con el suyo, si es el caso que modificó su dirección.

Establecer peers

La configuración de peers, se encuentra en el archivo ~/.juno/config/config.toml y para añadir los peers solo debemos ejecutar el siguiente comando:

sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" ~/.juno/config/config.toml

Establecer el costo del gas

Esto es recomendable para los validadores, ya que esto ayudará a proteger de spam y otros posibles ataques, esta configuración se encuentra por defecto en ~/.juno/config/app.toml

sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.0025ujuno,0.001ibc\/C4CFF46FD6DE35CA4CF4CE031E643C8FDC9BA4B99AE598E9B0ED98FE3A2319F9\"/" ~/.juno/config/app.toml

Esta configuración hará que el validador acepte tanto ujuno e IBC atom como tarifa para las transacciones, esta es la configuración que se recomienda.

Creación o Restauración de wallet

El validador necesita tener una billetera asociada para funcionar, aquí llegaran las comisiones, las recompensas de stacking que el nodo propio realice.

#Crear una nueva wallet si desea cambiar la ubicación use --home dir/.juno
junod keys add <nombre de la billetera> 
#Recuperar wallet ya existente, debe tener su frase nemotecnica para poder recuperarla, solo copiela
junod keys add <nombre de la billetera> --recover

Importante, al crear una nueva wallet, esta mostrará una frase nemotécnica, esta debe conservarse en algún lugar seguro ya que en caso de perder la wallet será la única forma de recuperarla, es de vital importancia no perder esta frase.

Sincronizar el nodo

Para ejecutar el binario se tienen dos métodos en el ecosistema de cosmos. Simplemente empezar a correr el binario como cualquier otro ejecutable o usar cosmovisor, nosotros recomendamos usar cosmovisor, ya que es una forma de tener el proceso de inicio, sincronización y actualización mucha más automatizado, para configurarlo con cosmovisor simplemente revise el apartado Cosmovisor de esta guía, en caso de querer hacerlo manualmente puede iniciar de la siguiente forma. Este proceso de sincronización puede tardar bastante, todo depende del tamaño de la blockchain.

junod start --home ubicacion/.juno
#Revisar estado de sincronización 
#true: aún está en proceso de sincronización
#false: ya está sincronizado y puede continuar
curl http://localhost:26657/status | jq .result.sync_info.catching_up
#Revisar altura de la cadena alcanzada 
curl http://localhost:26657/status | jq .result.sync_info.latest_block_height
#Uno compara el bloque alcanzado con la información que se desplega en el scan de la blockchain

Crear el validador en la red

Para realizar este paso, debe estar seguro de que su cadena ya esta sincronizada y tener una cantidad mínima de tokens juno en la wallet creada anteriormente.

junod tx staking create-validator \
  --amount 1000000ujuno \
  --commission-max-change-rate "0.1" \
  --commission-max-rate "0.20" \
  --commission-rate "0.1" \
  --min-self-delegation "1" \
  --details "detalles de su preferencia sobre el validador" \
  --pubkey=$(junod tendermint show-validator --home dir/.junod) \
  --moniker "$MONIKER_NAME" \
  --chain-id $CHAIN_ID \
  --gas-prices 0.025ujuno \
  --from <Nombre-billetera> \
  –-home ubicacion/.junod

Al finalizar con éxito este paso, debería poder ver después de unos segundos su validador dentro del scan de la red aquí https://www.mintscan.io/juno/validators

Configurando Cosmovisor

Cosmovisor es una herramienta de administración de los binarios de Cosmos SDK que constantemente supervisa nuevas actualizaciones y tiene la capacidad de ejecutarlas por sí mismo, de igual manera se recomienda estar al pendiente de toda actualización y si es posible descargar el binario de forma manual. Se recomienda usar cosmovisor para la mainnet, ya que automatiza procesos a la hora de actualizar nuestro nodo, es importante que ya sepa usar cosmovisor para implementarlo en mainnet, si no está familiarizado con este software, se recomienda implementarlo en el testnet y asegurarse de que puede configurarlo y ponerlo en marcha correctamente.

Instalación

#obtenemos cosmovisor
go get github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor

# o puede instalar última versión disponible (recomendado)
go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor@latest

# para elegir una versión específica use (v1.0.0 es un ejemplo) 
go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor@v1.0.0

Agregar variables de entorno

En el archivo ~/.profile se debe agregar las siguientes lineas

export DAEMON_NAME=junod
export DAEMON_HOME=$HOME/.juno
#Cargar las variables nuevamente al entorno
source ~/.profile

Estructura de Carpetas para Cosmovisor

Cosmovisor siempre espera una misma estructura de carpetas, la cual es la siguiente:

.
├── current -> genesis or upgrades/<name>
├── genesis
│   └── bin
│       └── $DAEMON_NAME
└── upgrades
    └── <name>
        └── bin
            └── $DAEMON_NAME

NOTA: este resultado anterior se puede ver con la herramienta tree, la raiz de estas carpetas esta predefinido a través de las variables. Por lo tanto; va quedar en el home definido para la instalación de juno. Para tener la estructura anterior creamos estas carpetas:

mkdir -p $DAEMON_HOME/cosmovisor/genesis/bin
mkdir -p $DAEMON_HOME/cosmovisor/upgrades

Configurar cosmovisor

Para esto cosmovisor necesita conocer el binario que usará para inicializar, en este caso sería v8.0.0, este binario se debe copiar en $DAEMON_HOME/cosmovisor/genesis/bin buscamos el binario, este fue compilado al inicio de la guia.

which junod
# Lo copiamos a la nueva ubicación, cambie el origen según sea su caso
cp $HOME/go/bin/junod $DAEMON_HOME/cosmovisor/genesis/bin

Configurar el servicio para ejecutarse en segundo plano

Con la anterior configuración lo que logramos es que haya una correspondencia entre los dos binarios (comovisor y junod), por lo que escribir cosmovisor version será igual que escribir junod version.

Igual que se configuraría para el binario junod, usaremos la configuración para cosmovisor, para que este pueda trabajar de forma correcta en segundo plano, y en caso de que ocurra algún bug o daño este se reinicie automáticamente para esto nosotros usamos el servicio systemd, primero creamos el servicio:

nano /etc/systemd/system/cosmovisor.service

La configuración correspondiente debe ajustarla a su sistema y a sus preferencias, compartimos la configuración que nosotros tenemos para que sirva de base, debe verificar bien las rutas de los binarios usados.

[Unit]
Description=cosmovisor juno
After=network-online.target

[Service]
User=<user>
ExecStart=/root/go/bin/cosmovisor start --home /mnt/data/.juno
Restart=always
RestartSec=3
LimitNOFILE=4096
Environment="DAEMON_NAME=junod"
Environment="DAEMON_HOME=/mnt/data/.juno"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"

[Install]
WantedBy=multi-user.target

Iniciar cosmovisor

Después de crear el servicio, debe habilitarlo y ponerlo a funcionar

systemctl daemon-reload
systemctl enable cosmovisor
systemctl start cosmovisor

Verificación de los procesos:

#validar el estado del demonio de cosmovisor
systemctl status cosmovisor

#Para ver los logs del proceso que se está ejecutando:
journalctl -u cosmovisor -f

Realizado por:

Mauricio Gil - [e-mail]

fabian - [e-mail]