企业组网(Fabric)

1 联盟链创建

  登录网络操作者系统后,进入区块链管理,点击网络创建按钮,并选择联盟链,即可开始联盟链的创建,用户可以通过每一步的信息输入完成组网操作。

  组网过程分为网络概述、邀请成员、底层选择、详细配置四个步骤,每个步骤填写完必填项目之后,点击下一步按钮即可以进入下一页面。

以下展示网络发起方的操作(受邀方请查看“邀请我的链”部分操作)。

img

网络概览 页面输入信息如下:

参数名 必填项 规则
网络名称 网络名称只得包含小写字母与数字,且不能以数字开头
跨域 单选项,跨域为跨JD BaaS平台组网,非跨域为单独JD BaaS平台组网
网络说明 中文或者英文,长度不超过200字

邀请成员页面需要添加受邀人,在选择框内输入受邀人账号,点击查询按钮,再勾选受邀人完成邀请操作。如邀请人输入错误,可以取消勾选以删除该邀请人。此页面一次可以邀请多人。

img

底层选择页面选择底层为Fabric。

img

选择后,点击下一步跳转至详细配置页面如下,开始进行配置。 img

详细配置页面中需要输入区块链基本信息,具体输入如下:

参数名 必填项 规则
共识模式 kafka分布式订阅,etcdraft和hotstuff共识算法作为共识服务
节点数 选择初始节点数
底层协议版本 根据共识算法的不同,提供1.4.0,2.0.0,2.2.0三种版本供以选择,只能选择一个版本
CA服务 仅可选择JDCA
多orderer 选择是否支持多orderer,多orderer可以在一个网络内设定多个排序节点
中间CA 选择是否使用中间CA,若选择是,则需要设置中间CA的用户名和密码
数据归档 选择是否使用数据归档,若选择是,则需要设置数据归档逻辑
国密 选择是否支持国密算法
TLS 选择是否支持TLS
存储 区块链数据存储,需要设置存储容量
API用户 用来调用API接口的用户名称,应用系统调用时需要使用该用户调用
API密码 API用户的密码,文字与字母组合
数据库类型 LevelDB和couchDB 中选择一项
公网IP 可以根据要求输入公网IP
敏感词 选择是否支持发起者的敏感词管理
浏览器 选择是否启用浏览器功能,如选择时,公网IP为必填项
多网络 默认选择否

输入完毕信息后点击发送按钮,系统开始创建区块链网络的进程。点击按钮可以查看运行状态。 img

当所有状态为running时,区块链网络建立完毕。 img

网络创建完毕后,可以点击网络名称链接,进入网络详情页面。

2 证书管理

  在当前版本中,建链完毕后自动完成两个节点证书的申请peer0和peer1。 img

  证书申请页面分为基本信息和高级信息部分,具体展示如下: img

此页面字段说明如下:

参数名 必填项 规则
证书名称 可以输入证书名称,必须英文,不超过20
证书密码 证书密码,数字输入
证书类型 可以选择普通节点和用户
域名 如有域名的特殊要求,可以写入域名
区域 有特殊的区域要去,可以输入区域信息
地址 有特殊的地址需求,可以输入地址信息
部门 有特殊的部门需求,可以输入部门信息

  在列表页面查看到证书信息,在此页面,可以点击证书名称查看证书的详细内容。

img

证书详情页面

  每一个证书都有相应的操作权限,证书管理的操作权限包括查询更新下载

  查询证书可以在输入框中输入证书名称,之后点击查询按钮即可查询对应名称的证书。

  更新证书可以更新证书密码、域名、区域、地址、部门信息。

  点击下载按钮,可以下载证书内容至本地保存。

证书更新页面

img

3 账本管理

账本管理是区块链中一项基本服务,账本管理可以帮助用户创建、加入、邀请加入、以及对账本的一系列操作,在每个区块链网络中都有账本管理的tab页面。首次进入时需要创建账本,点击账本创建按钮即可进行账本的创建,创建账本需要输入的信息如下:

参数名 必填项 规则
受邀人 选择一个受邀人,受邀人必须已经加入到创建账本的区块链网络中
solidity合约 选择是否支持solidity合约
账本名称 输入账本名称,只能英文输入,字符长度不大于20
账本说明 中文或者英文账本说明,字数不超过200

  账本创建时需要进行人员邀请,点击受邀人按钮,在左上角的查询框内输入对应的组织账号,点击查询按钮。在下方会展示受邀人信息,对于需要邀请的受邀人,点击“+”按钮,受邀人将出现在下方表格中。可以一次添加多个受邀人,如有错误的情况,可以点击删除按钮删除受邀人。选择完成点击添加按钮,完成邀请。

  账本创建的页面如下,输入完毕所有信息后,可以点击确认按钮完成账本的创建。 img

  账本创建后,可以在账本列表中查询相关信息,账本列表与区块链网络列表一样,进行了详细的tab页面区分,为了方便查看,以下根据不同的tab页进行列表功能的详细描述。

img

我创建的账本:我创建的账本列表,可以对账本进行一些授权操作,包括公开/隐藏准入。公开/隐藏功能可以控制账本是否在区块链网络中都可见。准入功能可以同意其它同加入账本的申请。

