eip	title	description	author	discussions-to	status	type	category	created	requires
9999	Semi-Fungible Token				Final	Standards Track	ERC	2023-03-08	165

抽象的

这是致力于规范元宇宙公共资源的标准。本文档中描述的智能合约接口集不兼容现有eip标准。该标准引入了SLOT、SOURCE和结构体<id、symbol、decimals、amount>三重结构模型。三重结构模型之间的关系灵活的体现了元宇宙的公共资源关系。该标准引入了新的转移与授权模型。

Token引入了slot使得合约可以纵向扩展，与source形成一对多的关系。

source与结构体也是一对多的关系，结构体实际上是token化的结果。

这样就形成了一个类似菜单的关系，使得资源的整合与运用更加灵活。

结构体中amount属性有量化性质，这就可以给source资源付能，可以为每个source付与数量或者资产属性，在多元化的元宇宙应用中相互协调配合使用的场景。

动机

传统不可替代的代币主要是 EIP-721 代币，这是一种能够根据身份区分数字资产的标准。 然而EIP-721 代币不提供量化特征，大大削弱了它们的可计算性、流动性和可管理性。 在元宇宙中需要一种更灵活的资源管理以及量化管理工具，该标准定义不仅解决了EIP-721 的弊端并且更加具备灵活性。 元宇宙需要多种类型多种道具的量化、计算、管理等，该标准提供了便利的定义接口集。

规格

每个符合EIP-9999 的合约都必须实现 EIP-9999和EIP-165接口

