- Imanol Hernando
Com utilitzar l' API Vottun NFT per desplegar un contracte ERC1155
L’estàndard ERC1155 és una manera potent de crear NFT que és més eficient i flexible que els testimonis ERC721 tradicionals. Amb ERC1155, podeu crear diversos tipus de NFT dins d’un sol contracte, reduint els costos del gas i facilitant la gestió dels vostres tokens.
En aquest tutorial, us mostrarem com utilitzar l’ API Vottun NFT per implementar un contracte ERC1155, crear nous testimonis i transferir-los a diferents adreces. T’oferirem instruccions pas a pas i codi de mostra per facilitar-te l’inici.
Al final d’aquest tutorial, tindreu una comprensió sòlida de com utilitzar l’ API Vottun NFT i l’estàndard ERC1155 per crear i gestionar els vostres propis NFT.
Aquests són els passos que seguirem per desplegar un testimoni ERC1155:
1- Aconsegueix les teves credencials per poder utilitzar les API.
2- Tingueu clar el nombre de fitxes i la quantitat de cadascun d’ells que voleu desplegar.
3- Carregueu els vostres actius digitals a IPFS mitjançant les nostres API.
4- Afegiu l’ url de la carpeta dels vostres actius i el token id-s que aneu a encunyar en el desplegament del contracte.
Com obtenir les meves credencials
Si encara no obteniu el vostre testimoni de prova gratuït de 30 dies, podeu obtenir-lo seguint els passos que es descriuen a l’ article següent .
Els NFT:
Per crear els vostres tokens cal tenir en compte els mateixos aspectes descrits a l’ article esmentat anteriorment , però heu de tenir en compte que a mesura que treballareu amb diversos actius gestionareu les carpetes a IPFS.
Fem un exemple amb les 3 imatges següents:
Carrega fitxers a Ipfs
Primer de tot hem de fer un fitxer ZIP amb els actius digitals que penjarem a IPFS. L’ hem de pujar mitjançant la següent API i això crearà un directori a IPFS. L’API retornarà l’URL.
El seu tipus de contingut ha de ser multipart/form-data i cal afegir el fitxer ZIP creat recentment a la trucada:
- fitxer: el mateix fitxer ZIP
El punt final per carregar el fitxer ZIP:
https://ipfsapi-v2.vottun.tech/ipfs/v2/upload/zip
L’API retornarà el resultat següent que conté l’ URL IPFS a la carpeta on hi ha els actius:
La trucada completa llançada des de curl:
Ara, tenim l’ URL del directori a IPFS. Els diferents actius seran accessibles si afegim el nom del fitxer a l’ url . Per exemple :
- Recurs 1: https://ipfsgw.vottun.tech/ipfs/QmaH7DdpFBuke93bJJNunK2HEXhay7ZTgp2WeSRhrZnEgd/1155-1.webp
- Recurs 2: https://ipfsgw.vottun.tech/ipfs/QmaH7DdpFBuke93bJJNunK2HEXhay7ZTgp2WeSRhrZnEgd/1155-2.jpeg
- Recurs 3: https://ipfsgw.vottun.tech/ipfs/QmaH7DdpFBuke93bJJNunK2HEXhay7ZTgp2WeSRhrZnEgd/1155-3.png
Amb les URL dels tres actius amb els quals treballarem, hem de crear les metadades per a cada actiu. Les metadades s’han de crear seguint els mateixos passos que es descriuen a l’ article ERC721 . L’exemple següent són les metadades d’un dels actius.
Un cop tinguem els fitxers de metadades de cada fitxer multimèdia, hem de crear un fitxer zip amb ells i utilitzar la mateixa API del pas anterior per pujar-lo a IPFS.
L’API retornarà el resultat següent que conté l’ URL IPFS a la carpeta que conté els fitxers de metadades:
Desplega el contracte i fitxes de menta
Ara estem preparats per encunyar les nostres fitxes, però primer hem de desplegar el nostre contracte ERC1155. Amb l’ API Vottun és possible fer un desplegament del contracte i l’encunyació de les NFT en una única trucada API. Per a aquest exemple farem servir la xarxa Avalanche i recordeu que teniu tota la informació https://developers.vottun.tech
El punt final per al desplegament és:
https://api.vottun.tech/nft/v2/erc1155/deploy
És una trucada POST i cal enviar el següent missatge en format JSON. Anem veure el paràmetres un per un :
- Nom: el nom que apareixerà com a nom de la col·lecció als mercats
- BlockchainNetwork : l’identificador de xarxa de la cadena de blocs que trieu
- GasLimit : el límit de gas a utilitzar
- IDs: els identificadors de fitxes de les fitxes que s’encunyaran
- Quantitats: la quantitat de cada fitxa que s’encunyarà
- RoyaltyRecipient : el compte que rebrà la regalia de cada venda.
- Àlies: un àlies a utilitzar per l’usuari.
La trucada completa llançada des de curl:
La resposta de l’API hauria de ser la següent:
És molt interessant veure a l’explorador blockchain la transacció. Podeu veure tant el desplegament del contracte com l’encunyació de la quantitat de fitxes que expressem a la trucada de l’API:
Transferència de fitxes
Amb el contracte desplegat i les fitxes encunyades, és possible transferir una o més fitxes a la cartera que volem. De fet, aquesta és una de les característiques més potents de l’ERC-1155. Vegem com transferir a diferents fitxes.
El punt final per a les fitxes de transferència és:
https://api.vottun.tech/nft/v3/erc1155/transfer
És una trucada POST i cal enviar el següent missatge en format JSON. Anem veure què és cadascun paràmetre :
- contractAddress : l’adreça blockchain del contracte
- de: l’adreça del propietari actual del testimoni
- a: l’adreça del receptor
- ids: els identificadors de les fitxes que enviarem
- quantitats: la quantitat de cada testimoni
- blockchainNetwork : la identificador de xarxa
La trucada completa llançada des de curl:
Obtenim la següent resposta de l’API. L’identificador és un identificador de l’operació que estem realitzant i podem comprovar-ne l’estat amb una altra crida a l’API. No rebem el resultat de la transferència perquè l’operació es fa de manera asíncrona.
Si fem servir el següent endpoint podrem comprovar l’estat de l’operació:
https://api.vottun.tech/nft/v3/operation/9246ccba-942b-479c-a5b3-66c59280ec2b
Rebrem una resposta semblant a la següent:
En el qual el més important és l’ statusId , que retorna un 4 (un 5 significa que hi ha hagut un error i un altre valor significa que el procés no ha acabat), vol dir que tot ha anat bé i també la transactionHash , amb la qual podem comprovar el seu estat a l’ explorador de testnet d’allaus :
https://testnet.snowtrace.io/tx/0xc8388bfbc0e87f519c69ddad15f5ad3e8b063d7f52fe081bdc1cedb989c52c78
Conclusions
En aquest article aprenem:
- La diferència entre l’ERC721 i l’ERC1155
- Com pujar un fitxer zip amb diversos recursos multimèdia i diversos fitxers de metadades a IPFS
- Desplegueu i engegueu un contracte ERC-1155 i diversos testimonis amb una única trucada d’API.
- Transfereix múltiples fitxes.
- Comprovar l’estat d’una operació.
En propers articles aprofundirem en les API de Vottun i en diferents estàndards, com ara els NFT de lloguer (ERC4907).