纸贵区块链云服务平台（Z-BaaS）操作指南

Z-BaaS（Ziggurat Blockchain as a Service）是纸贵科技发布的一款区块链云服务平台产品，旨在帮助开发者快速构建区块链基础设施，提供区块链应用开发、部署、测试和监控的整套解决方案。
Z-BaaS坚持技术研发与自主创新，支持各类主流的联盟链、公有链开发环境，包括Hyperledger Fabric、Z-Ledger、Ethereum等，并面向商业应用场景提供了多种企业级解决方案。Z-BaaS为开发者提供了简单易用的开发工具，开发者可以在可视化的操作界面下完成区块链的构建与操作，极大地降低了开发门槛，提高了开发效率。
主要功能包括：
按需部署：按需选择区块链配置，一键构建区块链网络；
区块浏览器：节点、区块、交易、资产等账本信息的可视化展示；
合约IDE：智能合约一站式管理，包括上传、编辑、编译和部署；
API调用：提供Restful API接口，可视化调用与调试；
账户与通证管理：匿名账户的创建与资产管理，自定义通证发行与流转；
日志查询：实时监控，区块链各节点日志信息查看。
Z-BaaS的产品优势：
1. 开放共赢：秉承开放共赢的设计原则，Z-BaaS支持各类主流的联盟链、公有链开发环境，包括Hyperledger Fabric、Z-Ledger、Ethereum等。
2. 简单易用：Z-BaaS以开发者需求为导向，支持区块链产品的免费试用，并提供简单易用的开发者工具与服务，开发者可以在可视化的操作界面下完成区块链的构建与操作，极大地降低了开发门槛，提高了开发效率。
3. 自主创新：Z-BaaS坚持技术研发与自主创新，提供基于Hyperledger Fabric 1.x自主研发的Z-Ledger企业级联盟链服务，并持续研究共识算法、密码学算法、跨链交互、去中心化存储等前沿技术，为开发者提供最先进的技术服务。
4. 成熟可靠：纸贵区块链云服务平台与国内主流的云计算厂商携手合作，采用Kubernetes、Docker等成熟的开源组件，为开发者提供成熟可靠的企业级区块链基础设施服务。
平台基本操作
1. 平台注册与登录

新用户可点击Z-BaaS首页右上角“注册”按钮进入注册页面，填写相关信息进行用户注册。

注册成功后，注册邮箱会收到一封验证邮件，请点击邮件内的激活链接进行账户激活。
如果您没有收到激活邮件，您可以尝试：
· 检查注册邮箱地址，返回重新注册；
· 检查邮箱垃圾箱；
· 联系我们：[email protected]。
已注册用户可点击“登录”按钮进入登录页面，填写邮箱与密码并登录系统。

登录系统后，会默认进入“我的项目”页，展示您已经选择的服务。若您还没有创建任何服务，可以根据页面提示按步骤创建服务。
2. 平台服务浏览与使用
点击Z-BaaS首页导航栏“产品服务”，可查看平台中包含的全部区块链云服务产品，包括Z-Ledger环境构建、Hyperledger Fabric环境构建、Ethereum测试网络接入等。

点击每个产品的“了解详情”按钮，可进入产品的详细介绍页面，介绍产品的优势、功能、截图和接入流程等信息。在产品详情页中点击“免费试用”或“立即体验”的按钮，即可在平台中创建服务，创建过程中需填写相关配置信息，完成服务的最终创建。

3 合约中心
合约中心里包含了众多优秀示例合约，帮助开发者快速上手合约开发。用户可以将合约中心的示例合约加入“我的合约”，查看详细合约信息并下载和编辑代码。

Z-Ledger环境构建
Z-Ledger是纸贵科技基于Hyperledger Fabric 1.0基础之上自主研发的商用级联盟链底层，及配套工具集。包括区块链底层系统、智能合约、SDK、浏览器、运维平台等产品，在共识机制、可扩展性、资产登记和流转、权限管理和隐私保护、跨链交互等方面做出许多重要改进，使之更适用于大规模企业级应用。
更多关于Z-Ledger的技术资料可前往 Z-Ledger技术文档中查看。
以下为您介绍在Z-BaaS中搭建Z-Ledger环境并完成链码操作的步骤：
1 环境构建
登录系统，在Z-Ledger服务详情页点击“免费试用版”，进入服务创建流程，选择区块链配置。

