オンチェーンメタデータ

オンチェーンメタデータとは？

オンチェーンメタデータとは、暗号資産、スマートコントラクト、NFT、トークン、ウォレット内のオブジェクト、ブロックチェーン上の記録に関する説明情報のうち、外部サーバーだけでなくブロックチェーン上に直接保存されているものを指します。簡単に言えば、メタデータはブロックチェーン上の資産が何であるかを説明する情報です。オンチェーンメタデータの場合、その説明はブロックチェーンの状態、トランザクションデータ、コントラクトストレージ、イベントログ、またはコントラクトが返すエンコード済みデータの中に保存されています。NFTのメタデータには、名前、説明、画像の参照先、属性、レアリティ特性、アニメーションファイル、外部リンク、クリエイター情報、ライセンスの詳細、ゲーム内のプロパティなどが含まれる場合があります。トークンコントラクトのメタデータには、名前、シンボル、ロゴ、説明、ウェブサイト、共同制作者、表示情報などが含まれる場合があります。スマートコントラクトのメタデータには、コントラクトの識別情報、プロジェクト情報、バージョンの詳細、スキーマへの参照、関連リソースへのリンクなどが含まれる場合があります。多くの暗号資産では所有権のみがオンチェーンに記録され、説明用のファイルやメディアは別の場所に保存されているため、この用語は重要です。オンチェーンメタデータは、資産のアイデンティティをより多くブロックチェーン内に保持することで、外部への依存を減らすことを目指します。

ERC-721規格では、tokenURIがname、description、imageフィールドを含むJSONファイルを参照できる、任意のメタデータ拡張が定義されています。

ERC-1155規格では、各トークンIDが、それぞれ固有のメタデータ、供給量、属性を持つ設定可能なトークンタイプを表せます。

オンチェーンメタデータは、NFT、トークン化資産、ゲームアイテム、デジタルアイデンティティ記録、DAO資産、コレクティブルプロジェクトなど、長期的な検証可能性が重要となるあらゆる暗号資産にとって、特に重要です。

オンチェーンメタデータの要点

• オンチェーンメタデータとは、ブロックチェーンに直接保存される、またはスマートコントラクトから直接返される資産情報です。
• NFT、代替可能トークン、スマートコントラクト、コレクション、実世界資産トークン、ゲームアイテム、本人確認情報、DAOの記録などを説明できます。
• 一般的なメタデータ項目には、名前、説明、画像、アニメーション、属性、外部リンク、特性、レベル、クリエイター情報、コレクション情報などがあります。
• 完全なオンチェーンメタデータは、永続性、監査可能性、検閲耐性を高める可能性があります。
• ブロックチェーン上のストレージと計算資源には限りがあるため、オンチェーンメタデータはコストが高くなる場合があります。
• 多くのNFTプロジェクトは、トークンとURIをオンチェーンに置き、JSONやメディアをIPFS、Arweaveなどのストレージレイヤーに保存するハイブリッド型メタデータを採用しています。
• メタデータには、静的、変更可能、動的、封印済み、またはスマートコントラクトのロジックのみで生成されるものがあります。
• メタデータ規格により、ウォレット、エクスプローラー、ゲーム、インデクサー、アプリケーションは資産を一貫した方法で表示できます。
• オンチェーンメタデータがあっても、著作権の保有、作品の独創性、法的権利、投資価値が自動的に証明されるわけではありません。
• ユーザーは、トークン化資産を購入、ミント、または利用する前に、メタデータとメディアの保存場所を確認する必要があります。

オンチェーンメタデータの仕組み

オンチェーンメタデータは、ブロックチェーンのトランザクションまたはスマートコントラクト内に説明データやメタデータを取得するロジックを置くことで機能します。シンプルなコントラクトでは、メタデータJSON全体を含む文字列を保存できます。別のコントラクトでは、メタデータを直接含むBase64エンコード済みのデータURIを返すことがあります。また別のコントラクトでは、トークンID、ブロックデータ、ゲームの状態、その他のコントラクト変数に基づいてメタデータを動的に生成する場合があります。オンチェーンにURIのみを保存し、実際のメタデータファイルはオフチェーンに置くコントラクトもあります。この最後の方法は一般的ですが、説明用のJSONが別のストレージに依存するため、完全なオンチェーンメタデータではありません。完全なオンチェーンNFTでは、通常のウェブサイトや中央サーバーに依存せず、コントラクト自体から主要なメタデータをすべて取得できます。ハイブリッド型NFTでは、所有権とコンテンツアドレス付きリンクをオンチェーンに保持しながら、容量の大きい画像や動画はチェーン外に保存できます。一般に、ここではコストと永続性のトレードオフが生じます。すべてをオンチェーンに保存すれば、より長期間保持しやすくなる一方、費用が大幅に増え、柔軟性が低下する場合があります。

オンチェーンメタデータとオフチェーンメタデータの違い

