NFT 元数据

什么是 NFT 元数据？

NFT 元数据是描述非同质化代币所代表内容的结构化信息。

在加密领域，NFT 用于证明某个独特代币在区块链上的所有权，而元数据则说明与该代币相关的可见、可读和功能性信息。

元数据可以包括 NFT 的名称、描述、图像、视频、音频、动画、特征、稀有度属性、游戏数据、外部链接，以及钱包、市场、游戏和区块链应用向用户展示的其他属性。

没有元数据，NFT 仍可能存在于链上，但用户可能不知道该代币代表什么，也不清楚它为何具有价值。

例如，智能合约可以显示钱包 A 拥有 token ID 100，但元数据会告诉用户 token ID 100 是数字艺术品、游戏中的剑、会员通行证、门票、音乐收藏品，还是其他类型的加密资产。

NFT 元数据通常通过 URI 与代币关联。URI 是 NFT 智能合约返回的链接或引用。

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

函数。

对于 ERC-1155 NFT，官方 ERC-1155 标准通过

函数定义了元数据 URI 系统。

这些标准帮助应用以可预测的方式读取 NFT 数据，无需猜测每个项目存储代币信息的方式。

NFT 元数据为何重要

NFT 元数据之所以重要，是因为它将区块链上的所有权与用户能够理解的内容联系起来。

区块链记录之所以重要，是因为它会跟踪所有权、转账、授权和智能合约规则。

元数据之所以重要，是因为它解释了所有者、买家、收藏者或玩家实际看到的资产内容。

钱包可以利用元数据显示 NFT 的图像和名称。

市场可以利用元数据展示特征、描述和系列详情。

游戏可以利用元数据读取物品类型、等级、稀有度、耐久度或能力数据。

代币门控社区可以利用元数据核验会员等级或访问权限。

分析工具可以利用元数据比较特征、稀有度、地板价和系列趋势。

如果元数据缺失、损坏、具有误导性或结构不佳，NFT 使用体验就可能变得混乱，可信度也会降低。

因此，完善的元数据设计是推出成熟 NFT 项目最重要的环节之一。

NFT 元数据如何运作

大多数 NFT 使用智能合约存储所有权数据，并使用元数据文件存储描述性数据。

应用请求代币元数据时，智能合约通常会返回一个 token URI。

token URI 可能指向存储在 IPFS、Arweave、中心化服务器、云存储系统或其他存储层上的 JSON 文件。

应用会获取 JSON 文件、读取元数据字段，并向用户展示 NFT。

一个简单的 NFT 元数据流程从智能合约开始。

钱包调用

或 。

合约返回元数据链接。

钱包获取元数据文件。

钱包读取名称、图像、描述和属性。

随后，钱包以便于用户理解的形式显示 NFT。

这个过程看似简单，但依赖正确的智能合约代码、有效的 JSON、可靠的存储、安全的媒体文件以及应用支持。

常见 NFT 元数据字段

字段为 NFT 提供便于用户理解的名称。

字段用于说明 NFT 代表什么、可能如何使用，或它有何特别之处。

字段指向主要视觉素材，例如 PNG、JPEG、GIF、SVG 或其他图像文件。

字段通常用于视频、音频、HTML 动画、3D 文件或交互式媒体。

字段可以将用户引导至介绍 NFT 更多信息的官方页面。

字段通常用于描述特征、稀有度因素、等级、类别、能力、分数和其他结构化数值。

字段有时用于为显示界面指定建议的背景颜色。

如果项目需要为游戏、会员系统、身份工具或其他加密应用提供特殊数据，也可以添加自定义字段。

自定义元数据可能很有用，但应提供清晰的文档，因为许多钱包和市场可能会忽略自己无法识别的字段。

NFT 元数据 JSON 示例

NFT 元数据通常以 JSON 对象的形式编写，因为 JSON 易于应用读取，也便于开发者生成。

此示例包含名称、描述、图像、动画文件、外部页面和属性。