pragma solidity ^0.8.6;
import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
interface IMNFTCore is IERC165 {
    struct SourceInfo{
        uint256 id;
        string symbol;
        uint8 decimals;
        uint256 amount;
    }
    /**
        说明：获取拥有者卡槽数量
        参数：
        _owner：拥有者
        返回：
        数量
     */
    function slotLengthOf(address _owner) external view  returns (uint256) ;
     /**
        说明：通过卡槽获取资源数量
        参数：
        _slotId：卡槽ID
        返回：
        数量
     */
    function sourcesLengthOf(uint256 _slotId) external view returns (uint256) ;
    /**
        说明：获取拥有者所有卡槽ID
        参数：
        _owner：拥有者
        返回：
        卡槽ID数组
     */
   function slotListOfAll(address _owner) external view  returns (uint256[] memory);
   /**
        说明：分页获取拥有者卡槽ID
        参数：
        _owner：拥有者
        _pageNum：页码（从0开始）
        _pageSize：每页数量
        返回：
        卡槽ID数组
     */
   function slotListOfPage(address _owner,uint256 _pageNum,uint256 _pageSize) external view returns(uint256[] memory);
   /**
        说明：通过slotID获取所有资源ID
        参数：
        _slotId：卡槽ID
        返回：
        资源ID数组
     */
    function sourcesListOfAll(uint256 _slotId) external view returns (uint256[] memory);
     /**
        说明：通过slotID分页获取资源ID
        参数：
        _slotId：卡槽ID
        _pageNum：页码（从0开始）
        _pageSize：每页数量
        返回：
        资源ID数组
     */
    function sourcesListOfPage(uint256 _slotId,uint256 _pageNum,uint256 _pageSize) external view returns(uint256[] memory);
     /**
        说明：通过slotID获取所有资源信息
        参数：
        _slotId：卡槽ID
        返回：
        资源信息数组
     */
    function sourcesInfoListOfAll(uint256 _slotId) external view   returns(SourceInfo[] memory);
    /**
        说明：通过slotID分页获取资源信息
        参数：
        _slotId：卡槽ID
        _pageNum：页码（从0开始）
        _pageSize：每页数量
        返回：
        资源信息数组
     */
    function sourcesInfoListOfPage(uint256 _slotId,uint256 _pageNum,uint256 _pageSize) external view returns(SourceInfo[] memory);
     /**
        说明：通过slotID分页获取拥有者资源信息
        参数：
        _owner：拥有者
        _slotId：卡槽ID
        _pageNum：页码（从0开始）
        _pageSize：每页数量
        返回：
        资源信息数组
     */
    function sourcesInfoListOfPage(address _owner,uint256 _slotId,uint256 _pageNum,uint256 _pageSize) external view  returns(SourceInfo[] memory);
    /**
        说明：通过slotID分页获取拥有者所有资源信息
        参数：
        _owner：拥有者
        _slotId：卡槽ID
        返回：
        资源信息数组
     */
    function sourcesInfoListOfAll(address _owner,uint256 _slotId) external view  returns(SourceInfo[] memory);
    /**
        说明：通过slotId获取拥有者资源ID数量
        参数：
        _owner：拥有者
        _slotId：卡槽ID
        返回：
        资源ID数量
     */
    function assetsLengthOf(address _owner,uint256 _slotId) external view  returns(uint256);
    /**
        说明：通过slotId获取拥有者所有资源ID
        参数：
        _owner：拥有者
        _slotId：卡槽ID
        返回：
        资源ID数组
     */
    function assetsListOfAll(address _owner,uint256 _slotId) external view  returns(uint256[] memory);
    /**
        说明：通过slotId分页获取拥有者资源ID
        参数：
        _owner：拥有者
        _slotId：卡槽ID
        _pageNum：页码（从0开始）
        _pageSize：每页数量
        返回：
        资源ID数组
     */
    function assetsListOfPage(address _owner,uint256 _slotId,uint256 _pageNum,uint256 _pageSize) external view  returns(uint256[] memory);
    /**
        说明：获取授权资源数量
        参数：
        _owner：拥有者
        _operator：被授权地址
        _slotId：卡槽ID
        返回：
        数量
     */
    function approveSourceLengthOf(address _owner,address _operator,uint256 _slotId) external view  returns(uint256);
    /**
        说明：获取授权资源ID数组
        参数：
        _owner：拥有者
        _operator：被授权地址
        _slotId：卡槽ID
        返回：
        资源ID数组
     */
    function approveSourceListOfAll(address _owner,address _operator,uint256 _slotId) external view  returns(uint256[] memory);
    /**
        说明：分页获取授权资源ID数组
        参数：
        _owner：拥有者
        _operator：被授权地址
        _slotId：卡槽ID
        _pageNum：页码（从0开始）
        _pageSize：每页数量
        返回：
        资源ID数组
     */
    function approveSourceListOfPage(address _owner,address _operator,uint256 _slotId,uint256 _pageNum,uint256 _pageSize) external view  returns(uint256[] memory);
    /**
        说明：获取资源信息
        参数：
        _slotId：卡槽ID
        _sourceId：资源ID
        返回：
        资源信息
     */
    function sourceInfo(uint256 _slotId,uint256 _sourceId) external view  returns(SourceInfo memory);
    /**
        说明：批量获取资源信息
        参数：
        _slotId：卡槽ID
        _sourceIds：资源ID数组
        返回：
        资源信息数组
     */
    function sourceInfo(uint256 _slotId,uint256[] memory _sourceIds) external view  returns(SourceInfo[] memory);
    /**
        说明：获取资源余额
        参数：
        _owner：拥有者
        _slotId：卡槽ID
        _sourceId：资源ID
        返回：
        资源余额
     */
    function sourceInfoAmount(address _owner,uint256 _slotId,uint256 _sourceId) external view  returns(uint256);
    /**
        说明：获取资源授权余额
        参数：
        _owner：拥有者
        _spender：被授权地址
        _slotId：卡槽ID
        _sourceId：资源ID
        返回：
        资源授权余额
     */
    function allowanceSourceInfoAmount(address _owner,address _spender,uint256 _slotId,uint256 _sourceId) external view  returns(uint256);
    
    /**
        说明：授权资源
        参数：
        _to：被授权地址
        _slotId：卡槽ID
        _sourceIds：资源ID数组
        返回：
        
     */
    function approveSources(address _to, uint256 _slotId,uint256[] memory _sourceIds) external   ;
   
