链下元数据

什么是链下元数据？

链下元数据是指有关加密资产、NFT、代币、智能合约、游戏道具、数字身份记录或代币化现实世界资产的描述性信息。这些信息存储在区块链之外，并由链上记录引用。简单来说，区块链可能记录代币的所有者，而说明代币代表什么的元数据文件则存储在其他地方。对于 NFT，链下元数据可能包括名称、描述、图片链接、动画链接、属性、稀有特征、外部 URL、系列信息、许可文本、游戏属性或创作者信息。对于代币合约，链下元数据可能包括徽标、项目介绍、横幅、社交媒体链接、文档链接，以及钱包和区块链浏览器使用的显示信息。对于代币化现实世界资产，链下元数据可能包括法律文件、审计报告、抵押品参考信息、估值文件，或不应公开存储在链上的身份验证信息。

ERC-721 标准定义了一种可选的元数据扩展，其中 tokenURI 可以指向描述 NFT 的 JSON 文件。

ERC-1155 标准也定义了多代币合约的元数据 URI 行为，包括针对代币 ID 的 URI 替换机制。

链下元数据很常见，因为直接将大型文件存储在区块链上，成本可能很高，效率也较低。这种做法的代价是会带来存储、可用性、可变性和信任风险，用户在依赖相关资产前应了解这些风险。

链下元数据要点

• 链下元数据是存储在区块链之外的资产信息，并通过链上 URI、哈希、指针或合约函数引用。
• 链下元数据广泛用于 NFT、游戏资产、代币徽标、合约资料、代币化现实世界资产、凭证和收藏品元数据。
• 常见存储方式包括 HTTPS 服务器、IPFS、Arweave、Filecoin 支持的存储、云存储和私有数据库。
• 链下元数据可以降低区块链成本，因为较大的 JSON 文件、图片、视频和文档无需直接存储在合约存储空间中。
• 主要风险包括链接失效、服务器关闭、域名丢失、未经授权的修改、固定存储不足、审查、隐私泄露和误导性元数据。
• IPFS 等内容寻址存储可以提高完整性，因为内容变化时，内容标识符也会改变。
• 持久性不等同于内容寻址，因为文件仍需通过固定、托管或永久存储来保持可用。
• 动态元数据可用于游戏、不断演变的 NFT、会员资格和代币化资产，但需要完善的更新控制。
• 元数据不会自动证明版权、法律所有权、真实性或资产价值。
• 用户应始终检查元数据的存储位置、修改权限，以及媒体文件是否仍可获取。

链下元数据如何运作

链下元数据通常始于一个存储或返回 URI 的智能合约。URI 可能指向网站上的 JSON 文件、IPFS CID、Arweave 交易、去中心化存储对象，或其他外部数据位置。钱包、区块链浏览器、市场、游戏或分析工具会从区块链读取该 URI。随后，应用会从外部位置获取元数据。元数据文件会告诉应用如何显示该资产。例如，tokenURI 可能返回一个 JSON 文件链接，其中包含代币名称、描述、图片 URI、动画 URI 和属性。钱包会使用该 JSON 文件向用户显示 NFT 图片和特征。区块链确认代币 ID 的所有权。链下元数据则说明该代币 ID 应代表什么。这种分离方式很有用，但也意味着代币记录和描述性内容可能遵循不同的安全假设。

链下元数据与链上元数据

链下元数据存储在区块链之外。链上元数据则由智能合约或区块链交易直接存储或生成。链下元数据通常成本较低、更容易更新，也更适合存储大型文件。链上元数据通常更持久、更透明，也更少依赖外部基础设施。完全链上 NFT 可以直接从合约返回所有关键元数据。典型的链下 NFT 可能只在链上存储 tokenURI，而将 JSON 文件保存在其他位置。混合型 NFT 可能将重要且不可变的特征存储在链上，同时将媒体或扩展元数据存储在链下。最佳模式取决于资产的用途。永久生成艺术可能适合使用链上元数据。需要频繁更新的游戏道具可能适合使用受控的链下元数据。现实世界资产代币可能需要链下文件，因为私有法律文件不应永久公开。

