区块链服务 BCS区块链服务 BCS

更新时间:2021/09/09 GMT+08:00
分享

REST API Demo

华为云区块链提供了REST API服务来简化用户访问区块链的学习成本。通过REST API服务,用户可以不需要学习fabric-go-sdk,fabric-Java-sdk, fabric-nodejs-sdk等,只需要开发的应用支持RESTful接口,就可以轻松访问区块链。本Demo通过一个go语言的客户端来演示如何使用REST API服务调用链代码,供您学习参考。

只用于场景体验,不用于实际应用。

仅适用于Hyperledger Fabric增强版的区块链服务。

创建区块链服务

  1. 登录区块链服务管理控制台。
  2. 单击页面右上角的“购买区块链服务”。
  3. 根据界面提示,配置区块链基本信息,参数如表1所示。

    为了保证示例Demo成功运行,请在参数配置时按照表格中的参数值填写。

    表1 基本信息配置

    参数

    参数值

    计费模式

    按需计费

    区域

    使用默认区域

    企业项目

    default

    区块链服务名称

    demo

    版本类型

    基础版或专业版

    区块链类型

    私有链

    Fabric内核

    v1.4.0

    共识策略

    测试策略(SOLO)

    资源初始密码

    请自行设置

    资源初始密码确认

    请自行设置

  4. 单击“下一步:资源配置”,进行资源配置,参数如表2所示。

    表2 资源配置

    参数

    示例

    环境资源

    选择“自定义环境”。

    集群

    创建新的CCE集群

    可用区

    请自行选择

    云主机规格

    4核/8GB

    云主机个数

    1

    高可用

    虚拟私有云

    系统自动创建VPC

    所在子网

    系统自动创建子网

    云主机登录方式

    密码

    root密码

    如果填写该项,则以填写值为准,如果不填写,则以资源初始密码为准。

    确认密码

    -

    是否使用CCE集群节点弹性IP

    弹性IP带宽

    使用默认规格

    弹性IP带宽

    5 Mbit/s

  5. 单击“下一步:区块链配置”,进行区块链配置,参数如表3所示。

    表3 区块链配置

    参数

    示例

    区块链配置

    选择“自定义配置”。

    区块链管理初始密码

    如果填写该项,则以填写值为准,如果不填写,则以资源初始密码为准。

    区块链管理确认密码

    -

    存储卷类型

    文件存储卷

    peer节点组织

    系统已默认创建1个节点组织,名称为organization,将节点数量修改为1。

    共识节点数量

    使用默认值。

    节点组织存储容量

    使用默认规格。

    通道配置

    organization节点组织已默认添加进至通道中,保持默认即可。

    共识节点数量

    使用默认。

    安全机制

    ECDSA

    须知:

    安全机制仅支持选择ECDSA。

    账本数据存储方式

    选择“文件数据库(GoLevelDB)”

    区块生成配置

    添加RESTful API支持

    请选择“是”。若您选择了“否”,则需要在服务创建完毕后,执行以下步骤安装RESTful API:

    1. 左侧导航栏选择“插件管理”。
    2. 在“插件仓库”页签下,鼠标移至baas-restapi插件卡片右上角。
    3. 单击“安装”,选择已购买的区块链服务,安装baas-restapi插件。

  6. 单击“下一步:确认订单”。
  7. 确认配置信息无误后,根据界面提示购买区块链服务。

    请等待数分钟,安装页面提示安装成功,查看服务状态变为“正常”后,表示区块链服务部署完成。

安装及实例化链代码

  1. 登录区块链服务管理控制台。
  2. 单击左侧导航栏中的“服务管理”。
  3. 在新创建的服务卡片中,单击“区块链管理”,登录链代码管理页面。
  4. 在登录页面输入用户名、密码、验证码,单击“登录”。

    用户名为admin,密码为您在创建区块链服务时设置的区块链管理初始密码,如果没有设置区块链管理初始密码,则以资源初始密码为准。

  5. 在链代码管理页面,单击页面左上角的

    安装参数如下:

    参数

    链代码名称

    bcsysq

    链代码版本

    1.0

    账本数据存储方式

    文件数据库(goleveldb)

    选择全部Peer节点

    勾选

    组织&Peer节点

    peer-0

    链代码语言

    Golang

    链代码文件

    下载示例链代码文件:chaincode_example02.zip

    链代码描述

    根据需要填写相关描述。

  6. 单击“安装”完成链代码安装。
  7. 链代码安装完成后,在链代码列表的“操作”列,单击“实例化”。

    实例化参数如下:

    参数

    实例化通道

    channel

    链代码版本

    1.0

    初始化函数

    init

    链代码参数

    a,200,b,250

    背书策略

    任意组织背书

    背书组织列表

    organization

    隐私保护配置