举例：区块链名称为“test”，共识算法选择“solo”，类型选择“高级配置”，点击完成，创建成功，进入我的项目页。
提示：试用版区块链将在部署后48小时自动释放。（我的项目页）
2 项目控制台
创建成功的Z-Ledger将会在我的项目中以卡片形式显示，点击卡片上“进入项目”可进入项目控制台。

项目控制台页面左侧导航栏展示了控制台的功能：区块链浏览器、链码管理、API调用、账户、通证、日志。
· 区块链浏览器：展示区块链账本基本信息，包括区块信息、交易信息、合约数量等；
· 链码管理：查看区块链链码信息，执行链码（智能合约）的安装、实例化等操作；
· API调用：提供Restful API，支持可视化调用并查看调用结果；
· 账户：提供账户管理工具，支持账户的创建、删除、查看资产和资产转账等功能；
· 通证：区块链通证资产查看，支持自定义通证发行；
· 日志：实时查看区块链各节点日志。
3 账户与通证
Z-Ledger在Hyperledger Fabric基础上新增了账户和通证的功能。
为了便于用户操作和理解，Z-Ledger区块链在初始化阶段会默认创建1个账户并给这个账户发行1000亿个ZIG Token。
ZIG Token是Z-Ledger的原生Token，账户发起交易时需消耗一定比例的ZIG Token作为手续费。
3.1 添加账户
进入“账户”模块，可以看到当前创建的全部账户，包括初始化生成的默认账户，记为账户1。
点击“添加账户”按钮新增一个账户，此时页面会有2个账户，新增的账户记为账户2。后文将针对账户1和账户2进行操作。

3.2 发行通证
进入“通证”模块，可以看到当前发行的全部通证信息，包括初始化生成的原生通证ZIG。
点击“发行通证”，输入通证名称、个数、小数点个数，发行账户等信息。
举例，名称：AToken；通证个数：100000000；小数点个数：3；账户：账户1。（以上数据代表实际发行通证数量为100000.000）

通证发行成功后进入“账户”模块，选择账户1点击“资产”查看当前账户地址下所有通证名称及数量。可以发现账户1已经拥有ZIG和AToken两种通证资产。

3.3 账户间通证转账
在账户1的通证资产页面，点击ZIG通证的“转账”，输入通证个数和转账地址。举例，通证个数：5000.00；转账地址：账户2。
点击“确定”后稍等一段时间，转账交易被确认。同理，可将AToken进行转账操作，通证个数：5000.000；转账地址：账户2。
此时可在账户2的资产页面，查看其资产数额变化信息。

目前，账户2已拥有ZIG和AToken两种资产，在后文将继续介绍账户2如何使用者两种资产。
4 示例链码演示
4.1 链码部署
“链码管理”模块展示了该区块链上已安装或已部署的链码，用户可以在该模块中为区块链安装部署新的链码。
在“链码管理”模块中点击加号执行链码安装，在“合约中心”中选择“资产挂单交易/asset”示例合约进行安装。
“资产挂单交易/asset”示例合约支持注册新用户，用户可以将资产以Token形式定价挂单，其他用户可以通过指定Token进行资产购买。

安装成功后，在“链码管理”页面会显示该示例链码。点击“部署”执行链码实例化，无需填写参数，点击提交，等待一段时间后，部署成功。