加密项目为何使用链下元数据

加密项目使用链下元数据，是因为区块链并非为低成本存储所有大型文件而设计。图片、视频、音频文件、3D 模型、法律文件和游戏数据都可能远大于普通交易数据。将这些数据直接存储在链上，可能使铸造和更新成本高昂。链下存储可以让项目缩小区块链交易的数据量。它还允许应用加载丰富媒体，而无需所有区块链节点都存储大型资产文件。链下元数据还可以支持动态体验。游戏可以更新角色等级。会员 NFT 可以更改状态。代币化资产可以更新估值文件。凭证可以指向私有记录，而不必将敏感信息暴露在公共账本上。其优点是灵活，但代价是需要额外信任存储和更新系统。

常见的链下元数据字段

最常见的元数据字段是资产名称。描述字段用于说明资产代表什么。image 字段指向用于显示的视觉文件。在应用支持的情况下，animation_url 字段可以指向视频、音频、HTML 或交互式媒体。attributes 或 properties 字段用于描述特征、稀有度、等级、属性、类别或游戏数值。external_url 字段可以指向项目页面或资产页面。合约级元数据可以包括系列名称、符号、描述、资料图片、横幅图片、精选图片、外部链接和协作者。

草案ERC-7572 contractURI 标准提议通过 contractURI 函数提供合约级元数据。

优质的元数据字段应清晰、一致，并便于钱包和索引器解析。质量较差的元数据可能导致资产难以显示、验证或比较。

链下元数据与 tokenURI

tokenURI 是 NFT 元数据最重要的函数之一。在 ERC-721 中，tokenURI 会为特定代币 ID 返回独立的 URI。该 URI 可能指向描述 NFT 的 JSON 文件。在许多系列中，tokenURI 指向的是链下文件，而非直接从合约返回元数据。这种设计可以降低铸造成本，并提高媒体存储的灵活性。但它也使系统依赖 JSON 文件的存储位置。如果服务器消失，代币可能仍然存在于链上，但图片和描述可能无法加载。如果 JSON 文件发生变化，即使代币 ID 保持不变，显示的 NFT 也可能随之改变。评估 NFT 的长期质量时，用户应检查 tokenURI。URI 可以显示项目使用的是普通服务器、IPFS、Arweave 还是其他存储方式。

链下元数据与 ERC-1155 URI 替换

ERC-1155 是一种多代币标准，可以在一个合约中管理多种代币类型。ERC-1155 元数据 URI 模式可以将字符串 {id} 用作占位符。客户端软件会以标准化的十六进制形式，用实际代币 ID 替换该占位符。这样，一个 URI 模板就可以服务于多个代币 ID。例如，一个基础路径可以指向许多不同的元数据 JSON 文件。这种方式适用于游戏、版本系列、奖励系统和包含多种道具类型的收藏系列。这也意味着开发者必须正确组织链下文件。如果文件命名方式有误，钱包可能找不到正确的元数据。如果链下文件夹被移动或更改，许多代币可能同时无法正常显示。ERC-1155 元数据效率较高，但需要谨慎管理存储。

链下元数据与 IPFS

IPFS 是链下 NFT 元数据和媒体最常见的存储方式之一。

IPFS NFT 数据指南建议使用 IPFS URI，将智能合约链接到存储在 IPFS 上的外部数据。

IPFS 使用内容标识符（CID）根据文件内容识别文件。如果内容发生变化，CID 也会改变。如果目标是检测篡改，与普通网页 URL 相比，IPFS 在这方面更具优势。IPFS URI 可以明确表明文件采用内容寻址，而不是绑定到某个服务器位置。不过，IPFS 不会自动保证内容永久可用。数据仍需由保留副本的节点进行固定、托管或保存。IPFS 指南解释称，获取的副本可能只是临时副本，若未固定，最终可能被删除。因此，IPFS 可以提高完整性，但仍需规划持久性。

