|
@@ -1,626 +1,120 @@ |
|
|
[TOC] |
|
|
[TOC] |
|
|
#JD区块链 |
|
|
#JD区块链 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html) |
|
|
[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html) |
|
|
|
|
|
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.jd.blockchain/sdk-pack/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.jd.blockchain/sdk-pack/) |
|
|
|
|
|
[![Build Status](https://travis-ci.com/blockchain-jd-com/jdchain.svg?branch=master)](https://travis-ci.org/blockchain-jd-com/jdchain) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
------------------------------------------------------------------------ |
|
|
|
|
|
### 版本修订历史 |
|
|
|
|
|
<table> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<th>版本号</th> |
|
|
|
|
|
<th>作 者</th> |
|
|
|
|
|
<th>修改日期</th> |
|
|
|
|
|
<th>备 注</th> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>0.0.6</td> |
|
|
|
|
|
<td>黄海泉</td> |
|
|
|
|
|
<td>2017-11-10</td> |
|
|
|
|
|
<td> |
|
|
|
|
|
定义JD区块链项目的目标与关键能力;<br> |
|
|
|
|
|
定义JD区块链的核心对象模型;<br> |
|
|
|
|
|
定义“账户”的生成算法和“区块/交易/操作/账户”的关键属性;<br> |
|
|
|
|
|
描述了编程接口的示例代码; |
|
|
|
|
|
</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>0.0.7</td> |
|
|
|
|
|
<td>黄海泉</td> |
|
|
|
|
|
<td>2017-11-17</td> |
|
|
|
|
|
<td> |
|
|
|
|
|
丰富了对“节点共识”、“节点分区”两项关键能力的详细描述; |
|
|
|
|
|
</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>0.0.8</td> |
|
|
|
|
|
<td>黄海泉</td> |
|
|
|
|
|
<td>2018-07-17</td> |
|
|
|
|
|
<td> |
|
|
|
|
|
增加部署图;增加智能合约开发的示例; |
|
|
|
|
|
</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
</table> |
|
|
|
|
|
|
|
|
|
|
|
------------------------------------------------------------------------ |
|
|
------------------------------------------------------------------------ |
|
|
|
|
|
|
|
|
## 一、概述 |
|
|
|
|
|
JD区块链项目的目标是提供一个面向广泛的应用场景、满足企业核心需求的灵活和易用的区块链系统。 |
|
|
|
|
|
以下是 JD 区块链用以满足企业核心需求的关键能力,也是显著区别于其它区块链的重要特征: |
|
|
|
|
|
|
|
|
|
|
|
- 快速共识 |
|
|
|
|
|
- 节点分区 |
|
|
|
|
|
- 并行多账本 |
|
|
|
|
|
- 大数据伸缩存储 |
|
|
|
|
|
- 条件检索 |
|
|
|
|
|
- 面向对象的合约代码编程模型 |
|
|
|
|
|
- 节点快速部署 |
|
|
|
|
|
- 多终端灵活接入 |
|
|
|
|
|
- 分布式自治的账户权限管理模型 |
|
|
|
|
|
|
|
|
|
|
|
JD区块链对于关键能力的定义是建立在深入理解和抽象各种多样化需求的基础上的。 |
|
|
|
|
|
|
|
|
|
|
|
- 快速共识(Efficient Consensus) |
|
|
|
|
|
我们认为,“快速”不仅仅体现在“用更短时间”达成共识,还要体现在交易(Transaction)要得到可靠地执行。 |
|
|
|
|
|
需要在算法和实现层面做出保障,确保所有提交的合法的交易会被系统在一个“确定性”和“足够短”的时间之内被严格地执行,系统不主动作出随机性地丢弃(不包括系统故障因素)。注:POW类算法产生的链分叉处理是一种系统随机性地丢弃交易的行为。 |
|
|
|
|
|
从使用者的视角来看,这种能力就是区块链系统的“可靠性”,这对于企业、金融场景而言尤其重要。 |
|
|
|
|
|
|
|
|
|
|
|
- 节点分区(Peer Partition) |
|
|
|
|
|
“分区”是一种分布式系统架构原则,通过将大范围目标按照某种相似特征分隔为一个个小范围目标,分别进行更高效地处理,这能从整体上提升整个系统的处理能力。 |
|
|
|
|
|
区块链系统也是一种分布式系统,沿用“分区”的思想这点来自以往的系统架构实践的经验,是有可能让区块链系统获得可媲美现有系统的处理能力。这种能力将可以无障碍地把区块链在应用于广泛的企业场景中。 |
|
|
|
|
|
在此,我们所说的“节点分区(Peer Partition)” 是共识过程中的物理通讯层面的分区,在共识过程中只有相关的物理节点才会建立通讯链路并复制和存储共识的状态数据。在一个区块链系统中,可以从节点全集中选择一个或多个节点子集,分别组成一个或多个节点分区(Peer Partition) |
|
|
|
|
|
|
|
|
|
|
|
- 并行多账本 |
|
|
|
|
|
账本(Ledger) |
|
|
|
|
|
- 大数据伸缩存储 |
|
|
|
|
|
- 条件检索 |
|
|
|
|
|
- 面向对象的合约代码编程模型 |
|
|
|
|
|
- 节点快速部署 |
|
|
|
|
|
- 多终端灵活接入 |
|
|
|
|
|
- 分布式自治的账户权限管理模型 |
|
|
|
|
|
|
|
|
|
|
|
## 二、对象模型 |
|
|
|
|
|
JD区块链的核心对象包括: |
|
|
|
|
|
|
|
|
|
|
|
- 账本(Ledger) |
|
|
|
|
|
一份账本(Ledger)实质上是由两部分组成: |
|
|
|
|
|
- 一组以“账户(Account)”表示的状态数据; |
|
|
|
|
|
- 以“区块的链条(Block-chain)”表示的状态数据的变更历史; |
|
|
|
|
|
|
|
|
|
|
|
JD区块链的“账本(Ledger)”是一个最顶层的管理数据的逻辑单元。在一个区块链节点构成的共识网络中,可以维护多套并行的“账本(Ledger)”。 |
|
|
|
|
|
|
|
|
|
|
|
- 账户(Account) |
|
|
|
|
|
- 在JD区块链中,账户(Account)被设计为包含“身份(Identity)”、“权限(Privilege)”、“状态(State)”、“控制规则(Control Rule)” 这4种属性的对象。 |
|
|
|
|
|
- 其中,“身份(Identity)”、“权限(Privilege)”这两种属性是一个面向应用的系统的基本功能; |
|
|
|
|
|
- “状态(State)”、“控制规则(Control Rule)” 这两种属性这是一个具备“图灵完备性”的系统的基本属性,使系统可以处理任意多样化的任务; |
|
|
|
|
|
- 在这里,“身份(Identity)”是一个抽象表述,其形式上就是一个“区块链地址(Address)”和相应的“非对称秘钥钥对(KeyPair)”/证书。 简单来说,一个“账户(Account)”就是一个区块链地址、公私钥对以及一套的权限配置. |
|
|
|
|
|
- 一个“账户(Account)”的“状态(State)”、“控制规则(Control Rule)” 这2种属性则是可选的,这提供了不同于其它区块链的账户/合约的一种新的使用方式,即一种数据和逻辑分离的应用设计思路(这在传统的web应用编程中被称为“贫血模型”)。同时,也意味着一个特定“账户”中的数据状态是可以跨账户/合约代码进行共享访问的。 |
|
|
|
|
|
- 从应用的视角来看,对“账户”的使用方式可以有几种模式: |
|
|
|
|
|
- 用于表示业务角色/用户: |
|
|
|
|
|
- 用于表示业务数据:仅有“状态(State)”没有“控制规则(Control Rule)”的账户,可称为数据账户,就有些类似于关系数据库中的“表(Table)”的作用,不同业务类别的数据则使用不同的账户来管理。 |
|
|
|
|
|
- 用于表示业务逻辑:仅有“控制规则(Control Rule)”没有“状态(State)”的账户,即所谓的合约账户,可表示某种用于处理数据的通用逻辑,可被授权访问特定的数据账户。 |
|
|
|
|
|
|
|
|
|
|
|
- 区块(Block) |
|
|
|
|
|
在概念上,与通常所说的区块的概念是一致的。 |
|
|
|
|
|
在实现上,一个区块的主要内容是包含了某一时刻提交的所有交易以及交易执行之后的状态数据的快照的hash,而不存储具体的交易操作和状态数据。 |
|
|
|
|
|
|
|
|
|
|
|
- 交易(Transaction) |
|
|
|
|
|
在概念上,与通常所说的Transaction的概念是一致的,表示一组需要原子执行的操作。 |
|
|
|
|
|
|
|
|
|
|
|
- 操作(Operation) |
|
|
|
|
|
操作是针对“账户(Account)”的“写”指令,包括以下几类: |
|
|
|
|
|
- 注册账户 |
|
|
|
|
|
- 更新账户的状态数据 |
|
|
|
|
|
- 更新账户的合约代码定义 |
|
|
|
|
|
- 调用账户的合约代码 |
|
|
|
|
|
|
|
|
|
|
|
- 合约代码(Contract Code) |
|
|
|
|
|
合约代码是一段用于对“账户(Account)”的状态数据执行操作的代码程序。 |
|
|
|
|
|
|
|
|
|
|
|
## 三、部署模型 |
|
|
|
|
|
|
|
|
|
|
|
1. 总体部署 |
|
|
|
|
|
![deployment architecture](docs/images/deployment.png) |
|
|
|
|
|
|
|
|
|
|
|
2. 系统组件 |
|
|
|
|
|
- 共识节点 |
|
|
|
|
|
- 复制节点 |
|
|
|
|
|
- SDK |
|
|
|
|
|
- 网关 |
|
|
|
|
|
- 终端 |
|
|
|
|
|
|
|
|
|
|
|
3. 配置和管理 |
|
|
|
|
|
|
|
|
|
|
|
## 四、账本结构 |
|
|
|
|
|
|
|
|
|
|
|
### 1. 账户生成算法 |
|
|
|
|
|
|
|
|
|
|
|
- 公私钥对 |
|
|
|
|
|
- 算法:默认ED25519 ,支持 SM2、CA; |
|
|
|
|
|
- 公钥存储格式:版本 + 算法标识 + 公私钥原始内容 + 校验码 |
|
|
|
|
|
- 字符编码方式:Base64 |
|
|
|
|
|
- 地址 |
|
|
|
|
|
- 算法 |
|
|
|
|
|
- 给定公钥 P (或由私钥 R 算出公钥 P) |
|
|
|
|
|
- 中间值 H1 = SHA256( P ) |
|
|
|
|
|
- 中间值 H2 = RIPEMD-160( H1 ) |
|
|
|
|
|
- 中间值 X = 版本 + 公钥算法标识 + H2 |
|
|
|
|
|
- 校验和 C = 前4字节( SHA256( SHA256( X )) ) |
|
|
|
|
|
- 地址 Address = Base58( X + C ) |
|
|
|
|
|
|
|
|
|
|
|
### 2. 区块 |
|
|
|
|
|
<table> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<th>属性</th> |
|
|
|
|
|
<th>名称</th> |
|
|
|
|
|
<th>说明</th> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>BlockHash</td> |
|
|
|
|
|
<td>当前区块 hash</td> |
|
|
|
|
|
<td>对区块中除此之外的其它所有属性一起进行哈希运算生成</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>BlockVersion </td> |
|
|
|
|
|
<td>区块版本</td> |
|
|
|
|
|
<td>表示区块-交易的属性结构的版本号;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>PreviousBlockHash</td> |
|
|
|
|
|
<td>上一区块 hash</td> |
|
|
|
|
|
<td></td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>BlockNumber</td> |
|
|
|
|
|
<td>区块高度</td> |
|
|
|
|
|
<td>区块高度是一个区块在链中的序号;<br>创始区块的高度为 0,每个新区块的高度依次递增;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>AccountHash</td> |
|
|
|
|
|
<td>账户树hash</td> |
|
|
|
|
|
<td>账户的 Merkle Tree 根的 hash</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>AccountCount</td> |
|
|
|
|
|
<td>账户数量</td> |
|
|
|
|
|
<td>区块生成时账本中的全部账户的总数</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>TxTreeHash</td> |
|
|
|
|
|
<td>交易树 hash</td> |
|
|
|
|
|
<td>本区块的交易集合的 Merkle Tree 根的 hash</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>TxCount</td> |
|
|
|
|
|
<td>区块交易数量</td> |
|
|
|
|
|
<td>当前区块包含的交易的数量;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>TxTotalCount</td> |
|
|
|
|
|
<td>账本交易总数</td> |
|
|
|
|
|
<td>截止到当前区块为止当前账本的所有交易的总数量;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>CloseTime</td> |
|
|
|
|
|
<td>区块关闭时间</td> |
|
|
|
|
|
<td>生成当前区块时的区块链节点的网络时间;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
</table> |
|
|
|
|
|
|
|
|
|
|
|
### 3. 交易 |
|
|
|
|
|
<table> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<th>属性</th> |
|
|
|
|
|
<th>名称</th> |
|
|
|
|
|
<th>说明</th> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>Hash</td> |
|
|
|
|
|
<td>当前交易 hash</td> |
|
|
|
|
|
<td>对交易中除此之外的其它所有属性一起进行哈希运算生成</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>LedgerNumber</td> |
|
|
|
|
|
<td>区块高度</td> |
|
|
|
|
|
<td>交易被包含的区块高度</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>BlobHash</td> |
|
|
|
|
|
<td>交易数据块hash</td> |
|
|
|
|
|
<td>交易的数据块是交易的原始数据,包含客户端提交的交易的全部操作及其参数; |
|
|
|
|
|
<br>交易的参与者需要使用私钥对交易数据块进行签名;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>Operations</td> |
|
|
|
|
|
<td>操作列表</td> |
|
|
|
|
|
<td>交易的操作列表;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>Sponsor</td> |
|
|
|
|
|
<td>交易发起人</td> |
|
|
|
|
|
<td>交易发起人的账户地址;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>SequenceNumber</td> |
|
|
|
|
|
<td>交易序号</td> |
|
|
|
|
|
<td>交易序号记录了一个特定的发起人的交易的顺序号,等同于该发起人历史上发起的交易的总数;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>Signatures</td> |
|
|
|
|
|
<td>签名列表</td> |
|
|
|
|
|
<td>由交易发起人和其它参与者对交易数据块的签名的列表;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>Result</td> |
|
|
|
|
|
<td>交易结果</td> |
|
|
|
|
|
<td>0 - 表示执行成功;非零表示执行失败;<br>注:最终的账本只包含成功的交易;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
</table> |
|
|
|
|
|
|
|
|
|
|
|
### 4. 操作 |
|
|
|
|
|
<table> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<th>属性</th> |
|
|
|
|
|
<th>名称</th> |
|
|
|
|
|
<th>说明</th> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>OpType</td> |
|
|
|
|
|
<td>操作类型</td> |
|
|
|
|
|
<td> |
|
|
|
|
|
一级操作类型包括:注册账户、配置权限、写入键值数据、写入对象数据、定义合约代码、调用合约代码;<br> |
|
|
|
|
|
“键值数据写入”操作的子操作类型包括:填入键值、移除键、数值增加、数值减少;<br> |
|
|
|
|
|
“对象数据写入”操作的自操作类型包括:插入对象、更新对象、移除对象; |
|
|
|
|
|
</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>Args</td> |
|
|
|
|
|
<td>参数列表</td> |
|
|
|
|
|
<td>与操作类型相对应的参数列表;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>SubOps</td> |
|
|
|
|
|
<td>子操作列表</td> |
|
|
|
|
|
<td>“子操作”是“操作”的递归定义,由“操作类型”来标识;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
</table> |
|
|
|
|
|
|
|
|
|
|
|
### 5. 账户 |
|
|
|
|
|
<table> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<th>属性</th> |
|
|
|
|
|
<th>名称</th> |
|
|
|
|
|
<th>说明</th> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>Address</td> |
|
|
|
|
|
<td>地址</td> |
|
|
|
|
|
<td>账户的唯一标识</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>RegNumber</td> |
|
|
|
|
|
<td>注册号</td> |
|
|
|
|
|
<td>账户被注册到区块链的区块高度;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>TxSquenceNumber</td> |
|
|
|
|
|
<td>交易序列号</td> |
|
|
|
|
|
<td>由账户发起的交易的序列号,初始为 0,账户每发起一个交易则增加1;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>ModelVersion</td> |
|
|
|
|
|
<td>账户模型版本</td> |
|
|
|
|
|
<td>表示构成一个账户结构的属性模型的程序版本号;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>Version</td> |
|
|
|
|
|
<td>账户版本</td> |
|
|
|
|
|
<td>初始为 0,对账户的每一次变更(包括对权限设置、状态和合约代码的变更)都会使账户状态版本增加 1 ;<br>注:交易序号的改变不会导致账户版本的增加;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>PrivilegeHash</td> |
|
|
|
|
|
<td>权限 hash</td> |
|
|
|
|
|
<td>权限树的根hash;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>PrivilegeVersion</td> |
|
|
|
|
|
<td>权限版本</td> |
|
|
|
|
|
<td>初始为 0, 每次对权限的变更都导致版本号加 1;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>StateType</td> |
|
|
|
|
|
<td>状态类型</td> |
|
|
|
|
|
<td>账户的状态类型有3种:空类型(NIL);键值类型;对象类型;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>StateVersion</td> |
|
|
|
|
|
<td>状态版本</td> |
|
|
|
|
|
<td>账户的状态类型有3种:空类型(NIL);键值类型;对象类型;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>StateHash</td> |
|
|
|
|
|
<td>状态哈希</td> |
|
|
|
|
|
<td>数据状态的 merkle tree 的根hash;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>CodeHash</td> |
|
|
|
|
|
<td>合约代码哈希</td> |
|
|
|
|
|
<td>由“账户地址+合约代码版本号+合约代码内容”生成的哈希;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
<tr> |
|
|
|
|
|
<td>CodeVersion</td> |
|
|
|
|
|
<td>代码版本</td> |
|
|
|
|
|
<td>初始为 0,每次对代码的变更都使版本加 1 ;</td> |
|
|
|
|
|
</tr> |
|
|
|
|
|
</table> |
|
|
|
|
|
|
|
|
|
|
|
## 五、编程接口 |
|
|
|
|
|
|
|
|
|
|
|
### 1. 服务连接 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
```java |
|
|
|
|
|
//创建服务代理 |
|
|
|
|
|
public static BlockchainKeyPair CLIENT_CERT = BlockchainKeyGenerator.getInstance().generate(); |
|
|
|
|
|
final String GATEWAY_IP = "127.0.0.1"; |
|
|
|
|
|
final int GATEWAY_PORT = 80; |
|
|
|
|
|
final boolean SECURE = false; |
|
|
|
|
|
GatewayServiceFactory serviceFactory = GatewayServiceFactory.connect(GATEWAY_IP, GATEWAY_PORT, SECURE, |
|
|
|
|
|
CLIENT_CERT); |
|
|
|
|
|
// 创建服务代理; |
|
|
|
|
|
BlockchainService service = serviceFactory.getBlockchainService(); |
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
## 一、项目介绍 |
|
|
|
|
|
JD Chain 的目标是实现一个面向企业应用场景的通用区块链框架系统,能够作为企业级基础设施,为业务创新提供高效、灵活和安全的解决方案。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 2. 用户注册 |
|
|
|
|
|
|
|
|
## 二、部署模型 |
|
|
|
|
|
|
|
|
|
|
|
JD Chain 主要部署组件包括以下几种: |
|
|
|
|
|
|
|
|
```java |
|
|
|
|
|
// 创建服务代理; |
|
|
|
|
|
BlockchainService service = serviceFactory.getBlockchainService(); |
|
|
|
|
|
// 在本地定义注册账号的 TX; |
|
|
|
|
|
TransactionTemplate txTemp = service.newTransaction(ledgerHash); |
|
|
|
|
|
SignatureFunction signatureFunction = asymmetricCryptography.getSignatureFunction(CryptoAlgorithm.ED25519); |
|
|
|
|
|
CryptoKeyPair cryptoKeyPair = signatureFunction.generateKeyPair(); |
|
|
|
|
|
BlockchainKeyPair user = new BlockchainKeyPair(cryptoKeyPair.getPubKey(), cryptoKeyPair.getPrivKey()); |
|
|
|
|
|
|
|
|
|
|
|
txTemp.users().register(user.getIdentity()); |
|
|
|
|
|
|
|
|
- 共识节点 |
|
|
|
|
|
|
|
|
// TX 准备就绪; |
|
|
|
|
|
PreparedTransaction prepTx = txTemp.prepare(); |
|
|
|
|
|
// 使用私钥进行签名; |
|
|
|
|
|
CryptoKeyPair keyPair = getSponsorKey(); |
|
|
|
|
|
prepTx.sign(keyPair); |
|
|
|
|
|
|
|
|
共识节点即参与共识的节点,这是系统的核心组件,承担了运行共识协议、管理账本数据、运行智能合约的职责。 |
|
|
|
|
|
|
|
|
// 提交交易; |
|
|
|
|
|
prepTx.commit(); |
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
一个区块链网络由多个共识节点组成,共识节点的数量范围由选择的共识协议决定。 |
|
|
|
|
|
|
|
|
|
|
|
共识节点和账本是两个不同的概念,共识节点是个物理上的概念,账本是个逻辑上的概念。JD Chain 是一个多账本区块链系统,一个共识节点上可以装载运行多个账本。账本是数据维度的独立管理单元。共识节点和账本的关系,就像关系数据库系统中,数据库服务器和数据库实例的关系。 |
|
|
|
|
|
|
|
|
### 3. 数据账户注册 |
|
|
|
|
|
|
|
|
共识节点通常都部署在参与方的内部网络中,通过由网络管理员指定的安全的网络出口与其它的共识节点建立通讯连接。 |
|
|
|
|
|
|
|
|
|
|
|
共识节点在形态上是服务器中的一个处理进程,背后需要连接一个本地或者内网的NoSQL数据库系统作为账本的存储。当前版本,共识节点目前是单进程的,未来版本将实现多进程以及多服务器集群模式。 |
|
|
|
|
|
|
|
|
```java |
|
|
|
|
|
// 创建服务代理; |
|
|
|
|
|
BlockchainService service = serviceFactory.getBlockchainService(); |
|
|
|
|
|
// 在本地定义注册账号的 TX; |
|
|
|
|
|
TransactionTemplate txTemp = service.newTransaction(ledgerHash); |
|
|
|
|
|
SignatureFunction signatureFunction = asymmetricCryptography.getSignatureFunction(CryptoAlgorithm.ED25519); |
|
|
|
|
|
CryptoKeyPair cryptoKeyPair = signatureFunction.generateKeyPair(); |
|
|
|
|
|
BlockchainKeyPair dataAccount = new BlockchainKeyPair(cryptoKeyPair.getPubKey(), cryptoKeyPair.getPrivKey()); |
|
|
|
|
|
|
|
|
|
|
|
txTemp.dataAccounts().register(dataAccount.getIdentity()); |
|
|
|
|
|
|
|
|
|
|
|
// TX 准备就绪; |
|
|
|
|
|
PreparedTransaction prepTx = txTemp.prepare(); |
|
|
|
|
|
// 使用私钥进行签名; |
|
|
|
|
|
CryptoKeyPair keyPair = getSponsorKey(); |
|
|
|
|
|
prepTx.sign(keyPair); |
|
|
|
|
|
|
|
|
|
|
|
// 提交交易; |
|
|
|
|
|
prepTx.commit(); |
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
- 网关节点 |
|
|
|
|
|
|
|
|
### 4. 写入数据 |
|
|
|
|
|
|
|
|
网关节点是负责终端接入的节点,负责终端连接、协议转换、交易准入、本地密码运算、密钥管理等职责。 |
|
|
|
|
|
|
|
|
```java |
|
|
|
|
|
// 创建服务代理; |
|
|
|
|
|
BlockchainService service = serviceFactory.getBlockchainService(); |
|
|
|
|
|
|
|
|
|
|
|
HashDigest ledgerHash = getLedgerHash(); |
|
|
|
|
|
// 在本地定义注册账号的 TX; |
|
|
|
|
|
TransactionTemplate txTemp = service.newTransaction(ledgerHash); |
|
|
|
|
|
|
|
|
|
|
|
// -------------------------------------- |
|
|
|
|
|
// 将商品信息写入到指定的账户中; |
|
|
|
|
|
// 对象将被序列化为 JSON 形式存储,并基于 JSON 结构建立查询索引; |
|
|
|
|
|
String commodityDataAccount = "GGhhreGeasdfasfUUfehf9932lkae99ds66jf=="; |
|
|
|
|
|
Commodity commodity1 = new Commodity(); |
|
|
|
|
|
txTemp.dataAccount(commodityDataAccount).set("ASSET_CODE", commodity1.getCode().getBytes(), -1); |
|
|
|
|
|
|
|
|
|
|
|
// TX 准备就绪; |
|
|
|
|
|
PreparedTransaction prepTx = txTemp.prepare(); |
|
|
|
|
|
|
|
|
|
|
|
String txHash = ByteArray.toBase64(prepTx.getHash().toBytes()); |
|
|
|
|
|
// 使用私钥进行签名; |
|
|
|
|
|
CryptoKeyPair keyPair = getSponsorKey(); |
|
|
|
|
|
prepTx.sign(keyPair); |
|
|
|
|
|
|
|
|
|
|
|
// 提交交易; |
|
|
|
|
|
prepTx.commit(); |
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
网关节点是一种轻量节点,需要绑定一个特定参与方的密钥对,连接到一个或多个共识节点。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 5. 查询数据 |
|
|
|
|
|
|
|
|
网关节点向共识节点的连接是需要通过认证的,绑定的参与方的密钥对必须事先已经注册到区块链账本中,且得到接入授权。 |
|
|
|
|
|
|
|
|
> 注:详细的查询可参考模块sdk-samples中SDK_GateWay_Query_Test_相关测试用例 |
|
|
|
|
|
|
|
|
- 终端 |
|
|
|
|
|
|
|
|
```java |
|
|
|
|
|
// 创建服务代理; |
|
|
|
|
|
BlockchainService service = serviceFactory.getBlockchainService(); |
|
|
|
|
|
|
|
|
|
|
|
// 查询区块信息; |
|
|
|
|
|
// 区块高度; |
|
|
|
|
|
long ledgerNumber = service.getLedger(LEDGER_HASH).getLatestBlockHeight(); |
|
|
|
|
|
// 最新区块; |
|
|
|
|
|
LedgerBlock latestBlock = service.getBlock(LEDGER_HASH, ledgerNumber); |
|
|
|
|
|
// 区块中的交易的数量; |
|
|
|
|
|
long txCount = service.getTransactionCount(LEDGER_HASH, latestBlock.getHash()); |
|
|
|
|
|
// 获取交易列表; |
|
|
|
|
|
LedgerTransaction[] txList = service.getTransactions(LEDGER_HASH, ledgerNumber, 0, 100); |
|
|
|
|
|
// 遍历交易列表 |
|
|
|
|
|
for (LedgerTransaction ledgerTransaction : txList) { |
|
|
|
|
|
TransactionContent txContent = ledgerTransaction.getTransactionContent(); |
|
|
|
|
|
Operation[] operations = txContent.getOperations(); |
|
|
|
|
|
if (operations != null && operations.length > 0) { |
|
|
|
|
|
for (Operation operation : operations) { |
|
|
|
|
|
operation = ClientOperationUtil.read(operation); |
|
|
|
|
|
// 操作类型:数据账户注册操作 |
|
|
|
|
|
if (operation instanceof DataAccountRegisterOperation) { |
|
|
|
|
|
DataAccountRegisterOperation daro = (DataAccountRegisterOperation) operation; |
|
|
|
|
|
BlockchainIdentity blockchainIdentity = daro.getAccountID(); |
|
|
|
|
|
} |
|
|
|
|
|
// 操作类型:用户注册操作 |
|
|
|
|
|
else if (operation instanceof UserRegisterOperation) { |
|
|
|
|
|
UserRegisterOperation uro = (UserRegisterOperation) operation; |
|
|
|
|
|
BlockchainIdentity blockchainIdentity = uro.getUserID(); |
|
|
|
|
|
} |
|
|
|
|
|
// 操作类型:账本注册操作 |
|
|
|
|
|
else if (operation instanceof LedgerInitOperation) { |
|
|
|
|
|
|
|
|
|
|
|
LedgerInitOperation ledgerInitOperation = (LedgerInitOperation)operation; |
|
|
|
|
|
LedgerInitSetting ledgerInitSetting = ledgerInitOperation.getInitSetting(); |
|
|
|
|
|
|
|
|
|
|
|
ParticipantNode[] participantNodes = ledgerInitSetting.getConsensusParticipants(); |
|
|
|
|
|
} |
|
|
|
|
|
// 操作类型:合约发布操作 |
|
|
|
|
|
else if (operation instanceof ContractCodeDeployOperation) { |
|
|
|
|
|
ContractCodeDeployOperation ccdo = (ContractCodeDeployOperation) operation; |
|
|
|
|
|
BlockchainIdentity blockchainIdentity = ccdo.getContractID(); |
|
|
|
|
|
} |
|
|
|
|
|
// 操作类型:合约执行操作 |
|
|
|
|
|
else if (operation instanceof ContractEventSendOperation) { |
|
|
|
|
|
ContractEventSendOperation ceso = (ContractEventSendOperation) operation; |
|
|
|
|
|
} |
|
|
|
|
|
// 操作类型:KV存储操作 |
|
|
|
|
|
else if (operation instanceof DataAccountKVSetOperation) { |
|
|
|
|
|
DataAccountKVSetOperation.KVWriteEntry[] kvWriteEntries = |
|
|
|
|
|
((DataAccountKVSetOperation) operation).getWriteSet(); |
|
|
|
|
|
if (kvWriteEntries != null && kvWriteEntries.length > 0) { |
|
|
|
|
|
for (DataAccountKVSetOperation.KVWriteEntry kvWriteEntry : kvWriteEntries) { |
|
|
|
|
|
BytesValue bytesValue = kvWriteEntry.getValue(); |
|
|
|
|
|
DataType dataType = bytesValue.getType(); |
|
|
|
|
|
Object showVal = ClientOperationUtil.readValueByBytesValue(bytesValue); |
|
|
|
|
|
System.out.println("writeSet.key=" + kvWriteEntry.getKey()); |
|
|
|
|
|
System.out.println("writeSet.value=" + showVal); |
|
|
|
|
|
System.out.println("writeSet.type=" + dataType); |
|
|
|
|
|
System.out.println("writeSet.version=" + kvWriteEntry.getExpectedVersion()); |
|
|
|
|
|
} |
|
|
|
|
|
} |
|
|
|
|
|
} |
|
|
|
|
|
} |
|
|
|
|
|
} |
|
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
// 根据交易的 hash 获得交易;注:客户端生成 PrepareTransaction 时得到交易hash; |
|
|
|
|
|
HashDigest txHash = txList[0].getTransactionContent().getHash(); |
|
|
|
|
|
Transaction tx = service.getTransactionByContentHash(LEDGER_HASH, txHash); |
|
|
|
|
|
// 获取数据; |
|
|
|
|
|
String commerceAccount = "GGhhreGeasdfasfUUfehf9932lkae99ds66jf=="; |
|
|
|
|
|
String[] objKeys = new String[] { "x001", "x002" }; |
|
|
|
|
|
KVDataEntry[] kvData = service.getDataEntries(LEDGER_HASH, commerceAccount, objKeys); |
|
|
|
|
|
|
|
|
|
|
|
long payloadVersion = kvData[0].getVersion(); |
|
|
|
|
|
|
|
|
|
|
|
// 获取数据账户下所有的KV列表 |
|
|
|
|
|
KVDataEntry[] kvData = service.getDataEntries(ledgerHash, commerceAccount, 0, 100); |
|
|
|
|
|
if (kvData != null && kvData.length > 0) { |
|
|
|
|
|
for (KVDataEntry kvDatum : kvData) { |
|
|
|
|
|
System.out.println("kvData.key=" + kvDatum.getKey()); |
|
|
|
|
|
System.out.println("kvData.version=" + kvDatum.getVersion()); |
|
|
|
|
|
System.out.println("kvData.type=" + kvDatum.getType()); |
|
|
|
|
|
System.out.println("kvData.value=" + kvDatum.getValue()); |
|
|
|
|
|
} |
|
|
|
|
|
} |
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
终端泛指可以提交交易的客户端,典型来说,包括人、自动化设备、链外的信息系统等。 |
|
|
|
|
|
|
|
|
|
|
|
终端只能通过网关节点来提交交易。终端提交的交易需要用体现该终端身份的私钥来签署,产生一份电子签名。随后当交易提交给网关节点时,网关节点需要在把交易提交到共识节点之前,对交易请求以网关节点绑定的私钥追加一项“节点签名”。 |
|
|
|
|
|
|
|
|
### 6. 合约发布 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 备份节点 |
|
|
|
|
|
|
|
|
```java |
|
|
|
|
|
|
|
|
|
|
|
// 创建服务代理; |
|
|
|
|
|
BlockchainService service = serviceFactory.getBlockchainService(); |
|
|
|
|
|
|
|
|
|
|
|
// 在本地定义TX模板 |
|
|
|
|
|
TransactionTemplate txTemp = service.newTransaction(ledgerHash); |
|
|
|
|
|
|
|
|
仅对账本数据提供备份,但不参与交易共识的节点。(注:目前版本中尚未实现,将在后续版本中提供) |
|
|
|
|
|
|
|
|
// 合约内容读取 |
|
|
|
|
|
byte[] contractBytes = FileUtils.readBytes(new File(CONTRACT_FILE)); |
|
|
|
|
|
|
|
|
|
|
|
// 生成用户 |
|
|
|
|
|
BlockchainIdentityData blockchainIdentity = new BlockchainIdentityData(getSponsorKey().getPubKey()); |
|
|
|
|
|
|
|
|
![](docs/images/deployment.jpg) |
|
|
|
|
|
|
|
|
// 发布合约 |
|
|
|
|
|
txTemp.contracts().deploy(blockchainIdentity, contractBytes); |
|
|
|
|
|
|
|
|
|
|
|
// TX 准备就绪; |
|
|
|
|
|
PreparedTransaction prepTx = txTemp.prepare(); |
|
|
|
|
|
|
|
|
## 三、编译源代码 |
|
|
|
|
|
|
|
|
// 使用私钥进行签名; |
|
|
|
|
|
CryptoKeyPair keyPair = getSponsorKey(); |
|
|
|
|
|
|
|
|
1. 安装 Maven 环境 |
|
|
|
|
|
|
|
|
prepTx.sign(keyPair); |
|
|
|
|
|
|
|
|
JD Chain 当前版本以 Java 语言开发,需要安装配置 JVM 和 Maven,JDK 版本不低于1.8 。(没有特殊要求,请按标准方法安装,此处不赘述) |
|
|
|
|
|
|
|
|
|
|
|
2. 安装 Git 工具 |
|
|
|
|
|
|
|
|
|
|
|
为了能够执行 git clone 命令获取代码仓库。 (没有特殊要求,请按标准方法安装,此处不赘述) |
|
|
|
|
|
|
|
|
|
|
|
3. 工程代码 |
|
|
|
|
|
|
|
|
// 提交交易; |
|
|
|
|
|
TransactionResponse transactionResponse = prepTx.commit(); |
|
|
|
|
|
|
|
|
JD Chain 源代码包括 3 个代码仓库 |
|
|
|
|
|
|
|
|
assertTrue(transactionResponse.isSuccess()); |
|
|
|
|
|
|
|
|
- jdchain |
|
|
|
|
|
- 这是当前仓库,也是核心仓库,包含了共识节点、网关节点、SDK等一切部署组件。依赖于 explorer 和 bftsmart 这两个仓库先进行编译安装; |
|
|
|
|
|
|
|
|
|
|
|
- explorer |
|
|
|
|
|
- 这是区块链浏览器的前端Web页面的工程,需要编译成静态资源包,由网关节点集成到一起部署。 |
|
|
|
|
|
- 地址:git@github.com:blockchain-jd-com/explorer.git |
|
|
|
|
|
|
|
|
// 打印合约地址 |
|
|
|
|
|
System.out.println(blockchainIdentity.getAddress().toBase58()); |
|
|
|
|
|
|
|
|
- bftsmart |
|
|
|
|
|
- 这是bftsmart共识协议的工程,需要先编译安装到本地 maven 仓库; |
|
|
|
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
### 7. 合约执行 |
|
|
|
|
|
|
|
|
4. 命令操作 |
|
|
|
|
|
|
|
|
```java |
|
|
|
|
|
|
|
|
- 编译安装 explorer 到本地 maven 仓库; |
|
|
|
|
|
```sh |
|
|
|
|
|
$ git clone git@github.com:blockchain-jd-com/explorer.git explorer |
|
|
|
|
|
|
|
|
// 创建服务代理; |
|
|
|
|
|
BlockchainService service = serviceFactory.getBlockchainService(); |
|
|
|
|
|
|
|
|
$ cd explorer |
|
|
|
|
|
|
|
|
// 在本地定义TX模板 |
|
|
|
|
|
TransactionTemplate txTemp = service.newTransaction(ledgerHash); |
|
|
|
|
|
|
|
|
$ git checkout master |
|
|
|
|
|
|
|
|
// 合约地址 |
|
|
|
|
|
String contractAddressBase58 = ""; |
|
|
|
|
|
|
|
|
|
|
|
// 使用接口方式调用合约 |
|
|
|
|
|
TransferContract transferContract = txTpl.contract(contractAddress, TransferContract.class); |
|
|
|
|
|
|
|
|
|
|
|
// 使用decode方式调用合约内部方法(create方法) |
|
|
|
|
|
// 返回GenericValueHolder可通过get方法获取结果,但get方法需要在commit调用后执行 |
|
|
|
|
|
GenericValueHolder<String> result = ContractReturnValue.decode(transferContract.create(address, account, money)); |
|
|
|
|
|
|
|
|
|
|
|
PreparedTransaction ptx = txTpl.prepare(); |
|
|
|
|
|
|
|
|
|
|
|
ptx.sign(adminKey); |
|
|
|
|
|
|
|
|
|
|
|
TransactionResponse transactionResponse = ptx.commit(); |
|
|
|
|
|
|
|
|
$ mvn clean install |
|
|
|
|
|
|
|
|
String cotractExecResult = result.get(); |
|
|
|
|
|
|
|
|
|
|
|
// TransactionResponse也提供了可供查询结果的接口 |
|
|
|
|
|
OperationResult[] operationResults = transactionResponse.getOperationResults(); |
|
|
|
|
|
|
|
|
``` |
|
|
|
|
|
- 编译安装 bftsmart 到本地 maven 仓库; |
|
|
|
|
|
- 需要手动先安装一个第三方包,位于仓库根目录下 lib/core-0.1.4.jar |
|
|
|
|
|
```sh |
|
|
|
|
|
$ git clone git@github.com:blockchain-jd-com/bftsmart.git bftsmart |
|
|
|
|
|
|
|
|
|
|
|
$ cd bftsmart |
|
|
|
|
|
|
|
|
|
|
|
$ git checkout master |
|
|
|
|
|
|
|
|
// 通过OperationResult获取结果 |
|
|
|
|
|
for (int i = 0; i < operationResults.length; i++) { |
|
|
|
|
|
OperationResult opResult = operationResults[i]; |
|
|
|
|
|
System.out.printf("Operation[%s].result = %s \r\n", |
|
|
|
|
|
opResult.getIndex(), BytesValueEncoding.decode(opResult.getResult())); |
|
|
|
|
|
} |
|
|
|
|
|
|
|
|
$ mvn install:install-file -Dfile=lib/core-0.1.4.jar -DgroupId=com.yahoo.ycsb -DartifactId=core -Dversion=0.1.4 -Dpackaging=jar |
|
|
|
|
|
|
|
|
|
|
|
$ mvn clean install |
|
|
|
|
|
|
|
|
|
|
|
``` |
|
|
|
|
|
- 编译 jdchain 工程; |
|
|
|
|
|
- 当编译完成后,共识节点的安装包位于 "仓库根目录"/source/deployment/deployment-peer/target/jdchain-peer-1.0.1.RELEASE.zip |
|
|
|
|
|
- 当编译完成后,网关节点的安装包位于 "仓库根目录"/source/deployment/deployment-gateway/target/jdchain-gateway-1.0.1.RELEASE.zip |
|
|
|
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
```sh |
|
|
|
|
|
$ git clone git@github.com:blockchain-jd-com/jdchain.git jdchain |
|
|
|
|
|
|
|
|
|
|
|
$ cd jdchain/source |
|
|
|
|
|
|
|
|
|
|
|
$ git checkout master |
|
|
|
|
|
|
|
|
|
|
|
$ mvn clean package |
|
|
|
|
|
|
|
|
|
|
|
``` |