华为云用户手册

业务流程管理 常见的 区块链 业务开发管理需要操作人员监控链上交易数据来掌握该笔业务的流程走向，即使使用区块链浏览器也需操作人员对浏览器中的数据进行筛选过滤，无疑增加了操作人员的工作量以及需要操作人员无一遗漏的筛选出正确交易才能开展下一步业务流程。 BCS 提供以业务为维度的管理流程，操作人员通过界面更加直观地查看该笔业务的当前进展和历史交易数据。并且针对用户管理，提供了以角色和群组的细粒度访问授权（Hyperledger Fabric增强版目前不支持细粒度，功能正在开发中），不同角色或群组的用户授予不同的权限，例如仓库管理员仅可处理货物的发放、货物收件人员仅可确认货物的签收。该功能使用户更多的精力放在处理业务，丰富了区块链上层业务和人员管理，极大地增加了区块链的易用性。 用户权限管理 智能合约的发起者作为该合约的管理员，可通过用户管理页面User Management进行用户权限管理。首先根据实际业务设置角色，例如买家、卖家和仓库管理员等角色。然后设置群组，每个群组可包含多个或单个角色。最后添加用户，管理员为其设置用户名和登录密码，并选择对应的群组。 业务监控 用户可通过用户名和密码登录到业务监控页面，查看当前业务流程和业务历史交易数据，通过图形化呈现业务进展和下一步流程走向。并且通过状态标识，可直观的查看当前业务是否完成。 业务处理 业务处理包括接口调用业务处理、自动业务处理和人工处理三种业务处理方式。接口调用业务处理指用户通过调用合约SDK发起交易进行业务处理；自动业务处理指根据业务逻辑判断，满足一定要求后自动发起交易进行业务处理；人工处理指根据用户角色，不同用户拥有特定的权限执行相应的人工处理业务，以角色为维度进行细粒度访问授权（Hyperledger Fabric增强版目前不支持细粒度，功能正在开发中）。 父主题： 区块链应用低代码开发功能

实现流程 各个角色可通过企业身份注册(带有service)和注册DID生成完全由自己控制的分布式身份，并将身份文档发布到区块链上完成身份的注册。企业用户的DID身份中可以包含其所能提供的服务信息，以支持多样的应用场景。 主要有三种角色：签发者、持有者和验证者，其中每个角色都可以是设备、应用、个人或者组织。 具备基础的身份标识之后，通过可验证凭证架设起身份与身份之间的认证体系。凭证的模板会由相关主体注册发布到区块链上，并持续维护。持有者便可以向签发者发起认证申请，获得凭证后出示给验证者完成校验。 验证者可以通过接口验证持有者出示的“可验证凭证”，确保其是否有权限和资质开展后续业务。

链代码接口 链代码启动必须通过调用shim包中的start方法。实际开发中， 您需要自行定义一个类，来继承ChaincodeBase。以下为继承时必须重写的方法： public class SimpleChaincodeSimple extends ChaincodeBase { @Override public Response init(ChaincodeStub stub) { } @Override public Response invoke(ChaincodeStub stub) { } } init方法：在链代码实例化或升级时被调用，完成初始化数据的工作。 Invoke方法：更新或查询账本数据状态时被调用， 需要在此方法中实现响应调用或查询的业务逻辑。

示例Demo Java语言示例Demo基于Java SDK开发，主要用于帮助开发人员理解并开发Java客户端应用程序，使用步骤如下： 单击链接获取Java客户端示例[链接]。 完成客户端初始化参数配置(App.java)，进行使用(配置可参考SDK客户端配置)。 示例Demo项目结构如下： . 表1 示例Demo目录结构 文件 介绍 App.java 业务端调用的示例，客户端的初始化配置。 Contract.java 通过合约对业务数据交互。对数据有修改的操作如插入和删除，需要调用其中的send方法。对数据的查询操作如查询某个键的历史，需要调用其中的query方法。 BlockUtil.java BlockUtil用于从区块上获取数据。 TxUtil.java TxUtil用于从交易上获取数据。 pom.xml 配置SDK仓库地址、SDK版本号。 README.md 提供详细的接口调用示例。 父主题： Java应用程序开发