和 字段使用 IPFS 风格的链接，这种链接常见于希望使用内容寻址存储的 NFT 项目。

数组为应用提供结构化数据，可用于展示、筛选、搜索或稀有度计算。

实际的 NFT 元数据文件可以更简单或更复杂，具体取决于资产类型。

ERC-721 元数据

ERC-721 是 Ethereum 上用于独特 NFT 的主要代币标准之一。

它常用于数字艺术、头像系列、收藏品、虚拟土地、证书、门票、会员资格和独一无二的代币化资产。

ERC-721 元数据扩展包含 3 个重要函数：

、 和 。

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

函数返回 NFT 系列或合约的简短代码，形式类似代币代码。

函数返回特定 token ID 对应元数据的 URI。

ERC-721 元数据通常将每个代币视为独一无二的个体。

当每个 NFT 都需要拥有自己的艺术作品、特征、描述、稀有度信息或媒体文件时，ERC-721 就很有用。

例如，token ID 1 可以指向一个 JSON 文件，而 token ID 2 可以指向另一个 JSON 文件。

即使两个代币属于同一个智能合约，每个 JSON 文件仍可以描述不同的物品。

ERC-1155 元数据

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

它常用于区块链游戏、数字物品、徽章、不同版本的物品、门票、奖励资产以及包含多种代币类型的系列。

ERC-1155 使用

函数返回特定 token ID 的元数据。

该标准还支持

替换模式。

当 ERC-1155 元数据 URI 包含

时，客户端应用会将其替换为实际 token ID，并将其转换为小写十六进制形式，再填充至 64 个字符。

这种方式让 ERC-1155 元数据适用于大型系列，因为一种 URI 模式就能服务多个 token ID。

例如，游戏合约可以为剑、盾牌、药水、徽章和角色皮肤使用同一种元数据 URI 模式。

每个 token ID 仍可对应一个具有不同属性的 JSON 文件。

如果项目需要在一个合约下管理多种物品，而不是为每种物品部署新合约，ERC-1155 元数据尤其有用。

NFT 元数据与 IPFS

IPFS 是 NFT 元数据和媒体文件最常用的存储系统之一。

官方 IPFS NFT 数据最佳实践介绍了 NFT 创作者如何在 IPFS 上存储数据，以支持长期访问并改善用户体验。

IPFS 使用内容寻址，这意味着内容通过其内容本身进行引用，而不是通过托管位置进行引用。

内容标识符（CID）指向特定内容。

官方 IPFS 内容寻址文档介绍了 CID 如何用于处理内容寻址数据。

如果元数据文件发生变化，CID 也会随之变化。

这有助于用户和应用检测内容是否已被更改。

NFT 元数据的 IPFS URI 可能类似于

。

元数据文件随后可能指向类似

的图像。

使用 IPFS 可以减少对单一中心化服务器的依赖，但并不自动保证内容永久可用。

官方 IPFS 持久化与固定文档说明，应固定内容以帮助其长期保持可用。

链上元数据

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

由于用户可以在区块链上查看元数据逻辑，这种方式可以提高 NFT 的透明度。

链上元数据还可以减少对外部服务器、网关和存储服务提供商的依赖。

然而，在链上存储大型图像、视频、音频文件和详细元数据可能成本高昂。

因此，完全链上的 NFT 通常使用精简的 SVG 文件、Base64 编码的 JSON、生成式艺术逻辑或简单的文本元数据。

当持久性和透明度比文件大小和更新灵活性更重要时，链上元数据就很有用。

对于大型媒体系列、高分辨率图像、3D 资产或频繁变化的游戏数据，链上元数据可能不太实用。

一些 NFT 项目采用混合模式，将重要特征存储在链上，而大型媒体文件存储在链下。

链下元数据

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

这是 NFT 最常见的模式，因为媒体文件可能过大，或直接存储在链上的成本过高。

链下元数据可以存储在 IPFS、Arweave、去中心化存储网络、中心化服务器、云存储或项目运营的 API 上。

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

