Chia 🌱 - DataLayer, tutorial de iniciación usando la CLI en Linux

En el anterior artículo hablamos acerca de Chia DataLayer, una base de datos descentralizada pública y de uso general que supone un paradigma tecnológico poco visto hasta entonces.

Introducción

Llega el momento de ponernos manos a la obra y comenzar a trabajar en un escenario básico en el cual contaremos de dos hosts con una instalación de la blockchain oficial de Chia.

Todos los pasos se realizarán mediante la interfaz de línea de comandos (CLI) en entornos Linux.

Uno de los hosts se configurará como publisher y se creará un datastore además de un mirror en los cual publicaremos datos en crudo. El otro host se configurará como observer, se suscribirá al datastore previamente creado y realizaremos pruebas para comprobar la sincronización de los datos.

1. Requisitos

Instrucciones para ambos hosts

• Dos máquinas Linux con la distribución de tu elección, preparadas con la última versión disponible de la blockchain de Chia. Clonarse el repositorio de git Chia-Network/chia-blockchain en un directorio (por ejemplo en /etc).

sudo git clone https://github.com/Chia-Network/chia-blockchain.git /etc/chia-blockchain

• Instalarlo siguiendo las instrucciones de la wiki dependiendo de la distribución que corresponda.

• Para cada instalación de Chia, tener sincronizada una wallet estándar (no es necesario tener un full-node sincronizado).
• Elegir el host y la cartera que creará al datastore y asegurarse de tener al menos 0,1 XCH (100000000000 Mojo) en ella ya que serán necesarios para crear el datastore. Si no se dispone de la cuantía se recomienda seguir las siguientes instrucciones para conseguirlo en aproximadamente 10min.
• Puesto que para el proceso de publicación de los datos se disponibilizará un mirror en la máquina publisher, asegurarse de que no haya ningún firewall que interrumpa las comunicaciones entrantes al puerto TCP 8575 de esa máquina

En el escenario de ejemplo, la máquina galixeon asumirá el role de publisher y galichia ejercerá de subscriber.

Accedemos mediante una interfaz de línea de comandos a la máquina publisher, nos ubicamos en el directorio donde se haya clonado el repositorio de chia-blockchain y activamos el entorno virtual de Python con la instrucción
. ./activate.

2. Habilitar los servicios

Instrucciones para ambos hosts

De cara a poder interactuar con las partes involucradas en el funcionamiento de DataLayer es necesario habilitar los servicios de wallet y data, mediante el siguiente comando:

chia start data wallet

3. Comprobar las carteras

Instrucciones para ambos hosts

Una vez arrancados los servicios, comprobamos que tenemos dos carteras: Una wallet de tipo STANDARD_WALLET y otra de tipo DATA_LAYER. Las wallets deben de estar sincronizadas con la red de Chia, sino no será posible realizar operaciones sobre la red. Ejecutamos el siguiente comando:

chia wallet show

Si aparece la palabra Synced estamos listos para operar, en caso de que el estado sea Syncing, es necesario esperar a que finalice de sincronizarse.

4. Crear un datastore

Instrucciones para host publisher

¡Bien! ya estamos listos para crear nuestro primer datastore en Chia. Simplemente ejecutamos el siguiente comando:

chia data create_data_store

Visualizaremos mucha información en el output; si todo ha ido de forma correcta, será muy similar al de la captura. Nos quedaremos únicamente con el ID del datastore, copiarlo y guardarlo.

En caso de ser necesario volver a consultar el ID del datastore ejecutar chia data get_owned_stores.

5. Hello World

Publicación de los datos

Instrucciones para host publisher

Volvemos a nuestro host publisher e intentamos crear un dataset de cara a probar el proceso de replicación. Para ello publicaremos un conjunto de datos de tipo clave-valor. Los datos que viajen a través de Data Layer únicamente pueden ser de tipo hexadecimal por lo que todo lo que querramos publicar en el repositorio de datos será necesario transformarlo antes de enviarlo.

Simplemente adaptar las variables DATASTORE_ID, CLAVE y VALOR con los valores deseados, copiar y pegar las instrucciones de cara a crear una entrada de datos sencilla. El comando xxd se encarga de realizar la conversión a hexadecimal en el formato correcto.

