Token $VTN
Accés
Discord Telegram
  • Alex Lopez

Encunya el meu primer NFT ERC721 amb API Vottun

Crear una col·lecció de NFT des del punt de vista d’un desenvolupador s’ha tornat molt fàcil gràcies a les API de Vottun. En uns senzills passos, i en molt poc temps, podeu integrar les API amb el vostre programari i desenvolupar les vostres pròpies solucions DAPP.3.

Create your first NFT (1)

Comencem

Aquests són els passos a seguir per explotar el vostre primer NFT amb les API de Vottun:

  1. Obteniu les vostres credencials per poder utilitzar les API.
  2. Tingueu clares les característiques de la vostra col·lecció: actius digitals i metadades.
  3. Desplegueu el vostre contracte a la xarxa que trieu.
  4. Pengeu el vostre actiu digital a IPFS mitjançant les nostres API.
  5. Afegiu l’URL del vostre actiu digital a les vostres metadades i pengeu-lo també a IPFS.
  6. Encunya el teu NFT amb l’URL de l’actiu digital penjat a IPFS.

Com obtenir les meves credencials

Obtenir credencials és molt fàcil. Tens l’opció d’obtenir una prova de 30 dies a l’URL https://apis.vottun.tech/trial . Omple el formulari i rebràs un correu electrònic com el següent amb les teves credencials a punt per utilitzar.

A més de les credencials, també rebràs la clau pública d’una cartera que podràs utilitzar en les teves proves (per motius de seguretat, la clau privada sempre es manté als nostres servidors).

Un cop els rebeu, el seu ús és molt senzill, el token JWT s’ha d’utilitzar com a autenticació de portador i l’ID de l’aplicació s’ha d’afegir en una altra capçalera anomenada x-application-vkn i l’heu d’enviar en totes les trucades.

Trobareu més informació sobre les API a https://developers.vottun.tech.

Els meus NFT

Per crear un NFT, heu de tenir en compte 4 aspectes importants:

  1. El propi actiu digital s’ha de crear en un format digital que es pugui emmagatzemar a la cadena de blocs. Això pot incloure qualsevol cosa, des d’una obra d’art digital, un fitxer de música, un vídeo o fins i tot un tuit. L’actiu digital ha de ser d’alta qualitat i resolució per garantir el seu valor i conveniència.
  2. S’han d’afegir metadades a l’NFT per proporcionar informació sobre l’actiu i la seva propietat. Això inclou el títol, la descripció, la informació del creador i qualsevol detall rellevant, com ara els números d’edició o la raresa. Les metadades han de ser completes i precises per oferir transparència i confiança als compradors potencials.
  3. L’NFT s’ha d’emmagatzemar en una xarxa d’emmagatzematge descentralitzada com IPFS (Interplanetary File System). Això garanteix que l’actiu digital sigui accessible i que cap entitat centralitzada no pugui eliminar ni modificar-lo. L’ús d’IPFS també permet compartir i visualitzar l’NFT a diferents plataformes i mercats.
  4. Finalment, quan es crea un NFT per a la venda en un mercat, s’han d’omplir determinats camps perquè sigui visible i es pugui cercar. Aquests inclouen el títol, la descripció, la imatge, el nom de la col·lecció i la informació del creador. També es recomana incloure informació addicional com ara la data de creació, el número d’emissió i les etiquetes o paraules clau rellevants per augmentar la visibilitat i atraure compradors potencials.

Desplegueu el vostre contracte intel·ligent

Un cop ho tenim tot clar, és hora de començar a utilitzar les API de Vottun. El primer que farem és desplegar un contracte intel·ligent a la xarxa que escollim, per a aquest article, utilitzarem Avalanche. Recordeu que teniu tota la informació a https://developers.vottun.tech

El punt final per al desplegament és:

https://api.vottun.tech/nft/v3/erc721/deploy

És una trucada POST i, a més, cal afegir un JSON amb la informació necessària per al seu desplegament:

