MRC-721

介绍

MRC-721 是一个基于 MetaID 的 NFT 专辑协议。尽管在 MetaID 协议中，每条数据均为 NFT，但我们仍需要一个专门的 NFT 专辑协议，以方便 NFT 以专辑方式展示和销售。本协议适用于各种 NFT 专辑，包括音乐 NFT 专辑、艺术创作 NFT 专辑、图书 NFT 专辑等。

---

协议格式

专辑

基础路径

/nft/mrc721/{collection_name}

MRC-721 采用路径区分不同的专辑，用户应该将 NFT PIN 创建在 /nft/mrc721/{collection_name} 下，即约定了相关 NFT 归属于专辑 {collection_name}，PIN 格式不限。

例如，用户要创建名字为“metabot”的 NFT 专辑，则需要将所有相关 NFT PIN 文件创建在 /nft/mrc721/metabot 路径下。

要点说明

1. 存放在 /nft/mrc721/ 路径下的所有 NFT 文件以及其他文件，均不接受 modify、revoke 和 hide 操作符。也就是说，MRC-721 协议下的所有文件都不能修改、撤销和隐藏。

2. {collection_name} 为任意字符，只要最后的路径符合 MetaID PIN 的路径规范即可。

---

专辑说明协议

路径

/nft/mrc721/{collection_name}/collection_desc

该协议为对其所在路径的专辑的说明和介绍。只有存在 collection_desc 协议文件的 NFT 专辑才会被后端索引器索引。

专辑说明协议格式

{
  "name": "the full name of the collection",
  "totalSupply": 5, // 该专辑的最大发行量，可接受值范围[-1~1e12]；默认值为 -1，表示无限制；可选
  "royaltyRate": 5, // 该专辑的销售版税设置，单位为百分比，5 即为 5%，范围 0-20，默认值为 0；可选
  "desc": "description of the collection", // 可选
  "website": "https://the-website-of-the-collection", // 可选
  "cover": "metafile://your-nft-cover-pinid", // 可选
  "metadata": "any data if needed" // 可选
}

要点说明

1. collectionid 为 collection_desc 协议的 PINID，collectionid 为专辑的索引值。

2. totalSupply 为专辑的最大发行量，索引器只索引专辑路径下与 totalSupply 值对应的 PIN。超过 totalSupply 数量的 PIN 视为不是该专辑的有效 PIN。例如，totalSupply 为 999，则只认为首先创建的前 999 个 PIN 为该专辑下的有效 PIN。

3. 每个专辑下只有一个 collection_desc 协议。如果一个 NFT 专辑有多个 collection_desc 协议，则只采用第一个，忽略后来的协议。

---

NFT Item 说明协议

路径

/nft/mrc721/{collection_name}/item_desc

该协议用于对专辑内各个 Item 的说明。此协议为可选项，是对相关 NFT Item 的补充性、额外性说明。即使缺失，也不会影响 NFT 专辑的创建和索引。

NFT Item 说明协议格式

{
  "items": [
    {
      "pinid": "the-pinid-of-nft", // 可选
      "name": "the-name-of-the-NFT-Item", // 可选
      "desc": "the description of the specific NFT", // 可选
      "cover": "metafile://your-nft-cover-pinid", // 可选
      "metadata": "any arbitrary data you can place here" // 可选
    }
    // 可重复添加 item 对象
  ]
}

要点说明

1. item_desc 是对专辑内各个 NFT 的描述性文件。

2. item_desc 为可选项，缺失时不影响后端索引器对该 NFT 专辑的索引。

3. 一个 NFT 专辑下允许存在多个 item_desc 协议文件。

4. 如有多个重复的 pinid，则采用先见原则。对于已存在的 pinid 的相关信息将忽略处理。

5. 如果 pinid 指向非本专辑的 pinid，则忽略处理。