项目可以存储丰富的媒体内容、大型 JSON 文件、游戏数据和动态内容，而无需支付高昂的链上存储成本。

主要风险在于依赖性。

如果存储系统发生故障、服务器消失、网关无法访问，或项目停止维护数据，即使代币仍然存在，NFT 也可能无法正常显示。

优秀的 NFT 项目应说明元数据的存储位置、是否可以更改，以及如何确保数据长期可用。

中心化元数据

中心化元数据托管在普通服务器、云端接口或项目控制的 API 上。

这种方式可能速度快、操作简单且灵活。

它适用于动态 NFT、游戏资产、揭晓机制、会员等级，以及需要频繁更新的应用。

然而，中心化元数据会带来信任风险，因为服务器运营方可能有能力更改或删除数据。

如果 NFT 只指向一个中心化 URL，用户就必须信任托管方会持续提供文件，且不会更改文件内容。

中心化服务器也可能遭到黑客攻击、关闭、审查、重定向或被遗弃。

中心化元数据并非总是不妥，但应明确披露。

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

不可变元数据

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

这可以增强信任，因为买家知道艺术作品、特征、描述和媒体引用之后不会被悄悄替换。

不可变元数据对于独一无二的艺术品、历史收藏品、证书、记录和固定发行量的系列尤其有价值。

然而，不可变性也可能让错误永久存在。

如果项目锁定元数据时存在错别字、链接损坏、特征错误或图像不正确，之后可能难以甚至无法修正。

项目应在锁定元数据前仔细测试。

收藏者应确认元数据是否已锁定，或管理员是否仍能更新元数据。

不可变元数据可以增强信心，但前提是元数据在永久固定前准确无误。

可变元数据

可变元数据可以在铸造后更改。

它适用于 NFT 揭晓、演变型艺术作品、游戏物品、会员等级、忠诚度徽章、活动通行证和动态身份系统。

例如，游戏角色 NFT 可能会随着游戏进度升级。

会员 NFT 可能会在持有者升至更高等级时更换图像。

活动 NFT 可能会在出席情况得到验证后更新。

动态艺术 NFT 可能会根据时间、钱包活动或链上事件发生变化。

可变元数据可以带来更多互动式 NFT 体验，但也会引发信任问题。

用户应了解谁可以更新元数据、可以更改哪些内容、更改是否受限制，以及更新规则由代码还是管理员钱包控制。

明确的更新规则十分重要，因为意料之外的元数据更改可能损害收藏者的信任和市场价值。

动态 NFT 元数据

动态 NFT 元数据会根据规则、事件或外部数据发生变化。

这让 NFT 更适用于游戏、身份、会员资格、体育收藏品、忠诚度计划和现实世界资产跟踪。

用户完成任务后，动态 NFT 可能会显示不同的属性。

持有者参加活动后，NFT 可能会更新。

玩家升级物品后，NFT 可能会发生变化。

预言机提供更新数据后，NFT 可能会显示新的信息。

动态元数据可以让 NFT 更具活力，但也需要谨慎设计。

项目应说明哪些因素会触发更新、用户是否可以验证更新逻辑，以及外部数据源发生故障时会如何处理。

动态 NFT 应避免对价值、用途或权利作出误导性表述。

NFT 元数据更新事件

由于许多应用会缓存 NFT 元数据，更新可能不会立即显示在所有钱包、市场和索引器中。

ERC-4906 通过为 ERC-721 NFT 提供标准元数据更新事件，有助于解决这一问题。

官方 ERC-4906 元数据更新扩展定义了

和 。

事件表示某个代币的 JSON 元数据已发生变化。

事件表示一段连续范围内的 token ID 已发生变化。

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

ERC-4906 不定义元数据本身的内容。

它只是为智能合约提供一种标准方式，用于通知外界元数据已经发生变化。

多个元数据 URI

某些 NFT 可能需要为同一个代币提供多个元数据 URI。

