NFT を IPFS でホスティングする

Pinataなどの IPFS プロバイダーを使用して NFT のメディアファイルとメタデータ JSON を IPFS にホスティングし、Chiliz Chain の NFT プロジェクト向けに永続的で分散化された tokenURI ストレージを実現します。

まだご存じない方のために説明すると、NFT を保有しているということは、その NFT のファイルそのものがブロックチェーン上にアップロードされていることを意味しません。むしろ、NFT は特定のトークンを含むブロックチェーンのブロックに対応します。このトークンには tokenURI と呼ばれる「ポインター」つまりリンクが格納されており、これにはメタデータファイルのオンラインアドレスが含まれます。そのメタデータファイル自体が、さらに別の URI を使ってメディアファイルを参照します。

ブロックチェーンはピアツーピアの性質を持つため、NFT ファイルとそのメタデータファイルを任意の Web ホスティングサービスに置くことはできません。あなたの tokenURI は、できる限り長く、できれば永久に、永続的（つまり「不変」）であり、アプリやマーケットプレイス間で移植可能である必要があります。

ここで IPFS が登場します。

IPFS について

IPFS（InterPlanetary File System）は、分散ネットワーク全体でデータをホスティングおよび共有することを目的とした分散型ファイルネットワークです。NFT プラットフォームは単一のサーバーに依存する代わりに IPFS からデータを取得でき、IPFS プロトコルによって、ホスティングされているすべてのファイルがローカルにあるかのように「感じられる」ようになります。

今すぐ IPFS について学ぶ必要がありますか？

それは NFT をミントするために選択した方法によります。

素のコードを使う場合（viem や ethers など）：はい、あらかじめ有効な tokenURI（例： ipfs://.../metadata.json）が必要です。
thirdweb などのダッシュボードを使う場合： いいえ。IPFS へのアップロードは組み込まれています。既存の ipfs://... をお持ちの場合は、NFT のパラメーターに貼り付けることもできます。
ほとんどの Web3 SDK を使う場合（Rarible の Multichain SDK など）：はい、URI が期待されます。一部のツールはアップロードを支援してくれるかもしれませんが、ほとんどはそうではありません。

IPFS のウェブサイトには、NFT のストレージに関するベストプラクティスを詳しく解説したページがあります。

NFT アップロードの詳細

NFT をアップロードする際には、IPFS が生成してくれる Content Identifier（CID）に対して 2 つのアップロードを実行する必要があります。

コンテンツそのもの。これに対して IPFS はホスティングされたファイルの IPFS URL を返します。
メタデータファイル。これはメディアファイルの CID を参照し、そのファイルの IPFS URL を含んでいる必要があります。

どちらも同じ CID の下で IPFS にアップロードされます。

理想的には、これらすべてを手動で行わなくて済むように、ツールセットがこれを引き受けてくれます。

参考までに、最小限の 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" 
    }] 
}