オンチェーンメタデータは、ブロックチェーンインフラに直接保存されるか、ブロックチェーンインフラによって生成されます。オフチェーンメタデータはブロックチェーンの外部に保存され、URL、APIエンドポイント、分散型ストレージリンク、その他の外部参照を通じて指定されます。たとえば、NFTコントラクトに保存されたtokenURIが、ウェブサイト上のJSONファイルを指している場合があります。この場合、トークンの所有権はオンチェーンですが、メタデータファイルはオフチェーンです。ウェブサイトが消えたり、ファイルが変更されたり、アクセスがブロックされたり、誤ったデータが返されたりすると、NFTの表示に不具合が生じる可能性があります。メタデータがコントラクトに直接保存されていれば、資産がウェブサイトに依存する度合いは低くなります。オフチェーンメタデータは低コストで、更新も容易です。オンチェーンメタデータは、より透明性と耐久性に優れる場合があります。どちらのモデルも、あらゆる用途に完璧というわけではありません。適切な資産設計では、資産の目的、コスト上限、法的要件、想定される存続期間に合った保存方式を選びます。

オンチェーンメタデータとオンチェーンメディアの違い

メタデータとメディアは関連していますが、同じものではありません。メタデータは資産に関する説明情報です。メディアは、ユーザーが見る、または体験する実際の画像、アニメーション、音声、動画、3Dモデル、インタラクティブファイルです。NFTによっては、メタデータをオンチェーンに保存しながら、オフチェーンのメディアを参照します。メタデータとメディアの両方を完全にオンチェーンに保存するNFTもあります。別のNFTでは、どちらも完全にはオンチェーンに保存せず、サーバーを参照するURLだけを保存する場合があります。この違いが重要なのは、プロジェクトがオンチェーンメタデータを掲げていても、オフチェーンメディアに依存している可能性があるためです。たとえば、コントラクトはオンチェーンでJSONオブジェクトを返していても、そのJSON内のimageフィールドがIPFSなどのストレージシステムを参照している場合があります。メディアがコンテンツアドレス方式の永続的なストレージを利用していれば、これは優れた設計となる可能性があります。ただし、何がオンチェーンで、何が外部にあるのかをユーザーが正確に理解する必要があります。

ERC-721メタデータ

ERC-721は、Ethereum系のスマートコントラクトシステムで最もよく知られたNFT規格です。ERC-721のメタデータ拡張には、name、symbol、tokenURIの各関数が含まれます。tokenURI関数は、特定のトークンIDのURIを返します。そのURIは、ERC-721 Metadata JSON Schemaに準拠したJSONファイルを参照する場合があります。この規格では、name、description、imageなどの一般的な項目が定められています。完全なオンチェーン設計では、tokenURIが外部ファイルを参照する代わりに、JSONを直接含むデータURIを返すことができます。これにより、ウォレットやアプリケーションは従来型の外部URLを取得せずにメタデータを読み取れます。ただし、すべてのインターフェースが、高度なオンチェーン形式すべてに同じように対応しているわけではありません。開発者は、ウォレット、エクスプローラー、アプリケーションでメタデータがどのように表示されるかをテストする必要があります。規格で構造を定義しても、実際の表示はソフトウェアの対応状況に左右されます。

ERC-1155メタデータ

ERC-1155は、1つのコントラクトで代替可能、非代替性、準代替性の資産を表現できるマルチトークン規格です。この規格では、各トークンIDが異なるトークンタイプを表せます。各トークンタイプは、それぞれ独自のメタデータ、供給量、属性を持つことができます。そのためERC-1155は、複数種類のアイテムを含むゲーム、コレクティブル、会員権、エディション、報酬、資産コレクションに適しています。ERC-1155のメタデータでは、トークンIDをメタデータのパスに置き換えるURI形式がよく使われます。1つのコントラクトで多数のトークンを管理できるため、大規模なコレクションを効率的に扱えます。ゲームアイテムやエディションのアイデンティティを長期間維持する必要がある場合、ERC-1155のオンチェーンメタデータが役立ちます。一方、各アイテムに固有の大きなデータ項目がある場合は、コストが高くなることがあります。開発者は、主要なプロパティをオンチェーンに保存し、大容量ファイルにはコンテンツアドレス方式のストレージを利用できます。最適な設計は、メタデータの更新頻度と各トークンに必要なデータ量によって異なります。

コントラクトレベルのメタデータ

コントラクトレベルのメタデータは、特定のトークンIDではなく、スマートコントラクトやコレクション自体を説明します。コレクション名、説明、プロフィール画像、バナー画像、注目画像、ウェブサイト、共同制作者、その他の表示情報などが含まれる場合があります。

草案であるERC-7572 contractURI規格は、コントラクトレベルのメタデータを返すcontractURI関数を提案しています。

ERC-7572では、返される文字列はオフチェーンのリソース、またはオンチェーンのJSONデータ文字列のいずれでもよいとされています。多くのアプリケーションがトークン単位の情報だけでなく、コレクション全体の情報も必要とするため、これは重要です。ウォレットはコレクションのロゴを表示する必要があるかもしれません。エクスプローラーはコントラクトの説明を表示する必要があるかもしれません。DAOダッシュボードは、検証済みのプロジェクト情報を表示する必要があるかもしれません。コントラクトレベルのメタデータは、正確かつ安全に管理されていれば、使いやすさを高められます。一方、適切な権限なしに攻撃者がコントラクトの説明、画像、共同制作者リストを更新できる場合、リスクが生じます。

ERC-8049と新しいオンチェーンメタデータの取り組み

草案のERC-8049提案は、コントラクトレベルのメタデータをオンチェーンに保存するための規格を定義しています。

