加密货币

前言

因为一些机缘，我最近和几个同行朋友一起提交了一个新的 EIP 协议标准，EIP-6150，这是一个支持层级结构的 NFT 协议标准，撰写此文时处在 Review 状态，改为 Last Call 状态的 PR 还在等待通过。

该协议标准有 4 位作者：Keegan Lee、msfew、Kartin 和 qizhou。Keegan Lee 就是我，主要负责了接口的定义和实现代码的编写。Kartin 是这个 EIP 的发起人，也是 Hyper Oracle 的创始人。msfew 则是 Hyper Oracle 的研究员，主要帮忙做一些辅助性的工作，包括完善文档、提交 PR、跟进讨论区的 QA 等。qizhou 是 EthStorage 的创始人，之前就提交过其他 EIP，熟悉申请 EIP 的流程，也对以太坊基金会的人比较熟悉，为这个协议提供了很多指导。以下是该 EIP-6150 的 github 地址：

https://github.com/ethereum/EIPs/blob/master/EIPS/eip-6150.md

Hierarchical NFTs

目前的 NFT 几乎都是扁平化的，不同 NFT 之间不存在关联关系。而层级化的 NFT，则可以将所有 NFT 串联起来组成树状结构，就像文件系统一样。

如上图所示，可以想象成每个文件夹都是一个单独的 NFT，不同文件夹之间的层级关系也就是 NFT 之间的层级关系。

层级化的 NFT 可用于多种不同的应用场景，比如：

组织架构社交关系图谱电商商品类目结构层级评论系统

可以说，任何具有层级结构的场景都可以适用这个 EIP-6150 协议标准。层级结构的 NFT 在去中心化社交、去中心化电商等领域都将可能产生广泛应用。

接口定义

EIP-6150 总共定义了 5 个接口文件：

IERC6150IERC6150EnumerableIERC6150BurnableIERC6150ParentTransferableIERC6150AccessControl

IERC6150

IERC6150是规定必须实现的接口，最小化定义了一个事件和四个函数，且要求继承 IERC165 和 IERC721 接口，接口定义如下：

Minted事件需在铸造一个新的 NFT 时发出，记录了新 NFT 的铸造者（minter）、接收者（to）、父节点 NFT 的 ID（parentId）、新 NFT ID（tokenId）。当铸造一个根节点 NFT 时，那 parentId 则记为 0，即 0 表示一个无效的空节点，因此，有效的节点 NFT 的 tokenId 就不可以为 0。

parentOf函数用于查询指定 tokenId 的 NFT 的父节点 NFT。

childrenOf函数则查询出指定 tokenId 的 NFT 的所有子节点 NFTs。

isRoot和isLeaf函数则分别可查询指定 tokenId 在整个 NFT 层级树中是不是根节点或叶子节点。

IERC6150Enumerable

IERC6150Enumerable是可选的扩展接口，主要补充了几个跟层级相关的 Enumerable 的查询接口，接口定义如下：

继承IERC721Enumerable也是可选的，但为了更好地兼容 ERC721，最好可以继承。childrenCountOf函数用于查询指定节点下有多少个子节点，如果参数 parentId 为 0，则表示查询根节点的数量。childOfParentByIndex函数则是从指定的父节点下的所有子节点数组中找出指定索引位置的子节点的 tokenId，比如指定父节点 parentId = 110，其下有 10 个子节点，找出索引位置为 5 的子节点 tokenId = 1105，则查询结果返回 1105。indexInChildrenEnumeration函数则是查询指定的 tokenId 在指定父节点下的子节点数组中所在的索引位置，比如指定 tokenId = 1105，父节点 parentId = 110，1105 在子节点数组中的索引位置为 5，则查询结果返回 5。如果指定 tokenId 并不在指定父节点 parentId 下面，则需要抛出错误。

IERC6150Burnable

IERC6150Burnable也是可选的扩展接口，定义了销毁节点的操作，接口定义如下：