链代码结构 Java语言的链代码结构如下： package main // 引入必要的包，系统自动操作，只要在maven或gradle中配置即可 import org.hyperledger.fabric.shim.ChaincodeBase; import org.hyperledger.fabric.shim.ChaincodeStub; public class SimpleChaincodeSimple extends ChaincodeBase { @Override public Response init(ChaincodeStub stub) { // 在该方法中实现链代码初始化或升级时的处理逻辑 // 编写时可灵活使用stub中的API } @Override public Response invoke(ChaincodeStub stub) { // 在该方法中实现链代码运行中被调用或查询时的处理逻辑 // 编写时可灵活使用stub中的API } //主函数，需要调用shim.Start()方法 public static void main(String[] args) { new SimpleChaincode().start(args); } }

请求示例 { "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----", "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "owner" : "did:example:8poVETnVCry9ecfHSDeQaR"}

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法,目前固定为SW cert 是 String 证书 sk 是 String 私钥 timestamp 是 String 时间戳 owner 是 String 密钥生成者的身份标识 keyManagerMode 否 String abe系统首次使用时，需选择中心模式“central”或者多中心模式“distributed”，该模式仅可选择一次，默认为多中心模式。

合约结构 Java语言合约由合约文件及依赖包构成，包含包声明、依赖包导入、智能合约的方法定义。 合约文件中，用户可自定义合约函数，需要实现Contract的init和invoke方法。 合约的结构如下： package com.huawei.poissonchain;import com.huawei.huaweichain.contract.Contract;import com.huawei.huaweichain.contract.ContractException;import com.huawei.huaweichain.contract.ContractStub;import org.slf4j.Logger;import org.slf4j.LoggerFactory;public class ExampleContract implements Contract { // 功能：合约的初始化（Init）接口，需要合约开发者在智能合约中实现此接口，供合约使用者在启动合约之后调用。注意，一般将合约启动时，首先需要执行且只需要执行一次的逻辑放到此方法中 // 入参：stub是智能合约SDK为本次合约执行交易准备的上下文对象，可以通过stub提供的API函数，获取交易请求相关信息、读写状态数据库、写日志等 // 返回值：需要返回给合约调用者（区块链客户端）的信息，没有信息需要返回时，返回值可以为null // 抛出异常：初始化过程的异常信息，可由合约编写者自行设定异常逻辑 @Override public byte[] init(ContractStub stub) throws ContractException { } // 功能：合约被调用（invoke）接口，需要合约开发者在智能合约中实现此接口，将主要的合约执行逻辑，放到此接口内，供合约使用者调用。 // 入参：stub是智能合约合约SDK为本次合约执行交易准备的上下文对象，可以通过stub提供的API函数，获取交易请求相关信息、读写状态数据库、写日志等 // 返回值：需要返回给合约调用者（区块链客户端）的信息，没有信息需要返回时，返回值可以为null // 抛出异常：初始化过程的异常信息，可由合约编写者自行设定异常逻辑 @Override public byte[] invoke(ContractStub stub) throws ContractException { }} 父主题： JAVA合约开发

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 用户证书，每行末尾均需要增加显式换行符\n sk 是 String 用户私钥，每行末尾均需要增加显式换行符\n timestamp 是 String 时间戳 service 是 Array of DIDService objects 提供的服务 表2 DIDService 参数 是否必选 参数类型 描述 type 是 String 类型 serviceEndpoint 是 String 接入点 credentialApplySchema 否 CredentialApplySchema object 申请凭证所需数据的Schema 表3 CredentialApplySchema 参数 是否必选 参数类型 描述 type 否 String 类型 name 否 String 名称 description 否 String 描述信息 attributes 否 Array of Attribute objects 属性列表 表4 Attribute 参数 是否必选 参数类型 描述 name 否 String 名称 type 否 String 类型 description 否 String 描述信息

请求示例 { "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----", "sk" : "------BEGIN PRIVATE KEY-----\n...\n...\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "service" : [ { "type" : "VerifiableCredentialService", "serviceEndpoint" : "https://example.com/vc/", "credentialApplySchema" : { "type" : "file", "name" : "Test Enterprise Certification", "description" : "this is test apply info", "attributes" : [ { "name" : "bob", "type" : "string", "description" : "Attribute's description" } ] } } ]}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 peer_num Number peer数量 chaincodes Number 合约数量 block_num Number 区块数量 transaction_num Number 交易数量 bph Array of bph objects 区块产生数量统计，按小时统计 bpm Array of bpm objects 区块产生数量统计，按每5分钟统计 tph Array of tph objects 合约交易数量统计，按小时统计 tpm Array of tpm objects 合约交易数量统计，按每5分钟统计 orgs_map Array of orgs_map objects 组织交易统计 peers_list Array of peers_list objects peer列表 表4 bph 参数 参数类型 描述 block Number 区块数量 time String 时间 表5 bpm 参数 参数类型 描述 block Number 区块数量 time String 时间 表6 tph 参数 参数类型 描述 tx Number 交易数量 time String 时间 表7 tpm 参数 参数类型 描述 tx Number 交易数量 time String 时间 表8 orgs_map 参数 参数类型 描述 org_name String 组织名称 tx_num Number 交易数量 表9 peers_list 参数 参数类型 描述 org_name String 组织名称 org_id String 组织ID peer String Peer名称 url String PeerURL status String Peer状态 状态码： 400 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_message String 错误描述 error_msg String 错误描述

运行Client程序 Client程序运行时一般要设定其使用的配置文件路径、通道名称、链代码名称、组织ID等。 配置文件路径即用户下载配置文件的存放路径。 通道名称即B CS 实例中的通道名称。 链代码名称即BCS实例中安装链代码时设定的名称。 组织ID，以如下示例配置文件内容为例，组织ID为02f23ab00f6e1ffcde8a27bfd3ac2290edc18127 client:organization: 02f23ab00f6e1ffcde8a27bfd3ac2290edc18127

请求示例 { "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----", "sk" : "------BEGIN PRIVATE KEY-----\n...\n...\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "did" : "did:example:ebfeb1f712ebc6f1c276e12ec21", "service" : [ { "type" : "VerifiableCredentialService", "serviceEndpoint" : "https://example.com/vc/", "credentialApplySchema" : { "type" : "file", "name" : "Test Enterprise Certification", "description" : "this is test apply info", "attributes" : [ { "name" : "bob", "type" : "string", "description" : "Attribute's description" } ] } } ]}

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 用户证书，每行末尾均需要增加显式换行符\n sk 是 String 用户私钥，每行末尾均需要增加显式换行符\n timestamp 是 String 时间戳 did 是 String 分布式身份标识 service 否 Array of DIDService objects 服务列表 表2 DIDService 参数 是否必选 参数类型 描述 type 是 String 类型 serviceEndpoint 是 String 接入点 credentialApplySchema 否 CredentialApplySchema object 申请凭证所需数据的Schema 表3 CredentialApplySchema 参数 是否必选 参数类型 描述 type 否 String 类型 name 否 String 名称 description 否 String 描述信息 attributes 否 Array of Attribute objects 属性列表 表4 Attribute 参数 是否必选 参数类型 描述 name 否 String 名称 type 否 String 类型 description 否 String 描述信息

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 context String context id String 分布式身份标识 publicKey Array of DocPublicKey objects 公钥列表 authentication Array of strings did主公钥标识 recovery String 备用公钥标识，可用于修改主密钥 service Array of Service objects 服务列表 proof Proof object 证明结构，可为空 created String 创建时间 updated String 更新时间 status String 状态 表6 DocPublicKey 参数 参数类型 描述 id String 公钥标识 type String 公钥类型 controller String 公钥的控制者标识 publicKeyPem String 公钥证书 表7 Service 参数 参数类型 描述 id String 服务标识 type String 服务类型 serviceEndpoint String 服务介绍网址 credentialApplySchema CredentialApplySchema object 申请凭证所需数据的Schema 表8 CredentialApplySchema 参数 参数类型 描述 type String 类型 name String 名称 description String 描述信息 attributes Array of Attribute objects 属性列表 表9 Attribute 参数 参数类型 描述 name String 名称 type String 类型 description String 描述信息 表10 Proof 参数 参数类型 描述 creator String 创建者身份标识 type String 签名类型 created String 签名创建时间 signatureValue String 签名值 状态码： 500 表11 响应Body参数 参数 参数类型 描述 errorCode String 错误码 最小长度：8 最大长度：36 errorMsg String 错误描述 最小长度：2 最大长度：512

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法,目前固定为SW cert 是 String 证书 sk 是 String 私钥 timestamp 是 String 时间戳 owner 是 String 密钥生成者的身份标识 keyManagerMode 否 String abe系统首次使用时，需选择中心模式“central”或者多中心模式“distributed”，该模式仅可选择一次，默认为多中心模式。

请求示例 { "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----", "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "owner" : "did:example:8poVETnVCry9ecfHSDeQaR"}

查询区块详情 消息构建。 接口方法 func (msg *QueryRawMessage) BuildBlockRawMessage(chainID string, blockNum uint64) (*common.RawMessage, error) 参数说明 参数 类型 说明 chainID string 链ID。 blockNum uint64 区块高度。 返回值 类型 说明 *common.RawMessage 根据块高查询区块详情需发送的消息。 error 查询成功返回类型为nil，反之返回error。 消息发送。 接口方法 func (action *QueryAction) GetBlockByNum(rawMsg *common.RawMessage) (*common.RawMessage, error) 参数说明 参数 类型 说明 rawMsg *common.RawMessage 上述根据块高查询区块详情消息。 返回值 类型 说明 *common.RawMessage 用于获取包含发送结果的消息。 error 发送成功返回类型为nil，反之返回error。 父主题： 其他查询

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 用户证书，每行末尾均需要增加显式换行符\n sk 是 String 用户私钥，每行末尾均需要增加显式换行符\n timestamp 是 String 时间戳

请求示例 { "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198", "channelID" : "channel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----", "sk" : "------BEGIN PUBLIC KEY-----\n...\n...\n-----END PUBLIC KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00"}

安装及实例化链代码 登录区块链服务管理控制台。 在新创建的实例卡片中，单击“区块链管理”，登录链代码管理页面。 在登录页面输入用户名、密码，单击“登录”。 用户名为admin，密码为您在创建区块链实例时设置的区块链管理初始密码，如果没有设置区块链管理初始密码，则以资源初始密码为准。 在链代码管理页面，单击页面左上角的。 安装参数如下： 参数 值 链代码名称 bcsysq 链代码版本 1.0 账本数据存储方式 文件数据库(goleveldb) 选择全部Peer节点 勾选 组织&Peer节点 peer-0 链代码语言 Golang 链代码文件 下载示例链代码文件：chaincode_example02.zip。 链代码描述 根据需要填写相关描述。 代码安全检查 链代码语言选择Golang，该功能才会显示。选择是否开启链代码安全检查。 单击“安装”完成链代码安装。 链代码安装完成后，在链代码列表的“操作”列，单击“实例化”。 实例化参数如下： 参数 值 实例化通道 channel 链代码版本 1.0 初始化函数 init 链代码参数 a,200,b,250 背书策略 任意组织背书 背书组织列表 organization 隐私保护配置 否

配置应用 在“实例管理”界面，在实例卡片中，单击“获取客户端配置”。 勾选“Peer节点证书”，指定节点组织选择organization，勾选“用户证书”并下载。 下载Demo项目工程：fabric-restapi-demo.zip，并将Demo项目代码工程包下载解压到本地并使用IDE打开。 本Demo是一个golang编写的REST客户端，通过REST API服务 来调用链代码，实现链代码a给b转账的功能，请用GoLand等个人喜欢的IDE打开。项目的内容如下图所示： 将下载的用户证书解压到项目的usercrypto目录下。如图所示： 修改参数配置。 修改config目录下conf.yaml中的各项参数，参考如下截图及表格。 修改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和端口。具体获取方法如下： 在已购买区块链实例卡片中，单击“容器集群”名称，进入云容器引擎CCE页面。 单击实例所在集群名称，进入集群信息页面。在左侧导航栏，单击“工作负载”。 在“无状态负载”页签，单击baas-restapi工作负载名称，进入详情页面，然后单击实例所在节点跳转至节点管理页面获取节点的弹性公网ip，该弹性公网ip为RESTAPI服务访问IP，端口固定为32621。 Path RESTAPI服务的访问路径，保持不变。 CryptoMethod 加密算法，如果是ECDSA算法填写“SW”。 SignCert 用户下载的证书中的签名证书路径。 PrvKey 用户下载证书中的签名私钥。 InvokeReq 请求body的参数，请按照部署的链码实际情况填写，可参考如下InvokeReq参数表。 QueryReq 与InvokeReq类似，按照部署链码的实际情况填写。 表5 InvokeReq参数表 参数 说明 范例 SignGzipSwitch Sign是否选择Gzip压缩。0表示否，1表示是。 "1" ChannelId 区块链通道名称。 "channel" ChaincodeId 链代码名称。 "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等等） 配置完成后，构建并运行main()来运行该Demo项目。 代码中将读取conf.yaml以及main.go中的参数QueryReq和InvokeReq请求，并调用RESTAPI的接口"/v1/chaincode/operation"来调用链代码，实现a给b转账功能。运行结果如下： 本Demo用一个简单的REST客户端调用RESTAPI服务实现了调用链代码，返回的invoke结果为一个base64加密的TransactionID，query结果为base64加密的数据值。代码仅供参考，可以通过该项目代码理解如何调用RESTAPI服务。

创建区块链实例 登录区块链服务管理控制台。 单击Hyperledger Fabric增强版卡片上的“购买”。 根据界面提示，配置区块链基本信息，参数如表1所示。 为了保证示例Demo成功运行，请在参数配置时按照表格中的参数值填写。 表1 基本信息配置 参数 参数值 计费模式 按需计费 区域 使用默认区域 企业项目 default 区块链实例名称 demo 版本类型 基础版 区块链类型 私有链 Hyperledger Fabric增强版内核 v2.2 共识策略 Raft(CFT) 资源初始密码 请自行设置 资源初始密码确认 请自行设置 单击“下一步：资源配置”，进行资源配置，参数如表2所示。 表2 资源配置 参数 示例 环境资源 选择“自定义环境”。 集群 创建新的CCE集群 可用区 请自行选择 云主机规格 4核/8GB 云主机个数 1 高可用 否 虚拟私有云 系统自动创建VPC 所在子网 系统自动创建子网 云主机登录方式 密码 root密码 如果填写该项，则以填写值为准，如果不填写，则以资源初始密码为准。 确认密码 - 是否使用CCE集群节点弹性IP 是 弹性IP计费方式 使用默认规格 弹性IP带宽 5 Mbit/s 单击“下一步：区块链配置”，进行区块链配置，参数如表3所示。 表3 区块链配置 参数 示例 区块链配置 选择“自定义配置”。 区块链管理初始密码 如果填写该项，则以填写值为准，如果不填写，则以资源初始密码为准。 区块链管理确认密码 - 存储卷类型 极速文件存储卷 节点组织存储容量 (GB) 使用默认规格。 账本数据存储方式 选择“文件数据库（GoLevelDB）” peer节点组织 系统已默认创建1个节点组织，名称为organization，将节点数量修改为1。 通道配置 organization节点组织已默认添加进至通道中，保持默认即可。 共识节点数量 使用默认值。 安全机制 ECDSA 须知： 安全机制仅支持选择ECDSA。 区块生成配置 否 添加RESTful API支持 请选择“是”。若您选择了“否”，则需要在实例创建完毕后，执行以下步骤安装RESTful API： 左侧导航栏选择“插件管理”。 在“插件仓库”页签下，鼠标移至baas-restapi插件卡片右上角。 单击“安装”，选择已购买的区块链实例，安装baas-restapi插件。 单击“下一步：确认订单”。 确认配置信息无误后，根据界面提示购买区块链实例。 请等待数分钟，安装页面提示安装成功，查看实例状态变为“正常”后，表示区块链实例部署完成。

交易 Usage: appdemo transaction [flags]Flags: -b, --AddrB string B' addr -t, --Tx string Transaction Num -C, --channel string channel id (default "mychannel") -c, --config string configuration file path (default "./config_test.yaml") -I, --idcc string idendity chaincode name (default "IDChaincode") -o, --orgid string organization id (default "org1") -p, --protectpwd string protect pwd -T, --txcc string transaction chaincode name (default "TxChaincode") -u, --userid string user id ./appdemo transaction -u A -p test -b a0760184f7ed24e0d86f5b2df40a973a9e1b5da9a1ae886532ac9cd634b59d59 -t 10//说明：其中-b后的字符串为B的账户地址（B注册成功时回显的地址）。

注意事项 在下载的sdk.yaml文件中查询orderer和peer的域名信息，将EIP+orderer域名和EIP+peer域名补充进“/etc/hosts”文件中。使用Fabric1.1版本时，peer域名中的EIP需要配置为公网IP，使用Fabric1.4版本时，peer域名中的EIP需要配置为私网IP，否则网络不通将会导致交易验证失败。 在“/etc/hosts”文件中增加orderer节点和peer节点的域名映射时，操作方法如下： X.X.X.X orderer-e5ad7831affbe8e6e2e7984b098f92406930a688-0.orderer-e5ad7831affbe8e6e2e7984b098f92406930a688.default.svc.cluster.localX.X.X.X peer-d524b0817aaed85490368776cb88042a149a56b5-0.peer-d524b0817aaed85490368776cb88042a149a56b5.default.svc.cluster.localX.X.X.X peer-d524b0817aaed85490368776cb88042a149a56b5-1.peer-d524b0817aaed85490368776cb88042a149a56b5.default.svc.cluster.local X.X.X.X为示例EIP，请替换为实际EIP。

注册 Usage: appdemo register [flags]Flags: -C, --channel string channel id (default "mychannel") -c, --config string configuration file path (default "./config_test.yaml") -I, --idcc string idendity chaincode name (default "IDChaincode") -i, --initbalance string init initbalance -o, --orgid string organization id (default "org1") -p, --protectpwd string protect pwd -T, --txcc string transaction chaincode name (default "TxChaincode") -u, --userid string user id ./appdemo register -u A -p test -i 100 部分参数不配置时使用的为默认值，见Flags中的描述。如果用户配置的与默认值不同，需要在参数中显示指定。 为用户生成一对同态公私钥 这里假设有个用户表示userid，用于区分用户，新用户注册的时候为这个用户生成一对公私钥，这里demo为每个用户将密钥对写到了本地的${userid}.data文件。 privKeyStr, pubKeyStr, err := pswapi_sdk.GenerateKey(propwd)check(err)fmt.Println("key is nil")userdata.PubKey = pubKeyStruserdata.PriKey = privKeyStr

查询 Usage: appdemo querybalance [flags]Flags: -C, --channel string channel id (default "mychannel") -c, --config string configuration file path (default "./config_test.yaml") -I, --idcc string idendity chaincode name (default "IDChaincode") -o, --orgid string organization id (default "org1") -p, --protectpwd string protect pwd -T, --txcc string transaction chaincode name (default "TxChaincode") -u, --userid string user id./appdemo querybalance -p test -u A 查询代码： 调用sdk提供的InitBalance接口初始化余额。 调用fabirc sdk发送交易。 get balance setup.ChainCodeID = txchaincode transRec := sdk_client.TransRecord{} fmt.Println("query balance") resps, err := sdk_client.Query(setup, "QueryBalance", [][]byte{[]byte(addrA)}) if err != nil { fmt.Println("Fail to query balance :", err.Error()) return err } err = json.Unmarshal(resps[0].ProposalResponse.GetResponse().Payload, &transRec) if err != nil { fmt.Println("unmarshal query result error: ", err.Error()) return err } decrypt balance curbalance, err := pswapi_sdk.Decrypt(transRec.Balance, userdata.PriKey, propwd) if err != nil { fmt.Println("sdk Decrypt error: ", err.Error()) return err } fmt.Println("current balance:" + curbalance.String())

请求示例 { "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----", "sk" : "------BEGIN PRIVATE KEY-----\n...\n...\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "orderIndex" : 1}

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 用户证书，每行末尾均需要增加显式换行符\n sk 是 String 用户私钥，每行末尾均需要增加显式换行符\n timestamp 是 String 时间戳 serviceID 否 String 服务的标识符

响应示例 状态码： 200 UntreatedVCOrder Information List { "items" : [ { "applyer" : "string", "orderSeq" : "string", "applyTime" : "string", "price" : "string", "status" : "string", "service" : "string", "reason" : "string", "dataUri" : "string", "encryptedAesKey" : "string", "uriType" : "string", "dataHash" : "string", "lockProof" : "string", "vcIndex" : "string" } ]} 状态码： 500 失败响应 { "errorCode" : "stringst", "errorMsg" : "string"}