ERC-7891 A hierarchical NFT splitting and merging standard (Splitting and Merging of NFTs)

Draft · NFTs & multi-token · created 2025-02-15

A standard that allows a single NFT to be split into multiple child NFTs or merged back into one, while tracking each token's share ratio.

Why it is needed

The hierarchical NFTs defined by EIP-6150 have a fixed structure in which the parent-child relationship, once set, cannot change. However, real-world assets such as real estate, equities, and game items often need to be divided into multiple pieces or have scattered pieces recombined into one. For example, splitting an NFT representing a single share of stock among multiple investors, or merging gradually accumulated fractions back into one complete share, had no standardized method under EIP-6150 alone. There was also no way to track each party's ownership ratio (share) directly within the token standard when multiple people split ownership of one asset, requiring separate external logic to be built every time such functionality was needed. ERC-7891 solves this by defining splitting, merging, and share transfer through a standard interface.

What to implement

In depth

Standard inheritance relationship

Contracts implementing ERC-7891 MUST also implement EIP-721, EIP-165, and ERC-6150 alongside this standard. The interface declaration is also structured so that IERC7891 inherits from IERC6150, IERC721, and IERC165, reusing the existing EIP-721 token and ERC-6150 parent-child hierarchy as is while adding only the split/merge functionality. The ERC-165 identifier for this interface is 0x43cb816b.

mintParent

mintParent(_tokenURI) issues a new parent NFT that becomes the top of the hierarchy. It takes a URI string pointing to metadata and returns the tokenId of the newly issued token. It is declared payable, allowing implementations that charge a fee upon issuance.

mintSplit and the Split event

mintSplit(parentId, _share) issues a child NFT holding a share ratio of share under the specified parentId and returns the new tokenId. This triggers a Split(parentId, childId, share) event, recording under which parent which child was created and with what share. share is a share ratio of type uint8.

mintMerge and the Merged event

mintMerge(parentId, _tokenIds) combines multiple child tokens sharing the same parentId (the _tokenIds array) into a single new token and returns newTokenId. When the merge occurs, a Merged(newTokenId, mergedTokenIds) event is emitted, recording the newly created token and the list of original tokens merged into it.

sharePass

sharePass(to, from, _share) moves an amount of share equal to _share from the from token to the to token. It redistributes shares internally without issuing a new token or burning an existing one.

burn

burn(tokenId) burns a token while returning the share it held to the parent NFT. This ensures that when a child token disappears, the total sum of shares is not broken but is recovered by the parent.

Design intent

According to the source Rationale, this standard reuses ERC-6150's parent-child structure as is to maintain compatibility while adding share management through an internal mapping. mintSplit and mintMerge are designed to clearly distinguish the separate operations of decomposing and combining assets, and sharePass is provided as a means to efficiently redistribute shares alone without minting or burning. The interface is designed to be minimal to preserve gas efficiency and semantic clarity.

Proposal status

This ERC has a status of Draft, meaning it is still under discussion and is a proposal whose content may change or be abandoned.

Original ERC · ← ERCs