文字列キーとbytes値を用いるオンチェーンストレージインターフェースを提供し、コントラクトレベルのメタデータという考え方を拡張しています。このような提案は、メタデータ規格が今も進化していることを示しています。従来のトークンメタデータの形式では、tokenURIリンクが中心となることがよくあります。新しい取り組みでは、コントラクトのアイデンティティ、クロスチェーン互換性、予測可能なストレージ、メタデータ更新イベント、ウォレットやエクスプローラー向けの高度な情報検出などが検討されています。ERC-8049は草案であるため、開発者は最終的な普遍的要件として扱うべきではありません。一方、メタデータ設計の今後の方向性を理解するために、内容を確認することはできます。より大きな流れは明らかです。暗号資産アプリケーションでは、コントラクトの内容、表す対象、表示データを更新できる人、その情報の保存場所を、より確実に把握する方法が求められています。ブロックチェーンが単純な送金を超える複雑なアプリケーションを支えるにつれ、オンチェーンメタデータの重要性は高まっています。

メタデータ更新イベント

プロジェクトによっては、メタデータが変更されることがあります。ゲームアイテムのレベルが上がることがあります。会員権トークンのステータスが変わることがあります。動的NFTの外観が、時間、実績、オラクルデータに応じて変化する場合があります。

ERC-4906メタデータ更新拡張は、ERC-721トークン向けにMetadataUpdateイベントとBatchMetadataUpdateイベントを追加します。

これらのイベントにより、アプリケーションはトークンのメタデータを更新すべきタイミングを把握できます。インデクサーやウォレットは、繰り返しの問い合わせを減らすためメタデータをキャッシュする場合があるので、これは有用です。メタデータが変更されても通知が発行されなければ、ユーザーに古い情報が表示される可能性があります。更新イベントにより、動的メタデータをより適切に扱えるようになります。また、不正な更新は信頼を損なう可能性があるため、権限管理も重要になります。

複数メタデータに対応するNFT

NFTによっては、複数のメタデータURIが必要です。画面ごとに異なる表示形式が必要なトークンがあります。共同制作のアート作品に複数のアーティスト版が含まれることがあります。ゲームアイテムにアップグレード履歴が必要な場合があります。トークン化された実世界資産では、最新のメタデータ、アーカイブ済みメタデータ、コンプライアンス用メタデータが必要になることがあります。

ERC-7160マルチメタデータ拡張は、ERC-721トークンごとに複数のメタデータURIを設定し、主要URIを固定する機能を提案しています。

このことは、メタデータが常に1つの静的ファイルとは限らなくなっていることを示しています。暗号資産が複雑になるにつれ、メタデータには履歴、バージョン、ユーザーが選択できる表示状態が必要になる場合があります。複数メタデータを使う設計は柔軟性を高める可能性があります。一方、どのバージョンが公式、最新、アーカイブ済み、ユーザー選択のいずれなのかが分かりにくいと、混乱を招く可能性もあります。

静的メタデータ

静的メタデータとは、ミント後、または最終公開後に変更されないメタデータです。固定されたアート、コレクティブル、歴史的記録、永続性が価値の一部となるトークンで一般的です。静的メタデータは、完全にオンチェーンに保存する、スマートコントラクトで変更できないようにする、またはコンテンツアドレス方式のストレージに固定する方法があります。資産が後から変更されないという確信を求めるコレクターは、静的メタデータを好むことがよくあります。想定される項目が安定しているため、静的メタデータは検証しやすくなります。継続的なメタデータ更新権限が不要となるため、運用リスクも減らせます。一方で、間違いが恒久的に残る可能性があります。誤字、誤った画像、不適切な属性、リンク切れが確定すると、修正が困難または不可能になる場合があります。静的メタデータは、ミント前に十分な確認を行うプロジェクトに最適です。確定したデータが正しい場合にのみ、ファイナリティは価値を持ちます。

動的メタデータ

動的メタデータは時間の経過とともに変化します。ゲーム、ロイヤルティプログラム、進化するアート、スポーツコレクティブル、実世界資産、本人確認情報、実績システムなどで役立つ場合があります。ユーザーがクエストを完了すると、動的NFTの外観が変わることがあります。トークン化資産の評価額、ステータス、検査記録、満期情報などが更新される場合があります。ユーザーが新たな貢献レベルに達したとき、会員権トークンのランクが変わることがあります。動的メタデータは、ブロックチェーン上の資産をより有用でインタラクティブなものにできます。一方で、信頼に関する疑問も生じます。誰がメタデータを更新できるのでしょうか？更新はどのようなルールに従うのでしょうか？所有者は更新履歴を確認できるのでしょうか？発行者は販売後に重要な特性を変更できるのでしょうか？動的メタデータには、明確な権限、イベント、監査証跡、ユーザーの期待が必要です。

完全なオンチェーンメタデータ

完全なオンチェーンメタデータとは、主要な説明項目がブロックチェーンのコントラクトに直接保存されるか、同コントラクトによって生成されることを指します。コントラクトストレージ、ハードコードされた文字列、生成SVG、Base64エンコード済みJSON、決定論的なレンダリングロジックなどを使って実現できます。通常のウェブサーバーに依存しないため、完全なオンチェーンメタデータは資産の耐久性を高める可能性があります。また、ユーザーがコントラクトを調べ、メタデータの生成方法を検証できるため、透明性も高まる可能性があります。完全なオンチェーンのジェネラティブアートは、その代表例です。コントラクトは、トークンID、シード値、保存された特性などから画像とメタデータを生成できます。この方法は、長期的な保存に役立つ可能性があります。主な欠点はコストです。オンチェーンに保存するすべてのバイトが、希少なブロックチェーン資源を使用します。大きな画像、動画、複雑なメタデータを完全にオンチェーンに保存すると、費用が高くなったり、現実的でなくなったりする可能性があります。