链下元数据与 Arweave

Arweave 是另一种用于加密元数据和媒体的存储网络。

Arweave 文档将 Arweave 描述为永久信息存储系统，以及开放账本中的去中心化网络。

一些项目会在希望以更强的持久性模式存储元数据或媒体时使用 Arweave。这可能适用于艺术品、档案、公共记录、历史资产以及承诺长期可用的收藏系列。从另一条区块链的角度看，Arweave 仍然是一个外部存储层。如果某条链上的 NFT 合约指向 Arweave 数据，所有权记录位于一条链上，而媒体或元数据则通过 Arweave 存储。相对于 NFT 所在的主链来说，这仍属于链下元数据。如果链接稳定且数据得到保存，这种设计可以较为可靠。用户仍应核实实际存储的内容、引用方式，以及存储的是元数据还是只有媒体文件。应谨慎核查永久存储的说法，因为营销措辞可能比实际技术方案更宽泛。

链下元数据与 Filecoin 支持的存储

Filecoin 支持的存储可用于增强链下元数据和媒体的持久性。IPFS 和 Filecoin 常被一起讨论，因为 IPFS 可以定位内容，而 Filecoin 可以通过存储交易和经济激励支持数据持续可用。项目可以使用 IPFS CID 进行内容寻址，并通过 Filecoin 存储来实现更长期的保存。这有助于解决完整性与可用性之间的差异。完整性意味着可以根据内容标识符验证文件。可用性意味着用户需要时确实能够获取文件。链下元数据需要兼顾这两点。如果没有人存储文件，再准确的 CID 也没有用。如果文件可以在不被察觉的情况下更改，那么可用性很高的服务器也不够可靠。优秀的元数据设计会兼顾内容可验证性和可靠获取能力。

HTTPS 元数据

HTTPS 元数据使用普通网页 URL 作为元数据位置。这种方式对开发者来说简单，应用也容易获取数据。它与普通浏览器和网络基础设施兼容性良好。问题在于，HTTPS 元数据通常依赖域名、服务器、云账户、访问策略和项目运营方。如果域名过期，元数据可能消失。如果服务器遭到攻击，元数据可能被替换。如果项目关闭 API，钱包可能无法正常显示资产。如果运营方更改 JSON 文件，即使链上没有更新，NFT 的显示内容也可能发生变化。HTTPS 存储适用于临时或动态资产，但对于承诺永久保存的资产而言，可靠性较弱。如果有价值的 NFT 或代币化资产仅依赖普通网页 URL，用户应保持谨慎。

链下元数据与中心化风险

中心化风险是链下元数据的主要弱点之一。有关 NFT 元数据中心化的研究发现，许多 NFT 元数据系统依赖中心化存储，可能因此面临审查、数据泄露、管理方修改和控制权丢失等风险。中心化服务器速度快、使用方便，但也可能成为单点故障。如果一家公司控制元数据服务器，该公司可能有能力改变资产的显示方式。如果云服务暂停账户，元数据可能无法加载。如果攻击者入侵服务器，用户可能看到恶意链接或假图片。如果项目消失，文件也可能随之消失。这并不意味着所有链下元数据都不好。它意味着存储架构应与资产所承诺的信任水平相匹配。声称永久保存的项目不应只依赖脆弱的中心化托管。

链下元数据与动态 NFT

动态 NFT 通常依赖链下元数据，因为其外观或属性可能随时间变化。游戏角色可能升级。体育收藏品可能更新数据。会员代币可能更改等级。现实世界资产代币可能更新文件状态。生成艺术作品可能在满足特定条件后展现新的状态。链下元数据可以让这些更新更容易，因为无需部署新合约即可更改 JSON 文件或 API。风险在于更新权限可能过于宽泛。如果发行方可以随时更改任何特征，买家可能无法真正确定自己持有什么。动态元数据应有明确规则、更新事件、访问控制和公开文档。灵活性不应演变为隐蔽控制。