    /**
        说明：转移资源
        参数：
        _from：从from地址转移到to地址
        _to：从from地址转移到to地址
        _slotId：卡槽ID
        _sourceIds：转移到资源id数组
        返回：
        
     */
    function transferSourcesFrom(
        address _from,
        address _to,
        uint256 _slotId,
        uint256[] memory _sourceIds
    ) external ;
    /**
        说明：批量转移资源资产
        参数：
        _to：转移到的地址数组
        _slotIds：卡槽ID数组
        _sourceIds：转移的资源id数组
        _amounts：转移的金额
        返回：
        true or false
     */
    function transferSourceInfoAmountBatch(address[] memory _to,uint256[] memory _slotIds,uint256[] memory _sourceIds,uint256[] memory _amounts) external  returns(bool);
    /**
        说明：批量转移资源资产
        参数：
        _from:被转移的地址数组
        _to：转移到的地址数组
        _slotIds：卡槽ID数组
        _sourceIds：转移的资源id数组
        _amounts：转移的金额
        返回：
        true or false
     */
    function transferSourceInfoAmountFromBatch(address[] memory _from,address[] memory _to,uint256[] memory _slotIds,uint256[] memory _sourceIds,uint256[] memory _amounts) external  returns(bool);
    /**
        说明：转移资源资产
        参数：
        _to：转移到的地址
        _slotId：卡槽ID
        _sourceId：转移的资源id
        _amount：转移的金额
        返回：
        true or false
     */
    function transferSourceInfoAmount(address _to,uint256 _slotId,uint256 _sourceId,uint256 _amount) external  returns(bool);
    /**
        说明：转移资源资产
        参数：
        _from：被转移的地址
        _to：转移到的地址
        _slotId：卡槽ID
        _sourceId：转移的资源id
        _amount：转移的金额
        返回：
        true or false
     */
    function transferSourceInfoAmountFrom(address _from,address _to,uint256 _slotId,uint256 _sourceId,uint256 _amount) external  returns(bool);
    /**
        说明：授权资源资产
        参数：
        _spender：被授权地址
        _slotId：卡槽ID
        _sourceId：资源id
        _amount：授权的金额
        返回：
        true or false
     */
    function approveSourceInfoAmount(address _spender,uint256 _slotId,uint256 _sourceId,uint256 _amount) external  returns(bool);
    /**
        说明：获取拥有者地址
        参数：
        _slotId：卡槽ID
        _sourceId：资源id
        返回：
        拥有者地址
     */
    function ownerOf(uint256 _slotId,uint256 _sourceId) external view   returns (address);
     /**
        说明：获取卡槽创建者地址
        参数：
        _slotId：卡槽ID
        返回：
        创建者地址
     */
    function minterOf(uint256 _slotId) external view   returns (address) ;
     /**
        说明：授权所有资源
        参数：
        _to：被授权地址
        _slotId：卡槽ID
        返回：
        
     */
    function approveAll(address _to, uint256 _slotId) external   ;

    /**
        说明：转移资源,校验实现接口
        参数：
        _from：从from地址转移到to地址
        _to：从from地址转移到to地址
        _slotId：卡槽ID
        _sourceIds：转移到资源id数组
        返回：
        
     */

    function safeTransferSourcesFrom(
        address _from,
        address _to,
        uint256 _slotId,
        uint256[] memory _sourceIds
    ) external  ;
    /**
        说明：转移资源,校验实现接口
        参数：
        _from：从from地址转移到to地址
        _to：从from地址转移到to地址
        _slotId：卡槽ID
        _sourceIds：转移到资源id数组
        _data：携带数据
        返回：
        
     */

