Hosting NFT na IPFS

Hostuj pliki multimedialne NFT oraz metadane JSON na IPFS, aby uzyskać trwałe, zdecentralizowane przechowywanie tokenURI przy użyciu Pinata lub innych dostawców IPFS dla projektów NFT na Chiliz Chain.

Jeśli jeszcze tego nie wiesz, posiadanie NFT nie oznacza, że plik NFT jest przesyłany w niezmienionej postaci na blockchain. Zamiast tego NFT odpowiada blokowi blockchain, który zawiera określony token. Token ten przechowuje "wskaźnik" lub link, zwany tokenURI, który zawiera adres online do pliku metadanych, a ten z kolei odwołuje się do pliku multimedialnego za pomocą kolejnego URI.

Ze względu na peer-to-peerową naturę blockchainu nie możesz po prostu hostować pliku NFT i jego pliku metadanych na dowolnym serwisie hostingowym. Twój tokenURI musi pozostać trwały (lub "niezmienny") i przenośny pomiędzy aplikacjami a marketplace'ami, tak długo jak to możliwe, najlepiej na zawsze.

W tym miejscu na scenę wkracza IPFS.

O IPFS

IPFS, czyli InterPlanetary File System, to zdecentralizowana sieć plików, która służy do hostowania i udostępniania danych w rozproszonych sieciach. Platformy NFT mogą pobierać dane z IPFS zamiast polegać na pojedynczym serwerze, a protokół IPFS sprawia, że wszystkie hostowane pliki "wydają się" lokalne.

Czy muszę uczyć się o IPFS już teraz?

To zależy od wybranej metody mintowania Twojego NFT:

• Przy użyciu czystego kodu (takiego jak viem lub ethers): Tak, wcześniej potrzebujesz prawidłowego tokenURI (np. ipfs://.../metadata.json).

• Za pośrednictwem dashboardu takiego jak thirdweb: Nie. Przesyłanie do IPFS jest wbudowane. Wciąż możesz wkleić istniejący ipfs://..., jeśli masz go w parametrach NFT.

• Przy użyciu większości SDK Web3 (takich jak Multichain SDK od Rarible): Tak, będą oczekiwać URI. Niektóre narzędzia mogą pomóc w przesyłaniu, ale nie większość.

Strona IPFS posiada obszerną stronę o najlepszych praktykach przechowywania NFT.

Szczegóły przesyłania NFT

Przesyłając swoje NFT, musisz wykonać dwa przesłania do Content Identifier (CID), który IPFS dla Ciebie generuje:

• Sama zawartość, dla której IPFS zwraca adres URL IPFS hostowanego pliku.

• Plik metadanych, który odwołuje się do CID pliku multimedialnego i musi zawierać adres URL IPFS tego pliku.

Oba mają zostać przesłane na IPFS pod tym samym CID.

W idealnym przypadku Twój zestaw narzędzi bierze to na siebie, dzięki czemu nie musisz robić tego wszystkiego ręcznie.

Dla celów informacyjnych, tak wyglądałby minimalny plik metadata.json:

{ 
    "name": "Stadium Pass #25456456", 
    "description": "PSG supporter entry ticket", 
    "image": "ipfs:///filename.png",           // for static images only!
    // "animation_url": "ipfs:///filename.mp4" // for video and audio files.
    "attributes": [
    { 
        "trait_type": "Tier", 
        "value": "Gold" 
    }] 
}

Aby dowiedzieć się więcej o strukturze metadanych NFT (na przykład dlaczego powinieneś używać image dla obrazów i animation_url dla filmów), zalecamy zapoznanie się z tym dokumentem od OpenSea:

Metadata StandardsOpenSea Developer Documentation

Uwaga: Nie powinieneś pisać pliku metadanych od zera! Twój zestaw narzędzi powinien być w stanie wygenerować go za Ciebie.

Możesz albo uruchomić własny node IPFS, albo zapłacić za hosting IPFS, taki jak Pinata, który oferuje darmowy plan cenowy, który może wystarczyć do Twoich potrzeb.

Postępuj zgodnie z przewodnikiem szybkiego startu Pinata, aby uzyskać swoje dane uwierzytelniające API (składające się z klucza API, sekretu API oraz tokena JWT) oraz domenę swojego Dedicated Gateway (na przykład blue-genetic-quail-122.mypinata.cloud).

Ponieważ ta dokumentacja nie ma na celu opisania wszystkiego na temat IPFS, zalecamy zagłębienie się w ten temat poprzez wyszukiwania online. Możesz zacząć od tego objaśnienia od Pinata:

How does IPFS work with NFTs? - Pinata DocsPinata Docs

... lub od tego wpisu na blogu od thirdweb:

What Is IPFS and How Does it Store NFT Metadata?thirdweb