Host NFT trên IPFS

Host các tệp media NFT và metadata JSON trên IPFS để lưu trữ tokenURI vĩnh viễn, phi tập trung bằng Pinata hoặc các nhà cung cấp IPFS khác cho các dự án NFT trên Chiliz Chain.

Nếu bạn chưa biết, sở hữu một NFT không có nghĩa là tệp của NFT đó được tải lên blockchain nguyên vẹn. Thay vào đó, một NFT tương ứng với một khối blockchain chứa một token nhất định. Token này lưu trữ một "con trỏ" hoặc liên kết, gọi là tokenURI, chứa địa chỉ trực tuyến đến một tệp metadata, và tệp metadata đó lại tham chiếu đến tệp media bằng một URI khác.

Do tính chất ngang hàng của blockchain, bạn không thể chỉ đơn giản host tệp NFT và tệp metadata của mình trên bất kỳ dịch vụ web hosting nào. tokenURI của bạn cần phải ổn định (hay "bất biến") và có thể truy cập được trên các ứng dụng và marketplace khác nhau, càng lâu càng tốt, có thể là mãi mãi.

Đây là lúc IPFS xuất hiện.

Về IPFS

IPFS, viết tắt của InterPlanetary File System, là một mạng lưu trữ tệp phi tập trung phục vụ mục đích host và chia sẻ dữ liệu trên các mạng phân tán. Các nền tảng NFT có thể lấy dữ liệu từ IPFS thay vì phụ thuộc vào một máy chủ duy nhất, và giao thức IPFS tạo cảm giác như tất cả các tệp được host đều nằm trên máy cục bộ.

Tôi có cần tìm hiểu về IPFS ngay bây giờ không?

Điều đó phụ thuộc vào phương pháp bạn chọn để đúc NFT:

• Sử dụng code thuần (như viem hoặc ethers): Có, bạn cần một tokenURI hợp lệ (ví dụ: ipfs://.../metadata.json) từ trước.

• Thông qua dashboard như thirdweb: Không. Tính năng tải lên IPFS đã được tích hợp sẵn. Bạn vẫn có thể dán một ipfs://... có sẵn nếu bạn có trong các thông số NFT.

• Sử dụng hầu hết các Web3 SDK (như Rarible's Multichain SDK): Có, chúng sẽ yêu cầu một URI. Một số công cụ có thể hỗ trợ việc tải lên, nhưng không phải tất cả.

Trang web IPFS có một trang chi tiết về các phương pháp tốt nhất khi lưu trữ NFT.

Chi tiết về việc tải lên NFT

Khi tải lên NFT, bạn cần thực hiện hai lần tải lên với Content Identifier (CID) mà IPFS tạo ra cho bạn:

• Nội dung thực tế, trong đó IPFS trả về một URL IPFS cho tệp được host.

• Tệp metadata, tham chiếu đến CID của tệp media và phải chứa URL IPFS cho tệp đó.

Cả hai đều cần được tải lên IPFS dưới cùng một CID.

Lý tưởng nhất là bộ công cụ của bạn sẽ xử lý việc này để bạn không phải làm thủ công toàn bộ.

Để tham khảo, đây là ví dụ về một tệp metadata.json tối giản:

{ 
    "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" 
    }] 
}

Để tìm hiểu thêm về cấu trúc metadata NFT (ví dụ: tại sao bạn nên dùng image cho hình ảnh và animation_url cho video), chúng tôi khuyên bạn đọc tài liệu này từ OpenSea:

Metadata StandardsOpenSea Developer Documentation

Lưu ý: Bạn không cần phải tự viết tệp metadata từ đầu! Bộ công cụ của bạn sẽ có khả năng tạo tệp đó cho bạn.

Bạn có thể tự chạy node IPFS của mình, hoặc trả phí cho một dịch vụ host IPFS như Pinata, vốn cung cấp gói miễn phí có thể đáp ứng nhu cầu của bạn.

Hãy làm theo hướng dẫn bắt đầu nhanh của Pinata để lấy thông tin xác thực API (gồm API key, API secret và JWT token) cũng như tên miền Dedicated Gateway của bạn (ví dụ: blue-genetic-quail-122.mypinata.cloud).

Vì tài liệu này không nhằm mục đích mô tả mọi thứ về IPFS, chúng tôi khuyến khích bạn tìm hiểu sâu hơn qua các tìm kiếm trực tuyến. Bạn có thể bắt đầu với bài giải thích của Pinata:

How does IPFS work with NFTs? - Pinata DocsPinata Docs

... hoặc bài blog từ thirdweb:

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