标准名称

Size: px

Start display at page:

Download "标准名称"

滚方
5 years ago
Views:

1 区块链数据格式规范 ( 来源 : 中国电子技术标准化研究院网站, ) 编者按 : 在由工业和信息化部信息化和软件服务业司指导工业和信息化部中国电子技术标准化研究院主办的中国区块链技术和产业发展论坛第二届开发大会上, 区块链数据格式规范标准正式发布, 该标准的发布有助于为区块链系统的数据结构设计提供参考, 为区块链行业应用提供统一的数据标准, 对我国区块链标准建设具有重要意义全文如下 :

2 目次前言... III 1 范围术语和缩略语其他标准中定义的术语缩略语数据对象结构数据分类数据元数据格式规范账户数据格式区块数据格式事务数据格式实体数据格式合约数据格式配置数据格式附录 A ( 资料性附录 ) 数据项标识符附录 B ( 资料性附录 ) 共识机制相关数据格式 B.1 类拜占庭容错 B.2 基于权益的证明 B.3 基于工作量的证明参考文献 I

3 前言本标准按照 GB/T 给出的规则起草本标准由中国区块链技术和产业发展论坛提出本标准负责起草单位 : 中国电子技术标准化研究院中国万向控股有限公司浙江蚂蚁小微金融服务集团有限公司深圳前海微众银行股份有限公司乐视联服信息技术 ( 北京 ) 有限公司万达网络科技集团有限公司中国平安保险 ( 集团 ) 股份有限公司上海金丘实业股份有限公司上海钜真金融信息服务有限公司鑫苑 ( 中国 ) 置业有限公司众安信息技术服务有限公司上海分布信息科技有限公司用友网络科技股份有限公司海航科技集团有限公司三一集团有限公司本标准主要起草人 : 李鸣, 唐晓丹, 谭智勇, 张开翔, 季宙栋, 周平, 吴小川, 赵博然, 华正皓, 陈家乐, 宋文鹏, 周子焱, 李斌, 李俊, 左鹏, 李奕, 李彦博, 金龙, 杜宇, 姚辉亚, 韩梅, 杨宝刚, 李佳秾, 罗荣阁, 胡丹青, 郝玉琨, 董长江, 高西林, 杜君君, 朱天阳, 倪旻, 易锋平, 孙琳, 周政军, 李升林使用帮助信息 : 任何单位和个人在使用本标准的过程中, 若存在疑问, 或有对本标准的改进建议和意见, 请与中国电子技术标准化研究院 ( 中国区块链技术和产业发展论坛秘书处 ) 联系电话 : /2804; 电子邮件 :cbdforum@cesi.cn 通信地址 : 北京市东城区安定门东大街 1 号 (100007) 为了推动本标准的持续改进, 使其更加贴近用户组织的实际需求, 欢迎社会各方力量参加本标准的持续改进, 本标准的更多信息欢迎关注中国区块链技术和产业发展论坛官方网站和公众号 III

4 区块链数据格式规范 1 范围本标准规定了区块链的数据格式规范具体规定了以下 : a) 区块链技术相关的数据结构 ; b) 区块链技术相关的数据分类及其相互关系 ; c) 区块链技术相关的数据元的数据格式要求本标准适用于 : a) 为计划使用区块链的组织建设区块链系统提供数据格式参考 ; b) 指导区块链服务提供组织建立区块链系统数据结构 ; c) 为区块链系统建设过程的中间件服务组织提供数据格式参考 2 术语和缩略语 2.1 其他标准中定义的术语 GB/T GB/T GB/T 和 CBD-Forum 界定的以下术语和定义适用于本文件 attribute 一个对象或实体的特征 [GB/T ] 区块链 blockchain 一种在对等网络环境下, 通过透明和可信规则, 构建不可伪造不可篡改和可追溯的块链式数据结构, 实现和管理事务处理的模式注 : 事务处理包括但不限于可信数据的产生存取和使用等 [CBD-Forum ] 数据元 data element 通过定义标识表示和允许值等一系列描述的一个数据单元 [GB/T ] 数据类型 data type 由数据元操作决定的用于采集字母数字和 ( 或 ) 符号的格式, 以描述数据元的值 1

