NFT 元数据标准

什么是 NFT 元数据标准？

NFT 元数据标准是一套智能合约接口、JSON 格式、URI 规则和存储实践，可帮助加密应用理解非同质化代币代表的内容。

NFT 可以在链上证明所有权，而元数据则说明用户实际看到的资产信息，例如名称、图片、描述、特征、动画、游戏数据或外部内容。

在大多数加密生态系统中，代币记录和媒体记录属于不同层面。

代币记录通过智能合约保存在区块链上。

元数据通常存储在 JSON 文件、API 响应、去中心化存储或链上编码数据中。

NFT 元数据标准让钱包、交易市场、游戏、索引器、投资组合工具和分析平台能够更轻松地以一致方式读取这些数据。

如果没有元数据标准，每个 NFT 项目都可以用完全不同的方式描述代币，这会让 NFT 的发现、展示、交易和验证变得困难得多。

目前没有一套涵盖所有区块链、所有媒体类型和所有应用的通用 NFT 元数据标准。

相反，最重要的元数据标准来自广泛使用的代币标准，例如 ERC-721、ERC-1155，以及 ERC-4906 等相关扩展。

NFT 元数据标准为何对加密领域很重要

NFT 元数据标准很重要，因为 NFT 的设计目标是能够在多种加密应用之间流转。

用户可能通过一个应用铸造 NFT，在钱包中查看，通过交易界面挂单，在游戏中使用，在会员系统中验证，并通过分析工具追踪。

这些系统都需要可靠的方式来识别 NFT。

元数据标准为这些系统提供了可预测的字段和函数，供其读取。

这可以提升互操作性，因为开发者不必为每个 NFT 系列单独构建定制集成。

这也能改善用户体验，让 NFT 显示清晰的名称、图片、描述和属性，而不是呈现为损坏或未知的代币。

元数据标准也能帮助 NFT 买家做出更明智的决定。

如果元数据结构清晰，用户就可以在购买或转移 NFT 前查看其特征、与稀有度相关的属性、媒体链接和系列信息。

这很重要，因为 NFT 的价值往往与可见特征、媒体质量、效用、真实性和长期数据可用性有关。

NFT 元数据标准的核心组成部分

NFT 元数据系统通常包含四个核心组成部分。

第一部分是用于提供元数据 URI 的智能合约接口。

第二部分是描述 NFT 的 JSON 元数据文件或响应。

第三部分是元数据引用的媒体，例如图片、视频、音频文件、3D 模型或动画。

第四部分是用于长期保存元数据和媒体的存储方式。

对于 ERC-721 NFT，关键函数通常是

。

对于 ERC-1155 NFT，关键函数通常是

。

这些函数会返回一个 URI，客户端应用可用它来获取或解码元数据。

该 URI 返回的元数据通常采用 JSON 格式，因为 JSON 简单、机器可读，并且广泛受到 Web 和加密应用支持。

ERC-721 元数据标准

ERC-721 是 Ethereum 兼容网络上最广为人知的独特 NFT 代币标准。

官方 ERC-721 标准定义了一个可选的元数据扩展，其中包含

、 和 等函数。

函数返回 NFT 系列或合约的名称。

函数返回 NFT 系列或合约的简短符号。

函数返回指向特定代币 ID 元数据的 URI。

ERC-721 标准还包含 ERC-721 Metadata JSON Schema，其中设有

、 和 等字段。

字段为 NFT 提供易读的名称。

字段用于说明资产、系列、效用或创作理念。

字段指向代表 NFT 的图片。

许多 NFT 项目还会加入

、、 等额外字段和自定义属性，但这些并非原始 ERC-721 标准的必填项。

ERC-721 元数据 JSON 示例

基本的 ERC-721 元数据文件通常是一个简单的 JSON 对象：

这个示例为 NFT 设置了名称、描述、图片和两个属性。

图片使用 IPFS URI，这有助于用户验证引用内容是否与特定内容标识符相符。