ハイブリッド型メタデータ

ハイブリッド型メタデータは、オンチェーンとオフチェーンのストレージを組み合わせたものです。多くのNFTやトークンシステムで、最も一般的な実用モデルです。コントラクトはトークンの所有権、トークンID、メタデータURIをオンチェーンに保存できます。メタデータURIは、IPFS、Arweave、HTTPS、その他のストレージシステムを参照する場合があります。メディアファイルはJSONメタデータとは別に保存されることがあります。この方法では、ブロックチェーン上の記録を通じて資産を確認できる状態を保ちつつ、ブロックチェーンのコストを抑えられます。設計の強みは、外部ストレージの方式によって異なります。通常のウェブURLは、ドメインの期限切れやサーバーの削除によって利用できなくなることがあります。コンテンツアドレス方式のIPFS CIDを使うと、コンテンツが変更されていないことをユーザーが検証しやすくなります。

IPFSのNFTデータに関するガイダンスでは、NFTデータの保存、アドレス指定、長期的な維持方法を計画することが推奨されています。

コンテンツアドレス方式とメタデータ

コンテンツアドレス方式とは、変更可能なサーバー上の場所ではなく、コンテンツを暗号学的に参照する方法でファイルを識別する仕組みです。IPFSでは、コンテンツを識別するためにCID（コンテンツ識別子）が使われます。ファイルが変わるとCIDも変わります。これにより、コンテンツが差し替えられたかどうかを検出できるため、コンテンツアドレス方式はNFTメタデータに有用です。IPFS CIDを参照するtokenURIは、通常のウェブURLだけを参照するtokenURIより堅牢な場合があります。ただし、コンテンツアドレス方式だけで、コンテンツの可用性が自動的に保証されるわけではありません。コンテンツを取得できる状態に保つには、誰かがピン留め、ホスティング、保存を行う必要があります。そのため、ストレージ設計では完全性と永続性の両方を考慮すべきです。完全性とは、データが変更されていないことです。永続性とは、後からもデータを見つけられることです。

Base64メタデータ

Base64メタデータは、JSONやメディアをスマートコントラクトから直接返す一般的な方法です。コントラクトは、data:application/json;base64などのデータURIで始まるtokenURIを返すことがあります。エンコードされたコンテンツには、NFTの名前、説明、画像、属性を含めることができます。画像自体もSVGなどのデータ形式でエンコードされる場合があります。コントラクトが表示に必要な情報をすべて返せるため、この方法は完全なオンチェーンNFTでよく使われます。外部のメタデータサーバーに依存しないという利点もあります。一方で、Base64データはコントラクトの出力を大きくし、人間が直接読み取りにくくする場合があります。また、大きな値を保存したり、非効率に生成したりすると、ガス代が増える可能性があります。開発者は、複数のウォレットやエクスプローラーでBase64メタデータをテストする必要があります。エンコードされた画像、アニメーション、一般的でない項目への対応状況は、インターフェースによって異なる場合があります。

トークン化された実世界資産のオンチェーンメタデータ

トークン化された実世界資産のメタデータは、そのトークンがブロックチェーン外の対象を表す場合があるため、慎重に設計する必要があります。メタデータには、請求書、ファンド持分、債券、不動産記録、商品に対する権利、カーボンクレジット、コレクティブル、法的契約などが記載される場合があります。その情報の一部は公開に適しており、オンチェーンに保存できる場合があります。一方で、非公開、規制対象、または個人情報に当たるものもあります。公開ブロックチェーンに機密性の高い法的情報や個人情報を直接書き込むのは危険です。公開記録は削除が難しい場合があるためです。より適切な設計としては、ハッシュ、証明、文書参照、アクセス制限付きの証明をオンチェーンに保存し、非公開文書は管理されたストレージに保管する方法が考えられます。オンチェーンメタデータは透明性を支えますが、機密情報を不必要に公開すべきではありません。実世界資産のメタデータには、バージョン管理も必要です。契約条件、担保の状況、満期日、監査結果、法的文書は、時間とともに変わる可能性があります。どのメタデータが正式な情報源であり、どのようなルールで更新されるのかを、プロジェクトは明確に説明すべきです。

ゲームにおけるオンチェーンメタデータ

ブロックチェーンゲームでは、アイテム、キャラクター、スキン、土地、武器、実績、消費アイテムなどの説明にメタデータが使われます。オンチェーンメタデータは、アイテムの希少性、特性、所有権、履歴をプレイヤーが検証するのに役立ちます。動的メタデータによって、プレイヤーがアイテムを使うにつれてアイテムを変化させることもできます。たとえば、剣のNFTが経験値を獲得したり、キャラクターNFTのレベルが上がったり、建築後に土地NFTの状態が変わったりする場合があります。ゲームアイテムの状態を他のコントラクトが直接読み取れるため、完全なオンチェーンのゲームメタデータはコンポーザビリティを高める可能性があります。ただし、ゲームでは大きな画像、頻繁な状態変更、複雑なロジックが必要になることがよくあります。そのすべてをオンチェーンに保存すると、費用が高すぎる可能性があります。多くのゲームでは、重要な所有権や属性をオンチェーンに置き、大容量のアセットはオフチェーンに置くハイブリッドモデルが採用されています。優れたゲームメタデータ設計では、永続的な特性と頻繁に変化するゲームプレイデータを分けます。これにより、コスト、速度、プレイヤーの信頼のバランスを取りやすくなります。