DATASTORE_ID="ddc4b7bd618cfdaba43c467d26b20677d2874fe23b883deefae1bb524ddd5ad2"
CLAVE="CRIPSISXYZ"
VALOR="HOLA MUNDO!"

chia data update_data_store --id=$DATASTORE_ID -d "[{\"action\":\"insert\", \"key\":\"$(xxd -pu <<< $CLAVE)\", \"value\":\"$(xxd -pu <<< $VALOR)\"}]"

El output debe contener el campo {'success': True}. Podemos observar la key tx_id que indica el identificador de la transacción, que es pública dentro de la blockchain.

Probar a registrar un par de datos en el datastore.

Prueba de inclusión del dato

Instrucciones para host publisher

Vamos a comprobar que los datos se han incluído en la blockchain y que se han generado el hash único que identifican al cambio y su contenido:

chia data get_root_history --id=DATASTORE_ID

Como podemos ver en el output, tenemos un json con tres elementos (el primer elemento es el raíz y siempre se autogenera), que son la cantidad de transacciones que se han generado para ese datastore y para cada elemento, si la transacción está confirmada, la prueba de inclusión (el hash) y una marca de tiempo de cuando se ha validado dicha transacción.

6. Creación de un mirror

Instrucciones para host publisher

Ahora que ya sabemos registrar transacciones dentro de la blockchain y comprobar su inclusión, es hora de que los datos del datastore sean replicables a otros nodos de chia. Para ello es necesario crear un mirror que apunte al identificador del datastore al cual nos conectaremos a posteriori desde el host subscriber.

Levantar el servicio

Comenzamos por levantar el servicio del mirror llamado data_layer_http que se disponibilizará a través del puerto TCP 8575. Si se dispone de un nombre de dominio que apunta a la máquina publisher, se puede utilizar dicho nombre. En caso contrario utilizar directamente la IP pública.

chia start data_layer_http

Añadir el espejo

Ejecutamos el siguiente comando en el cual le especificamos con -i el ID del datastore, con -u el FQDN o la IP que apunte al host y con -a una pequeña cantidad de Mojos. Ese parámetro sirve entre otras cosas para decidir la prioridad de elección del mirror en el caso de haber varios mirrors para un datastore.

chia data add_mirror -i DATASTORE_ID -u http://NOMBRE_O_IP:8575 -a 1000

En este punto ya tenemos capacidad de replicación de datos para cuando se suscriba una nueva cartera.

7. Suscribirse al datastore

Instrucciones para host subscriber

Ahora es el turno de la máquina subscriber suscribirse al datastore recientemente creado y a su mirror. Para ello ejecutar el siguiente comando y sustuir STORE_ID por el ID del datastore previamente creado:

chia data subscribe -store STORE_ID -u http://NOMBRE_O_IP:8575

La salida como de costumbre debe de ser {'success': True}.

Prueba de inclusión del dato

Vamos a comprobar que los datos se han replicado correctamente a través de DataLayer, desde el host subscriber. Volvemos a ejecutar

chia data get_root_history --id=DATASTORE_ID

Como podemos ver en el output, tenemos el mismo json con el elemento raíz y las dos transacciones que hemos generado previamente. Eso significa que los cambios están ya propagados a nuestro nodo.

8. Lectura de datos

Ahora que sabemos que los datos están disponibles, vamos a tratar de visualizarlos. Mediante el siguiente comando vamos a ver los datos en crudo en hexadecimal:

chia data get_keys_values --id=STORE_ID

Vemos dos elementos dentro del array del json, con su relación de clave-valor. Si quisieramos visualizar únicamente las claves disponibles, ejecutar

chia data get_keys --id=STORE_ID

Si queremos conocer de forma rápida el valor descifrado de un campo hexadecimal, simplemente ejecutar nuevamente el comando xxd con los parámetros para revertir. Por ejemplo:

echo 0x4352495053495358595a0a | xxd -r -p

Y listo! Ahora ya entendemos el funcionamiento de la replicación de datos de Chia.

Cantidad (XCH): Donar un poco de Chia :)