🚧 Stagnant Standards Track: ERC

ERC-5437: 安全联络人接口

使用非对称加密的安全通知接口

Authors	Zainan Zhou (@xinbenlv)
Created	2022-08-09
Discussion Link	https://ethereum-magicians.org/t/erc-interface-for-security-contract/10303
Requires	EIP-165

摘要
动机
规范
理由
向后兼容性
安全注意事项
版权

摘要

使用非对称加密的安全通知接口。该接口公开一个非对称加密密钥和一个传递目的地。

动机

目前，没有一致的方法来指定一个官方渠道，供安全研究人员向智能合约维护者报告安全问题。

规范

本文档中的关键词“必须”、“禁止”、“需要”、“应该”、“不应该”、“推荐”、“可以”和“可选”应按照 RFC 2119 中的描述进行解释。

interface IEIP5437 {

    /// REQUIRED (必需)
    function getSecurityContact(uint8 type, bytes memory data) public view
    returns (
        uint8 type,
        bytes memory publicKey,
        bytes memory extraData
    );

    /// OPTIONAL (可选)
    // TODO 考虑在最终确定之前移除，如果不需要
    function setSecurityContact(
        uint8 type,
        bytes memory publicKey,
        bytes memory extraData) public;
    event SecurityContactChanged(uint8 type, bytes memory publicKeyForEncryption, bytes memory extraData);

    /// OPTIONAL (可选)
    function securityNotify(uint8 type, bytes memory data) public payable;
    /// OPTIONAL (可选)
    event OnSecurityNotification(uint8 type, bytes memory sourceData, uint256 value);

    /// OPTIONAL (可选)
    // TODO 考虑将其作为一个单独的 EIP
    function bountyPolicy(uint256 id) public view returns(string, bytes memory extraData);
}

兼容的接口必须实现 getSecurityContact 方法。

type 是一个字节的数据，有效范围为 [0x10, 0x7f]。范围 [0x00, 0x0f] 和 [0x80, 0xff] 保留用于未来扩展。

type 指示 publicKey 和 extraData 的格式，如下所示

| Type | Encryption scheme (加密方案) | extraData | ——-|————————————-|————————————————– | 0x10 | GnuPG - RSA/3072 | Email address(es) (电子邮件地址) 以 RFC 2822 格式编码 | ————————————————————————————————

可以通过未来的 EIP 提出此表的新版本，方法是指定一个新的 type 编号。

从 getSecurityContact 返回的 publicKey 必须遵循上表中指定的加密方案。

以下是使用 RSA/3072 的 publicKey 示例，该密钥通过 RFC 20 ASCII 编码的公钥字符串中的 GnuPG 生成：

如果实现了 setSecurityContact 并且对它的调用已成功设置了新的安全联系人，则必须发出一个 SecurityContactChanged 事件，其中包含与 setSecurityContact 相同的传入参数
另外，建议实现一个链上安全通知方法 securityNotify 以接收链上安全通知。如果它被实现并且调用成功，则必须发出一个具有相同传入参数数据的 OnSecurityNotification。
兼容的接口必须实现 EIP-165。
建议通过 bountyPolicy 方法设置赏金策略。 id = 0 保留用于完整概述，而其他数字用于不同的个人赏金策略。返回的字符串将是赏金策略内容的 URI。没有指定赏金政策的特定格式。

理由

为了简单起见，此 EIP 使用给定的加密方案指定了一个简单的 GPG 方案，并使用电子邮件地址作为联系方式。未来的 EIP 可能会指定新的加密方案或传输方法。
此 EIP 添加了一个可选方法 setSecurityContact 来设置安全联系人，因为它可能会因加密密钥过期等情况而发生变化。
此 EIP 显式地将 securityNotify 标记为 payable，以便允许实施者设置质押金额来报告安全漏洞。
此 EIP 通过添加 bountyPolicy 和 extraData 字段，允许未来进行扩展。这些字段的附加值可能会在未来的 EIP 中添加。

向后兼容性

目前，OpenZeppelin 等现有解决方案在源代码中使用明文

/// @custom:security-contact some-user@some-domain.com

建议新版本的智能合约除了传统的 @custom:security-contact 方法外，还采用此 EIP。

安全注意事项

实施者应正确遵循加密方案要求的安全措施，以确 Chosen 通信频道的安全性。一些最佳实践如下：

保持安全联系人信息最新；
按照最佳实践建议的周期轮换加密密钥；
定期监视频道，以便及时收到通知。

版权

在 CC0 下放弃版权和相关权利。

Citation

Please cite this document as:

Zainan Zhou (@xinbenlv), "ERC-5437: 安全联络人接口 [DRAFT]," Ethereum Improvement Proposals, no. 5437, August 2022. [Online serial]. Available: https://eips.ethereum.org/EIPS/eip-5437.

ERC-5437: 安全联络人接口

使用非对称加密的安全通知接口

Table of Contents

摘要

动机

规范

理由

向后兼容性

安全注意事项

版权

Citation