5 [GB/T ] 标识符 identifier 数据元的唯一标识 [GB/T ] 智能合约 smart contract 以数字形式定义的能够自动执行条款的合约注 : 在区块链技术领域, 智能合约是指基于预定事件触发不可篡改自动执行的计算机程序 [CBD-Forum ] 2.2 缩略语下列缩略语适用于本标准 PKI 公钥基础设施 (Public Key Infrastructure) ID 标识 (Identity) 3 数据对象结构区块链技术相关的数据对象结构包括上述区块事务实体合约账户配置六个主要数据对象其中区块链核心的数据对象包括区块事务实体和合约每一区块数据对象中包含一个或多个事务数据对象, 每个事务对象包括类的实体数据对象, 还包括事务的业务逻辑, 即合约数据对象在区块链核心数据对象之外, 包括配置数据对象, 提供区块链系统正常运行过程中所需的配置信息配置数据对象和区块链核心数据对象共同构建了区块链运行所需的基础数据基础而账户数据对象表示区块链业务的实际发起者和相关方对应的数据结构图 1 给出了数据视图相关的实体间关系注 : 区块链技术数据结构中所包含的关键要素是区块链技术中涉及到的必要数据, 在不同区块链技术相关的平台中可能包含其他非必要数据未在本标准的范围中账户区块核心事务实体合约配置图 1 2

6 4 数据分类本标准以数据对象的类别为依据, 将区块链数据分为以下六类 : a) 账户数据 : 指描述区块链事务的实际发起者和相关方的数据区块中记录的事务信息均被关联到相关的账户之上, 每个区块链服务客户拥有一个或多个账户来使用区块链服务 b) 区块数据 : 指区块链网络的底层链式数据, 用来把一段给定时间内发生的事务处理结果持久化为成块链式数据结构通常情况下, 区块由区块头和区块体组成区块头包含区块相关的控制信息, 区块体包含具体的事务数据 c) 事务数据 : 指描述区块链系统上承载的具体业务动作的数据其中, 事务既包括交易类型事务, 也包括非交易类型事务 d) 实体数据 : 指描述事务的静态的数据通常包括发起方地址接收方地址交易发生额交易费用存储数据和实体数据备注 e) 合约数据 : 指描述事务的动态处理逻辑的数据合约又称智能合约, 是一套以计算机代码形式定义的承诺, 以及合约参与方可执行承诺的协议这里的合约数据既包括处理逻辑的可执行代码, 也包括处理逻辑的执行结果 f) 配置数据 : 指区块链系统正常运行过程中所需的配置信息通常包括共识协议版本号软件版本号和网络通信底层对等节点配置信息等 5 数据元区块链数据元通过数据标识符中文名称英文名称数据类型数据长度数据说明数据备注 7 个来描述具体说明见表 1 表 1 名称说明数据标识符各数据元的唯一标识, 编号是以阶层式分类, 分别将数据分类和数据元依顺序进行流水号编码记录前段码为数据分类号码, 后段码以数据元的流水号, 详见附录 A 中文名称数据元的中文名称, 在一定语境下名称应保持唯一英文名称数据元的英文名称, 在一定语境下名称应保持唯一数据类型描述数据元的特征和基本要素, 本标准中使用的数据类型主要包括 : 字符串类型整数类型数组类型数据长度描述该数据元的长度, 在本标准中用定长或不定长表示, 并给出了推荐字节长度数据说明详细描述该数据元的和表达的含义数据备注描述该数据元是否必要, 在本标准中分为必选和可选第 6 章给出了对各种区块链数据元的说明和要求对各数据元的数据标识符的参考性规范见附录 A 6 数据格式规范 6.1 账户数据格式账户数据主要包括以下几种数据元 : a) 账户公钥 ; b) 账户私钥 ; 3

7 c) 账户资产 ; d) 数字证书 ; e) 账户所属机构账户公钥账户公钥的数据格式要求见表 2 表 2 中文名称账户公钥英文名称 Account Public Key 数据类型字符串数据长度定长, 推荐 64 字节数据说明根据 PKI 体系为用户生成的密钥对里, 可公开的部分数据备注必选账户私钥账户私钥的数据格式要求见表 3 表 3 中文名称账户私钥英文名称 Account Private Key 数据类型字符串数据长度定长, 推荐 32 字节数据说明根据 PKI 体系为用户生成的密钥对里, 不公开的部分数据备注必选账户资产账户资产的数据格式要求见表 4 表 4 中文名称账户资产英文名称 Account Asset 数据类型数组数据长度不定长数据说明账户拥有的资产说明, 包括资产名称, 资产列表, 余额等数据备注可选数字证书数字证书的数据格式要求见表 5 4