    function safeTransferFrom(
       address _from,
        address _to,
        uint256 _slotId,
        uint256[] memory _sourceIds,
        bytes memory _data
    ) external  ;
    /** 
        说明：创建资源,校验实现接口
        参数：
        _to：资源拥有者
        _slotId：卡槽ID
        _sourceIds：资源id数组
        _tokenData：结构题初始化数据
        _daismTokenId: _daismTokenId=-1 is eth,_daismTokenId=0 is utoken ,other is daism token
        返回：
        
     */
    function safeMint(address _to, uint256 _slotId,uint256[] memory _sourceIds,bytes[][] calldata _tokenData,int[] memory _daismTokenIds,uint256[] memory _payAmounts) external payable;
    /** 
        说明：创建资源,校验实现接口
        参数：
        _to：资源拥有者
        _slotId：卡槽ID
        _sourceIds：资源id数组
        _tokenData：结构题初始化数据
        _data：携带数据
        _daismTokenId: _daismTokenId=-1 is eth,_daismTokenId=0 is utoken ,other is daism token
        返回：
        
     */
    function safeMint(address _to, uint256 _slotId,uint256[] memory _sourceIds,bytes[][] calldata _tokenData,bytes memory data,int[] memory _daismTokenIds,uint256[] memory _payAmounts) external payable ;
    /** 
        说明：创建资源,不校验实现接口
        参数：
        _to：资源拥有者
        _slotId：卡槽ID
        _sourceIds：资源id数组
        _tokenData：结构题初始化数据
        _daismTokenId: _daismTokenId=-1 is eth,_daismTokenId=0 is utoken ,other is daism token
        返回：
        
     */
    function mint(address _to, uint256 _slotId,uint256[] memory _sourceIds,bytes[][] calldata _tokenData,int[] memory _daismTokenIds,uint256[] memory _payAmounts) external payable  ;


}

EIP-9999 令牌接收器

如果一个智能合约想要在从其他地址接收到值时得到通知，它应该实现接口中的所有功能IMNFTCoreReceiver，在实现中它可以决定是接受还是拒绝传输。有关详细信息，请参阅“传输规则”。

pragma solidity ^0.8.6;
interface IMNFTCoreReceiver {
    
    function onMNFTCoreReceived(
        address operator,
        address from,
        uint256 slotId,
        uint256[] memory sourceIds,
        bytes calldata data
    ) external returns (bytes4);
    
}

代币操纵

场景

转移:_

本次EIP引入了两种新的转账模型：sourceId的转移和source amount的转移

    function transferSourcesFrom(
        address _from,
        address _to,
        uint256 _slotId,
        uint256[] memory _sourceIds
    ) external ;
	
  function transferSourceInfoAmountFrom(address _from,address _to,uint256 _slotId,uint256 _sourceId,uint256 _amount) external  returns(bool);

第一个允许槽内的资源进行转移

第二个允许槽内资源的价值进行转移

规则

审批规则:_

本EIP提供两种审批类型：针对source的审批和针对source amount的审批

• approveSources，批准授权的资源，这意味着授权运营商能够管理所有者批准的资源，但不包括资源的amount。
• approveSourceInfoAmount批准授权资源的amount，这意味着授权运营商能够管理所有者批准资源的amount。
• 对于任何批准功能，调用者必须是所有者或已获得更高级别的权限。

transferFrom 规则:_

• function transferSourcesFrom(address _from,address _to,uint256 _slotId,uint256[] memory _sourceIds) 该函数应该根据以下规则指示从一个地址到两一个地址转移:

  • _from 必须是所有者或者被授权的_sourceIds操作者。
  • _from、_to为0地址则失败。
  • _slotId不存在则失败。
  • 如果_sourceIds 不属于_from 所有或者未被授权则失败。

• 该function transferSourceInfoAmountFrom(address _from,address _to,uint256 _slotId,uint256 _sourceId,uint256 _amount) 函数将资源的amount从_from转移到_to，应该遵循以下规则：

  • _from 必须是所有者或者被授权的_amount操作者。
  • _from、_to为0地址则失败。
  • _slotId不存在则失败。
  • _sourceId不存在则失败。
  • 如果_amount 超过_from 能管理的数量则失败.

基本原理

设计决策：

sourceId与sourceAmount虽然说是有层级关系，但他们的价值归属不强关联。也就是说sourceAmount所有者在转移sourceId的时候不受影响。 这样会拥有者无论是资源价值或者是资源amount价值都不受转移而影响。丰富而灵活的体现了多种元宇宙使用场景。无论是设计两层或者三层结构的场景都能很好的兼容。

参考实施

• EIP-3525 implementation

版权

通过CC0放弃版权和相关权利。