デジタルアイデンティティにおけるオンチェーンメタデータ

デジタルアイデンティティシステムでは、認証情報、証明、バッジ、会員資格、評判の記録などをメタデータで表す場合があります。オンチェーンメタデータによって、認証情報を公開の場で検証しやすくなる可能性があります。一方で、個人情報が恒久的に公開されると、プライバシー上のリスクが生じます。公開ブロックチェーンは、パスポート番号、住所、健康データ、非公開の法的記録などの生データを保存する場所として、通常は適していません。その代わりに、アイデンティティシステムでは、ハッシュ、選択的開示、ゼロ知識証明、分散型識別子、オフチェーンの暗号化記録などが使われることがあります。機密情報を明かさずに、メタデータで認証情報の種類を説明できます。たとえば、オンチェーン記録で、既知の機関が認証情報を発行したことと、その認証情報が存在することを証明できます。非公開の詳細情報はオフチェーンに保管し、必要な場合にのみ提示できます。アイデンティティに関するオンチェーンメタデータでは、データ最小化の原則に従うべきです。公開検証に本当に必要な情報だけをチェーンに保存すべきです。

オンチェーンメタデータと来歴

来歴とは、作成、所有、譲渡、変更の履歴を指します。オンチェーンメタデータは、資産の詳細や更新内容をブロックチェーン上で確認できるようにすることで、来歴の管理を支援します。NFTの来歴には、ミント時刻、クリエイターアドレス、トークンID、メタデータハッシュ、公開イベント、更新イベント、譲渡履歴などが含まれる場合があります。トークン化資産の来歴には、発行、監査、カストディの変更、償還、文書参照などが含まれる場合があります。確かな来歴があれば、その資産が主張どおりのものであるかをユーザーが確認しやすくなります。来歴が不十分だと、複製品、偽物、誤解を招く資産を見分けにくくなる場合があります。メタデータだけでは真正性を証明できません。詐欺師が有名作品や実物資産を表すと主張するメタデータを作成することも可能です。ユーザーは、発行者、コントラクトアドレス、ミント履歴、外部の権利を引き続き確認する必要があります。オンチェーンメタデータは証拠の一部であり、自動的に真実となるわけではありません。

オンチェーンメタデータと不変性

不変性とは、オンチェーンに記録されたデータが変更されにくいことを指します。重要な項目を後から変更できない不変メタデータは、コレクターの信頼を高める可能性があります。販売後に表示される資産を差し替える、ラグプルのようなメタデータ変更からユーザーを守ることにもつながります。ただし、不変性によって間違いが固定される場合もあります。メタデータにリンク切れの画像、誤った特性、誤字のある名前、不正確なライセンスが含まれていると、修正できない可能性があります。変更可能なメタデータなら間違いを修正できますが、更新権限を持つ人への信頼が必要になります。これは設計上の選択を伴います。公開後にメタデータを凍結すべきプロジェクトもあります。透明性の高いガバナンスのもとで更新を認めるべきプロジェクトもあります。変更できない中核的な特性と、変更可能な表示項目を分けるべきプロジェクトもあります。

オンチェーンメタデータとガス代

ガス代は、オンチェーンメタデータの大きな制約の1つです。ストレージ、計算、トランザクション処理には限りがあるため、公開ブロックチェーンでは手数料が発生します。短い文字列の保存なら、手頃な場合があります。大きな画像、長いアニメーション、複雑なメタデータファイルの保存には、多額の費用がかかる場合があります。開発者は、大きなファイルの代わりにハッシュ、コンパクトな特性値、SVG生成ロジック、コンテンツアドレス方式のリンクを使い、コストを抑えることがよくあります。Layer 2ネットワークは一部のメタデータ操作のコストを下げられる場合がありますが、ストレージが無料になるわけではありません。コストはユーザーにも影響します。メタデータの更新にトランザクションが必要な場合、データが変わるたびにユーザーまたはプロジェクト運営者が手数料を支払う必要があるかもしれません。テスト段階では良好に見えるメタデータ設計も、規模が拡大すると費用がかさむ場合があります。効率的なストレージ計画は、優れたスマートコントラクト設計の一部です。

オンチェーンメタデータとインデクサー

インデクサーとは、ブロックチェーンデータを読み取り、アプリケーション向けに整理するサービスです。ウォレット、エクスプローラー、ゲーム、ダッシュボードは、メタデータを素早く表示するためインデクサーに依存することがよくあります。メタデータがオンチェーンにあっても、アプリケーションはその検索、デコード、キャッシュ、更新の方法を把握する必要があります。標準化された関数やイベントは、インデクサーの安定した動作に役立ちます。たとえば、tokenURIを使うとインデクサーはトークン単位のメタデータを見つけられます。contractURIを使うと、インデクサーはコントラクト単位のメタデータを見つけられます。MetadataUpdateイベントは、キャッシュ済みデータを更新するタイミングをインデクサーに知らせるのに役立ちます。規格がなければ、プロジェクトごとに独自のインデックス作成ロジックが必要になる場合があります。その結果、資産の表示が難しくなり、誤解も起きやすくなります。メタデータ規格は、暗号資産エコシステム全体の相互運用性を高めます。