8 中文名称英文名称数据类型数据长度数据说明数据备注表 5 数字证书 Digital Certificate 数组不定长数字证书是一个经证书授权中心数字签名的包含公开密钥拥有者信息以及公开密钥的文件可选账户所属机构账户所属机构的数据格式要求见表 6 表 6 中文名称账户所属机构英文名称 Institution 数据类型数组数据长度不定长数据说明机构为加入到区块链网络的, 独立运作的成员, 可以为企业, 组织, 团体等, 账户可以在组织关系上归属于某个机构数据备注可选 6.2 区块数据格式区块数据主要包括以下几种数据元 : a) 区块高度 ; b) 区块标识 ; c) 版本信息 ; d) 前一区块摘要值 ; e) 默克尔树根 ; f) 区块时间戳 ; g) 区块随机数 ; h) 难度系数 ; i) 事务列表区块高度区块高度的数据格式要求见表 7 表 7 中文名称区块高度英文名称 Block Height 数据类型整数数据长度定长数据说明标识区块序号, 描述区块在区块链中的位置 5

9 数据备注可选区块标识区块标识的数据格式要求见表 8 中文名称区块标识英文名称 Block ID 表 8 数据类型数据长度数据说明数据备注字符串定长, 推荐长度 32 字节通常指区块摘要, 区块在区块链中的唯一标识必选版本信息版本信息的数据格式要求见表 9 表 9 中文名称版本信息英文名称 Block Version 数据类型字符串数据长度不定长数据说明当前区块版本号, 主要对应当前区块头的结构及各个字段的含义数据备注可选前一区块摘要值前一区块摘要值的数据格式要求见表 10 表 10 中文名称前一区块摘要值英文名称 Previous Block Hash 数据类型字符串, 推荐长度 32 字节数据说明通常指前一区块的区块摘要, 区块在区块链中的唯一标识默克尔树根默克尔树根的数据格式要求见表 11 中文名称默克尔树根表 11 6

10 英文名称数据类型数据长度数据说明数据备注 Merkle Tree Root 字符串定长, 推荐长度 32 字节由本区块里相关的信息通过树状结构算法汇总生成的摘要值事务树根必选, 状态和回执树根可选区块时间戳区块时间戳的数据格式要求见表 12 表 12 中文名称区块时间戳英文名称 Block Timestamp 数据类型整数, 推荐长度 8 字节数据说明表示本区块的生成时间刻度 ( 正整数 ), 从 1970 年起的时间计数, 精度为毫秒数, 正序增加区块随机数区块随机数的数据格式要求见表 13 表 13 中文名称区块随机数英文名称 Block Nonce 数据类型整数数据说明区块随机数, 通常用于记账节点竞争记账权的 Hash 计算的可变参数数据备注可选难度系数难度系数的数据格式要求见表 14 表 14 中文名称难度系数英文名称 Difficulty 数据类型整数, 推荐长度 8 字节数据说明通常用于表示记账节点竞争记账权的 Hash 计算难度的参数数据备注可选事务列表 7

11 事务列表的数据格式要求见表 15 表 15 中文名称事务列表英文名称 Transaction List 数据类型数组数据长度不定长数据说明区块中的事务列表, 每个事务通常表示一个业务操作数据备注必选 6.3 事务数据格式事务数据主要包括以下几种数据元 : a) 事务标识 ; b) 事务类型 ; c) 签名者 ; d) 事务时间戳事务标识事务标识的数据格式要求见表 16 表 16 中文名称事务标识英文名称 Transaction ID 数据类型字符串数据长度定长数据说明事务处理中, 可保证事务数据的唯一标识, 通常为哈希值数据备注必选事务类型事务类型的数据格式要求见表 17 表 17 中文名称事务类型英文名称 Transaction Type 数据类型字符串或整数数据长度定长数据说明进行事务操作时, 定义事务操作的事件类型, 可以有一或多种类型数据备注可选签名者签名者的数据格式要求见表 18 8