数组通常用于描述特征、稀有度因素、游戏数据、会员等级或其他结构化属性。

应用可以读取这些元数据，并以用户易于理解的形式展示 NFT。

ERC-1155 元数据标准

ERC-1155 是一种多代币标准，可在同一个智能合约中表示同质化代币、半同质化代币和 NFT。

因此，ERC-1155 适用于区块链游戏、数字物品、限量版本、徽章、门票、会员权益以及包含多种代币类型的系列。

官方 ERC-1155 标准包含基于

函数的元数据 URI 系统。

该函数会返回指定代币 ID 的 URI。

ERC-1155 还支持特殊的

替换模式。

如果 URI 或 JSON 值中出现字符串

，符合标准的客户端软件会将其替换为实际代币 ID，并转换为补齐至 64 个字符的小写十六进制形式。

这种设计很有用，因为一个 URI 模板可以支持多个代币 ID。

例如，游戏合约可以使用同一个基础元数据路径，同时为每把剑、每款皮肤、每枚徽章或每个角色提供不同的元数据文件。

OpenZeppelin ERC-1155 Metadata URI 文档说明了代币专属 URI 如何指向符合 ERC-1155 Metadata URI JSON Schema 的 JSON 文件。

ERC-1155 元数据 JSON 示例

ERC-1155 元数据文件可以包含与 ERC-721 元数据相似的字段，也可以包含支持在一个合约中管理多种代币类型的属性。

这个示例描述了一件游戏物品，包含名称、描述、图片和结构化属性。

模式可以帮助客户端解析特定 ERC-1155 代币 ID 对应的媒体或元数据。

由于 ERC-1155 可以管理多种代币类型，当不同 ID 代表差异很大的资产时，元数据设计尤其需要清晰。

Token URI 与元数据 URI

token URI 是一个指针，用于告知应用在哪里可以找到 NFT 元数据。

对于 ERC-721，URI 通常来自

。

对于 ERC-1155，URI 通常来自

。

元数据 URI 可以采用多种格式。

HTTPS URI 指向 Web 服务器或 API 端点。

IPFS URI 指向由 IPFS 进行内容寻址的数据。

Arweave URI 指向存储在 Arweave 上的数据。

data URI 可以将元数据直接编码在 URI 本身中。

链上元数据函数可以直接从智能合约生成并返回元数据。

每种方案在成本、灵活性、持久性、速度和信任方面都有不同取舍。

良好的 NFT 元数据标准实现应确保 token URI 稳定、易读，并符合项目的长期存储计划。

常见 NFT 元数据字段

字段为 NFT 提供易于理解的名称。

字段用于说明 NFT 代表什么。

字段指向 NFT 的主图片。

字段通常用于视频、音频、HTML 动画或其他丰富媒体。

字段通常用于将用户引导至包含更多信息的官方页面。

字段通常用于记录特征、稀有度数据、等级、数据值、类别和其他结构化信息。

字段有时用于建议展示背景颜色。

项目可以根据应用特定数据需求添加自定义字段。

应记录自定义字段的说明，因为不支持这些字段的应用可能会忽略它们。

元数据应同时便于人和机器使用。

属性与特征

属性是 NFT 元数据中最重要的组成部分之一，因为它们描述了代币的独特之处或用途。

在头像系列中，属性可能包括背景、服装、眼睛、嘴巴、配饰和特殊效果。

在区块链游戏中，属性可能包括类别、等级、力量、耐久度、冷却时间、稀有度或技能类型。

在会员 NFT 中，属性可能包括等级、状态、地区、活动访问权限或忠诚度等级。

在数字艺术中，属性可能包括版本、色彩组合、生成方式、艺术家系列或材质风格。

规范的属性格式有助于钱包、区块链浏览器和分析工具正确展示特征数据。

这也有助于买家比较同一系列中的 NFT。

属性格式不规范可能引发混乱、导致稀有度排名错误，并造成不同应用中的显示不一致。

