メタデータURI

メタデータURIとは？

メタデータURIとは、暗号資産、特にNFTのメタデータファイルを指すリンクです。

簡単に言えば、トークンに関する情報の保存場所をウォレット、マーケットプレイス、ゲーム、アプリに知らせるものです。

情報には、トークン名、説明、画像、アニメーション、3Dモデル、属性、外部URL、希少性を示す特性、その他の表示データが含まれる場合があります。

NFTでは、アートワークや説明データのすべてがトークン自体にオンチェーンで保存されているとは限らないため、メタデータURIが重要です。

その代わり、スマートコントラクトがJSON形式のメタデータファイルを指すURIを保存または返します。

ERC-721 NFT標準には、特定のNFTのURIを返すtokenURI関数を含む、任意のメタデータ拡張が定義されています。

このURIにより、アプリはNFTに何を表示し、どのように説明すべきかを把握できます。

メタデータURIが正常に機能しなくても、NFT自体はオンチェーンに存在し続ける場合があります。しかし、ウォレットやマーケットプレイスが画像、名前、特性を正しく表示できなくなる可能性があります。

メタデータURIの仕組み

メタデータURIは、ブロックチェーン上のトークンIDをオフチェーンまたはオンチェーンのメタデータに結び付けます。

ユーザーがウォレットやマーケットプレイスでNFTを開くと、通常、アプリはスマートコントラクトにトークンのURIを問い合わせます。

次に、アプリはそのURIからメタデータファイルを取得します。

メタデータファイルは、構造化データによく使われるJSON形式で記述されるのが一般的です。

たとえば、JSONファイルにはname、description、image、animation_url、attributesなどのフィールドが含まれる場合があります。

ウォレットやマーケットプレイスはそれらのフィールドを読み取り、NFTをユーザーに表示します。

この仕組みにより、大容量のメディアファイルをスマートコントラクト内に直接保存する必要がなくなり、NFTを利用しやすくなります。

一方で、リンク先のメタデータが引き続き利用可能で、変更されないかどうかに表示が左右されるため、リスクも生じます。

メタデータURIとToken URIの違い

メタデータURIとToken URIは、密接に関連する用語です。

Token URIは通常、特定のトークンのメタデータの場所を返すスマートコントラクトの関数または値を指します。

メタデータURIは、メタデータを取得できる実際のリンクまたはパスを指します。

NFTに関する議論では、これらの用語がほぼ同じ意味で使われることも多くあります。

ERC-721 NFTでは、tokenURIがトークンIDのメタデータURIを返す一般的な関数名です。

ERC-1155トークンのURIモデルでは、トークンIDをURIパスに挿入するID置換に対応できます。

ERC-1155マルチトークン標準では、メタデータURIのJSONスキーマが定義され、クライアントが{ id }文字列を実際のトークンIDに置き換える方法が説明されています。

NFTのメタデータにはどのような情報が保存される？

NFTのメタデータには通常、アプリが資産を表示するために必要な説明情報が保存されます。

一般的なフィールドは、name、description、image、external_url、animation_url、attributesです。

imageフィールドは、PNG、JPEG、GIF、SVG、その他の対応メディアファイルを指す場合があります。

animation_urlフィールドは、動画、音声ファイル、HTMLコンテンツ、3Dモデル、インタラクティブなメディアファイルを指す場合があります。

attributesフィールドには、背景、衣服、希少度、アイテムの種類、キャラクタークラス、ゲーム内ステータスなどの特性が保存されることがよくあります。

こうした特性は、NFTコレクション、ブロックチェーンゲーム、アバタープロジェクト、仮想土地、メタバース資産で特に重要です。

プラットフォームやトークン標準によっては、技術情報やプロジェクト固有のフィールドがメタデータに含まれることもあります。

適切なメタデータは明確かつ正確で、ユーザーが受け取ると期待する資産と一致している必要があります。

一般的なメタデータURIの形式

一般的なメタデータURIの形式には、HTTPSリンク、IPFSリンク、Arweaveリンク、オンチェーンデータURIがあります。

HTTPSメタデータURIは、通常のWebサーバーを指します。

使いやすい形式ですが、サーバーが停止したり、ファイルが変更または削除されたりするリスクがあります。

IPFSメタデータURIは、InterPlanetary File Systemを通じて保存されたコンテンツを指します。

IPFSのコンテンツアドレス指定に関するドキュメントでは、IPFSがコンテンツ自体に基づいてコンテンツを識別するContent Identifier（CID）を使用すると説明されています。

コンテンツアドレス指定を使うリンクでは、取得したファイルが想定したコンテンツと一致するかを確認しやすくなります。

ArweaveメタデータURIは、恒久的な分散型ストレージを目指して設計されたArweaveに保存されたデータを指します。