Com podeu veure, us informem del nom de l’Smart Contract (apareixerà com a nom de col·lecció als Marketplaces), el Símbol, que no és més que un nom en codi per al Token, la xarxa blockchain, en aquest cas l’Avalanche. Testnet i el límit de gas a utilitzar, hem posat 3000000 per aquest contracte.

La trucada completa llançada des de curl:

I un exemple per executar-se a NodeJS:

L’API retornarà el resultat següent:

Carregueu fitxers a IPFS

Utilitzant les API, primer penjarem el nostre actiu digital a IPFS, això retornarà una URL del nostre actiu a la xarxa. Per a això farem una trucada POST al punt final:

https://ipfsapi-v2.vottun.tech/ipfs/v2/file/upload

El seu tipus de contingut ha de ser multipart/form-data i inclourà dos camps:

  • Nom del fitxer: un nom per al fitxer
  • Fitxer: el mateix fitxer

L’API retornarà el resultat següent que conté l’URL IPFS a l’actiu:

La trucada completa llançada des de curl:

I des de NodeJS:

Un cop tenim l’URL de l’actiu, creem les nostres metadades i també les pengem a IPFS. En el nostre cas, hem creat aquestes metadades:

Els camps name , image , description i external_url són estàndard i s’utilitzen a tots els mercats. També podeu afegir el camp animation_url amb un gif animat o un vídeo que en alguns mercats s’utilitzarà per mostrar l’NFT a la vostra pàgina. Tot el contingut de dades és gratuït i podeu carregar qualsevol JSON vàlid.

Ara només hem de trucar al nostre punt final per carregar les metadades (a curl):

I aquesta crida retorna el resultat següent:

Quan el camp IpfsHash conté l’URL de les metadades a IPFS, PinSize conté la mida total utilitzada per les metadades i una marca de temps amb el moment de la creació.

I ara, només ens falta encunyar la NFT.

Ara que tenim les metadades penjades a IPFS, podem encunyar la nostra primera NFT. Necessitarem l’adreça pública del contracte intel·ligent que vam desplegar al principi i l’URL de les metadades que vam obtenir al punt anterior. Així doncs, per encunyar anomenarem el següent endpoint: https://api.vottun.tech/nft/v3/vottun/mint I proporcionarem la informació necessària per encunyar l’NFT;

NFT Mint

A recipient Address passarem l’adreça a la qual anem a encunyar l’NFT, és a dir, l’adreça pública del compte que serà el propietari del token. En ipfsUri passarem l’url rebuda de la càrrega de metadades a IPFS, en ipfsHash l’última part, que comença per Qm en aquest cas, que és el CID de l’IPFS i la resta són força evidents, contractAddress conté l’adreça pública del contracte que vam desplegar al principi d’aquest article i en royaltyPercentage direm a la NFT que en cas de transferència haurem de pagar aquesta regalia al propietari del contracte intel·ligent (recordeu que segons l’estàndard de royalties aquest pagament és voluntari).

Aquest encunyació retorna un codi de transacció amb el resultat següent:

Això es deu al fet que aquest tipus de transaccions es realitzen de manera asíncrona. Per veure l’estat de la transacció podem trucar al punt final https://api.vottun.tech/nft/v3/operation/5fa5825b-a1ed-4f7d-bc70-d52eb0b16dc9 Això retornarà informació similar 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’allau: https://testnet.snowtrace.io/tx/0x1b8c5183a59fc86e9cdaccb7505424631ec4e20daa5660e79c8259a6612c60bc

En aquest article hem après a:

  • Obteniu les nostres credencials per utilitzar les API de Vottun.
  • Desplegueu un Smart Contract compatible amb ERC721 a la xarxa Testnet d’Avalanche (Fuji).
  • Creeu les metadades per a una NFT i pengeu-les, juntament amb l’actiu digital, al servidor IPFS de Vottun.
  • Encunyar el nostre primer NFT a la xarxa Allaus.

En propers articles aprofundirem en altres transaccions que podem realitzar amb les API i treballarem amb altres estàndards com ERC1155.