企业组网(长安链)

1 联盟链创建

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

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

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

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

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

  邀请成员页面会列出所有可以邀请入网的成员名单,每个成员对应一个网络管理员账号。此处可以进行条件查询,可以使用公司名称或BaaS名称来查询;在邀请成员页面可以选择多个成员加入,支持全选功能。选择完毕后可以点击下一步按钮选择长安链底层。

  选择完底层后,点击下一步进入详细配置界面。

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

参数名 必填项 规则
共识模式 支持TBFT和RAFT两种共识模式
底层版本 目前仅提供1.2.6版本
CA服务 目前仅提供JDCA
数据库类型 目前支持leveldb,rocksdb和mysqldb。按需选择一个即可
中间CA 选择是否使用中间CA,若选择是,则需输入CA用户和密码
国密 选择是否使用国密算法
浏览器 选择是否启用浏览器功能
API用户 用来调用API接口的用户名称,应用系统调用时需要使用该用户调用
API密码 API用户的密码,数字、字母、特殊符号组合
存储 选择区块链数据存储
公网IP 可以根据要求输入该集群的公网IP
初始账本 填写初始账本名

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

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

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

2 证书管理

  在当前版本中,建链完毕后自动完成四个共识节点证书的申请consensus1,consensus2,consensus3,consensus4。

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

此页面字段说明如下:

参数名 必填项 规则
证书名称 可以输入证书名称
证书密码 证书密码
证书类型 可以选择用户、普通节点和共识节点
域名 如有域名的特殊要求,可以输入域名信息
区域 如有特殊的区域要求,可以输入区域信息
地址 如有特殊的地址要求,可以输入地址信息

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

证书详情页面

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

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

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

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

证书更新页面

3 账本管理

  账本管理是区块链中一项基本服务,账本管理可以帮助用户创建、加入、邀请加入、以及对账本的一系列操作。JD BaaS在使用长安链为底层时,在创建阶段会要求管理员填写一个初始账本,账本名称可以自行输入,此账本会将所有参与方全部纳入进来,如无特殊要求,可以使用此账本进行后续业务。如有特殊的账本隔离需求,那么可以将新建账本。

  创建账本需要进入账本管理Tab页,点击账本创建按钮即可进行账本的创建,创建账本需要输入的信息如下:

参数名 必填项 规则
受邀人 选择一个受邀人,受邀人必须已经加入到创建账本的区块链网络中
网络名称 展示项,不可输入,显示当前网络名称
账本名称 输入账本名称,只能输入英文小写字母,字符长度不大于20
账本说明 中文或英文账本说明,字数不超过200

  账本创建时需要进行人员邀请,点击受邀人按钮,弹出可受邀列表页面,此页面为当前区块链网络中的所有参与者。在需要邀请加入账本的成员前勾选“√”即可,如需全选可在表头方框处勾选即可全部选择。对于勾选错误的受邀人,可以再次点击去掉“√”标识。选择完毕受邀人后,可以点击添加按钮,完成邀请。

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

账本概览页面

  账本创建后,可以在账本列表中查询账本信息,为方便查看,以下根据不同的tab页进行列表功能的详细描述。

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

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

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

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

4 合约管理

  合约管理页面同样为用户提供展示列表,该列表页提供合约查询功能,输入合约名称后点击查询按钮可以查询到符合条件的合约信息。

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

参数名 必填项 规则
网络名称 展示项,不可输入,显示为当前网络名称
账本名称 选择账本名称
合约名称 输入合约名称,只能英文输入,字符长度不大于20
合约版本 输入合约版本,只能数字输入,长度不超过5
合约语言 选择合约语言,可以选择C++,Go,Rust和Solidity
合约文件 在本地系统中上传一个合约文件,要求必须为.zip文件格式

  智能合约创建时需要选择合约文件,系统会从本地将文件上传服务器,在出现下图所示状态时表示合约上传完毕,此时点击部署按钮部署合约。

  随后在合约管理界面找到刚部署的合约,点击后面的安装按钮进行人员邀请。

  点击受邀人按钮,弹出可受邀列表页面,此页面为当前区块链网络中的所有参与者。选择完毕受邀人后。可以点击添加按钮,完成邀请。随后点击安装按钮即可完成安装。

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

我创建的合约: 此页签下可以对本账号创建的合约进行操作,包括合约的公开/隐藏准入操作

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

  准入功能用来审核需要加入合约的组织,只有认为有必要的情况下,才会准入共同执行一段合约。准入页面打开后,可以看到申请人的姓名和公司,可以选择同意拒绝对方加入该合约。

  操作功能可以让用户试调用合约在合约方法和合约参数处输入信息可以直接将信息写入。

  在调用成功后,同样此页面的查询功能,可以将之前写入的信息读取出来。

查询返回的数据需要经Hex解码。

我加入的合约: 受邀请并且同意加入后,合约会显示在此页面,他人创建的合约不可进行更新;此页面可以操作合约,对合约进行调用。调用方式与我创建的合约一致,在此不做累述。

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

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

5 应用管理

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

6 API管理

  API用户用来对接应用层与区块链底层,当需要调用区块链接口时,可以利用此用户来进行,此用户账号密码由网络管理者创建并保存。需要建立API账户需要进入API用户管理页面,点击注册按钮,打开用户注册页面注册API用户,该页面输入信息如下:

参数名 必填项 规则
API用户名称 输入用户名称,仅限英文输入,长度不超过255
API用户密码 输入用户密码,区分大小写,仅限数字、字母及特殊字符
邮箱 可选输入,邮箱可以接收API调用信息

  输入完毕所有信息后,可以点击确认创建API用户,也可以点击取消按钮或者×”`来关闭当前页面。

7 区块链浏览器

  选择长安链为底层时,区块链浏览器使用了长安链原生的浏览器服务,可以使用其查看区块链网络状态、区块高度、链码和链上数据,可以使用浏览器完成很多便捷操作,同时浏览器提供一系列结构,可以让用户通过浏览器进行对链上数据的查询操作。

浏览器主页

区块链列表

交易界面