Arweaveの公式サイトでは、データを恒久的に保存し、ノードにデータの維持を促すパーミッションレスのハードドライブとして説明されています。

オンチェーンデータURIは、メタデータをスマートコントラクトに直接保存するか、ブロックチェーンからエンコード済みのメタデータを返します。

オンチェーンメタデータは長期保存に強い一方、コストが高く、技術的な制約を受ける場合があります。

NFTにとってメタデータURIが重要な理由

メタデータURIは、NFTの見え方や、ユーザーが保有する資産を理解する方法に影響するため重要です。

NFTにはオンチェーンのトークンIDと所有者アドレスがあっても、資産の識別情報や外観を説明するのはメタデータです。

メタデータURIが機能しなくなると、NFTの画像や特性が表示されなかったり、誤った情報が表示されたりする可能性があります。

プロジェクトチームがメタデータURIを変更できる場合、NFTに後から別のコンテンツが表示される可能性があります。

そのため、経験豊富なコレクターや暗号資産ユーザーは、メタデータが凍結されているか、分散化されているか、完全にオンチェーンにあるかをよく確認します。

メタデータの品質は、信頼性、市場価値、ゲーム内での有用性、メタバースとの互換性、長期保存に影響する場合があります。

暗号資産プロジェクトにとって、メタデータ設計は単なる技術的な詳細ではありません。

資産の信頼性とユーザー体験を支える要素の一つです。

中央集権型メタデータURI

中央集権型メタデータURIは通常、一般的なWebサーバーやクラウドサービス上のファイルを指します。

この形式は開発者にとってシンプルで高速です。

また、誤りの修正やミント後のアセット公開が必要な場合に、チームがメタデータを簡単に更新できます。

ただし、中央集権型メタデータには信頼に関するリスクがあります。

サーバーが停止すると、ウォレットの画面でNFTの画像や特性が表示されなくなる可能性があります。

プロジェクトチームがファイルを変更すると、ユーザーの想定とは異なるメタデータがNFTに表示される場合があります。

ドメインの有効期限が切れたり、第三者に乗っ取られたりすると、リンク切れや悪意あるコンテンツが表示される可能性があります。

プロジェクトによっては中央集権型メタデータも適切ですが、ユーザーはそのトレードオフを理解しておく必要があります。

分散型メタデータURI

分散型メタデータURIは通常、IPFSやArweaveなどのシステムを通じて保存されたコンテンツを指します。

これにより、データの耐久性を高め、単一企業のサーバーへの依存を減らせる可能性があります。

IPFSでは、ipfs://に続いてCIDが記載されたリンクがよく使われます。

Arweaveでは、保存データを指すトランザクションベースのリンクがよく使われます。

分散型ストレージが自動的に完璧な仕組みになるわけではありません。

IPFSコンテンツを取得しやすい状態で維持するには、ノードによるピン留めまたはホスティングが必要です。

Arweaveは恒久的な保存を目指していますが、正しいファイルがアップロードされ、リンクされているかを確認する必要があります。

優れたNFTプロジェクトは通常、メタデータの保存方法を透明にし、ユーザーが簡単に確認できるようにしています。

オンチェーンメタデータURI

オンチェーンメタデータとは、ブロックチェーンに直接保存されるか、スマートコントラクトによって生成されるメタデータです。

この方法では、外部サーバーやストレージネットワークへの依存を減らせます。

最大限の耐久性や完全なオンチェーンアートを目指すプロジェクトでよく使われます。

オンチェーンメタデータでは、tokenURIの応答にエンコード済みのJSONを直接含められるデータURIを使う場合があります。

別のWebサイトからメタデータを取得する必要がなくなるため、NFTをより自己完結型にできます。

主な制約はコストです。

大きな画像、アニメーション、3Dファイルをオンチェーンに直接保存するのは、高コストまたは非現実的な場合があります。

そのため、多くのプロジェクトは小さなメタデータをオンチェーンに保存し、大容量のメディアファイルは別の場所に保存します。

ベースURI

ベースURIとは、同じスマートコントラクト内の複数のトークンで共通して使われる開始パスです。

各トークンの完全なメタデータリンクを個別に保存する代わりに、コントラクトがベースパスとトークンIDを組み合わせる場合があります。

たとえば、プロジェクトはベースパスの末尾にトークン番号を追加して、各メタデータファイルを特定できます。

この設計により、スマートコントラクトのストレージコストを削減し、大規模なNFTコレクションを管理しやすくできます。

ただし、コントラクトの所有者が後からベースパスを変更できる場合、ベースURIの設計はアップグレードに伴うリスクにもなります。

ベースパスが変わると、多数のトークンのメタデータが同時に変わる可能性があります。

ユーザーは、ベースURIが固定されているか、アップグレード可能か、管理者ウォレットによって管理されているかを確認してください。

メタデータの凍結

