通往STO之路|ERC-1643标准详解

9月份以太坊社区相继出现 ERC-1400/1404/1410/1411 等证券型通证发行(Security Token Offering,简称STO)的标准提案，预示着通证市场开始主动拥抱政策监管，以太坊社区也在技术上寻求合规通证的实现机制。

ERC-1643: 让智能合约关联法律文件

对于证券型通证(Security Token, 简称ST)来说, 发行的法律合规性是第一要务。

ST 及其所有权通常需要定义投资者或发行人的权利和义务，因此将法律文件与相关合约关联起来的能力就非常重要。

ERC-1643正是提供了这种能力: 它允许发行者为通证合约添加法律合规文档, 并为该文档操作提供了一组标准的接口, 包括文档查阅、修改以及对变更的订阅。

如何在链上表示一份文档

在ERC-1643标准中, 一份链上文档(document)通常用以下数据关联表示:

- 文档名称, 类型byte32

- 最近修改时间, 类型uint256

- 内容的hash值, 类型bytes32

- 统一资源标识符(URI), 类型string

ERC-1643 文档管理接口

ERC-1643文档管理接口一览:

详解:

getDocument

功能: 获得文档详情

@param _name 文档名称

@return string 文档的统一资源定位符(URI)

@return byte32 内容hash值

@return uint256 最近修改的时间戳

setDocument

功能: 添加或更新文档

@param _name 文档名称

@param _uri 文档的统一资源定位符(URI)

@param _documentHash 内容hash值

注意:

- 文档添加/更新失败, setDocument必须抛出

- 文档添加/更新成功, 必须触发 DocumentUpdated 事件

removeDocument

功能: 删除文档

@param _name 文档名称

注意:

- 文档删除失败, removeDocument必须抛出

- 文档删除成功, 必须触发 DocumentRemoved 事件

getAllDocuments

功能: 返回同一智能合约上添加的所有文档列表, 包括:

- 通过setDocument添加的文档

- 未被removeDocument删除掉的文档

文档事件

@param _name 文档名称

@param _uri 文档的统一资源定位符(URI)

@param _documentHash 内容hash值

@return _timestamp 最近修改的时间戳

结语

由ERC-1643提供的标准接口, 为智能合约提供了关联法律文件的能力, 钱包、交易所、其他第三方都将依此获得法律文件的标准视图，通证持有者也能及时订阅这些文件的更新。

可以说, ERC-1643为1400系列的STO标准提供了至关重要的基础设施。

参考:

https://github.com/ethereum/EIPs/issues/1643

往期文章

通往STO之路|以太坊ERC1404标准解读

通往STO之路 | 以太坊ERC1410方案详解

ERC系列| ERC1066标准解析

®作者简介：Codefine好码安全团队专注于智能合约安全审计和全生命周期管理, 已为全球多家交易所、钱包、公链做过智能合约安全审计和开发管理。团队通过独有的多维审计引擎，持续为合作伙伴提供正确、安全、可用的智能合约基础设施。

本文经「原本」原创认证，作者好码实验室，访问yuanben.io查询【2AM4K3EI】获取授权信息。