图片和媒体元数据

在许多 NFT 元数据文件中，image 字段是最显眼的部分。

该字段通常指向 PNG、JPEG、GIF、SVG 或其他图片格式。

对于媒体更丰富的 NFT，元数据还可能指向视频、音频、3D 文件、交互式媒体或基于 HTML 的体验。

项目应采用常见 NFT 应用能够安全、可靠展示的媒体格式。

大型文件可能会延长加载时间，尤其是在移动钱包或索引器中。

文件应使用明确的 MIME 类型和稳定的存储链接。

项目应避免使用不安全的脚本、可疑的外部重定向，或可能给用户带来安全问题的文件。

媒体质量很重要，因为元数据往往是用户在判断 NFT 是否有价值、是否实用或是否可信之前首先看到的内容。

链上元数据

链上元数据直接存储在智能合约中，或由智能合约生成。

由于用户可以在区块链上检查合约逻辑和数据，链上元数据可能更透明。

链上元数据也可以减少对外部服务器的依赖。

不过，链上存储可能成本高昂，尤其是存储大型图片、视频和详细 JSON 文件时。

因此，链上 NFT 通常使用精简 SVG 图片、生成式艺术逻辑、Base64 编码 JSON 或算法生成的元数据。

如果持久性和透明度比媒体大小或更新灵活性更重要，链上元数据可能是不错的选择。

如果 NFT 需要大型媒体文件、频繁更新或复杂的链下数据，链上元数据可能并不适合。

链下元数据

链下元数据存储在区块链之外，并通过 URI 引用。

这是最常见的模式，因为图片、视频、音频文件和 3D 资产可能过大，无法直接存储在链上。

链下元数据可以存储在中心化服务器、去中心化存储网络、分布式文件系统或永久存储协议中。

链下元数据的主要优点是灵活。

主要风险则是依赖存储服务提供方、服务器、网关或项目团队。

如果承载元数据的服务器离线，NFT 仍可能存在于链上，但在用户界面中看起来无法正常显示。

如果元数据托管在可变 API 上，项目可能无需更改区块链记录，就能改变用户看到的内容。

买家应了解元数据是中心化还是去中心化、是否不可变，以及是否由更新权限持有者控制。

IPFS 与 NFT 元数据

IPFS 广泛用于 NFT 元数据，因为它使用内容寻址，而不是基于位置的寻址。

官方 IPFS NFT 数据最佳实践介绍了创作者如何存储 NFT 数据，以改善持久性和用户体验。

在 IPFS 中，内容标识符会指向特定内容。

内容发生变化时，内容标识符也会随之改变。

这有助于用户验证元数据文件或媒体文件是否在同一个内容地址下被悄然更改。

不过，IPFS 内容仍需通过固定内容、存储服务、节点或其他持久化方案保持可用。

如果没有节点提供内容，IPFS 链接就无法发挥作用。

优秀的 NFT 项目应提前规划铸造后、揭晓后以及项目初期热度消退后，如何确保元数据和媒体持续可用。

中心化元数据

中心化元数据存储在服务器、云存储桶或由项目控制的 API 上。

这种模式易于构建和更新。

它可以支持动态 NFT、游戏数据、揭晓系统和频繁的元数据变更。

但这也会带来信任风险，因为项目方或服务器运营者可能有能力更改、删除或重定向元数据。

中心化服务器也可能故障、到期、遭到攻击，或变得维护成本过高。

中心化元数据并非总是不妥，但项目应清楚披露相关情况。

用户应了解 NFT 是否依赖项目运营的服务器才能正常显示。

采用中心化元数据的项目应保护基础设施、监控运行时间，并在条件允许时制定长期迁移计划。

不可变元数据

不可变元数据是指最终确定后无法更改的元数据。

这可以提升收藏者的信任，因为项目所有者或管理员钱包之后无法修改作品、特征和描述。

不可变元数据尤其适用于独一无二的艺术品、固定收藏品、历史记录、证书，以及买家期望代币呈现形式保持稳定的资产。