メタデータの凍結とは、通常の管理操作では変更できないよう、プロジェクトがメタデータをロックした状態を指します。

表示される資産が後から変更されないという信頼性を高めるため、NFTコレクターにとって重要です。

メタデータを凍結しても、ファイルが常に完全に恒久保存されるとは限りません。

通常は、スマートコントラクトまたはプラットフォームが、プロジェクトチームによるメタデータリンクの更新を許可しなくなったことを意味します。

実際の耐久性は、メタデータやメディアファイルの保存場所にも左右されます。

たとえば、IPFSやArweaveを指す凍結済みメタデータは、脆弱な中央集権型サーバーを指す凍結済みメタデータより堅牢な場合があります。

メタデータURIとNFTのリビール

多くのNFTコレクションでは、リビールイベント時にメタデータURIを使用します。

リビール前は、すべてのトークンがプレースホルダー画像や非公開のメタデータファイルを指している場合があります。

リビール後、プロジェクトはベースURIまたはメタデータファイルを更新し、各トークンに最終的なアートワークや特性を表示します。

これは一般的な手順ですが、信頼が必要です。

ユーザーは、リビールが公平に行われ、チームが希少な特性を操作しないと信頼する必要があります。

優れたプロジェクトはリビール方法を明確に説明し、可能であれば透明性のあるランダム性や公開検証を採用します。

リビール後は、メタデータが凍結されるか、耐久性のある方法で保存されることをユーザーが望む場合がよくあります。

ブロックチェーンゲームにおけるメタデータURI

ブロックチェーンゲームでは、ゲーム内資産が特性、レベル、装備、ステータス、アップグレード履歴などを持つことが多いため、メタデータURIが重要です。

剣のNFTには、攻撃力、希少度、耐久性、属性、画像データが含まれる場合があります。

キャラクターNFTには、クラス、レベル、スキル、衣服、アニメーションデータが含まれる場合があります。

ゲームのメタデータには、固定されたものと動的に変化するものがあります。

プレイヤーがアイテムをアップグレードしたり、クエストを完了したり、新しい形態を解放したりすると、動的メタデータが変わる場合があります。

これにより資産のインタラクティブ性が高まりますが、ゲームの更新ルールへの信頼も必要です。

メタデータを変更できる主体と、変更がスマートコントラクト、ゲームサーバー、プロジェクト管理者のいずれによって制御されるかを理解しておく必要があります。

メタバースにおけるメタデータURI

メタバースでは、メタデータURIが仮想資産の外観や機能を定義する場合があります。

仮想土地NFTのメタデータには、所在地、区画サイズ、座標、プレビュー画像、ワールドデータが記載される場合があります。

ウェアラブルNFTのメタデータは、3Dモデル、テクスチャファイル、アニメーションファイル、互換性情報を指す場合があります。

イベントパスNFTのメタデータには、入場権、日付、バッジの種類、関連特典が記載される場合があります。

アプリが正しいデジタルオブジェクトを読み込めるかどうかでユーザー体験が決まるため、メタバース資産には信頼性の高いメタデータが必要です。

メタデータが欠けていたり、構造が不適切だったりすると、ウォレット、ゲーム、仮想世界で資産が正しく表示されない可能性があります。

メタデータURIのセキュリティリスク

1つ目のリスクは、メタデータのリンク切れです。

URIが存在しないファイルを指していると、NFTが正しく表示されない場合があります。

2つ目のリスクは、メタデータの変更です。

プロジェクトがURIやファイルの内容を変更できる場合、ユーザーが長期的に期待した資産を受け取れない可能性があります。

3つ目のリスクは、悪意あるメタデータです。

メタデータファイルや外部リンクが、危険なWebサイトやフィッシングページにユーザーを誘導する場合があります。

4つ目のリスクは、偽の資産です。

詐欺師は、画像を複製したり、誤解を招く名前や偽のコレクションメタデータを使ったりしてNFTを作成できます。

5つ目のリスクは、プライバシー情報の漏えいです。

一部のメタデータやメディアリンクは、トラッキングサーバーを通じて読み込まれる際にユーザーの行動を明らかにする場合があります。

6つ目のリスクは、プラットフォームへの依存です。

NFTが技術的にはオンチェーンに存在していても、表示されるコンテンツが非公開APIや中央集権型アプリに依存している場合があります。

メタデータURIの確認方法

まず、URIがHTTPS、IPFS、Arweave、オンチェーンデータのどれを使用しているかを確認します。

メタデータファイルが正しく読み込まれ、想定した資産と一致しているかを確認します。

画像やメディアファイルも、耐久性のあるストレージを指しているか確認します。

メタデータが凍結または不変化されていることを示す情報を探します。

スマートコントラクトの所有者がベースURIを変更できるか確認します。

メタデータにname、description、image、attributesの各フィールドが明確に含まれているか確認します。

