- Imanol Hernando
Cómo utilizar la API Vottun NFT para implementar un contrato ERC1155
El estándar ERC1155 es una forma poderosa de crear NFT que es más eficiente y flexible que los tokens ERC721 tradicionales. Con ERC1155, puede crear múltiples tipos de NFT dentro de un solo contrato, lo que reduce los costos de gas y facilita la administración de sus tokens.
En este tutorial, le mostraremos cómo utilizar la API Vottun NFT para implementar un contrato ERC1155, crear nuevos tokens y transferirlos a diferentes direcciones. Le proporcionaremos instrucciones paso a paso y código de muestra para que le resulte más fácil comenzar.
Al final de este tutorial, tendrá una comprensión sólida de cómo utilizar la API Vottun NFT y el estándar ERC1155 para crear y administrar sus propios NFT.
Estos son los pasos que seguiremos para implementar un token ERC1155:
1- Consigue tus credenciales para poder utilizar las API.
2- Ten claro el número de tokens y la cantidad de cada uno de ellos que vas a desplegar.
3- Cargue sus activos digitales a IPFS utilizando nuestras API.
4- Agrega la URL de la carpeta de tus activos y los ID de los tokens que vas a acuñar en el despliegue del contrato.
Como obtener mis credenciales
Si aún no consigues tu token de prueba gratuito de 30 días puedes obtenerlo siguiendo los pasos descritos en el siguiente artículo .
Los NFT:
Para poder crear tus tokens es necesario considerar los mismos aspectos descritos en el artículo mencionado anteriormente pero debes tomar en consideración que como vas a trabajar con múltiples activos vas a administrar carpetas en IPFS.
Hagamos un ejemplo con las siguientes 3 imágenes:
Subir archivos a ipfs
Primero que nada tenemos que hacer un archivo ZIP con los activos digitales que vamos a subir a IPFS. Tenemos que cargarlo usando la siguiente API y esto creará un directorio en IPFS. La API devolverá su URL.
Su tipo de contenido debe ser multipart/form-data y es necesario agregar a la llamada el archivo ZIP creado recientemente:
- archivo: el archivo ZIP en sí
El punto final para cargar el archivo ZIP:
https://ipfsapi-v2.vottun.tech/ipfs/v2/upload/zip
La API devolverá el siguiente resultado que contiene la URL de IPFS a la carpeta donde están los activos:
La llamada completa lanzada desde curl:
Ahora tenemos la URL del directorio en IPFS. Se podrá acceder a los diferentes activos si agregamos el nombre del archivo a la URL . Para ejemplo :
- Activo 1: https://ipfsgw.vottun.tech/ipfs/QmaH7DdpFBuke93bJJNunK2HEXhay7ZTgp2WeSRhrZnEgd/1155-1.webp
- Activo 2: https://ipfsgw.vottun.tech/ipfs/QmaH7DdpFBuke93bJJNunK2HEXhay7ZTgp2WeSRhrZnEgd/1155-2.jpeg
- Activo 3: https://ipfsgw.vottun.tech/ipfs/QmaH7DdpFBuke93bJJNunK2HEXhay7ZTgp2WeSRhrZnEgd/1155-3.png
Con las URL de los tres activos con los que vamos a trabajar tenemos que crear los metadatos de cada activo. Los metadatos deben crearse siguiendo los mismos pasos descritos en el artículo ERC721 . El siguiente ejemplo son los metadatos de uno de los activos.
Una vez que tengamos los archivos de metadatos para cada archivo multimedia, debemos crear un archivo zip con ellos y usar la misma API del paso anterior para subirlo a IPFS.
La API devolverá el siguiente resultado que contiene la URL de IPFS a la carpeta que contiene los archivos de metadatos:
Implementar el contrato y los tokens Mint
Ahora estamos listos para acuñar nuestros tokens, pero primero debemos implementar nuestro contrato ERC1155. Con la API de Vottun es posible realizar un despliegue del contrato y la acuñación de los NFT en una única llamada a la API. Para este ejemplo vamos a utilizar la red Avalanche y recuerda que tienes toda la información https://developers.vottun.tech
El punto final de la implementación es:
https://api.vottun.tech/nft/v2/erc1155/deploy
Es una llamada POST y es necesario enviar el siguiente mensaje en formato JSON. vamos ver el parámetros uno por uno :
- Nombre: el nombre que aparecerá como nombre de la colección en los mercados
- BlockchainNetwork : el ID de red de la cadena de bloques de su elección
- GasLimit : El límite de gas a utilizar
- ID: los identificadores de los tokens que se van a acuñar
- Cantidades: la cantidad de cada token que se va a acuñar
- RoyaltyRecipient : la cuenta que va a recibir los derechos de cada venta.
- Alias: un alias a utilizar por el usuario.
La llamada completa lanzada desde curl:
La respuesta de la API debería ser la siguiente:
Es muy interesante ver en el explorador blockchain la transacción. Puedes ver tanto el despliegue del contrato como la acuñación de la cantidad de tokens que expresamos en la llamada API:
Transferir fichas
Con el contrato desplegado y los tokens acuñados es posible transferir uno o más tokens al monedero que queramos. En realidad , esta es una de las características más poderosas del ERC-1155. Veamos cómo transferir a diferentes tokens.
El punto final para la transferencia de tokens es:
https://api.vottun.tech/nft/v3/erc1155/transfer
Es una llamada POST y es necesario enviar el siguiente mensaje en formato JSON. vamos ver qué es cada parámetro :
- contractAddress : la dirección blockchain del contrato
- de: la dirección del propietario actual del token
- a: la dirección del destinatario
- ids: los id-s de los tokens que vamos a enviar
- cantidades: la cantidad de cada ficha
- red blockchain : la Identificación de red
La llamada completa lanzada desde curl:
Obtenemos la siguiente respuesta de la API. El id es un identificador de la operación que estamos realizando y podemos comprobar el estado de la misma con otra llamada API. No recibimos el resultado de la transferencia porque la operación se realiza de forma asincrónica.
Si utilizamos el siguiente endpoint podremos comprobar el estado de la operación:
https://api.vottun.tech/nft/v3/operation/9246ccba-942b-479c-a5b3-66c59280ec2b
Recibiremos una respuesta 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 de testnet de avalancha :
https://testnet.snowtrace.io/tx/0xc8388bfbc0e87f519c69ddad15f5ad3e8b063d7f52fe081bdc1cedb989c52c78
Conclusiones
En este artículo aprendemos:
- La diferencia entre ERC721 y ERC1155
- Cómo cargar un archivo zip con múltiples recursos multimedia y múltiples archivos de metadatos en IPFS
- Implemente y acuñe un contrato ERC-1155 y varios tokens con una única llamada API.
- Transfiere múltiples tokens.
- Consultar el estado de una operación.
En próximos artículos profundizaremos en las API de Vottun y diferentes estándares como los NFT de alquiler (ERC4907).