12 中文名称英文名称数据类型数据长度数据说明数据备注表 18 签名者 Signers 字符串定长进行事务操作时, 对事务进行签名的签名者的集合可选事务时间戳事务时间戳的数据格式要求见表 19 表 19 中文名称事务时间戳英文名称 Transaction Timestamp 数据类型整数数据长度 32 字节数据说明正整数, 从 1970 年起的时间计数, 精度为毫秒, 正序增加数据备注可选 6.4 实体数据格式实体数据主要包括以下几种数据元 : a) 发起方地址 ; b) 接收方地址 ; c) 事务处理发生额 ; d) 事务处理费用 ; e) 附件数据 ; f) 实体数据备注发起方地址发起方地址的数据格式要求见表 20 表 20 中文名称发起方地址英文名称 Sender Address 数据类型字符串长度定长说明事务操作的发起者或源账户, 作为该事务发起方的唯一标识备注必选接收方地址接收方地址的数据格式要求见表 21 9

13 中文名称英文名称数据类型数据长度数据说明数据备注表 21 接收方地址 Recipient Address 字符串定长事务操作中的接收方, 作为事务操作对象的唯一标识可选事务处理发生额事务处理发生额的数据格式要求见表 22 表 22 中文名称事务处理发生额英文名称 Transaction Amount 数据类型整数或字符串数据说明事务操作中涉及到账户资产的变更数量, 交易额数据备注可选事务处理费用事务处理费用的数据格式要求见表 23 表 23 中文名称事务处理费用英文名称 Transaction Fee 数据类型整数或字符串数据说明事务操作中通常会产生一定的交易费用, 以防止垃圾交易流量攻击等数据备注可选附加数据附加数据的数据格式要求见表 24 表 24 中文名称附加数据英文名称 Additional Data 数据类型字符串数据说明为部分业务需要提供的备选字段, 可增加与业务需求相关的附加数据数据备注可选 10

14 6.4.6 实体数据备注实体数据备注的数据格式要求见表 25 表 25 中文名称实体数据备注英文名称 Memo 数据类型字符串数据长度不定长数据说明事务操作中, 可对应该事务的 text ID 和 hash 类型的备注字段数据备注可选 6.5 合约数据格式合约数据主要包括以下几种数据元 : a) 合约标识 ; b) 合约版本号 ; c) 合约代码 ; d) 合约存储合约标识合约标识的数据格式要求见表 26 表 26 中文名称合约标识英文名称 Contract ID 数据类型字符串数据长度定长数据说明合约在区块链上部署后, 通过一个唯一的确定的地址标识, 供调用方访问合约的代码, 状态存储等数据备注该标识一般由创建该合约的账户信息 + 序列号 + 其他合约信息 ( 可选 ) 通过可选的摘要算法生成, 要求生成的标识唯一, 确定, 可用可选合约版本号合约版本号的数据格式要求见表 27 表 27 中文名称合约版本号英文名称 Contract Version 数据类型字符串数据长度不定长数据说明针对智能合约的代码和编译发布到区块链上的二进制代码数据, 使用版本号标识不同的版本数据备注某个智能合约持续提供某个业务功能, 但因需求更迭, 或面向不同的问题域而具备不同的特性, 需要进行版本划分可选 11

15 6.5.3 合约代码合约代码的数据格式要求见表 28 表 28 中文名称合约代码英文名称 Contract Code 数据类型字符串数据长度不定长数据说明合约的可执行指令, 经过指定编译器编译生成, 供区块链上的虚拟机调用执行数据备注根据不同的虚拟机体系, 合约代码采用不同的计算机语言编写, 并由不同的编译器生成二进制可执行指令可选合约存储合约存储的数据格式要求见表 29 表 29 中文名称合约存储英文名称 Contract Storage 数据类型数组数据长度不定长数据说明合约执行过程生成的状态数据的集合, 其与合约的逻辑密切相关数据备注可采用 key-value 格式或关系型数据库保存可选 6.6 配置数据格式配置数据主要包括以下几种数据元 : a) 协议版本号 ; b) 版本软件号 ; c) 节点标识 ; d) 节点地址 ; e) 节点公钥协议版本号协议版本号的数据格式要求见表 30 表 30 中文名称协议版本号英文名称 Protocol Version 数据类型字符串数据长度不定长数据说明针对区块链节点之间以及外部应用和区块链节点通信, 交互的协议, 使用版本号标识不同的协议版本数据备注区块链协议可以随着软件版本升级, 具备不同的接口, 功能, 一般区块链软件应在协议层面向下兼容, 12

