ERC-5851: 链上可验证凭证

    /** 元数据
    * 
    * @param title 定义声明字段的名称
    * @_type 是数据的类型 (bool,string,address,bytes,..)
    * @param description 有关声明详细信息的其他信息。
     */
    struct Metadata {
        string title;
        string _type;
        string description;
    }

   struct Values{
       string stringValue;
       uint uintValue;
       address addressValue;
       bool boolValue;
  }

    /** 声明
    * 
    * 声明结构由持有人声明关联且验证者必须验证的条件和值组成。
    * @notice 下面给出的参数仅供参考，开发人员可以通过使用 TLV、编码为 base64 等方案来优化需要在链上表示的字段。
    * @dev 定义 SBT 证书的特定声明参数的结构
    * @notice 此结构用于验证过程，它包含元数据、逻辑和期望
    * @notice 逻辑可以表示用于定义不同操作的枚举格式，也可以是逻辑运算符（以基于 unicode 标准的 ASCII 图形形式存储）。例如：
("⊄" = U+2284, "⊂" = U+2282,  "<" = U+003C , "<=" = U + 2265,"==" = U + 003D, "!="U + 2260, ">=" = U + 2265,">" =  U + 2262).
    */
    struct Claim {
        Metadata metadata;
        string logic;
        Values expectation;
   
    }

    /// @notice getter 函数，用于验证地址 `claimer` 是否是 tokenId `SBTID` 定义的声明的持有人
    /// @dev 它必须定义条件运算符（下面解释的逻辑）以允许应用程序将其转换为代码逻辑
    /// @dev 此处给出的逻辑必须是条件运算符，必须是以下之一（"⊄", "⊂", "<", "<=", "==", "!=", ">=", ">"）
    /// @param claimer 是想要验证发行者发给它的 SBT 的 EOA 地址。
    /// @param SBTID 是用户作为声明人的 SBT 的 Id。
    /// @return 如果断言有效，则返回 true，否则返回 false
    /**
    例如，ifVerified(0xfoo, 1) => true 将意味着 0xfoo 是给定集合的 tokenId 定义的 SBT 身份代币的持有人。
    */
    function ifVerified(address claimer, uint256 SBTID) external view returns (bool);

  
    /// @notice getter 函数，用于获取给定身份持有者的链上身份验证逻辑。
    /// @dev 它不能为 address(0) 定义。
    /// @param SBTID 是用户作为声明人的 SBT 的 Id。
    /// @return 由管理员为给定 KYC 提供商定义的所有条件元数据的描述的结构数组。
    /**
    例如：standardClaim(1) --> {
    { "title":"age",
        "type": "uint",
        "description": "基于合法文件上的出生日期的年龄",
        },
       "logic": ">=",
    "value":"18"  
    }
    定义为身份索引 1 编码的条件，定义身份条件，即持有人必须等于或大于 18 岁。
    **/

    function standardClaim(uint256 SBTID) external view returns (Claim[] memory);

    /// @notice 用于设置由 SBTID 定义的给定身份代币的声明要求逻辑（由 Claims 元数据定义）详细信息的函数。
    /// @dev 它应该只由 admin 地址调用。
    /// @param SBTID 是管理员想要为其定义 Claims 的基于 SBT 的身份证书的 Id。
    /// @param `claims` 是由管理员定义的所有条件元数据的描述的结构数组。有关更多信息，请查看元数据部分。
    /**
    例如：changeStandardClaim(1, { "title":"age",
            "type": "uint",
            "description": "基于合法文件上的出生日期的年龄",
            },
        "logic": ">=",
        "value":"18"  
    });
    将对应于管理员需要根据 Claims 数组结构详细信息中描述的条件来调整 tokenId = 1 的身份验证 SBT 的标准声明的功能。
    **/

    function changeStandardClaim(uint256 SBTID, Claim[] memory _claims) external returns (bool);

    /// @notice 使用 ZKProof 协议根据给定的身份验证身份的函数
    /// @dev 它应该只由 admin 地址调用。
    /// @param SBTID 是管理员想要为其定义 Claims 的基于 SBT 的身份证书的 Id。
    /// @param claimer 是需要被证明为 tokenID 定义的 SBT 所有者的地址。
    /**
    例如：certify(0xA....., 10) 意味着管理员将 id 为 10 的 DID 徽章分配给 `0xA....` 钱包定义的地址。
    */
    function certify(address claimer, uint256 SBTID) external returns (bool);

    /// @notice 使用 ZKProof 协议根据给定的身份验证身份的函数
    /// @dev 它应该只由 admin 地址调用。
    /// @param SBTID 是管理员想要为其定义 Claims 的基于 SBT 的身份证书的 Id。
    /// @param claimer 是需要被证明为 tokenID 定义的 SBT 所有者的地址。
    /* 例如：revoke(0xfoo,1)：表示 KYC 管理员撤销地址“0xfoo”的 SBT 证书编号 1。*/
    function revoke(address certifying, uint256 SBTID) external returns (bool);

    /**
    * standardChanged
    * @notice 当管理员更改声明时，必须触发 standardChanged。
    * @dev 对于创建新的 SBTID，也必须触发 standardChanged。
    例如：emit StandardChanged(1, Claims(Metadata('age', 'uint', '基于合法文件上的出生日期的年龄' ), ">=", "18");
    当更改声明条件时发出，该条件允许证书持有人调用带有修改器的函数，声明持有人必须等于或大于 18 岁。
    */
    event StandardChanged(uint256 SBTID, Claim[] _claims);
    
    /**
    * certified
    * @notice 当将 SBT 证书授予认证地址时，必须触发 certified。
    例如：Certified(0xfoo,2); 意味着钱包持有人地址 `0xfoo` 经过认证可以持有 id 为 2 的证书，因此可以满足所需接口定义的所有条件。
    */
    event Certified(address claimer, uint256 SBTID);
    
    /**
    * revoked
    * @notice 撤销 SBT 证书时，必须触发 revoked。
    例如：Revoked( 0xfoo,1); 意味着实体用户 0xfoo 已被撤销为 SBT ID 1 定义的所有函数访问权限。
    */
    event Revoked(address claimer, uint256 SBTID);
}