NFTのメタデータに含まれる見覚えのない外部リンクはクリックしないでください。

メタデータを信頼する前に、コントラクトアドレスをプロジェクトの公式情報と照合してください。

高額なNFTを購入する場合は、購入前にスマートコントラクトとストレージ方法を確認してください。

メタデータURIとメディアURIの違い

メタデータURIは、トークンのメタデータファイルを指します。

メディアURIは、メタデータ内で参照される実際の画像、アニメーション、動画、音声、3Dファイルを指します。

たとえば、メタデータURIがJSONファイルを指している場合があります。

そのJSONファイル内のimageフィールドが、別の画像URIを指していることがあります。

どちらのリンクも重要です。

メタデータURIが機能していても、メディアリンクが切れていればNFTが正しく表示されない場合があります。

優れたNFTプロジェクトは、メタデータとメディアの両方に耐久性のあるストレージを使用する必要があります。

メタデータURIに関するよくある誤解

よくある誤解の1つは、NFT画像が常にオンチェーンに直接保存されているというものです。

多くの場合、スマートコントラクトが指すのはメタデータURIだけで、画像は別の場所に保存されています。

もう1つの誤解は、IPFSがコンテンツの恒久的な利用可能性を自動的に保証するというものです。

IPFSはコンテンツアドレス指定を採用していますが、ユーザーが安定して取得できるようにするには、コンテンツのホスティングまたはピン留めが必要です。

3つ目の誤解は、メタデータが凍結されていればメディアも必ず恒久保存されるというものです。

メタデータが凍結されていてもリンクが固定されるだけで、リンク先のファイルには耐久性のあるストレージが必要です。

4つ目の誤解は、メタデータを持つNFTはすべて本物だというものです。

詐欺師はメタデータや画像をコピーできるため、ユーザーはコントラクトとコレクションの情報源を確認する必要があります。

FAQ

暗号資産におけるメタデータURIとは？

メタデータURIとは、通常はNFTであるトークンのメタデータファイルを指すリンクです。

NFTのメタデータには何が含まれる？

NFTのメタデータには、トークン名、説明、画像、アニメーション、特性、属性、外部URL、その他の表示情報が含まれる場合があります。

メタデータURIはオンチェーンに保存される？

URIはスマートコントラクトに保存またはコントラクトから返される場合がありますが、メタデータファイル自体はオフチェーンに保存されることがよくあります。

tokenURIとは？

tokenURIは、特定のNFTトークンIDのメタデータURIを返す、ERC-721で一般的な関数です。

メタデータURIと画像URIの違いは？

メタデータURIはJSON形式のメタデータファイルを指し、画像URIはそのメタデータ内の実際の画像またはメディアファイルを指します。

メタデータにはHTTPSよりIPFSの方が適している？

IPFSはコンテンツアドレス指定による保存が可能ですが、HTTPSはWebサーバーに依存します。ただし、IPFSコンテンツを安定して利用するには、ピン留めまたはホスティングが必要です。

メタデータの凍結とは？

メタデータの凍結とは、通常の管理機能では簡単に変更できないよう、プロジェクトがメタデータをロックした状態です。

NFTのメタデータはミント後に変更できる？

はい。スマートコントラクトやストレージの設定でプロジェクトチームまたは管理者によるURIやファイル内容の更新が許可されていれば、変更される可能性があります。

NFTの画像が表示されなくなるのはなぜ？

メタデータURI、メディアURI、サーバー、ゲートウェイ、ストレージプロバイダーがファイルを読み込めない場合、NFT画像が表示されなくなる可能性があります。

NFTの購入前に確認すべきことは？

コントラクトアドレス、メタデータURI、ストレージ方法、メタデータの凍結状況、メディアリンク、プロジェクトの規約、コレクションの真正性を確認してください。

まとめ

メタデータURIは、ウォレット、マーケットプレイス、ゲーム、メタバースアプリでNFTやその他の暗号資産の情報を表示するうえで重要な要素です。

トークンIDを、資産の名前、画像、説明、特性、メディアリンクを記載したメタデータファイルに結び付けます。

メタデータURIによりNFTの柔軟性と表示のしやすさが高まる一方、ストレージ、セキュリティ、信頼に関するリスクも生じます。

優れたメタデータURIの設計は、透明性、耐久性、正確性を備え、ユーザーが資産を購入した後に操作されにくいものである必要があります。

ユーザーはメタデータが中央集権型か、分散型か、オンチェーンか、凍結済みか、アップグレード可能かを理解する必要があります。

また、メディアファイルが信頼できる方法で保存されているか、NFTのコントラクトが本物かどうかも確認してください。

暗号資産では、所有権は資産を語る要素の一つにすぎません。

メタデータURIは、資産の外観や説明、長期的な表示を信頼できるかどうかを左右します。