16 采用协议版本号进行区分, 一套软件可以对使用不同的协议的各种客户端提供服务可选软件版本号软件版本号的数据格式要求见表 31 表 31 中文名称软件版本号英文名称 Software Version 数据类型字符串数据长度不定长数据说明针对区块链软件本身, 含代码和二进制软件形态, 使用版本号标识不同的发行版本数据备注区块链软件可以针对不同的软件生命周期, 以及不同的应用场景, 不同的目标用户, 采用不同的版本必选节点标识节点标识的数据格式要求见表 32 表 32 中文名称节点标识英文名称 Peer ID 数据类型字符串数据长度不定长数据说明区块链节点的唯一标识, 可选用节点的公钥做为唯一标识节点地址节点地址的数据格式要求见表 33 中文名称节点地址英文名称 Peer Address 数据类型字符串数据长度按照 IPv4 和 IPv6 定义长度不定数据说明区块链网络节点的 IP 地址数据备注必选节点公钥节点公钥的数据格式要求见表 34 表 33 13

17 中文名称英文名称数据类型数据长度数据说明数据备注节点公钥 Peer Public Key 字符串定长区块链网络节点的公钥信息可选表 34 14

18 区块链数据元参考标识见表 A.1 附录 A ( 资料性附录 ) 数据项标识符表 A.1 数据分类数据元数据标识账户数据区块数据事务数据实体数据合约数据配置数据账户公钥 01_001 账户私钥 01_002 账户资产 01_003 数字证书 01_004 账户所属机构 01_005 区块高度 02_001 区块标识 02_002 版本信息 02_003 前一区块摘要值 02_004 默克尔树根 02_005 区块时间戳 02_006 难度系数 02_007 随机数 02_008 事务列表 02_009 事务标识 03_001 事务类型 03_002 签名者 03_003 事务时间戳 03_004 发起方地址 04_001 接收方地址 04_002 交易发生额 04_003 交易费用 04_004 附加数据 04_005 实体数据备注 04_006 合约标识 05_001 合约版本号 05_002 合约代码 05_003 合约存储 05_004 共识协议版本号 06_001 软件版本号 06_002 节点标识 06_003 节点地址 06_004 节点公钥 06_005 15

19 附录 B ( 资料性附录 ) 共识机制相关数据格式 B.1 类拜占庭容错注 : 类拜占庭容错共识算法是指能解决拜占庭将军问题的一类算法, 典型的如 PBFT 算法及其演变的类似算法 B.1.1 验证者格式 B 验证者地址验证者地址的数据格式要求见表 B.1 表 B.1 中文名称验证者地址英文名称 Validator Address 数据类型字符串数据说明地址作为验证身份的标识, 验证者不可更改其地址数据备注可选 B 验证者公钥验证者公钥的数据格式要求见表 B.2 表 B.2 中文名称验证者公钥英文名称 Validator Public Key 数据类型字符串数据说明验证者公钥用来验证验证者签名的正确与否, 公钥编码后也可得到其相应验证者地址 B 验证者投票权重投票权重的数据格式要求见表 B.3 表 B.3 中文名称投票权重英文名称 Validator Voting Power 数据类型整数数据说明验证者根据所占投票权重进行投票, 投票中超过一定比例的权重可进入下一轮投票 16

20 B.1.2 验证者 B 验证者地址列表验证者地址列表的数据格式要求见表 B.4 表 B.4 中文名称验证者地址列表英文名称 Validator Address 数据类型数组数据长度不定长数据说明验证者列表包含当前区块链系统里所有的验证者, 验证者具有区块记账的权利 B 提案者提案者的数据格式要求见表 B.5 表 B.5 中文名称提案者英文名称 Proposer 数据类型数组数据说明提案者也是验证者, 但相对验证者多了提交打包下一个区块提案的任务 B 验证者投票权重总和验证者投票权重总和的数据格式要求见表 B.6 表 B.6 中文名称权重总和英文名称 Total Voting Power 数据类型整数数据说明当前区块链系统里所有验证者投票权重的总和 B.1.3 投票 B 投票者地址投票者地址的数据格式要求见表 B.7 17