元数据更新事件

元数据更新事件可以帮助应用了解何时刷新缓存的元数据。

ERC-4906 元数据更新扩展为 ERC-721 代币新增了 MetadataUpdate 和 BatchMetadataUpdate 事件。

这很有用，因为钱包和索引器通常会缓存元数据，而不是每次都重新获取。如果元数据发生变化但没有更新信号，用户可能仍会看到旧图片或旧属性。ERC-4906 还提醒，在涉及链下元数据修改时，权限控制很重要。这是因为元数据更新函数可能成为敏感的管理员权限。如果错误账户可以触发或控制更新，用户信任可能受损。使用动态链下元数据的项目应确保更新行为可预期。项目还应说明谁可以更新元数据，以及更新的原因。用户应检查元数据在铸造或购买后是否仍可能发生变化。

合约级链下元数据

合约级元数据描述的是合约或系列，而非单个代币 ID。其中可以包括系列名称、描述、资料图片、横幅图片、精选图片、外部链接和协作者。ERC-7572 提议使用 contractURI，让合约返回合约级元数据。返回的 contractURI 字符串可能指向链下资源，也可能返回链上 JSON 数据。这很重要，因为钱包和区块链浏览器通常需要丰富的合约信息，才能向用户展示相关内容。合约级元数据可以提升易用性，但如果被恶意更改，也可能误导用户。伪造或遭到入侵的合约元数据文件可能显示熟悉的徽标或名称。用户不应仅凭合约元数据作出信任判断。合约地址、源代码、发行方历史记录和官方沟通渠道仍然重要。显示信息应辅助验证，而非取代验证。

链下元数据与新的链上元数据标准

新型元数据标准表明，开发者正尝试降低链下存储带来的一些风险。

草案ERC-8049 提案定义了一种将合约级元数据存储在链上的标准。

该提案指出，合约元数据通常依赖链下 URL 或 IPFS，因此可能带来信任和可用性风险。ERC-8049 并不是所有链下元数据的通用替代方案。它表明生态正在朝着更清晰的合约身份和更可靠的钱包显示数据发展。一些项目仍会使用链下元数据，因为大型文件和私有文档不适合存储在链上。其他项目可能会将核心身份数据迁移至链上，只把大型媒体文件保留在链下。未来很可能采用混合型元数据。关键身份字段可能会变得更容易在链上验证。大型媒体、私有文档和频繁变化的数据可能仍保留在链下，并辅以更强的完整性证明。

链下元数据与揭示机制

许多 NFT 系列都采用揭示机制。揭示前，所有代币可能都指向同一个占位元数据。揭示后，每个代币都会获得独特的元数据。这种做法可以营造期待感，并减少提前针对特征进行狙击的行为。如果揭示过程不透明，也会产生信任问题。如果随机性和元数据分配机制处理不当，不诚实的团队可能不公平地分配稀有特征。项目可以通过公布元数据承诺、使用可验证随机数、锁定元数据哈希或清晰说明揭示流程来降低风险。链下元数据可以让揭示机制更容易实现，因为文件可以替换或更新。如果用户无法验证流程，同样的灵活性也可能引发质疑。公平的揭示机制应在用户铸造前就能被理解。

链下元数据与元数据冻结

元数据冻结是指在某个时间点后禁止进一步更改元数据。项目可能会在揭示后冻结元数据，让用户知道资产不会意外发生变化。冻结可以通过合约逻辑、不可变 URI 设置、内容寻址链接、存储承诺或永久存储上传实现。冻结可以让显示的资产更稳定，从而提升收藏者的信任。但冻结也可能将错误一并锁定。如果冻结前元数据存在链接失效、拼写错误、特征错误或许可不正确等问题，后续修复可能十分困难。项目应在冻结前仔细审查元数据。用户应确认元数据是否真正被冻结，而不是仅在营销中被称为最终版本。公开声明的约束力弱于可执行的技术控制。合约和存储方案应与项目的承诺相符。

