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
event Split(uint256 indexed parentId, uint256 indexed childId, uint8 share);: The event emitted when a new child token holding a share is issued under a parent.event Merged(uint256 indexed newTokenId, uint256[] mergedTokenIds);: The event emitted when multiple child tokens are merged to create a new token.function mintParent(string memory _tokenURI) external payable returns (uint256 tokenId);: Issues a new parent NFT that becomes the top of the hierarchy.function mintSplit(uint256 parentId, uint8 _share) external payable returns (uint256 tokenId);: Issues a child NFT with a specified share under a designated parent.function mintMerge(uint256 parentId, uint256[] memory _tokenIds) external payable returns (uint256 newTokenId);: Combines multiple child tokens sharing the same parent into a single new token.function sharePass(uint256 to, uint256 from, uint8 _share) external;: Moves part of one token's share to another token.function burn (uint256 tokenId) external;: Burns a token and returns its share to the parent token.
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.