Host NFT บน IPFS

โฮสต์ไฟล์มีเดียและ metadata JSON ของ NFT บน IPFS เพื่อการจัดเก็บ tokenURI แบบถาวรและกระจายศูนย์ โดยใช้ Pinata หรือผู้ให้บริการ IPFS อื่น ๆ สำหรับโปรเจกต์ NFT บน Chiliz Chain

หากคุณยังไม่ทราบ การมี NFT ไม่ได้หมายความว่าไฟล์ของ NFT จะถูกอัปโหลดโดยตรงลงบน blockchain แต่ NFT คือบล็อกบน blockchain ที่เก็บ token หนึ่งตัว ซึ่ง token นั้นจะเก็บ "ตัวชี้" หรือลิงก์ที่เรียกว่า tokenURI ซึ่งมีที่อยู่ออนไลน์ไปยังไฟล์ metadata และไฟล์ metadata นั้นจะอ้างอิงไปยังไฟล์มีเดียอีกทีผ่าน URI อีกรายการหนึ่ง

เนื่องจาก blockchain มีลักษณะแบบ peer-to-peer คุณจึงไม่สามารถโฮสต์ไฟล์ NFT และไฟล์ metadata บนบริการเว็บโฮสติ้งทั่วไปได้ tokenURI ของคุณจำเป็นต้องคงทน (หรือ "ไม่เปลี่ยนแปลง") และพกพาได้ข้ามแอปและมาร์เก็ตเพลสต่าง ๆ ให้นานที่สุดเท่าที่จะเป็นไปได้ ซึ่งอาจหมายถึงตลอดไป

นี่คือจุดที่ IPFS เข้ามามีบทบาท

เกี่ยวกับ IPFS

IPFS ย่อมาจาก InterPlanetary File System คือเครือข่ายไฟล์แบบกระจายศูนย์ที่ทำหน้าที่โฮสต์และแชร์ข้อมูลข้ามเครือข่ายที่กระจายตัว แพลตฟอร์ม NFT สามารถดึงข้อมูลจาก IPFS แทนที่จะพึ่งพาเซิร์ฟเวอร์เดียว และโปรโตคอล IPFS ทำให้รู้สึกเหมือนว่าไฟล์ที่โฮสต์ทั้งหมดอยู่ในเครื่องของคุณ

ฉันจำเป็นต้องเรียนรู้เกี่ยวกับ IPFS ตอนนี้เลยไหม?

ขึ้นอยู่กับวิธีที่คุณเลือกในการ mint NFT:

ใช้โค้ดโดยตรง (เช่น viem หรือ ethers): ใช่ คุณต้องมี tokenURI ที่ถูกต้อง (เช่น ipfs://.../metadata.json) ก่อน
ผ่านแดชบอร์ด เช่น thirdweb: ไม่จำเป็น การอัปโหลดไปยัง IPFS ถูกรวมไว้แล้ว คุณยังสามารถวาง ipfs://... ที่มีอยู่แล้วได้หากต้องการในพารามิเตอร์ NFT
ใช้ Web3 SDK ส่วนใหญ่ (เช่น Rarible's Multichain SDK): ใช่ SDK จะต้องการ URI เครื่องมือบางอย่างอาจช่วยในการอัปโหลดได้ แต่ไม่ใช่ทั้งหมด

เว็บไซต์ IPFS มี หน้าที่ครอบคลุมเกี่ยวกับแนวทางปฏิบัติที่ดีที่สุดในการจัดเก็บ NFT

รายละเอียดการอัปโหลด NFT

เมื่ออัปโหลด NFT ของคุณ คุณต้องอัปโหลดสองรายการไปยัง Content Identifier (CID) ที่ IPFS สร้างให้คุณ:

ตัวเนื้อหาเอง ซึ่ง IPFS จะส่งคืน URL ของ IPFS สำหรับไฟล์ที่โฮสต์
ไฟล์ metadata ที่อ้างอิง CID ของไฟล์มีเดีย และต้องมี URL ของ IPFS สำหรับไฟล์นั้น

ทั้งสองรายการต้องอัปโหลดบน IPFS ภายใต้ CID เดียวกัน

ตามหลักการแล้ว เครื่องมือที่คุณใช้ควรจัดการสิ่งนี้ให้ เพื่อที่คุณจะไม่ต้องทำด้วยตนเองทั้งหมด

เพื่อให้เข้าใจ นี่คือตัวอย่างของไฟล์ 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" 
    }] 
}

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับโครงสร้าง metadata ของ NFT (เช่น ทำไมควรใช้ image สำหรับรูปภาพและ animation_url สำหรับวิดีโอ) เราแนะนำให้อ่านเอกสารนี้จาก OpenSea:

Metadata StandardsOpenSea Developer Documentation

หมายเหตุ: คุณไม่จำเป็นต้องเขียนไฟล์ metadata ตั้งแต่ต้น! เครื่องมือที่คุณใช้ควรสามารถสร้างมันให้คุณได้

คุณสามารถ รัน IPFS node ของคุณเอง หรือจ่ายค่าบริการ IPFS เช่น Pinata ซึ่งมีแผนบริการฟรีที่อาจเพียงพอสำหรับความต้องการของคุณ

ทำตาม คู่มือเริ่มต้นใช้งานของ Pinata เพื่อรับข้อมูลรับรอง API (ประกอบด้วย API key, API secret และ JWT token) และโดเมน Dedicated Gateway ของคุณ (เช่น blue-genetic-quail-122.mypinata.cloud)

เนื่องจากเอกสารนี้ไม่ได้มีจุดประสงค์เพื่ออธิบายทุกอย่างเกี่ยวกับ IPFS เราจึงแนะนำให้คุณเจาะลึกในหัวข้อนี้ผ่านการค้นหาออนไลน์ คุณสามารถเริ่มต้นด้วยบทความอธิบายของ Pinata: