IPFS で NFT イメージをホストするにはどうすればよいですか? (ピニャータガイド)

IPFS と NFT ストレージにおけるその役割を理解する

1. IPFS は InterPlanetary File System の略で、Web をより高速、より安全、よりオープンにするために設計されたピアツーピア ハイパーメディア プロトコルです。

2. サーバー アドレスでファイルを検索する従来の HTTP とは異なり、IPFS は独自の暗号化ハッシュによってコンテンツを取得し、不変性と整合性を確保します。

3. イーサリアムのようなブロックチェーンネットワークは、コストとスケーラビリティの制約により、大きなバイナリファイルをチェーン上に直接保存しないため、NFTはメディア資産の外部ストレージに依存します。

4. IPFS にイメージ ファイルを保存すると、少なくとも 1 つのノードがコンテンツをピン留めしている限り、資産へのアクセスが保証され、集中的な障害点が回避されます。

5. IPFS によって生成されたコンテンツ識別子 (CID) は、NFT のメタデータ JSON ファイルに埋め込まれた正規参照となり、トークンをその視覚的表現にリンクします。

Pinata アカウントと API アクセスのセットアップ

1. pinata.cloud にアクセスし、電子メールまたは GitHub 認証を使用して無料アカウントにサインアップします。

2. プロファイル設定の下の「API キー」セクションに移動し、「ピン」権限が有効になっている新しいキーのセットを生成します。

3. JWT トークンと API キー ペアの両方をコピーします。これらの資格情報は、プログラムまたは CLI ツール経由で Pinata の REST API と対話するときに必要です。

4. Pinata は、誰でも認証なしで CID を解決できる https://gateway.pinata.cloud/ipfs/ などのパブリック ゲートウェイを提供し、分散アクセスを可能にします。

5. 無料枠ユーザーは、小規模な NFT コレクションの起動やワークフローのテストに十分な、毎月 1 GB の固定ストレージと制限付き API 呼び出しを受け取ります。

Pinata Web インターフェイスを使用した NFT イメージのアップロード

1. Pinata ダッシュボードにログインし、上部のナビゲーション バーから [Pin File] をクリックします。

2. 個々の画像ファイル、または複数のアセットを含む ZIP アーカイブをアップロード領域にドラッグ アンド ドロップします。

3. アップロードが完了すると、Pinata には CID、ファイル名、サイズ、タイムスタンプが表示されます。また、ファイルが Pinata のインフラストラクチャに固定されているかどうかも表示されます。

4. アップロードされたアイテムの横にある 3 点メニューをクリックして、その CID をコピーするか、共有可能なゲートウェイ URL を生成します。

5. バッチ処理の場合、後でメタデータの生成を簡素化するために、アップロードする前に一貫した命名規則で画像を整理します。

Pinata SDK および CLI ツールを使用したアップロードの自動化

1. npm 経由で公式 Pinata SDK をインストールします: npm install @pinata/sdk 。

2. API キーとシークレットを使用して Node.js スクリプトでクライアントを初期化し、読み取り可能なストリームまたはバッファーを使用してpinFileToIPFS()を呼び出します。

3. pinata-cliパッケージを使用してターミナルからアップロードします: pinata pin add ./images/ 。再帰的なディレクトリのアップロードをサポートします。

4. アップロード ロジックをミント スクリプトに統合して、ブロックチェーンにメタデータを書き込む直前に各画像が CID を受け取るようにします。

5. 返された CID を、対応するトークン ID とともにローカル JSON ファイルまたはデータベースに保存して、コントラクト展開中の追跡可能性を維持します。

よくある質問

Q: IPFS に固定されたイメージを更新できますか? A: いいえ。IPFS コンテンツは設計上不変です。画像を変更するには、画像を再アップロードして新しい CID を取得し、それに応じて NFT のメタデータを更新する必要があります。

Q: Pinata がオフラインになったらどうなりますか? A: ファイルは、キャッシュまたは固定されている他の IPFS ノードを通じて引き続き利用できます。 Cloudflare-ipfs.com や dweb.link などのパブリック ゲートウェイも、同じ CID を独立して提供します。

Q: ミントを作成するたびに、NFT 画像を再度ピン留めする必要がありますか? A: 必ずしもそうとは限りません。すべての NFT が同じ画像を参照している場合、またはバリエーションがオフチェーンで処理されるテンプレートベースの構造を使用している場合は、1 回のアップロードで十分です。

Q: 私の画像がまだ固定されていることを確認する方法はありますか? A: はい。 Pinata のpinListエンドポイントを使用するか、 curl 'https://api.pinata.cloud/data/pinList?ipfsPinHash= CID_HERE ' -H 'Authorization: Bearer YOUR_JWT'を介してステータスを確認します。