NFT'yi IPFS'te Barındırma

Chiliz Chain NFT projeleri için Pinata veya diğer IPFS sağlayıcılarını kullanarak NFT medya dosyalarını ve meta veri JSON'unu kalıcı, merkeziyetsiz tokenURI depolaması için IPFS'te barındırın.

Henüz bilmiyorsanız, bir NFT'ye sahip olmak NFT'nin dosyasının olduğu gibi blockchain'e yüklendiği anlamına gelmez. Aksine, bir NFT belirli bir token'ı içeren bir blockchain bloğuna karşılık gelir. Bu token, tokenURI adı verilen ve meta veri dosyasının çevrimiçi adresini içeren bir "işaretçi" veya bağlantı depolar; meta veri dosyası da başka bir URI kullanarak medya dosyasına referans verir.

Blockchain'in eşler arası yapısı nedeniyle NFT dosyanızı ve meta veri dosyasını herhangi bir web barındırma hizmetinde barındıramazsınız. tokenURI'niz, uygulamalar ve pazaryerleri arasında mümkün olduğunca uzun süre boyunca, belki sonsuza dek kalıcı (veya "değiştirilemez") ve taşınabilir olmalıdır.

İşte tam burada IPFS devreye giriyor.

IPFS Hakkında

IPFS, InterPlanetary File System (Gezegenlerarası Dosya Sistemi) anlamına gelir; dağıtılmış ağlarda veri barındırma ve paylaşma amacıyla hizmet veren merkeziyetsiz bir dosya ağıdır. NFT platformları, tek bir sunucuya güvenmek yerine IPFS'ten veri çekebilir; IPFS protokolü tüm barındırılan dosyaları sanki yerel dosyalarmış gibi hissettirme özelliğine sahiptir.

Şu an IPFS hakkında bilgi edinmem gerekiyor mu?

Bu, NFT'nizi basmak için seçtiğiniz yönteme bağlıdır:

• Vanilla kod kullanımı (viem veya ethers gibi): Evet, önceden geçerli bir tokenURI'ye (örneğin ipfs://.../metadata.json) ihtiyacınız var.

• thirdweb gibi bir pano aracılığıyla: Hayır. IPFS'e yükleme yerleşik olarak sunulur. Yine de NFT parametrelerinde mevcut bir ipfs://... adresiniz varsa yapıştırabilirsiniz.

• Çoğu Web3 SDK kullanımı (Rarible'ın Multichain SDK'sı gibi): Evet, bir URI beklerler. Bazı araçlar yükleme konusunda yardımcı olabilir, ancak çoğu olmaz.

IPFS web sitesinde NFT Depolama en iyi uygulamaları hakkında kapsamlı bir sayfa bulunmaktadır.

NFT Yükleme Ayrıntıları

NFT'nizi yüklerken, IPFS'in sizin için oluşturduğu İçerik Tanımlayıcısına (CID) iki yükleme yapmanız gerekir:

• İçeriğin kendisi; IPFS, barındırılan dosya için bir IPFS URL'si döndürür.

• Medya dosyasının CID'sine referans veren ve dosya için IPFS URL'sini içermesi gereken meta veri dosyası.

Her ikisi de aynı CID altında IPFS'e yüklenmelidir.

İdeal olarak araç setiniz bunu üstlenerek her şeyi manuel olarak yapma zorunluluğundan kurtarır.

Bilgi amaçlı olarak, minimal bir metadata.json dosyasının nasıl görüneceği aşağıda gösterilmiştir:

{ 
    "name": "Stadium Pass #25456456", 
    "description": "PSG supporter entry ticket", 
    "image": "ipfs:///filename.png",           // yalnızca statik görüntüler için!
    // "animation_url": "ipfs:///filename.mp4" // video ve ses dosyaları için.
    "attributes": [
    { 
        "trait_type": "Tier", 
        "value": "Gold" 
    }] 
}

NFT meta veri yapısı hakkında daha fazla bilgi edinmek için (örneğin görüntüler için neden image, videolar için animation_url kullanmanız gerektiği), OpenSea'nın şu belgesini okumanızı öneririz:

Metadata StandardsOpenSea Developer Documentation

Not: Meta veri dosyasını sıfırdan yazmanız gerekmiyor! Araç setiniz bunu sizin için oluşturabilmelidir.

Kendi IPFS node'unuzu çalıştırabilir veya ihtiyaçlarınız için yeterli olabilecek ücretsiz bir fiyatlandırma planı sunan Pinata gibi bir IPFS barındırma hizmetine ödeme yapabilirsiniz.

API kimlik bilgilerinizi (API anahtarı, API gizli anahtarı ve JWT token'dan oluşan) ve Özel Ağ Geçidi etki alanınızı (örneğin, blue-genetic-quail-122.mypinata.cloud) edinmek için Pinata'nın hızlı başlangıç kılavuzunu izleyin.

Bu belgeler IPFS hakkında her şeyi anlatmayı amaçlamadığından, konuya çevrimiçi aramalar aracılığıyla daha derin dalmanızı öneririz. Şu Pinata açıklamasıyla başlayabilirsiniz:

How does IPFS work with NFTs? - Pinata DocsPinata Docs

... veya thirdweb'den şu blog yazısıyla:

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