21 中文名称英文名称数据类型数据长度数据说明数据备注表 B.7 投票者地址 Voter Address 字符串定长地址作为投票者在区块链里的身份标识, 地址由公钥编码后产生必选 B 投票者序号投票者序号的数据格式要求见表 B.8 表 B.8 中文名称投票者序号英文名称 Voter Index 数据类型整数数据说明投票者在投票者列表里会有唯一的序号作为投票者另一身份标识数据备注可选 B 被投票的区块高度被投票的区块高度的数据格式要求见表 B.9 表 B.9 中文名称投票高度英文名称 Voting Height 数据类型整数数据说明指准备打包的下一个区块的高度, 即当前区块链的下一个区块高度 B 投票轮次投票轮次的数据格式要求见表 B.10 表 B.10 中文名称投票轮次英文名称 Voting Round 数据类型整数数据说明投票者所处轮次, 在打包一个区块的过程中节点会经过多个轮数, 每个轮数会有相应的时间限制数据备注非可选 18

22 B 投票的类型投票类型的数据格式要求见表 B.11 表 B.11 中文名称投票类型英文名称 Voting Type 数据类型整数数据说明在提交一个区块时, 存在多种投票类型这里用不同整数来表示具体的投票类型, 如 : 预投票, 预提交数据备注非可选 B 投票区块标识投票区块标识的数据格式要求见表 B.12 表 B.12 中文名称投票区块标识英文名称 Voting Block ID 数据类型字符串数据说明所投区块的摘要, 此摘要通过区块的做哈希运算得到 B 投票者签名投票者签名的数据格式要求见表 B.13 表 B.13 中文名称投票者签名英文名称 Signature 数据类型字符串数据说明投票者对投票信息的签名, 此签名可代表其所做动作确实是其所为, 而非他人 B.2 基于权益的证明 B.2.1 权益累计时长权益累计时长的数据格式要求见表 B.14 中文名称权益累计时长英文名称 Accumulated Stake Duration 表 B.14 19

23 数据类型数据长度数据说明数据备注整数定长参与记账投票权益的时长, 权益证明成功产生新的权益后, 权益时间会清零必选 B.3 基于工作量的证明 B.3.1 随机数随机数的数据格式要求见表 B.15 表 B.15 中文名称随机数英文名称 Nonce 数据类型整数数据说明基于工作量证明的区块链系统会要求记账者 ( 矿工 ) 找到适当的随机数, 对该随机数和待记账的区块内容的合并信息进行 Hash 运算, 并要求计算出来的 Hash 值必须满足特定格式 ( 通常必须以特定数量的 0 开始 ) B.3.2 区块记账者区块记账者的数据格式要求见表 B.16 表 B.16 中文名称区块记账者英文名称 Block Generator 数据类型字符串数据说明标识实际提交本区块的记账者 ( 矿工 ) 信息, 通常用记账者的公钥地址或账户地址来表示 20

24 参考文献 [1] GB/T 信息技术数据元的规范与标准化第 1 部分数据元的规范与标准化框架 [2] GB/T 信息技术数据元的规范与标准化第 2 部分数据元的分类 [3] GB/T 信息技术数据元的规范与标准化第 3 部分数据元的基本 [4] GB/T 信息技术数据元的规范与标准化第 4 部分数据定义的编写规则与指南 [5] GB/T 信息技术数据元的规范与标准化第 5 部分数据元的命名和标识原则 [6] CBD-Forum 区块链参考架构 ( 原文链接 : 转载请注明 ) 21

标准名称

标准名称中国区块链技术和产业发展论坛标准 CBD-Forum-002-2017 区块链数据格式规范 Blockchain Data format specification 2017-12 - 22 发布目次前言... III 1 范围... 1 2 术语和缩略语... 1 2.1 其他标准中定义的术语... 1 2.2 缩略语... 2 3 数据对象结构... 2 4 数据分类... 3 5 数据元...