- Alex Lopez
Crea mi primer NFT ERC721 con las API de Vottun
Crear una colección de NFT desde el punto de vista de un desarrollador se ha vuelto muy fácil gracias a las API de Vottun . En unos sencillos pasos, y en muy poco tiempo, podrás integrar las API con tu software y desarrollar tus propias soluciones DAPP.3.
Empecemos
Estos son los pasos a seguir para extraer su primer NFT con las API de Vottun :
- Obtenga sus credenciales para poder utilizar las API.
- Ten claras las características de tu colección: activos digitales y metadatos.
- Implemente su contrato en la red de su elección.
- Cargue su activo digital a IPFS utilizando nuestras API.
- Agregue la URL de su activo digital a sus metadatos y cárguelo también en IPFS.
- Crea tu NFT con la URL del activo digital subido a IPFS.
Como obtener mis credenciales
Obtener credenciales es muy fácil. Tienes la opción de obtener una prueba de 30 días en la URL. https://apis.vottun.tech/trial . Complete el formulario y recibirá un correo electrónico como el siguiente con sus credenciales listas para usar.
Además de las credenciales, también recibirás la clave pública de una billetera que podrás utilizar en tus pruebas (por razones de seguridad, la clave privada siempre se guarda en nuestros servidores).
Una vez que los recibes su uso es muy sencillo, el token JWT se debe utilizar como Autenticación de Portador y el ID de la Aplicación se debe agregar en otro encabezado llamado x-application- vkn y debes enviarlo en todas las llamadas.
Encontrará más información sobre las API en https://developers.vottun.tech .
Mis NFT
Para poder crear un NFT debes tener en cuenta 4 aspectos importantes:
- El activo digital en sí debe crearse en un formato digital que pueda almacenarse en la cadena de bloques. Esto puede incluir cualquier cosa, desde una obra de arte digital, un archivo de música, un vídeo o incluso un tweet. El activo digital debe ser de alta calidad y resolución para garantizar su valor y deseabilidad.
- Se deben agregar metadatos a la NFT para proporcionar información sobre el activo y su propiedad. Esto incluye el título, la descripción, la información del creador y cualquier detalle relevante, como los números de edición o la rareza. Los metadatos deben ser completos y precisos para brindar transparencia y confianza a los compradores potenciales.
- El NFT debe almacenarse en una red de almacenamiento descentralizada como IPFS (Sistema de archivos interplanetario). Esto garantiza que el activo digital sea accesible y ninguna entidad centralizada pueda eliminarlo ni modificarlo. El uso de IPFS también permite compartir y ver la NFT en diferentes plataformas y mercados.
- Finalmente, al crear un NFT para la venta en un mercado, se deben completar ciertos campos para que sea visible y se pueda buscar. Estos incluyen título, descripción, imagen, nombre de la colección e información del creador. También se recomienda incluir información adicional como la fecha de creación, el número de edición y cualquier etiqueta o palabra clave relevante para aumentar la visibilidad y atraer compradores potenciales.
Implemente su contrato inteligente
Una vez que tengamos todo claro, es el momento de empezar a utilizar las API de Vottun . Lo primero que haremos será implementar un contrato inteligente en la red de nuestra elección, para este artículo usaremos Avalanche. Recuerda que tienes toda la información en https://developers.vottun.tech
El punto final de la implementación es:
https://api.vottun.tech/nft/v3/erc721/deploy
Es una llamada POST y, además, debes agregar un JSON con la información necesaria para su despliegue:
Como puedes ver, informamos el nombre del Contrato Inteligente (aparecerá como nombre de colección en los Marketplaces), el Símbolo, que no es más que un nombre en clave para el Token, la red blockchain, en este caso la Avalancha. Testnet y el límite de gas a utilizar, hemos puesto 3000000 para este contrato.
La llamada completa lanzada desde curl:
Y un ejemplo para ejecutar en NodeJS:
La API devolverá el siguiente resultado:
Subir archivos a IPFS
Usando las API, primero cargaremos nuestro activo digital en IPFS, esto devolverá una URL de nuestro activo en la red. Para ello realizaremos una llamada POST al endpoint:
https://ipfsapi-v2.vottun.tech/ipfs/v2/file/upload
Su tipo de contenido debe ser multiparte/form-data e incluirá dos campos:
- Nombre de archivo: un nombre para el archivo.
- Archivo: el archivo en sí
La API devolverá el siguiente resultado que contiene la URL IPFS del activo:
La llamada completa lanzada desde curl:
Y de NodeJS:
Una vez que tenemos la URL del activo, creamos nuestros metadatos y también los subimos a IPFS. En nuestro caso, nosotros tener creado este metadatos :
Los campos nombre , imagen , descripción y external_url son estándar y se utilizan en todos los mercados. También puedes agregar el campo Animation_url con un gif animado o un video que en algunos mercados se usará para mostrar el NFT en tu página. Todo el contenido de datos es gratuito y puede cargar cualquier json válido .
Ahora solo nos queda llamar a nuestro endpoint para subir los metadatos (en curl):
Y esta llamada devuelve el siguiente resultado:
Donde el campo IpfsHash contiene la URL de los metadatos en IPFS, PinSize contiene el tamaño total utilizado por los metadatos y una marca de tiempo con la hora de creación.
Y ahora solo nos falta acuñar el NFT.
Ahora que tenemos los metadatos subidos a IPFS, podemos crear nuestro primer NFT. Necesitaremos la dirección pública del contrato inteligente que implementamos al principio y la URL de los metadatos que obtuvimos en el punto anterior. Entonces, para acuñar llamaremos al siguiente endpoint: https://api.vottun.tech/nft/v3/vottun/mint y le proporcionaremos la información necesaria para acuñar el NFT;
NFT Mint
En destinatarioAddress pasaremos la dirección a la que vamos a acuñar el NFT, es decir, la dirección pública de la cuenta que será propietaria del token. En ipfsUri pasaremos la url recibida de la carga de metadatos a IPFS, en ipfsHash la última parte, que comienza con Qm en este caso, que es el CID de IPFS y el resto son bastante obvios, contractAddress contiene la dirección pública del contrato que Implementamos al principio de este artículo y en porcentaje de regalías le diremos al NFT que en caso de transferencia tenemos que pagar esta regalía al propietario del contrato inteligente (recuerde que según el estándar de regalías este pago es voluntario).
Esta acuñación devuelve un código de transacción en el siguiente resultado:
Esto se debe a que este tipo de transacciones se realizan de forma asincrónica. Para ver el estado de la transacción podemos llamar al endpoint https://api.vottun.tech/nft/v3/operation/5fa5825b-a1ed-4f7d-bc70-d52eb0b16dc9 . Esto devolverá información similar a la siguiente:
En el que lo más importante es el statusId , que devuelve un 4 (un 5 significa que ha habido un error y otro valor significa que el proceso no ha terminado), significa que todo ha ido bien y también el transactionHash , con el que podemos comprobar su estado en el explorador testnet de avalanchas: https://testnet.snowtrace.io/tx/0x1b8c5183a59fc86e9cdaccb7505424631ec4e20daa5660e79c8259a6612c60bc
En este artículo hemos aprendido cómo:
- Obtenga nuestras credenciales para utilizar las API de Vottun.
- Implemente un contrato inteligente compatible con ERC721 en la red Testnet de Avalanche (Fuji).
- Cree los metadatos para un NFT y cárguelos, junto con el activo digital, en el servidor IPFS de Vottun.
- Acuñando nuestro primer NFT en la red Avalanche.
En futuros artículos profundizaremos en otras transacciones que podemos realizar con las API y trabajaremos con otros estándares como ERC1155.