Skip to main content

Como crear un NFT en Solana usando Candy Machine

Created on
Updated on
Nov 26, 2024

8 min read

Introducción

¡Hola querido lector! Hemos recibido un montón de pedidos por otra guía de NFT en Solana. En la guia anterior no llegamos hasta la parte mas jugosa, que es la parte donde enlazamos una imagen y metadatos de un token.

Para poder hacer esto vamos a usar un programa llamado Candy Machine. Es una herramienta que te permite instalar tu propia tienda NFT de Solana en tu propio pequeño espacio del internet.

En esta guía vamos a guiarte por el proceso de instalar todo esto.

note

esta guía está creada con la intención de mostrarte como se hace y que se necesita para crear tu propio NFT en Solana. No es para enseñarte todas las tecnologías subyacentes. Hay muchísimo para aprender del ecosistema de Solana y si quieres hacer mas que lo que esta guia te ofrece, entonces tendrás que investigar y aprender alguna cosas mas! Ánimo! :)

Estos prerrequisitos tendrán que ser instalados antes de que sigamos adelante, ponemos los enlaces a todas las guías de instalación para cada uno, ellos de seguro han hecho un mejor trabajo explicando como se instala cada tecnología que lo que nosotros podríamos hacer.

Prerrequisitos

Introducción a Candy Machine

Candy Machine es un programa que utiliza Metaplex CLI para generar un NFT, enlaza una imagen y la metadata relevante de un token NFT, y ejecuta lo que se llama una "Fair auction", que consiste principalmente en dos cosas, la primera es que la subasta empieza para todos al mismo tiempo, no hay preventas! Lo segundo es que la transacción no se enviará si no quedan más NFT para poder ser creados.

Nunca más tirar tu SOL al vacío, inseguro de que existan más NFT para ser creados o no. Aunque hay muchas cosas por aprender e indagar aquí a medida que se avanza, la mejor manera de aprender es construyendo.

Haciendo un Fork del repositorio

Hay dos repositorios diferentes que puedes usar, uno es creado por el equipo de soporte de Candy Machine y otro que un miembro de la comunidad creó por encima para hacer las cosas un poco mas simples y crear un flujo de trabajo mas fluido. Nosotros usaremos este último en este tutorial, si quieres indagar por tu cuenta y desviarte del camino de este tutorial, debes de entender cómo funciona Metaplex.

Para poder hacer un fork del repositorio, deberás ir al repositorio creado por la comunidad y hacer clic en el botón de fork arriba a la derecha

Una vez realizado el fork del repositorio, lo tendras que clonar::

git clone https://github.com/<NombreDeUsuario>/solana-candy-factory

Instalación del Proyecto

Una vez que el código se ha descargado a tu ordenador, deberás abrir la carpeta solana-candy-machine en tu editor de código.

Instalación de las dependencias

Ahora empezaremos a configurar nuestro proyecto para empezar a desarrollarlo. El primer paso es instalar las dependencias, ejecutando el siguiente comando:

yarn

Corriendo la base de datos

Luego de instalar las dependencias necesarias, hay que correr la base de datos Postgres en Docker que va a tener la información de los NFT antes de ser emitidos hacia la red blockchain.

yarn start-nft-manager-db

Esto configura la base de datos y le brindará permisos para conectarse a Strapi, un gestor de contenido headless que contendrá toda la información de los NFTs.

Administrador NFT

Esta es la mayor belleza de todo este repositorio. Es posible utilizar un gestor de contenido headless para poder administrar toda la información de los NFTs antes de ser emitidos hacia la blockchain. Para poder configurar esto se utiliza el siguiente comando:

yarn nft-manager

Luego de esto, puedes navegar hacia la dirección http://localhost:1337/admin. La primera vez tendrás que crear una cuenta y loguearte. Después, tienes que crear un "usuario", para hacerlo, haz click en la opción que se muestra en la siguiente imagen

Llena los campos con la siguiente información:

  • Username: admin
  • Password: Admin123
  • Email: yourEmail@website.com
  • Confirmed: On
  • Role: Authenticated (Esto es MUY IMPORTANTE)

Lo único que queda es guardar el usuario. Habiendo realizado este paso, podemos empezar a crear nuestra colección

Una colección tiene una a muchas (one-to-many) relaciones con los NFTs. Una colección tendrá muchos NFTs.

El proceso sera muy parecido al de crear un usuario. Navega hacia la sección de Collections para crear una colección nueva.

Hay dos campos aquí, Name y Family que están relacionados a las collections, porque los campos que estamos llenando en Strapi tienen que coincidir con los atributos del JSON definido en el Estandar de Metadata NFT en SOLANA.

Name tiene que ser el nombre específico del proyecto que estás lanzando, mientras que Family puede ser de un conjunto más amplio.

Voy a nombrar los campos por su nombre, en pos de la transparencia de esta guía.

Name será Collection_Name y Family será Collection_Family. Ahora puedes guardar la colección e ir a la sección de NFTs para crear tus NFTs individuales.

Voy a mostrarte como se ven los míos y de paso, explicar cada campo:

Formato para la siguiente información --> FieldName: Valor -- Explicación

  • Name: CoolNFTName -- El nombre de tu NFT
  • Symbol: CNN -- Este es el "Ticker" de tu NFT, el identificador. Como DAPE para Degenerate APE Academy.
  • Description: Esta es la descripción de mi Super Cool NFT -- La descripción del NFT individual
  • Seller_fee_basis_points: 500 -- Este es el porcentaje de regalías que el creador del NFT recibirá en cada compra (500 es igual al 5%). No necesitas preocuparte mucho por este punto con este framework porque usamos la terminal de comandos pero siempre es bueno revisar que esté configurado como realmente queramos más allá de cómo se implemente en la terminal de comandos.
  • Image: Image.png -- Nombre del archivo de imagen. Deja este campo como Image.png (sin importar el nombre de la imagen real) porque cambia dinámicamente. DEBE de coincidir con el JSON en la parte de Properties --> Files --> Uri que mostraré más abajo.
  • Animation URL: n/a -- Es una URL a un archivo multimedia, soporta MP4 y MOV para video, MP3, FLAC y WAV para audio y GLB para AR/3D. Puedes usar `?ext={file_extension} para proveer informacion del tipo de archivo. External URL: https://www.quicknode.com/ -- Esta es una dirección que puede ser usada como respaldo para ver la imagen en un servicio centralizado como imgur. Sin embargo, puedes dejarlo en blanco (blank == "").
  • Traits:
  "attributes": [
{
"value": "Solana",
"trait_type": "Chain"
},
{
"value": "QuickNode",
"trait_type": "Company"
},
{
"value": "Tutorial",
"trait_type": "Category"
},
{
"value": "Degen",
"trait_type": "Status"
}
]

Estos serán los atributos de tu NFT. Tu no tienes que tener estos y son completamente arbitrarios. Sin embargo, si establece algún atributo, debe de tener un valor y un campo trait_type. El valor puede ser un texto o un número.

  • Properties:
  "files": [
{
"uri": "image.png",
"type": "image/png"
}
],
"category": "image",
"creators": [
{
"share": 100,
"address": "7K6XCSwVh3YZAh7GhARZ9pQ7gWkFNuWQ77U5CbV3PcF3"
}
]

Las propiedades contienen mucha información sobre lo que se está mostrando. Enlaza el tipo de archivo (Puedes ver los tipos soportados aqui), establece la uri (subida en arweave) y luego enlaza el creador o creadores del NFT, pueden haber múltiples creadores así que share puede ser hasta 100.

  • Content: Esto es donde puedes subir tu imagen. Esta es la que yo he escogido!

Nota: La imagen debe estar en formato PNG

Una vez que has llenado toda esta información con los datos que elegiste, estas listo para mintear el NFT.

Usar Candy Machine para crear el NFT

Con todo lo que hemos realizado hasta ahora, estamos solo a unos cuantos comandos para empezar. Y esto es debido al framework que estamos usando que simplifica las cosas a tan solo un par de comandos.

Lo primero que necesitamos hacer es asegurarnos que todo el dinero que se genere de los NFTs van a ir a tu cuenta. Usa el siguiente comando:

yarn update-creator-all-rows

Te preguntará la dirección correcta, pon tu dirección de Solana, es la dirección de creators que vimos anteriormente

Luego puedes poner el porcentaje de regalías que quieres hacer de las futuras ventas de los NFTs, esto es el campo Seller_fee_basis_points.

Con esto chequeado , podemos generar la información de los NFT

yarn update-creator-all-rows

Te preguntará si quieres mezclar (shuffle), esto intercambiara aleatoriamente el orden en que las personas van a mintear los NFTs. Si estás creando una partida muy grande de NFTs de entre 5 y 10 mil, seguramente no quieres que se generen en orden, esto lo mezclara por ti. En este tutorial solo hacemos un NFT asi que no tiene sentido alguno hacer esto.

Luego de correr el comando anterior, podrás apreciar dos archivos en la carpeta nft-manager/nfts-sources, 0.json y 0.png

Si estos archivos están ahí, estás listo para lanzarlos a la blockchain.

Como estamos usando la devnet las cosas serán un poco diferentes a si quieres lanzar tu NFT a la mainnet, pero el Readme del repositorio cubre bien estas diferencias. Puedes correr el siguiente comando y aceptar todos los valores por defecto apretando Enter sin ninguna otra adición.

yarn setup-dev

Si quieres aprender lo que sucede por detrás de este comando, está disponible en el archivo readme! Solo tienes que entender que esta es la parte encargada del minting del NFT que acabas de generar anteriormente.

Esto es todo para el proceso de lanzamiento a la blockchain!

Haciendo Minting de tu NFT

Con todo el programa creado y lanzado a la blockchain, solo queda interactuar con él. Para correr el sitio web debes de correr el siguiente comando:

yarn dev

Esto pondrá a tu disposición una página web http://localhost:3000. Puedes conectar tu wallet y hacer click en el botón de "Mint" como se muestra abajo:

Como puedes ver en la imagen, no hay más disponibles ya que acabamos de mintear el único que existía. Si ahora intentas hacer mint nuevamente mientras no hay disponibles, va a preguntarte si confirmas la transacción y luego el programa denegara la transacción ya que no hay más NFT para darte. Esto es parte de la fair auction que hablamos anteriormente.

Si todo salió como corresponde, ahora debes de tener un NFT en tu Phantom Wallet. Así se ve la mía:

Conclusión

¡Felicidades! Acabas de hacer mint de tu primer NFT en Solana! Hay muchas cosas detrás que nosotros no hemos cubierto. Si estás intentando hacer un lanzamiento más grande de NFTs en la mainnet, recomiendo estudiar más profundamente Metaplex para ver cómo funcionan los diferentes comandos existentes, las cosas no siempre funcionan tan directamente y debes de ser capaz de arreglar los problemas que aparezcan. Dicho esto, aún así has aprendido un montón!

Suscribete a nuestro newsletter para más artículos y guías en Ethereum. Si tienes algún tipo de comentario, se libre de comentarlos en nuestro Twitter Siempre puedes hablar con nosotros en nuestro servidor de Discord, puedes encontrar algunos de los más geniales desarrolladores :)

Share this guide