配置应用

  1. 在“服务管理”界面,在服务卡片中,单击“获取客户端配置”。
  2. 勾选“Peer节点证书”,指定节点组织选择organization,勾选“用户证书”。
  3. 单击“下载”,下载organization组织的用户证书至本地默认路径。
  4. 下载Demo项目工程:fabric-restapi-demo.zip,并将Demo项目代码工程包下载解压到本地并使用IDE打开。

    本Demo是一个golang编写的REST客户端,通过RESTAPI服务来调用链代码,实现链代码a给b转账的功能,请用GoLand等个人喜欢的IDE打开。项目的内容如下图所示:

  5. 将下载的用户证书解压到项目的usercrypto目录下。如图所示:

  6. 修改参数配置。

    1. 修改config目录下conf.yaml中的各项参数,参考如下截图及表格。

    2. 修改src/restapi目录下的main.go文件,参考如下截图及表格。

      针对需要参与背书的每个peer节点,对其构造一个OrgPeer结构体,将组织ID和peer节点的域名传入,并将该结构体添加进OrgPeer类型的数组中,经json.Marshal()方法转换为字节数组,最后会转换成字符串类型传入。其中OrgPeer结构体定义如下:

      type OrgPeer struct {

      OrgId string `json:"orgId"`

      PeerDomainName string `json:"peerDomainName"`

      }

      表4 参数表

      参数

      说明

      Endpoint

      RESTAPI服务的访问IP和端口。具体获取方法如下:

      1. 在已购买区块链服务卡片中,单击“容器集群”名称,进入云容器引擎CCE页面。
      2. 在左侧导航栏,选择工作负载 > 无状态负载
      3. 在无状态负载页面中,restapi工作负载所在行的“外部访问地址”列获取RESTAPI服务访问IP和端口。端口固定为32621。

      Path

      RESTAPI服务的访问路径,保持不变。

      CryptoMethod

      加密算法,如果是ECDSA算法填写“SW”。

      SignCert

      用户下载的证书中的签名证书路径。

      PrvKey

      用户下载证书中的签名私钥。

      InvokeReq

      请求body的参数,请按照部署的链码实际情况填写,可参考如下InvokeReq参数表。

      QueryReq

      与InvokeReq类似,按照部署链码的实际情况填写。

      表5 InvokeReq参数表

      参数

      说明

      范例

      SignGzipSwitch

      Sign是否选择Gzip压缩。0表示否,1表示是。

      "1"

      ChannelId

      区块链通道ID。

      "c123456"

      ChaincodeId

      链代码ID。

      "testcode"

      ChaincodeVersion

      链代码版本。

      "1.0"

      UserId

      由组织CA签发的用户ID,目前区块链服务默认生成的都为User1。

      "User1"

      OrgId

      区块链组织ID。

      说明:

      在“通道管理”页面中,单击通道名称后的“查看节点”,查看“MSP标识”,去掉MSP即为区块链组织ID。例如:MSP标识为"1232b2032faafee152b58cd82cecf52e49a22a38MSP",区块链组织ID为"1232b2032faafee152b58cd82cecf52e49a22a38”。

      "1232b2032faafee152b58cd82cecf52e49a22a38"

      OrgPeers

      各个Peer节点的组织ID和域名。

      "[{OrgId:" 1232b2032faafee152b58cd82cecf52e49a22a38", PeerDomainName:"peer-1232b2032faafee152b58cd82cecf52e49a22a38-0 .peer-1232b2032faafee152b58cd82cecf52e49a22a38.default.svc.cluster.local "}]"

      Opmethod

      区块链链码调用类型,目前只有两类:invoke和query。

      "invoke"

      Args

      链码调用参数。

      '["invoke","a","b","100"]' (第一个参数为invoke的调用函数,可以是其他值如:move,query等等)

  7. 配置完成后,构建并运行main()来运行该Demo项目。

    代码中将读取conf.yaml以及main.go中的参数QueryReq和InvokeReq请求,并调用RESTAPI的接口"/v1/chaincode/operation"来调用链代码,实现a给b转账功能。运行结果如下:

    本Demo用一个简单的REST客户端调用RESTAPI服务实现了调用链代码,返回的invoke结果为一个base64加密的TransactionID,query结果为base64加密的数据值。代码仅供参考,可以通过该项目代码理解如何调用RESTAPI服务。

分享:

    相关文档

    相关产品