链下元数据与代币化现实世界资产

代币化现实世界资产通常需要链下元数据，因为法律和金融记录可能很大、涉及隐私或受监管。代币可能代表对基金、发票、房地产、商品、债券、碳信用或其他现实世界权益的敞口。元数据可能引用说明权利、义务、审计、抵押品、到期日或赎回规则的文件。其中一部分信息可能公开。另一部分信息可能需要限制访问。将私有法律文件直接放在公共区块链上，可能造成隐私和合规问题。一种常见设计是在链上存储文档哈希，并将文档保留在链下。哈希有助于验证文档是否发生变化。出于法律、隐私或许可方面的原因，实际文件可以保留在受控存储中。对于现实世界资产，元数据应将区块链记录与具有法律效力的文件关联起来，而不是取代这些文件。

链下元数据与游戏

区块链游戏通常使用链下元数据，因为游戏资产可能经常变化。剑的威力可能提升。角色可能升级。玩家建造之后，土地可能发生变化。皮肤可能解锁新的视觉状态。频繁进行链上更新可能成本高、速度慢，因此游戏工作室可能会将变化中的元数据存储在链下。这可以让游戏体验更流畅。但这也意味着玩家必须信任游戏的更新规则。如果游戏可以随时更改道具属性，道具的经济价值也可能随之变化。良好的游戏元数据设计应区分永久所有权和可变的游戏状态。玩家应清楚哪些特征固定不变，哪些特征可能变化。

链下元数据与数字身份

数字身份系统可能使用链下元数据来保护隐私。凭证可能需要证明用户具有某种身份、会员资格、许可证或成就。凭证背后的原始个人数据通常应保留在链下。公共区块链通常不是存储护照号码、家庭住址、健康数据、就业档案或私有法律记录的合适地点。身份系统可能会改为在链上存储哈希、承诺、发行方引用或验证指针。详细的凭证元数据可以保留在链下，并按需选择性共享。这种设计有助于兼顾验证和隐私。但它也会依赖凭证发行方、存储服务提供商和访问系统。身份元数据应遵循数据最小化原则。只有确实需要公开验证的信息才应放在链上。

链下元数据与隐私

将敏感文件保留在公共账本之外，可以让链下元数据更好地保护隐私。不过，链下并不自动意味着私密。HTTPS 元数据文件仍可能是公开的。如果 IPFS 文件可用，知道 CID 的任何人都可能获取该文件。元数据文件可能暴露姓名、位置、会员资格、活动出席情况、钱包关联信息或私人图片。除非用户明确了解风险，否则项目绝不应在公共元数据中放入敏感用户信息。注重隐私的系统应考虑加密、访问控制、选择性披露、哈希和链下权限管理。用户应假设公共元数据可能被复制和存档。删除原始服务器上的文件，并不一定会移除所有副本。元数据隐私需要在发布前认真设计，而不是暴露后再补救。

链下元数据与版权

链下元数据不会自动证明版权归属。元数据文件可以声称 NFT 代表某张著名图片、某首歌曲、某个游戏道具或现实世界物品。这种说法可能不实。区块链可以证明某个钱包拥有某个代币，但不能自动证明铸造者对相关媒体拥有法律权利。image 字段可能指向被复制的艺术作品。description 字段可能包含误导性的许可说明。买家依赖项目网站后，该网站可能会消失。用户在认定自己拥有知识产权前，应核实创作者身份、许可条款、合约地址、铸造历史、官方文档和法律权利。对于高价值资产，法律协议可能比元数据文件更重要。元数据记录的是声明，但不会让所有声明都变成事实。

链下元数据与安全