不过，不可变也可能意味着错误会永久保留。

如果项目锁定了含有拼写错误、媒体链接失效或特征不正确的元数据，可能无法修复，或修复难度很大。

项目在锁定元数据前应仔细检查并进行测试。

买家应检查系列的元数据是否已经锁定，或项目是否仍有更新权限。

可变元数据

铸造后仍可更改的元数据称为可变元数据。

它适用于 NFT 揭晓、游戏进度、进化型艺术、会员状态、忠诚度等级和动态身份系统。

游戏过程中，剑类 NFT 可能会获得新的数据值。

用户达到更高等级后，会员 NFT 可能从银级变为金级。

艺术类 NFT 可能会根据时间、用户操作或链上事件逐渐演变。

可变元数据可以支持丰富的体验，但也需要信任。

用户应了解谁有权更改元数据、可以更改哪些内容、是否存在最大变更范围，以及更新是否受透明规则约束。

如果可变元数据规则不明确，买家可能担心特征、图片或效用会被不公平地更改，从而降低信心。

通过 ERC-4906 发出元数据更新信号

ERC-4906 是 ERC-721 元数据更新扩展，可帮助应用获知元数据何时发生变化。

该标准为单个代币定义了

事件。

该标准还为连续的代币 ID 范围定义了

事件。

这些事件有助于钱包、索引器和 NFT 应用更高效地刷新缓存元数据。

这一点很重要，因为许多应用会缓存 NFT 元数据，以减少重复请求并提升性能。

如果没有标准更新事件，即使项目已经更改代币信息，应用也可能继续显示旧元数据。

ERC-4906 本身不定义元数据格式。

它只提供一种标准方式来通知外界元数据已经发生变化。

通过 ERC-7160 支持多个元数据 URI

有些 NFT 需要为同一个代币设置多个元数据 URI。

官方 ERC-7160 多元数据扩展提议让 ERC-721 代币支持多个元数据 URI。

当 NFT 具有不同状态、展示模式、版本、媒体层或元数据记录时，这种方式可能很有用。

例如，一个 NFT 可能有一个公开图片的元数据 URI、一个游戏状态的 URI，以及一个历史版本的 URI。

多元数据设计可以提高灵活性，但也需要用户界面提供明确支持。

如果用户不清楚哪个 URI 处于启用状态或被固定，多种元数据来源可能会造成混乱。

项目应说明为何存在多个元数据 URI，以及应用应如何解读这些 URI。

元数据缓存

元数据缓存是指应用保存一份 NFT 元数据副本，而不是每次都重新获取。

缓存可以提升速度并减少存储系统的负载。

但元数据发生变化时，缓存也可能造成延迟。

一个钱包可能显示新元数据，而另一个应用仍显示旧元数据。

索引器可能需要时间来检测更新事件、获取新的 JSON、处理媒体并刷新数据库。

因此，即使智能合约层面的元数据更新已经生效，在所有平台上显示出来仍可能需要时间。

ERC-4906 等标准事件可以减少这一问题，但应用仍需监听事件并更新缓存。

NFT 元数据与稀有度

由于特征通常保存在元数据中，元数据会影响稀有度。

如果项目使用属性描述背景、服装、物品类型、版本、等级或其他特征，稀有度工具可能会利用这些字段对 NFT 进行排名。

规范的元数据有助于进行稀有度分析。

不一致的元数据可能导致稀有度计算出错。

例如，一个代币的特征值可能写作

，另一个则写作 ，尽管两者表示的是同一种特征。

这类不一致可能导致工具将两种特征视为不同数值。

项目应在上线前统一特征名称、特征值、数据类型和拼写。

除非有明确、公平的更正流程，否则项目也应避免在售出后更改与稀有度相关的元数据。

NFT 元数据与效用

NFT 元数据可以描述效用，但不会自动赋予效用。