オンチェーンメタデータとウォレットの表示

ウォレットは、ユーザーが保有資産を把握できるようメタデータを利用します。ウォレットには、トークン名、コレクション名、画像、シンボル、説明、特性、残高、コントラクトアドレス、チェーンなどが表示される場合があります。メタデータがない、または壊れている場合、ウォレットには画像なし、不明なトークン、汎用プレースホルダーなどが表示されることがあります。メタデータが誤解を招く内容なら、ユーザーが誤った資産を承認または取引する可能性があります。そのためメタデータは、デザインだけでなくユーザーの安全にも関わります。ウォレットは、メタデータが不審な場合、コントラクトアドレスや警告を表示すべきです。開発者は、壊れやすいサーバーや不明瞭なファイル形式に依存するメタデータを避けるべきです。ウォレットに見慣れた画像が表示されているだけで、資産を信用すべきではありません。詐欺師は、名前、画像、説明をコピーできます。表示されるメタデータよりも、コントラクトアドレスや発行者の履歴のほうが重要な場合がよくあります。

オンチェーンメタデータとセキュリティ

オンチェーンメタデータは、変更可能な外部サーバーへの依存を減らすことで、セキュリティを高める可能性があります。一方、更新ロジックが脆弱だと、新たなセキュリティ上の問題が生じる場合があります。メタデータを更新できるプロジェクトオーナーの鍵は、攻撃者にとって価値の高い標的になります。その鍵が侵害されると、攻撃者が画像、説明、リンク、コントラクトレベルの表示データを変更する可能性があります。メタデータ内のリンクが、フィッシングページ、悪意のあるファイル、虚偽の主張を参照することもあります。スマートコントラクトでは、明確なアクセス制御によってメタデータ更新関数を制限する必要があります。プロジェクトは、メタデータを変更できるかどうかを開示すべきです。誰が、どのような条件で変更できるのかも説明する必要があります。外部リンクや指示を含むメタデータには注意が必要です。読みやすいメタデータはユーザーの行動に影響するため、セキュリティ上の攻撃対象領域の一部として扱う必要があります。

オンチェーンメタデータと著作権

オンチェーンメタデータによって、著作権、商標権、商業利用権が自動的に付与されるわけではありません。NFTに画像フィールドが含まれていても、ミントした人がその作品を所有している証明にはなりません。トークンが実世界資産を説明していても、その資産の法的所有権が自動的に証明されるわけではありません。メタデータには、ライセンス条件、クリエイター名、外部リンクを記載できます。それらの記載にも、法的および事実上の裏付けが必要です。購入者は、プロジェクトのライセンス、発行者、コントラクトアドレス、ミント履歴、公式ドキュメントを確認すべきです。価値の高い資産では、メタデータの文言より法的契約のほうが重要な場合があります。オンチェーンメタデータは、主張を記録するのに優れています。ただし、それによってすべての主張の法的有効性が証明されるわけではありません。デジタル資産の所有と知的財産権を混同してはいけません。

オンチェーンメタデータとプライバシー

公開オンチェーンメタデータは誰でも閲覧できます。透明性の面では有用ですが、非公開情報を扱う場合はリスクがあります。機密データを公開ブロックチェーンに書き込むと、削除は非常に困難になる場合があります。強い理由と明確な同意がない限り、メタデータで個人を特定できる情報を公開すべきではありません。一見無害なメタデータでも、ウォレットの取引履歴と組み合わさると機密情報になる場合があります。たとえば会員バッジから、勤務先、参加したコミュニティ、出席したイベントが分かることがあります。本人確認情報や認証情報を扱うシステムでは、個人情報の生データをオンチェーンに保存しないようにすべきです。ハッシュ、コミットメント、暗号化ストレージ、アクセス制限、ゼロ知識証明などの活用を検討する必要があります。メタデータの永続性は強力です。その力は慎重に使うべきです。

オンチェーンメタデータとAI生成アセット

AI生成のアート、音楽、キャラクター、ゲームアセットが増えるにつれ、メタデータ設計の重要性も高まっています。メタデータには、プロンプトの履歴、モデルのバージョン、生成日、クリエイターのウォレット、ライセンス条件、来歴に関する注記などを記載できます。透明性を高めるため、こうした情報をオンチェーンに保存するプロジェクトもあります。完全な生成記録は容量が大きいため、ハッシュや参照情報のみを保存するプロジェクトもあります。オンチェーンメタデータは、生成アセットがいつミントされ、どのコントラクトから発行されたかを証明するのに役立つ場合があります。ただし、コンテンツが独創的であること、権利を侵害していないこと、人間が作成したことを自動的に証明するわけではありません。AI生成の暗号資産が増えるにつれ、メタデータではクリエイターの主張、機械生成の詳細、検証済みの事実を明確に区別すべきです。優れたメタデータは混乱を減らせます。不適切なメタデータは、偽の来歴を公式情報のように見せてしまう可能性があります。特に高価な資産では、ユーザーはメタデータを批判的に読む必要があります。

