售前客服二维码
文章均源于网络收集编辑侵删
提示:仅接受技术开发咨询!
新用户可点击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文档。
4 日志查看
进入“日志”模块,查看区块链网络中节点的运行日志。在Hyperledger Fabric的基础配置中,可以通过下拉菜单选择查看CA节点、Orderer节点或Peer节点的日志信息。
5 释放区块链
当不需要此链时,进入“我的项目”,选择该区块链并点击“立即释放”。
文章均源于网络收集编辑侵删
提示:仅接受技术开发咨询!