我加入的账本:在我加入的账本下可以查看账本信息,点击账本名称链接,可以进入账本查看详情信息。账本详细信息中,还可以对链码进行管理,此部分在链码管理中详述。

已公开的账本:账本创建者在创建完成账本后,对账本进行公开操作,公开的账本在相同网络下可以查看。

邀请我的账本:账本的创建者在创建账本时,或者在账本创建后。可以邀请同网络下的其它成员加入账本。受邀人员在“邀请我的”页签下可以看到受邀信息,并确定是否要加入网络,如要加入,点击准入按钮,查看加入账本标签页,可以点击同意或者拒绝按钮加入或者拒绝加入网络。

4 合约管理

  智能合约作为应用和区块链交互的重要桥梁,也是JD BaaS区块链技术服务能力的核心之一。利用JD BaaS平台的合约管理功能,可以有效的管理上传、部署合约,同时进行版本的管理。

  进入任意网络后点击合约管理页签,可以看到合约管理列表页面,首先需要手工创建一个合约。同时该列表页提供合约查询功能,输入合约名称后点击查询按钮可以查询到符合条件的合约信息。

img

合约列表页面

  点击安装合约按钮,可以打开合约创建的页面。页面输入信息如下:

参数名 必填项 规则
受邀人 选择一个受邀人,受邀人必须已经加入到合约创建的账本中。
合约名称 输入合约名称,只能英文输入,字符长度不大于20
合约版本 输入合约版本,只能数字输入,长度不超过5
参数 输入合约参数
合约文件 在本地系统中上传一个合约文件,要求文件必须为.zip格式

  为合约添加受邀人需要点击受邀人按钮,下方会展示受邀人信息,可以一次添加多个受邀人,如有错误的情况,去掉勾选删除受邀人。勾选受邀人点击添加按钮,完成邀请。

img

添加受邀人

  合约上传必须是.zip文件,选择完毕文件后,系统会从本地将文件上传服务器。

img

合约上传完成

  输入完毕可以点击安装按钮进行安装操作。合约建立完毕后可以在列表页面查看,合约列表页面与区块链网络、账本一样,区分了不同的权限页签,方便用户快速找到自己需要的合约信息。下面将分页签介绍各个列表的功能和操作权限。

我创建的合约:此页签下可以对创建的合约进行查看,合约的公开/隐藏准入节点信息均可以在此页面进行操作。

公开和隐藏可以操作合约的状态,是否在该账本下所有参与方都可以看到并申请加入该合约。公开状态下的合约可以被查看并申请加入。

img

合约状态

  准入功能用来审核需要加入合约的组织。准入页面打开后,如果有成员申请加入就可以看到申请人的姓名和公司,可以选择同意拒绝对方加入该合约。

img

合约准入页面

  对于我创建的合约,还可以进行更新操作,他人创建的合约不可进行更新。也可以操作合约,对合约进行调用。同时也会显示节点信息,保证用户查看合约节点情况。更新合约需要输入的信息如下:

参数名 必填项 规则
合约名称 输入合约名称,只能英文输入,字符长度不大于20
合约版本 输入合约版本,只能数字输入,长度不超过5
参数 输入合约参数
合约文件 在本地系统中上传一个合约文件,要求文件必须为.zip格式

  完成信息输入后,点击安装按钮,可以进行合约的更新操作。

img

合约更新页面

  同样,对于安装完毕的合约,可以在此页面进行一个简单调用,输入对应的合约方法可以查看参数调用是否正确。

img

合约调用页面

  节点信息功能可以让用户快速知道合约的基本信息,目前展示order和peer相关信息。

img

节点信息页面

我加入的合约:受邀请并且同意加入后,合约会显示在此页面。

img

已公开的合约:此页签下显示账本内所有已经公开的合约信息,对于不是本账号创建的合约可以申请加入,对于是本账号创建的合约只能查看节点信息

邀请我的合约:已受邀的合约中,可以看到被邀请加入的合约,点击概览按钮可以查看合约信息,并决定是否加入,加入可以选择同意按钮,不加入可以选择拒绝按钮,加入后,合约信息将在已安装的合约中显示。

img

5 应用管理

  应用管理页面可以查看联盟链网络下安装的所有应用,可以对已安装的应用进行公开/隐藏转发升级应答删除操作。

img

应用管理列表

6 操作日志管理

  在区块链网络建成后,所有对于网络的操作都会被记录,并在操作日志管理中列表展示,操作日志管理是对系统达成监管要求的必要功能。

  点击网络运行状态,打开运行状态列表,点击日志链接进行查看。

img

7 chaineye浏览器

  Chaineye浏览器是JD BaaS自研的区块链浏览器,对比原生浏览器有界面美观、查询快速、功能强大的特点,在组建网络时选择了chaineye浏览器后,可以使用其查看区块链网络状态、区块高度、链码和链上数据,在符合JD BaaS进化链码的前提下,可以使用浏览器完成很多便捷操作,同时chaineye浏览器提供一系列结构,可以让用户通过浏览器进行对链上数据的查询操作。

浏览器主页

img

网络概览页面

img

区块链高度页面

img

交易页面 img