オンチェーンメタデータのメリット

オンチェーンメタデータの第1のメリットは耐久性です。オンチェーンに直接保存されたデータは、外部サーバーへの依存度が低くなります。第2のメリットは検証可能性です。ユーザーはスマートコントラクト、トランザクション記録、メタデータの出力を直接調べることができます。第3のメリットは検閲耐性です。通常のウェブサイトは、分散型ブロックチェーンに埋め込まれたデータよりも削除されやすい場合があります。第4のメリットは来歴です。メタデータの変更や更新イベントによって、確認可能な履歴を作成できます。第5のメリットはコンポーザビリティです。他のスマートコントラクトがオンチェーン属性を読み取り、ゲーム、DeFi、アイデンティティシステム、DAOツールで利用できます。第6のメリットはプラットフォームへの依存を減らせることです。共通規格に従えば、複数のアプリケーションで資産を表示できます。

オンチェーンメタデータのリスクと制約

第1の制約はコストです。ブロックチェーンのストレージは、外部ストレージと比べて高額になる場合があります。第2の制約はデータ量です。大きな画像、動画、複雑なファイルを完全にオンチェーンに保存するのは、現実的でない場合がよくあります。第3の制約は、間違いが永続することです。確定後に誤ったメタデータを修正するのは困難な場合があります。第4の制約はプライバシーです。公開メタデータから機密情報が漏れる可能性があります。第5の制約は表示互換性です。一部のウォレットやアプリケーションは、すべてのメタデータ形式に対応しているわけではありません。第6の制約はガバナンスリスクです。変更可能なメタデータでは、更新権限を持つ人への信頼が必要です。第7の制約は虚偽の主張です。メタデータは、実際には証明されていない真正性、希少性、権利などを主張することがあります。

オンチェーンメタデータに関するよくある間違い

よくある間違いの1つは、すべてのNFTが画像をオンチェーンに保存していると思い込むことです。多くのNFTは所有権をオンチェーンに記録しますが、メディアは別の場所に保存しています。もう1つの間違いは、IPFSリンクなら常に永久に利用できると思い込むことです。IPFSコンテンツにも永続性の計画が必要です。3つ目の間違いは、不変メタデータが常に優れていると思い込むことです。不変メタデータは誤りを固定してしまう可能性があります。4つ目の間違いは、開示せずに1つの管理者ウォレットへメタデータ更新の無制限の権限を与えることです。5つ目の間違いは、機密性の高い個人情報を公開チェーンに保存することです。6つ目の間違いは、ウォレットやインデクサーが読み取れない独自形式の項目を使うことです。7つ目の間違いは、メタデータを法的権利の証明として扱うことです。8つ目の間違いは、動的メタデータの更新イベントを発行しないことです。9つ目の間違いは、永続性をうたう資産を中央集権型サーバーに依存させることです。10個目の間違いは、一般的なウォレットやエクスプローラーでのメタデータ表示をテストしないことです。

開発者向けのベストプラクティス

デプロイ前にメタデータの保存方式を決めます。用途に合う場合は、ERC-721、ERC-1155、ERC-4906、ERC-7160、コントラクトレベルのメタデータ規格など、確立されたトークン規格を使用します。長期的な信頼性が重要な場合は、必須の不変特性をオンチェーンに保存します。すべてをオンチェーンに保存する費用が高すぎる場合は、大容量メディアにコンテンツアドレス方式のストレージを利用します。動的メタデータが変化したときは、更新イベントを発行します。メタデータが変更可能、不変、公開遅延方式、完全なオンチェーン生成のいずれなのかを文書化します。強固なアクセス制御で更新関数を保護します。機密性の高い個人情報を公開チェーンに直接保存しないようにします。複数のアプリケーションでtokenURI、contractURI、データURI、Base64項目、メディアリンクをテストします。メタデータスキーマはシンプルで一貫性があり、インデクサーが解析しやすいものにします。

ユーザー向けのベストプラクティス

メタデータが完全にオンチェーンなのか、コンテンツアドレス方式なのか、通常のURLでホストされているのかを確認します。表示される画像や名前を信頼する前に、コントラクトアドレスを検証します。メタデータを変更できるかどうかを説明するプロジェクトのドキュメントを確認します。コントラクトの所有者がミント後にメタデータを変更できるか確認します。メタデータが外部リンクを参照している場合は注意します。表示されるNFT画像が、トークンの所有権記録と同じものとは限らないことを理解します。オンチェーンメタデータが著作権や法的権利を証明すると思い込まないようにします。可能であればブロックチェーンエクスプローラーを使ってtokenURIやcontractURIを確認します。価値の高い資産では、メディアの永続性と発行者の履歴を検証します。メタデータはデューデリジェンスの一部として扱い、すべての真実を示すものと考えないようにします。

オンチェーンメタデータが役立つ場面

永続性が重要な場合、オンチェーンメタデータが役立ちます。ウェブサイトが消えてもNFTやトークンの内容を理解できるようにしたい場合に有用です。コントラクトのロジックから直接生成できるジェネラティブアートにも適しています。スマートコントラクトがアイテム属性を読み取る必要があるゲームにも役立ちます。コミュニティが公開記録を必要とするDAO資産にも有用です。状態や監査情報を透明にする必要があるトークン化資産にも役立ちます。機密性のない検証情報のみを保存するアイデンティティシステムにも有用です。複数のアプリケーションがメタデータを独立して検証する必要がある場合にも適しています。大きな非公開ファイル、大容量メディア、削除が必要になる可能性のある情報にはあまり適していません。永続性よりストレージコストを優先する場合にも、あまり適していません。