元数据文件可能会说明 NFT 能提供访问权限、等级状态、游戏战力、活动入场权或会员权益。

实际效用可能取决于智能合约、网站、游戏服务器、代币门控应用或链下协议。

这意味着元数据应准确且不具误导性。

如果项目在元数据中宣称某项效用，用户应能了解如何验证和使用该效用。

动态效用 NFT 应明确说明元数据更新由链上规则、项目服务器还是管理员手动操作控制。

优质元数据应帮助用户了解 NFT 的作用，同时避免对其未来价值作出过度承诺。

NFT 元数据与知识产权

NFT 元数据通常指向创意内容，但元数据本身不会自动确定版权归属。

购买 NFT 通常意味着购买一个代币，并不自动意味着同时获得关联作品、音乐、视频或品牌资产的版权。

美国版权局 NFT 研究报告指出，NFT 所有权与知识产权是不同的问题。

这一区别很重要，因为元数据可以展示图片或描述媒体资产，但法律权利通常取决于许可条款、项目条款或单独协议。

项目应避免在元数据中加入含糊或误导性的权利声明。

用户在将相关媒体用于商业用途前，应阅读 NFT 许可条款。

元数据可以帮助用户发现和查看内容，但除非项目明确如此设计，否则不应将其视为完整的法律合同。

NFT 元数据的安全风险

如果 NFT 元数据指向不安全文件、恶意网站或遭到入侵的服务器，就可能带来安全风险。

元数据字段中的外部 URL 可能会将用户引向网络钓鱼页面。

如果中心化存储遭到入侵，媒体文件可能会被替换。

动态元数据端点可能向不同用户返回不同内容。

项目管理员钱包可能滥用更新权限，在买家购买 NFT 后更改其特征、图片或链接。

应用应对元数据进行清理和校验，避免不安全的渲染行为，并保护用户免受可疑链接的影响。

项目应保护元数据更新权限、存储账户、部署密钥和 API 基础设施。

用户应避免通过不明 NFT 元数据中的链接签署钱包消息或连接钱包。

NFT 元数据标准的最佳实践

在 Ethereum 兼容网络上构建 NFT 时，项目应使用 ERC-721 元数据或 ERC-1155 元数据等广泛认可的标准。

项目应确保 JSON 有效、简洁且格式一致。

项目应使用清晰的字段名称，并避免添加不必要的自定义字段；如需添加，应提供相应说明。

项目应使用稳定的媒体链接，并在铸造前规划长期存储方案。

项目应在上线前通过多个钱包和 NFT 应用测试元数据。

项目应披露元数据是可变还是不可变。

项目应保护任何可以更新元数据的钱包、合约函数或服务器。

如果应用需要检测 ERC-721 元数据变化，项目应使用 ERC-4906 事件。

如果元数据更新会影响外观、特征、效用、稀有度或持有者预期，项目应保留公开的变更日志。

项目应避免利用元数据作出财务承诺或关于未来价值的误导性声明。

NFT 买家的最佳实践

条件允许时，NFT 买家应在购买前检查元数据。

买家应查看 token URI 指向的是 IPFS、HTTPS、链上数据还是其他存储系统。

买家应了解图片和 JSON 文件是永久保存、可变，还是依赖项目服务器。

买家应检查特征是否结构清晰且保持一致。

买家不应仅因元数据展示了作品，就认为 NFT 附带商业使用权。

如果元数据中的外部链接要求连接钱包，买家应保持谨慎。

买家应记住，展示出来的图片并不等同于价值保证、法律所有权或未来效用。

买家应将元数据质量视为多项考量因素之一，同时还应考虑安全性、流动性、创作者声誉、社区实力和项目执行情况。

NFT 元数据开发者检查清单

开发者应确定 NFT 使用 ERC-721、ERC-1155 还是其他代币标准。

开发者应针对所选标准实现正确的元数据函数。

发布前，开发者应验证每个 JSON 文件。

开发者应统一特征名称和数据类型。