4.2 链码调用
链码部署成功后，进入“API调用”页面，对刚部署成功的示例链码进行API调用。
API调用界面展示了所提供的多种API，包括获取链信息、获取区块信息、获取交易信息、链码调用、账户和通证操作等等。链码的调用方式包括Invoke和Query，分别对应“Invoke Chaincode”和“Query Chaincode”这两个API。用户可点击进入，填写相关参数，执行调用并查看反馈结果。
需要注意的是：在Zig-Ledger中通过Invoke方式调用合约时需要指定账户，每次进行Invoke操作时需要从ZIG账户中扣除一定额度的手续费，费用以当前已经发送的交易字节数来确定。
以下继续介绍“资产转移合约”的示例操作步骤：
1）添加用户U1、用户U2
创建U1，在“Invoke Chaincode”API中，填写链码名称“asset”，链码版本“1.0”，链码函数“addUser”，参数“U1”“15”，调用账户“账户1”，执行调用，获得如下结果：

返回了交易TxHash，代表交易成功。
同理，继续创建用户U2，填写链码名称“asset”，链码版本“1.0”，链码函数“addUser”，参数“U2”“20”，调用账户“账户2”，执行调用，完成创建。
2）查询用户信息
在“Query Chaincode”API中，填写链码名称“asset”，链码版本“1.0”，链码函数“queryUser”，参数“U1”，执行查询，获得如下结果：

返回了U1用户的信息，说明U1成功创建。
同理，在“Query Chaincode”API中，填写链码名称“asset”，链码版本“1.0”，链码函数“queryUser”，参数“U2”，执行查询，返回U2信息，U2成功创建。
3）添加资产-BOOK1
现在我们为U1添加1个挂单资产，该资产设定为一本书，名叫BOOK1，类型是BOOK，描述是A guidebook，并定价2.00单位的AToken。
在“Invoke Chaincode”API中，填写链码名称“asset”，链码版本“1.0”，链码函数“addAsset”，参数“BOOK1”“BOOK”“A guidebook”“AToken”“200”“U1”（参数200包含了小数点，代表2.00个AToken），调用账户“账户1”，执行调用，获得如下结果：

返回了交易TxHash，代表交易成功。
4）查询资产-BOOK1
在“Query Chaincode”API中，填写链码名称“asset”，链码版本“1.0”，链码函数“readAsset”，参数“BOOK1”，执行查询，获得如下结果：

返回了BOOK1资产的信息，资产成功创建，owner是U1。
同理，也可以使用函数“readAssetByRange”来查询名称在A-Z范围内的所有资产。
5）U2购买资产BOOK1
在“Invoke Chaincode”API中，填写链码名称“asset”，链码版本“1.0”，链码函数“buyAsset”，参数“BOOK1”“U2”，调用账户“账户2”，执行调用，获得如下结果：

返回了交易TxHash，代表交易成功。
如果该笔交易顺利执行，那么BOOK1将归属于U2，并且U1和U2的AToken数量也将发生变化，那么接下来让我们去查询下这些信息。
6）查询资产-BOOK1
在“Query Chaincode”API中，填写链码名称“asset”，链码版本“1.0”，链码函数“readAsset”，参数“BOOK1”，执行查询，获得如下结果：

可以发现，BOOK1的owner已经变更为U2。
7）查询账户的资产
在“账户”模块中查询账户1和账户2的资产信息，发现资产数量发生变化，账户2的AToken减少了2个，而账户1的AToken增加了2个，验证之前的交易成功执行。

下表汇总了示例合约的操作流程：

4.3 完成调用
调用完成后，返回“区块链浏览器”，发现此时区块链信息已经发生变化，区块和交易数量有所增加。
点击可查看刚才调用所产生的区块和交易详情。

4.4 Restful API调用
开发者可以通过可视化的界面完成调用，也可以通过Restful API进行调用。Zig-Ledger构建服务提供了一系列Restful API用于帮助开发者快速构建区块链应用，开发者在调用前需先获取Token令牌来获得调用权限。具体接口使用方法详见技术文档 – Zig-Ledger Restful API文档。

5 日志查看
进入“日志”模块，查看区块链网络中节点的运行日志。在Zig-Ledger的高级配置中，可以通过下拉菜单选择查看CA节点、Orderer节点或Peer节点的日志信息。

6 释放区块链
当不需要此链时，进入“我的项目”，选择该区块链并点击“立即释放”。