オンチェーンメタデータを一言で表すと

オンチェーンメタデータとは、ブロックチェーンに保存される、またはスマートコントラクトによって生成される説明データであり、外部サーバーだけに頼らず、暗号資産やコントラクトが何を表すかをユーザー、ウォレット、エクスプローラー、アプリケーションが理解するのに役立ちます。

よくある質問

オンチェーンメタデータとは何ですか？

オンチェーンメタデータとは、資産やコントラクトに関する説明情報がブロックチェーンに直接保存されるか、スマートコントラクトから直接返されることを指します。

すべてのNFTメタデータはオンチェーンですか？

いいえ。多くのNFTは所有権をオンチェーンに記録しますが、メタデータやメディアは外部URL、IPFS、Arweave、その他のストレージシステムに保存しています。

メタデータとメディアの違いは何ですか？

メタデータは資産の説明情報で、メディアは資産に関連付けられた実際の画像、アニメーション、音声、動画、ファイルです。

tokenURIとは何ですか？

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

contractURIとは何ですか？

contractURIは、名前、説明、画像など、コレクションまたはコントラクトの情報を返すために使われるコントラクトレベルのメタデータ関数です。

オンチェーンメタデータのコストが高いのはなぜですか？

公開ブロックチェーンのストレージと計算資源は希少で、トランザクション手数料が必要になるためです。

オンチェーンメタデータは変更できますか？

コントラクトの設計によって異なります。変更できないメタデータもあれば、権限を持つアカウントやスマートコントラクトのルールによって更新できるものもあります。

IPFSのメタデータはオンチェーンメタデータと同じですか？

いいえ。IPFSのメタデータは通常オフチェーンに保存されますが、コンテンツアドレス方式です。一方、オンチェーンメタデータはブロックチェーンのコントラクトに直接保存されるか、同コントラクトによって生成されます。

オンチェーンメタデータはアートの権利の保有を証明しますか？

いいえ。オンチェーンメタデータは主張や参照情報を記録できますが、法的権利は著作権、ライセンス、契約、発行者の権限によって決まります。

ウォレットにメタデータが必要なのはなぜですか？

ウォレットは、名前、画像、説明、特性、コレクション情報など、ユーザーに分かりやすい詳細を表示するためにメタデータを必要とします。

動的メタデータとは何ですか？

動的メタデータとは、更新、ゲームの状態、実績、オラクルデータ、コントラクトのルールなどに応じて時間とともに変化するメタデータです。

NFTを購入する前に何を確認すべきですか？

コントラクトアドレス、メタデータの保存方式、メディアの保存方式、更新権限、発行者の履歴、資産に関する法的権利を確認する必要があります。

結論

オンチェーンメタデータは、暗号資産を読み取りやすく、便利で、検証可能なものにする仕組みを理解するうえで、中核となる概念です。ブロックチェーンはウォレットがトークンを保有していることを証明できますが、そのトークンが何を表すかを説明するのがメタデータです。NFTのメタデータには、ウォレットやアプリケーションに表示される名前、画像、説明、特性などを定義できます。スマートコントラクトのメタデータには、コントラクトのアイデンティティ、コレクションのプロフィール、表示画像、プロジェクト情報などを定義できます。トークン化資産のメタデータは、ブロックチェーン上の記録を実世界の文書、権利、状態、監査情報に結び付けることができます。メタデータをオンチェーンに保存すると、永続性、透明性、信頼を最小限に抑える設計を高められる可能性があります。消失や変更の可能性があるウェブサイトへの依存を減らせます。他のコントラクトやアプリケーションがメタデータを直接読み取れるため、資産のコンポーザビリティも高められます。ただし、すべての項目やファイルにオンチェーンメタデータが最適とは限りません。大容量メディアをオンチェーンに直接保存すると、費用が高くなる場合があります。非公開情報は通常、公開台帳に保存すべきではありません。変更可能なメタデータは便利ですが、信頼できる更新管理が必要です。不変メタデータは長期間維持できますが、間違いまで恒久的に残す可能性があります。優れたメタデータシステムは、オンチェーンに保存される情報、他の場所に保存される情報、変更権限を持つ人を明確に説明します。ウォレット、エクスプローラー、ゲーム、インデクサーが資産を正しく理解できるよう、規格を利用します。すべてをオンチェーンに保存するのが現実的でない場合は、コンテンツアドレス方式のストレージを活用します。更新権限を保護し、メタデータが変更されたときはイベントを発行します。重要なファイルが壊れやすいサーバーに依存しているのに、永続性があるとユーザーに誤解させないようにします。ユーザーにとって、オンチェーンメタデータはNFTやトークンのデューデリジェンスに欠かせない確認事項です。ウォレットに美しい画像が表示されているだけでは十分ではありません。重要なのは、メタデータがどこに保存され、誰が管理し、変更可能か、そして発行者が主張する権利を本当に持っているかです。暗号資産において、メタデータは単なる装飾ではありません。生のブロックチェーン上の所有権と、人が理解できる意味をつなぐものです。