官方 ERC-7160 多元数据扩展提出了一种方法，让 ERC-721 代币支持多个元数据 URI。

对于包含不同版本、状态、语言、显示模式、历史记录或特定应用数据的 NFT，这种方式可能很有用。

例如，某个 NFT 可以有一个用于公开艺术作品的 URI、一个用于游戏数据的 URI，以及一个用于历史版本的 URI。

多个元数据 URI 可以提高灵活性，但如果用户不清楚哪个 URI 当前有效或属于官方来源，也可能造成混乱。

使用多个元数据来源的项目应说明每个 URI 的解释方式。

NFT 元数据与稀有度

NFT 系列中的稀有度数据通常来自元数据。

背景、服装、武器类型、版本编号、颜色、类别、等级和配饰等特征通常存储在元数据属性中。

稀有度工具可以读取这些属性，并计算每种特征在整个系列中出现的频率或稀有程度。

这意味着元数据质量会直接影响用户对 NFT 价值的理解。

如果特征名称不一致，稀有度排名就可能不准确。

例如，某些工具可能会将

、 和 视为不同的值。

如果特征缺失或分配错误，买家可能会误判 NFT 的稀有度。

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

如果用户已经购买 NFT，项目在更改稀有度相关元数据时也应格外谨慎。

NFT 元数据与媒体文件

NFT 元数据通常会指向用户可以查看、收听或互动的媒体文件。

这些媒体文件可以包括图像、视频、音轨、3D 模型、动画、文档或交互式 HTML 体验。

媒体文件和元数据文件不一定存储在同一位置。

JSON 元数据文件可能存储在 IPFS 上，而图像存储在另一个 IPFS CID 下。

项目也可能使用一种存储方式保存缩略图，并使用另一种方式保存高分辨率媒体。

媒体文件应稳定、安全，并兼容常见的 NFT 应用。

文件过大可能会导致加载速度缓慢，尤其是在移动钱包中。

不安全的脚本、可疑重定向和具有误导性的外部链接可能带来安全风险。

项目应在铸造或揭晓 NFT 前，测试媒体在多个应用中的显示效果。

NFT 元数据与所有权

NFT 元数据本身并不控制代币所有权。

所有权通常记录在智能合约中。

元数据描述与代币关联的资产。

如果 Alice 将 NFT 转给 Bob，所有者会发生变化，但元数据可能保持不变。

如果游戏将一把剑 NFT 从 3 级升级到 4 级，元数据会发生变化，但所有者可能保持不变。

这一区别很重要，因为用户有时会混淆代币、元数据和媒体文件。

代币是区块链资产。

元数据是结构化描述。

媒体文件是元数据引用的图像、视频、音频或其他内容。

完整的 NFT 体验依赖这三个层面协同运作。

NFT 元数据与知识产权

NFT 元数据可以描述艺术作品、音乐、视频、游戏内容、品牌资产、文字或其他创作作品。

然而，购买 NFT 并不自动意味着买家拥有相关媒体的版权。

美国版权局和 USPTO 的 NFT 研究指出，NFT 所有权与知识产权可能涉及不同的问题。

这意味着元数据可以展示或描述创作内容，但并不代表买家获得完整的法律权利。

项目可能授予个人展示权、商业使用权、游戏使用权，也可能不授予除代币所有权之外的任何特殊权利。

相关权利应在项目许可协议或条款中说明。

用户不应认为 NFT 元数据中的图像意味着自己有权销售周边商品、创作衍生作品或将内容用于商业用途。

创作者应避免使用含糊的元数据表述，以免混淆代币所有权与版权所有权。

NFT 元数据与版税

NFT 元数据不同于 NFT 版税信息。

元数据描述代币的内容、特征和媒体。

版税标准描述 NFT 出售或转售时应由谁获得创作者付款。

Ethereum 上最广为人知的版税标准是 ERC-2981。

ERC-2981 通过智能合约函数返回版税信息，而元数据通常通过 token URI 返回。

