NFTメタデータをIPFSにバックアップするにはどうすればよいですか? (分散ストレージ)

NFT メタデータとその脆弱性を理解する

1. NFT メタデータは通常、名前、説明、画像 URL、特性などの属性を含む JSON 形式でオフチェーンに存在します。

2. 初期の NFT プロジェクトの多くは、集中サーバーまたはクラウド プラットフォームでメタデータをホストしており、リンクの腐敗、検閲、またはサービスの停止にさらされていました。

3. 壊れた URI は、たとえトークン自体がオンチェーン上で有効なままであっても、NFT がウォレットまたはマーケットプレイスで空の資産として表示される可能性があることを意味します。

4. CloudflareのIPFSゲートウェイのようなサードパーティのゲートウェイのみに依存すると、アクセスを調整したり変更したりする可能性のある仲介者への依存が生じます。

5. イーサリアムのガスコストとサイズ制限のため、完全なメタデータのオンチェーンストレージはほとんど実現できないため、分散型オフチェーンストレージが不可欠になります。

IPFS アップロード用のメタデータの準備

1. ERC-721 または ERC-1155 メタデータ スキーマに従って JSON 構造を正規化し、 name 、 description 、 imageなどの必須フィールドが存在することを確認します。

2. imageまたはanime_urlフィールド内の絶対 HTTP URL を、後で CID を置換するための相対パスまたはプレースホルダーに置き換えます。

3. 関連するメディア ファイル (PNG、GIF、MP4) を JSON と同じローカル ディレクトリに保存し、 ipfs add -rなどのツールを使用して再帰的な固定を有効にします。

4. アップロード前に SHA-256 ハッシュを計算してファイルの整合性を検証します。アップロード後のハッシュの不一致は、破損または不完全な転送を示します。

5. 秘密キー、ウォレット アドレス、または API トークンをメタデータ ファイル内に埋め込むことは避けてください。たとえ IPFS に保存されていたとしても、それらは永続的に公開され、不変になります。

コマンドラインツールを使用した IPFS へのアップロード

1. ipfs-desktopまたはgo-ipfs CLI をインストールし、 ipfs initでローカル ノードを初期化し、 ipfs デーモン経由で起動します。

2. メタデータ フォルダーに移動し、 ipfs add -r ./nft-assets/を実行して、すべてのファイルを再帰的に追加し、ルート CID を生成します。

3. ipfs cidbase32を使用して、デフォルトの Base58 CID を Base32 形式に変換し、可読性を向上させ、転記エラーを減らします。

4. Pinata 、 NFT.Storage 、またはWeb3.Storageなどの永続サービスを使用してルート CID を固定し、ローカル ノードによるガベージ コレクションを防ぎます。

5. https://ipfs.io/ipfs/を開いて、レンダリングされたメタデータをクロスチェックします。ブラウザーの/metadata.json - すべてのネストされた参照が正しく解決されることを確認します。

IPFS URI を使用したスマート コントラクトの更新

1. アップグレード可能な NFT コントラクトの場合、 setBaseURI('ipfs://のような関数を呼び出します) /')すべてのトークン ID が共有プレフィックス パスを指すようにします。

2. トークンごとの URI を使用する場合は、JSON ファイルごとに個別の CID を構築し、それらをコントラクトのtokenURI()オーバーライド ロジックに直接保存します。

3. ゲートウェイ URL のハードコーディングを避ける (例: https://gateway.pinata.cloud/ipfs/) ) 契約内 - これらは集中化を導入し、プロバイダーがポリシーを変更すると機能しなくなる可能性があります。

4. 「トークン URI の表示」リンクをクリックして、戻り値がipfs://で始まり、その後に有効な CID が続くことを確認して、Etherscan または Polygonscan の解像度をテストします。

5. ipfs cid Inspectionを使用して最終的な URI 形式を監査するバージョン (v0/v1)、コーデック (dag-pb/dag-cbor)、およびマルチハッシュの整合性を検証します。

よくある質問

Q: IPFS にアップロードした後にメタデータを更新できますか? A: いいえ。IPFS コンテンツは設計上不変です。変更を反映するには、新しいファイルを生成し、再アップロードし、新しい CID を取得して、コントラクトの URI ポインタを更新する必要があります。

Q: メディア ライブラリ全体を IPFS に保存する必要がありますか、それとも JSON のみを保存する必要がありますか? A: 両方必要です。 JSON は、相対パスまたは埋め込み CID を使用してメディアを参照する必要があります。そうしないと、NFT には視覚的表現や機能資産が欠けてしまいます。

Q: アップロード中にローカル IPFS ノードがオフラインになった場合はどうなりますか? A: CLI 経由で開始されたアップロードは、最初にローカルで処理されます。 ipfs add中にipfs デーモンが実行されている限り、後でネットワークから切断されたとしても、ブロックはノードのデータストアに追加されます。

Q: IPFS 上のメタデータ ファイルのサイズ制限はありますか? A: プロトコル レベルの上限はありませんが、実際的な制限は存在します。多くの場合、ゲートウェイでは単一ファイルのアップロードが100 MBに制限され、ファイルが大きくなると、分散ノード全体での取得の遅延と固定コストが増加します。