如果用户过度信任显示信息，链下元数据就可能造成安全风险。恶意元数据文件可能包含网络钓鱼链接。遭到入侵的服务器可能将安全图片替换为恶意行动号召内容。假冒系列可能复制真实资产的名称、图片和描述。即使钱包显示熟悉的品牌，合约地址也可能是错误的。元数据更新可能在用户购买后改变资产表面呈现的身份。应用应将元数据视为不可信输入。应用应清理字段内容、提醒用户注意可疑链接，并避免执行元数据中的不安全代码。用户应验证合约地址，谨慎点击资产描述中的链接。如果资产的显示内容依赖链下文件，安全就不止涉及智能合约本身。

链下元数据与索引器

索引器读取区块链数据，并将其整理后提供给钱包、区块链浏览器、游戏、仪表盘和应用。元数据在链下时，索引器通常会获取 tokenURI 或 contractURI，并缓存返回的 JSON。这样可以提高速度，因为应用无需每次都获取所有元数据文件。如果元数据发生变化但索引器没有刷新，也可能造成数据过期。ERC-4906 等更新事件可以帮助索引器了解何时重新获取元数据。没有更新事件时，应用可能仍显示旧图片或旧特征。如果一个网关出现故障而另一个网关正常，不同索引器也可能显示不同内容。开发者应使用标准模式和明确的更新信号。用户应记住，钱包显示内容是对元数据的解读，而不是区块链本身。如果显示内容有误，查看源 URI 可能会有所帮助。

链下元数据与钱包显示

钱包高度依赖元数据来帮助用户理解代币。钱包可能根据链下元数据显示代币名称、图片、符号、系列、特征和描述。如果元数据缺失，钱包可能显示空白图片或未知资产。如果元数据加载缓慢，资产可能会延迟显示。如果元数据发生变化，钱包可能显示新图片或新特征。如果元数据包含恶意内容，钱包可能显示误导性信息。因此，元数据关系到用户体验和用户安全。代币的显示内容可能影响用户是否签署交易、接受报价或信任某个系列。钱包应尽可能显示合约地址和风险提示标记。用户不应只凭钱包中显示的图片作出判断。

链下元数据与 DAO

DAO 可能使用链下元数据保存提案、治理记录、会员徽章、金库资产和社区凭证。治理代币或 NFT 可能指向描述投票权、成员角色或参与历史的元数据。提案可能引用预算、法律备忘录、资助申请或项目计划等链下文件。将所有治理文件都存储在链上可能成本高昂，也可能暴露私人信息。链下元数据可以提高 DAO 治理的可行性。但提案文件可能会在投票者审阅后被更改。DAO 可以通过存储文档哈希、使用内容寻址链接和归档最终提案材料来降低这一风险。投票者应知道自己阅读的文件是否与最终获批文件一致。治理依赖清晰的记录。链下方式带来的便利不应削弱问责机制。

链下元数据与 AI 生成资产

AI 生成的资产可以使用链下元数据记录提示词、模型版本、生成日期、创作者钱包、许可和来源说明。这些信息可能过大或过于敏感，不适合全部存储在链上。链下元数据可以保留更丰富的生成记录。如果存储设计不完善，这些记录也可能被编辑或删除。元数据文件可能声称图片由某个模型或创作者生成。这种说法仍需验证。对于 AI 生成的 NFT，元数据应区分事实数据、创作者声明和法律权利。原始媒体或提示词包的哈希可以帮助证明文件未被更改。不过，哈希不能证明内容合法、原创或未侵犯其他主体的合法权益。AI 资产元数据应保持透明，但不应夸大其证明能力。

链下元数据的优势

链下元数据的第一个优势是成本更低。项目可以存储大型文件，而不必为每个字节支付区块链存储费用。第二个优势是灵活性。元数据可以支持动态资产、游戏更新、揭示、修正和不断变化的记录。第三个优势是支持丰富媒体。视频、音频文件、3D 模型和高分辨率图片更容易存储在链下。第四个优势是隐私控制。敏感文档可以保存在受控存储中，而不是放在公共账本上。第五个优势是性能更好。应用可以使用内容分发系统、网关或存储网络高效加载文件。第六个优势是更容易集成。钱包、区块链浏览器、游戏和索引器普遍能够识别 JSON 元数据和标准 URI。