开发者应根据项目对持久性的要求选择媒体存储方式。

开发者应决定元数据将被锁定、可更新、动态变化，还是完全存储在链上。

开发者应通过严格的访问控制保护更新函数。

在适当情况下，开发者应发出标准元数据更新事件。

开发者应测试 NFT 在钱包、区块链浏览器和索引工具中的显示效果。

开发者应记录所有元数据处理方式，避免用户之后感到意外。

关于 NFT 元数据标准的常见误解

一种常见误解是，NFT 元数据总是存储在链上。

实际上，许多 NFT 只在链上存储 URI，而 JSON 和媒体文件保存在链下。

另一种误解是，所有元数据字段都是官方必填项。

实际上，标准只定义了一些核心字段和接口，而许多常用字段只是普遍采用的惯例，并非严格要求。

第三种误解是，IPFS 元数据会自动永久保存。

IPFS 使用内容寻址，但内容仍需通过节点、固定服务或存储服务保持可用。

第四种误解是，元数据更新总是意味着发生了可疑事件。

有些更新很常见，例如揭晓、游戏进度、存储迁移或错误更正。

第五种误解是，元数据决定版权归属。

元数据可以描述资产，但法律权利取决于许可、条款和适用法律。

常见问题

什么是 NFT 元数据标准？

NFT 元数据标准是一套智能合约接口和元数据格式，可帮助应用读取并展示 NFT 的名称、图片、描述和特征等信息。

ERC-721 是主要的 NFT 元数据标准吗？

ERC-721 是主要 NFT 标准之一，其可选元数据扩展被广泛用于独特 NFT。

ERC-721 与 ERC-1155 元数据有什么区别？

ERC-721 通常通过

返回单个独特代币的元数据，而 ERC-1155 使用 ，并可在一个合约中管理多种代币类型的元数据。

NFT 元数据通常包含哪些字段？

NFT 元数据通常包含

、、 等字段，有时也包含 、 或 。

NFT 元数据必须存储在链上吗？

不必。NFT 元数据可以存储在链上或链下，许多 NFT 使用链上 URI 引用链下 JSON 文件。

为什么许多 NFT 使用 IPFS 存储元数据？

许多 NFT 使用 IPFS，因为内容寻址可以将元数据和媒体关联到特定内容标识符，而不是仅关联到服务器位置。

NFT 铸造后可以更改元数据吗？

可以。如果合约、URI、存储系统或元数据端点的设计允许更新，NFT 元数据就可以在铸造后更改。

什么是 ERC-4906？

ERC-4906 是一种 ERC-721 扩展，提供了用于通知 NFT 元数据发生变化的标准事件。

元数据可以证明版权归属吗？

不可以。元数据可以描述 NFT 的媒体或效用，但版权归属取决于法律权利、许可和项目条款。

高质量的 NFT 元数据有哪些特点？

高质量 NFT 元数据应有效、一致、透明、安全、便于索引、关联可靠的存储，并清楚说明是否可以更新。

结语

NFT 元数据标准至关重要，因为它将区块链所有权与用户对 NFT 的视觉、描述和功能信息需求联系起来。

ERC-721 和 ERC-1155 为 Ethereum 兼容 NFT 合约提供了最重要的元数据基础。

ERC-4906 帮助应用检测元数据变化，而 ERC-7160 等较新的扩展则支持更灵活的元数据设计。

优质 NFT 元数据应结构清晰、存储可靠，并如实说明相关信息。

它应帮助钱包、游戏、交易工具和用户理解代币代表什么，而不必依靠猜测。

对创作者和开发者而言，元数据标准可以提升互操作性并减少集成问题。

对买家和收藏者而言，元数据质量有助于判断 NFT 是否易于理解、持久、可靠，并符合其宣称的效用。

随着 NFT 在艺术、游戏、身份、会员权益、门票和代币化媒体等领域持续扩展，元数据标准仍将是加密 NFT 生态系统最重要的基础组成部分之一。