TUTORIAL: creando tokens nativos en Cardano testnet (Linux)

Aprender a crear tus tokens usando cardano-node y Daedalus en la testnet.

Basado/inspirado en: Minting Native Tokens on Cardano Testnet

El libro mayor (ledger) de Cardano, posee la característica ‘Multi-activos’ (multi-asset) lo cual permite registrar transacciones en varios activos de forma nativa sin necesidad de smart contracts. Los activos que se pueden crear con esta característica en Cardano se llaman ‘tokens nativos’.

Con la actualización Mary lanzada en marzo de 2021, se habilitó esta funcionalidad, permitiendo la creación de 31787 tokens al momento de escribir este artículo.

Al final de este tutorial habrás aprendido a crear una transacción que acuñará un token en la testnet de Cardano con metadata.

Para efectos de demostrar la utilidad y el potencial de los tokens nativos, en esta oportunidad acuñaremos un token que simulará la creación de un certificado de Denominación de Origen, según la propuesta hecha en nuestro artículo: Usando la blockchain Cardano para emitir certificados de Denominación de Origen en Venezuela.

Para ejecutar con éxito la acuñación del token deberás contar con:

• Daedalus testnet sincronizada al 100%.
• cardano-node 1.27.0 (lo instalé siguiendo esta guía).

Para poder hacer uso de la sincronización de Daedalus con la blockchain, guardaremos esta variable con la ruta del archivo cardano-node.socket (puede variar entre distribuciones de Linux):

Vamos a crear una variable para almacenar el ID de la testnet, lo necesitaremos más adelante:

Almacenemos también el nombre del token y la cantidad:

Asegúrate de estar en un directorio en el que tengas permiso de escritura, lo mejor es crear uno nuevo para esta operación pues vamos a crear varios archivos y directorios relacionados con la transacción.

Con los siguiente comandos, crearemos un monedero desde el cual acuñaremos el token:

Ahora, podrás encontrar la dirección de tu nuevo monedero en el archivo payment.addr, utiliza Daedalus para enviar algunas ADA de prueba a ese monedero.

¿Donde puedes adquirir ADA en testnet? En el faucet oficial: https://developers.cardano.org/en/testnets/cardano/tools/faucet/

Consultemos nuestro saldo a ver si cayó la transferencia:

Deberás ver algo como esto:

Exportaremos los parámetros del protocolo, los necesitaremos para calcular la comisión de la transacción. Los guardaremos en un archivo llamado protocol.json:

Para crear nuestra política, vamos a crear un directorio:

Ahora, crearemos las llaves que nos ayudarán a generar el policyID, parámetro indispensable para la creación de un token:

Crearemos ahora el archivo en el cual guardaremos el policy script:

Ahora, el policy script más básico posible:

Acá la documentación sobre los policy scripts

Ya podemos generar nuestro policyID:

A continuación ya podemos crear nuestra transacción.

La creación de un token consiste en la ejecución de una transacción de acuñación compuesta de:

• Entrada (UXTO)
• Salida (dirección y monto)
• Información de acuñación (política y nombre del token)
• Metadata

Comenzaremos con la metadata, que consiste en un archivo en formato JSON que llamaremos metadata.json. Por exigencia del protocolo, la raíz debe ser un número entero, el resto es la información de la D.O.C. o en tu caso lo que desees incluir:

Para preparar la entrada, consultaremos de nuevo el saldo de nuestro monedero y esta vez nos fijaremos en los datos que lo componen: TxHash (id de la transacción), TxIx (índice), Amount (monto en lovelace).

Guardemos esos datos en variables (en tu caso los valores serán distintos):

Ahora construyamos la transacción en bruto, vamos a guardarla en un archivo llamado matx.raw:

Luego, procedemos a calcular la tarifa. Este comando nos devolverá el monto en lovelace:

Guardemos el monto de la tarifa en una variable (reemplaza el valor por el que te arrojó en tu consola):

Ahora que tenemos la tarifa, volvamos a construir la transacción:

Firmamos:

Ya podemos enviar nuestra transacción a la blockchain:

Una vez que la transacción haya sido propagada y validada, podremos verla al consultar de nuevo nuestro saldo. Ya tienes en tu monedero el token creado, ahora la puedes enviar a tu monedero Daedalus testnet para que puedas visualizarlo.

Además, con el TxHash puedes también visualizar la transacción en el explorador de la tesnet: https://explorer.cardano-testnet.iohkdev.io/

Puede que al enviar la transacción, te arroje algún error por algún parámetro mal colocado, en esta guía encontrarás los errores más comunes y su solución: Diagnosing transactions problems and troubleshooting.