链下元数据的风险和局限

第一个风险是链接失效。如果元数据 URL 不再可用，资产可能无法正常显示。第二个风险是未经授权的修改。如果元数据文件可以编辑，用户购买后资产仍可能发生变化。第三个风险是中心化。单个服务器或云账户可能成为故障点。第四个风险是可用性不足。如果没有人固定或托管 IPFS 内容，用户可能无法获取这些内容。第五个风险是隐私泄露。元数据可能暴露不应公开的信息。第六个风险是误导性声明。元数据可能声称拥有并不存在的权利、稀有度、真实性或资产背书。第七个风险是缓存不一致。不同钱包或索引器可能显示同一资产的不同版本。

链下元数据常见错误

一个常见错误是认为拥有 NFT 就意味着媒体存储在链上。许多 NFT 将所有权记录在链上，而元数据存储在链下。另一个错误是使用普通 HTTPS URL，却声称收藏系列会永久保存。第三个错误是使用 IPFS，却没有可靠地固定数据。第四个错误是更改元数据时没有触发更新事件。第五个错误是未披露就赋予某个管理员钱包无限的元数据控制权。第六个错误是在公共元数据中存储私有用户信息。第七个错误是把元数据当作版权的法律证明。第八个错误是在铸造前没有备份媒体文件。第九个错误是使用钱包无法读取的非标准字段。第十个错误是没有检查元数据在多个钱包和区块链浏览器中的显示效果。

给开发者的最佳实践

部署合约前先确定元数据存储模式。需要长期保证完整性时，使用内容寻址存储。链接 IPFS 内容时，使用 IPFS URI，而不是特定网关的 URL。使用可靠的基础设施固定 IPFS 元数据和媒体。如果资产承诺长期可用，应使用永久存储选项。如果重要的链下文档需要验证，应在链上存储哈希或承诺。元数据发生变化时，触发元数据更新事件。说明元数据是可变、已冻结、动态还是基于揭示机制。通过严格的访问控制保护元数据更新函数。避免在公共元数据文件中放入敏感个人数据。

给用户的最佳实践

购买高价值资产前，检查 tokenURI 或元数据位置。核实元数据使用的是 HTTPS、IPFS、Arweave 还是其他存储方式。检查 IPFS 内容是否已固定或以其他方式保存。查阅项目有关元数据冻结和更新控制的文档。验证合约地址，不要只相信显示的图片或名称。谨慎对待元数据描述中的外部链接。不要认为代币图片能够证明版权归属。在可能的情况下，使用区块链浏览器检查元数据函数。对于高价值资产，检查媒体和元数据是否可以通过多个独立路径获取。将元数据视为尽职调查的一部分，而不是价值的完整证明。

链下元数据适用场景

当文件过大、无法高效地存储在链上时，链下元数据很有用。当资产需要丰富的图片、视频、音频、3D 模型或交互内容时，它很有用。当元数据需要根据游戏状态、会员状态或现实世界事件发生变化时，它很有用。当法律或私有文档不应永久公开时，它很有用。当项目需要快速加载和广泛的应用支持时，它很有用。当内容寻址或永久存储可以提供较强的完整性和可用性时，它很有用。它适用于 NFT、游戏道具、代币化资产、身份凭证、DAO 记录和合约显示数据。如果项目承诺最高程度的持久性，却只依赖脆弱的服务器，那么链下元数据并不适用。如果更新控制不明确或权限过大，链下元数据也不太适用。如果公共元数据文件暴露敏感信息，则可能带来危险。

一句话了解链下元数据

链下元数据是存储在区块链之外、并由链上记录引用的加密资产信息。它让 NFT、代币、游戏、身份和现实世界资产数据变得更丰富、更经济、更灵活，同时也带来存储、信任、可用性和更新风险。