有些项目可能会在元数据中附带版税说明，但正确的版税信息应来自项目使用的合约或版税系统。

用户应了解，仅凭元数据并不能保证支付版税或强制执行版税。

NFT 元数据与安全风险

NFT 元数据可能带来安全风险，因为应用通常会从外部来源获取并显示内容。

元数据文件可能包含指向钓鱼网站的链接。

媒体文件可能来自已遭入侵的服务器。

中心化元数据端点可能向不同用户返回不同内容。

管理员钱包可能会更新元数据，损害持有者的利益。

虚假系列可能会复制正版图像，并利用元数据伪装成真品。

应用应将元数据视为不可信输入，并避免不安全的渲染行为。

项目应保护存储账户、更新函数、管理员钱包、API 和部署密钥。

用户应避免通过 NFT 元数据中的未知链接连接钱包。

用户在与可解锁内容或外部页面互动前，还应核实项目的官方来源。

NFT 元数据链接失效

元数据链接失效是影响 NFT 质量的主要问题。

如果 token URI 不再有效，钱包可能无法显示 NFT。

如果图像链接失效，NFT 可能显示为空白或损坏文件。

如果元数据服务器下线，用户可能无法访问描述、特征和媒体引用。

如果某个 IPFS CID 未固定，也没有任何节点提供服务，相关内容可能无法访问。

元数据损坏并不一定会销毁链上代币，但可能降低用户信任和市场价值。

项目应监控元数据的可用性并保留备份。

收藏者应记录有价值 NFT 的重要 token URI 和 CID。

NFT 元数据缓存

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

缓存有助于应用更快加载并减少重复请求。

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

项目可能已经更新某个代币的元数据，但钱包在刷新缓存前仍会显示旧版本。

因此，用户有时会在不同应用中看到不同的 NFT 图像或特征。

ERC-4906 可以帮助应用检测更新，但应用仍需监听事件并刷新数据。

元数据更改未立即显示时，问题可能出在缓存，而不是智能合约更新失败。

NFT 创作者的最佳实践

NFT 创作者应在上线前决定元数据将采用不可变、可变还是动态模式。

创作者应清楚说明元数据政策，让买家知道哪些内容可以更改，哪些不能更改。

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

发布 JSON 文件前，应先验证其有效性。

应统一特征名称、数值、拼写和数据类型。

应通过可靠的存储系统保存媒体和元数据。

如果长期内容寻址很重要，应使用 IPFS URI 或其他持久引用。

应固定 IPFS 内容并保留备份。

应保护任何可以更新 token URI 或元数据的函数或钱包。

如果钱包和索引器需要检测元数据变化，应使用元数据更新事件。

应避免对稀有度、所有权权利、用途或未来价值作出误导性表述。

NFT 买家的最佳实践

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

应确认 token URI 指向 IPFS、HTTPS、链上数据还是其他存储系统。

应了解元数据是固定的还是可以更改。

应查看图像和媒体文件是否存储可靠。

对于完全依赖未知中心化服务器的 NFT，应保持谨慎。

不要认为元数据会赋予自己版权或商业使用权。

应检查特征是否一致，以及稀有度信息是否有元数据支持。

避免点击 NFT 描述或元数据字段中的可疑外部链接。

请记住，吸引人的元数据并不能保证流动性、盈利、法律权利或项目长期成功。

常见 NFT 元数据错误

一种常见错误是使用无效 JSON，导致应用无法读取。

另一种常见错误是链接到未固定、未备份或托管不可靠的媒体文件。

第三种错误是在同一系列中使用不一致的特征名称。

第四种错误是售出后更改元数据，却未向持有者说明原因。

第五种错误是使用中心化元数据，却声称 NFT 完全去中心化。

第六种错误是只将媒体存储在 IPFS 上，却把元数据文件留在脆弱的服务器中。

第七种错误是使用过大的文件，导致钱包和移动应用加载缓慢。

第八种错误是在项目未发布清晰权利条款时，将元数据当作法律许可。