只定义了两个函数，safeBurn用于安全销毁单个节点，但要求只有指定节点为叶子节点时才允许销毁。就和 Linux 的文件系统一样，如果某目录下存在其他文件或文件夹，是不允许直接删除的。若强制删除，则目录下的所有文件和文件夹都会被级联式全部删除。当前协议没有定义级联式删除的函数，若有这个需求，可以自己再额外去添加函数实现。safeBatchBrun函数则是用于批量销毁多个叶子节点。

IERC6150ParentTransferable

IERC6150ParentTransferable也是一个可选的扩展接口，支持层级关系的转移，就和文件夹可以从一个目录移动到另一个目录一样，接口定义如下：

接口定义了两个函数和一个事件，支持单节点的转移，也支持多节点的批量转移。每个节点发生层级关系转移时，需要抛出ParentTransferred事件，记录下所转移的 tokenId、旧的父节点 ID 和新的父节点 ID。transferParent将指定的 tokenId 转移到指定的父节点下，若指定的父节点为 0，则表示指定节点改为了根节点。batchTransferParent则可以指定多个 tokenId，批量将这些节点都转移到指定的父节点下。

IERC6150AccessControl

最后一个接口IERC6150AccessControl也是可选的，提供了几个权限控制的函数，接口定义如下：

总共定义了三个函数，isAdminOf用于查询指定的 account 对指定的 tokenId 是否有管理员权限。在 ERC721 中，每个 NFT 都只有唯一的 owner 并拥有管理权限。但在层级式的结构中，一个 NFT 是可以有多个管理员的，就和文件系统中可以有多个管理员一样。这个扩展接口就提供了支持多管理员的模式，但对于怎么设置多个管理员，则难以定义通用函数，所以就没做标准化的定义。不过，需要保证，NFT 的 owner 同时也是管理员。

canMintChildren则用来判定某个 account 对指定的 parentId 是否具有铸造子节点的权限。

canBurnTokenByAccount则用来检查某个 account 对指定的 tokenId 是否具有销毁的权限。

参考实现

EIP 的 github 上，我对每个接口都提供了对应的参考实现代码，代码地址如下：

https://github.com/ethereum/EIPs/tree/master/assets/eip-6150/contracts

但这里我不打算对每个实现代码都一一讲解，我只讲最核心的ERC6150.sol的实现。因为代码相对有点长，就不贴代码出来了，大家可以点击链接进去看代码。我主要讲讲实现的一些逻辑和思路。

存储上，用了三个 mapping：_parentOf、_childrenOf、_indexInChildrenArray，分别用来存储指定节点的：父节点、子节点数组、所在子节点数组里的索引位置。有了这三个 mapping 之后，几个查询函数的实现就非常简单了，我就不细说了。核心是_safeMintWithParent和_safeBurn函数，分别是铸造 NFT 和销毁 NFT 的内部函数。

铸造函数的代码如下：

实现逻辑其实也很简单，有两个校验需要注意下，一是要铸造的新 NFT 的 tokenId 需要大于 0，正如前面所说的，0 为无效节点；二是当 parentId 不为 0 时，需保证 parentId 是存在的，当 parentId 为 0 时，则表示铸造的是根节点 NFT。_beforeMintWithParent和_afterMintWithParent是为了增加扩展性而增加的，可由继承此合约的上层合约根据需求再去实现。中间代码就是对几个 mapping 进行赋值了，然后调用了 ERC721 的_safeMint函数实现底层的铸造，接着就发送 Minted 事件了。

这个铸造函数是 internal virtual 的，上层合约可以重载该函数，且上层的实现合约需要再根据具体需求自己添加开放的铸造函数。

接着看看销毁函数，代码如下：

销毁时，要求 tokenId 是存在的且需是叶子节点才允许销毁。另外，销毁时，需要从子节点数组中移除，而为了节省 gas，同时把子节点数组中的最后一个元素移到了销毁的索引位置。

另外，实现代码中，也封装了批量铸造的内部函数，方便扩展支持批量铸造多个子节点的需求。

其实，整个协议并不复杂，但已经足以覆盖到很多应用场景，后续我会结合一些具体的应用场景，再增加示例代码作为案例，以促进该协议的落地应用。