常见问题

链下元数据是什么意思？

链下元数据是存储在区块链之外，但由区块链代币、合约、URI、哈希或指针引用的资产描述信息。

链下元数据不好吗？

不一定。链下元数据可以降低成本并支持丰富媒体，但必须妥善存储和保护。

NFT 为什么使用链下元数据？

NFT 使用链下元数据，是因为图片、视频、JSON 文件和属性可能过大或成本过高，不适合直接存储在链上。

什么是 tokenURI？

tokenURI 是一种常见的 NFT 函数，会返回可查找特定代币 ID 元数据的 URI。

HTTPS 元数据有什么风险？

如果服务器、域名、云账户或项目运营方出现故障或遭到入侵，HTTPS 元数据可能失效或被更改。

IPFS 元数据属于链下元数据吗？

是。相对于代币所在的区块链，IPFS 元数据属于链下数据，但它可以通过内容寻址帮助验证文件完整性。

IPFS 能保证内容永久可用吗？

不能。IPFS 通过 CID 标识内容，但仍需固定、托管或保存内容，用户之后才能获取。

链下元数据可以更改吗？

可以。如果项目或服务器控制相关文件，链下元数据就可能被更改；除非设计采用不可变链接、元数据冻结或强有力的承诺机制。

什么是动态元数据？

动态元数据是指根据更新、游戏状态、成就、预言机数据、会员状态或发行方规则随时间变化的元数据。

元数据能证明版权归属吗？

不能。元数据可以描述资产或声明权利，但版权和法律所有权取决于许可、合同、发行方权限及适用法律。

用户如何验证链下元数据？

用户可以检查 tokenURI 和存储方式，验证内容哈希或 CID，查看更新权限，并测试元数据和媒体是否可以获取。

较安全的链下元数据设计是什么？

较安全的设计会采用标准元数据模式、内容寻址存储、可靠的持久性方案、链上哈希或承诺、明确的更新控制，并如实披露哪些内容可以更改。

结论

链下元数据是加密资产中最常见的设计选择之一，因为它让项目能够将区块链所有权与丰富、易读的信息关联起来。没有元数据时，代币可能只有一个地址、代币 ID 和余额。有了元数据，用户便可以看到名称、图片、描述、特征、文档、媒体和背景信息。链下元数据如此普遍，原因很实际。区块链并不适合存储大型文件，存储成本也很高。链下系统可以更经济、灵活地存储 JSON 文件、图片、视频、游戏数据、法律文件和身份记录。这让 NFT、代币化资产、游戏、凭证和合约资料更容易构建和展示。然而，链下元数据会改变信任模式。区块链可能保障所有权，但资产的含义可能取决于外部文件。如果该文件消失、被更改或无法获取，用户体验和资产价值都可能受到影响。普通网络服务器易于使用，但对于长期存在的加密资产而言较为脆弱。IPFS 通过内容寻址提高完整性，但仍需规划文件固定和可用性。Arweave 和其他持久存储系统可以改善长期访问能力，但用户仍应验证实际存储和引用的内容。动态元数据可以让资产更实用，但如果更新权限管理不明确，也可能形成隐蔽控制。对开发者而言，最稳妥的做法是从一开始就诚实地设计元数据。使用钱包和索引器能够识别的标准。需要保障完整性时，使用内容寻址存储。链下文档需要验证时，存储哈希或承诺。元数据发生变化时，触发更新事件。保护更新权限。避免在公共文件中放入敏感个人数据。对用户而言，最稳妥的做法是在信任资产前检查存储方式。钱包中显示的图片再精美，也不足以作为判断依据。重要的问题包括：元数据存储在哪里、是否可以更改、由谁控制、是否可以获取，以及相关法律声明是否属实。链下元数据本身并非缺陷。它是一种权衡。谨慎使用时，它能让加密资产更具表现力、更经济且更实用。使用不当时，它可能让区块链资产变成失效链接、误导性图片或无法验证的承诺。