Hyperledger Fabric环境构建
Hyperledger Fabric是一个面向企业的分布式账本平台，具有高度的灵活性、模块化和可扩展性能。Zig-BaaS提供Hyperledger Fabric 1.0版本区块链网络的快速构建，并为开发者提供区块浏览器、链码管理、API调用、日志查看等功能。
以下为您介绍在Zig-BaaS中搭建Hyperledger Fabric环境并完成链码操作的步骤：
1 环境构建
打开Zig-BaaS首页，在Hyperledger Fabric服务详情页点击“免费试用版”，进入服务创建流程，选择区块链配置。

举例：区块链名称为“test”，共识算法选择”solo“，类型选择“基础配置”，点击完成，创建成功，进入我的项目页。
提示：试用版区块链将在部署后48小时自动释放。

2 项目控制台
创建成功的Hyperledger Fabric将会在我的项目中以卡片形式显示，点击卡片上“进入项目”可进入项目控制台。

项目控制台页面左侧导航栏展示了控制台的功能：区块链浏览器、链码管理、API调用、日志。
· 区块链浏览器：展示区块链账本基本信息，包括区块信息、交易信息、合约数量等；
· 链码管理：查看区块链链码信息，执行链码（智能合约）的安装、实例化等操作；
· API调用：提供Restful API，支持可视化调用并查看调用结果；
· 日志：实时查看区块链各节点日志。
3 示例链码演示
3.1 链码部署
“链码管理”模块展示了该区块链上已安装或已部署的链码，用户可以在该模块中为区块链安装部署新的链码。
在“链码管理”中点击加号，在“合约中心”中选择“资产转移合约/trans”示例合约进行安装。

安装成功后，在“链码管理”页面会显示该示例链码。点击“部署”执行链码实例化，部署时需输入参数：a,10,b,10，点击提交，等待一段时间后，部署成功。

3.2 链码调用
链码部署成功后，进入“API调用”页面，对刚部署成功的示例链码进行API调用。
API调用界面展示了所提供的多种API，包括获取链信息、获取区块信息、获取交易信息、链码调用等等。链码的调用方式包括Invoke和Query，分别对应“Invoke Chaincode”和“Query Chaincode”这两个API。用户可点击进入，填写相关参数，执行调用并查看反馈结果。
以下继续介绍“资产转移合约”的示例操作步骤：
1）查询实体a、实体b的资产
在“Query Chaincode”API中，填写链码名称“trans”，链码版本“1.0”，链码函数“query”，参数“a”，执行查询，获得如下结果：

代表a具有10单位的资产。
同理查询实体b的资产，填写链码名称“trans”，链码版本“1.0”，链码函数“query”，参数“b”，执行查询。查询得到实体b具有10单位的资产。
a、b的资产数量与部署时填写的初始化参数相符。
2）从a向b转移5个单位的资产
在“Invoke Chaincode”API中，填写链码名称“trans”，链码版本“1.0”，链码函数“invoke”，参数“a”“b”“5”，执行查询，获得如下结果：

返回了交易TxHash，代表交易成功。
3）查询实体a、实体b的资产
在“Query Chaincode”API中，填写链码名称“trans”，链码版本“1.0”，链码函数“query”，参数“a”，执行查询，获得如下结果：

代表a具有5单位的资产，因为在上一步，a向b转移了5单位的资产。
同理查询实体b的资产，可以发现实体b拥有15单位的资产，资产转移成功。
下表汇总了示例合约的操作流程：
操作步骤函数名称参数方法说明

3.3 完成调用
调用完成后，返回“区块链浏览器”，发现此时区块链信息已经发生变化，区块和交易数量有所增加。
点击可查看刚才调用所产生的区块和交易详情。

3.4 Restful API调用
开发者可以通过可视化的界面完成调用，也可以通过Restful API进行调用。Hyperledger Fabric构建服务提供了一系列Restful API用于帮助开发者快速构建区块链应用，开发者在调用前需先获取Token令牌来获得调用权限。Restful API接口详见“API调用”模块。具体接口使用方法详见技术文档 – Hyperledger Fabric Restful API文档。