跳到正文
← 使用教程

OpenSea 的 Metadata 标签怎么读:分别核对 JSON 和图片存储

链小知 · 入门 · 核验 · 依官方文档整理

按目标资产记录五种标签,再用已有 URI/JSON 判断标签所指层级,避免把图片代理或上链名称当全部媒体上链。

开始前准备

  • 准备一个已知 NFT 的 OpenSea 页面、网络/合约/Token ID;如有项目公开的 token URI 和 JSON,也准备其取得时间。
  • 本篇按2026-02-02帮助页的Blockchain details/Metadata与当前ERC-721/1155标准说明;其他链或改版入口缺失时保留未知。查看公开页面/已有JSON不需要签名,未进入购买或元数据更新。

1. 锁定本次查看的单枚资产

从opensea.io打开目标NFT,先在About记下blockchain、collection contract address和token ID,再定位Blockchain details中的Metadata。截取包含资产定位与标签的同一记录,写明页面时间。

只凭图片找到的条目可能属于另一合约;若三项与预期不一致,先回到正确资产页。页面没有该字段时记录“标签未显示”,不要按合集里另一枚的标签代填。

检查结果:取得同一资产的三项身份、读取时间和标签是否可见。

2. 保留标签原文并拆开两种上链含义

记录实际英文标签,不把Fully onchain和Onchain metadata合并。前者指元数据与媒体都存在链上;后者指元数据引用或生成于链上,媒体仍可能由外部提供。

例如名称/算法在链上、image指向服务器时,单凭前一项不能结论为全部图片上链。把“元数据在哪里”和“媒体在哪里”写成两列,未知项留空并说明原因。

检查结果:两个存储层有各自状态,未由上链元数据推导全部媒体上链。

3. 用原始 URI 对照分布式、服务器或嵌入内容

在已有项目记录或已保存JSON中找原始token URI,按scheme记录https://、ipfs://、ar://、data:application/json;base64或web3://。官方存储说明分别展示服务器、IPFS、Arweave、内嵌JSON和EVM解析形式。

打开代理图或网关HTTP地址只能说明那条访问路径。优先保留原URI及其来源,再分别看JSON的image引用;data URI若只内嵌JSON、image仍是HTTPS,不可据此认定媒体也在链上。无需访问未知外部页面来补结论。

检查结果:原始URI、访问URL和JSON内媒体引用分别记录;无法取得原URI时只报告标签。

4. ERC-1155 的 URI 占位符先按规则替换

已有ERC-1155 uri若含{id},按token ID转为小写十六进制、去0x并左补零至64位后替换。官方例314592为4cce0,因此尾部是0004cce0;完整值按64位保存,不能直接把十进制314592填入模板。

ERC-721的tokenURI没有一律套用该替换规则。保留输入ID是十进制还是hex,最好使用大整数/字符串处理;如果不清楚代币标准,先标“URI解析规则待确认”,不自行生成媒体链接。

检查结果:占位替换以标准和ID为前提,完整64位值与原始模板可复核。

5. 对 Unknown 或分类冲突给出有限结论

Decentralized表示元数据在IPFS或Arweave;Centralized表示依赖传统服务器;Unknown表示程序没确定存储方法,可能是来源不识别或没有标准token URI。Unknown不是“没有NFT”或“元数据为零”。

OpenSea明确程序分类可能不准确。已有URI/JSON与标签冲突时,附上资产三项身份、页面记录和原URI交给项目方或支持排查;不要为消除差异去签名“验证资产”,也不要自行改标签当完成。

检查结果:结论区分标签读取、URI佐证和冲突待核;没有把标签当版权或真实性认证。

6. 整理可复查的存储记录

保存链+合约+ID、页面日期、标签原文、原URI、JSON媒体引用与证据缺项。分类说明与具体资产实际内容分开,不能由一个URL仍可访问保证未来永久可访问。

公开记录核对不执行链上交易。官方提到将元数据写到链上会增加gas,这是创建/更新存储的成本;本篇没有部署、修改、刷新或支付,也没有检查该资产所有权/当前交易权限。

检查结果:形成“标签与现有记录相符/存在冲突/证据不足”的结论,注明实际未读取的媒体与链上内容。

怎样确认完成

  • 目标资产的身份、标签与已有URI/JSON的存储层区别已记录,冲突和缺证项可追溯。
  • 指南依据官方文档整理;没有实际目标NFT、URI资源可用性或内容永久保存的验收回执。

常见错误与边界

  • 同一HTTP网关可能代取IPFS内容;域名外观不能代替原URI。
  • Fully onchain不等于合法版权、正版创作者或投资安全;算法分类仍可能有误。
  • 页面标签消失或Unknown均不是链上资产不存在的证明。

本教程根据官方资料整理,尚未完成逐步操作验收。界面、支持范围及费用变化时,先核对官方说明。 纯文本版 · 提交纠错依据