第九种错误是让单个管理员钱包不受限制地更改元数据，却没有上限、时间锁、多重签名流程或公开政策。

第十种错误是在铸造或揭晓前没有测试元数据显示效果。

如何查看 NFT 元数据

用户可以读取 NFT 智能合约中的 token URI 来查看 NFT 元数据。

通常可以通过区块链浏览器、钱包工具、合约读取页面或 NFT 分析工具完成。

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

。

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

。

找到 URI 后，用户可以打开元数据文件；如有需要，也可以通过 IPFS 网关转换 IPFS URI。

随后，用户可以查看

、、、 和 等字段。

如果元数据指向媒体文件，用户也可以查看这些媒体链接。

这个过程有助于用户了解 NFT 信息的来源，以及元数据是否完整、可靠。

NFT 元数据的 SEO 和 AEO 摘要

NFT 元数据是说明 NFT 代表内容的结构化数据。

通常包括名称、描述、图像、特征和媒体链接。

ERC-721 NFT 通常使用

返回独特代币的元数据。

ERC-1155 NFT 通常使用

返回多代币资产的元数据。

IPFS 广泛用于 NFT 元数据，因为它支持通过 CID 创建内容寻址链接。

元数据可以是链上、链下、中心化、去中心化、不可变、可变或动态的。

优质元数据可以改善 NFT 的显示效果、发现体验、稀有度分析、游戏用途和用户信任。

元数据质量差可能导致图像损坏、特征错误、所有权权利不明确、安全风险，以及用户对 NFT 项目的信心下降。

常见问题

NFT 元数据是什么意思？

NFT 元数据是描述 NFT 的结构化信息，包括名称、图像、描述、特征、媒体链接和其他属性。

NFT 元数据存储在哪里？

NFT 元数据可以存储在链上、IPFS、Arweave、中心化服务器、API 或 NFT 智能合约引用的其他存储系统中。

NFT 元数据存储在区块链上吗？

有些 NFT 元数据存储在链上，但许多 NFT 只将元数据 URI 存储在链上，而将 JSON 和媒体文件保存在链下。

什么是 token URI？

token URI 是 NFT 智能合约返回的链接或引用，用于告知应用 NFT 元数据的存储位置。

NFT 元数据包含哪些内容？

NFT 元数据通常包含

、、、、 和 等字段。

NFT 元数据可以更改吗？

如果合约、存储系统或元数据端点允许更新，NFT 元数据就可以更改。

什么是不可变 NFT 元数据？

不可变 NFT 元数据是指确定或锁定后无法更改的元数据。

什么是动态 NFT 元数据？

动态 NFT 元数据是指会根据规则、事件、游戏进度、用户操作或外部数据发生变化的元数据。

NFT 元数据能证明版权所有权吗？

不能。NFT 元数据描述代币内容，但版权所有权取决于许可协议、相关条款和适用法律。

NFT 元数据为何会影响价值？

NFT 元数据会影响用户如何查看资产、理解特征、核验稀有度、使用其功能以及信任项目的长期质量，因此可能影响其价值。

结语

NFT 元数据是 NFT 生态系统中最重要的组成部分之一，因为它赋予了区块链代币所有权以具体含义。

智能合约可以证明某个钱包拥有一个代币，而元数据则解释该代币代表什么。

优质元数据有助于钱包、市场、游戏、索引器和用户正确展示并理解 NFT。

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

IPFS 和其他存储系统帮助项目在区块链之外存储元数据和媒体，同时仍可将其与链上代币关联。

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

优质 NFT 元数据应有效、清晰、一致、安全、持久，并如实说明哪些内容可以更改。

创作者应在铸造、揭晓或更新系列前仔细规划元数据。

买家应了解元数据的存储位置、是否可变，以及它实际代表哪些权利或用途。

随着 NFT 持续拓展至艺术、游戏、会员资格、身份、门票和代币化媒体领域，元数据仍将是连接区块链所有权与真实用户体验的关键层。