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均不是链上资产不存在的证明。