检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
简介 在使用可信跨链服务时,您需要开发自己的链代码和应用。本文档主要介绍跨链业务链代码的开发,专供具备Go/Java开发经验的开发人员使用。 当前仅“华北-北京四”区域支持可信跨链服务。 购买区块链服务 您可通过华为云区块链服务Hyperledger Fabric增强版实例,具体请参考基于CCE集群部署。
计费说明 跨链服务的计费模式为包年包月。收费标准请参考价格详情。
准备工作 进行跨链交易之前的准备。 订购区块链服务 安装及实例化链代码 下载配置文件和证书 父主题: 跨链场景演示-数据交互
修改跨链资产数值(putStateWithLock) 在跨链资产交换涉及的智能合约方法中,所有对跨链资产的修改都必须与资产上锁同时进行。可将上述逻辑封装至一个方法中,便于后续在其他智能合约方法(主要是preCommitSend与preCommitRecv)中调用: /* *
交易发起方回滚(rollbackSend) 该方法用于在跨链资产交换发起方所属区块链上执行回滚操作,即还原发起方所属区块链上对应资产至跨链资产交换开始前的状态,并解锁该资产,使得其可以继续处理下一笔跨链操作。 本例中,该方法将根据发起方所属区块链上args[0]对应数据锁中的Pr
跨链交易 跨链触发交易 跨链查询交易 跨链查账本交易
跨链场景演示-数据交互 方案概述 准备工作 使用跨链服务
交易发起方提交(commitSend) 该方法用于在跨链资产交换发起方所属区块链上执行提交操作,即解锁发起方所属区块链上对应资产,使得其可以继续处理下一笔跨链操作。 本例中,该方法将删除发起方所属区块链上args[0]对应的数据锁,代表该笔跨链资产交换操作在发起方已端到端完成。u
安装及实例化链代码 安装链代码 实例化链代码 父主题: 准备工作
交易发起方预提交(preCommitSend) 该方法用于在跨链资产交换发起方所属区块链上执行预提交操作,即修改发起方所属区块链上对应资产的值,并对该资产上锁。 本例中,该方法将修改发起方所属区块链上args[0]对应账户的余额为跨链资产交换完成后的数值,同时对该账户上锁,并在数
下载配置文件和证书 安装和实例化链代码完成后,下载配置文件和证书,用于在跨链服务中注册区块链。 操作步骤 在“服务管理”界面,在Cross-ChainA服务卡片中,单击“获取客户端配置”。 勾选“SDK文件”,配置参数请参考表1。 表1 配置参数 参数 说明 链代码名称 tcshelper,注:名字必须保持一致
跨链链代码开发(Hyperledger Fabric) 开发前准备 开发跨链智能合约
开发环境准备 请根据自身业务选择Go(推荐)或其他语言的开发环境。 Go开发环境准备: 安装Go开发环境。安装包下载地址为:https://golang.org/dl/ 。(请选择1.9.2之后的版本) 各个系统对应的包名(以1.14版本为例) 操作系统 包名 Windows go1
zip”和业务链代码“tcsexample.zip”。 操作步骤 选择名为Cross-ChainA的区块链服务卡片,单击“区块链管理”。 输入用户名,密码,单击“登录”。 用户名为admin,初始登录密码为您在部署区块链服务时设置的区块链管理初始密码。如果没有设置区块链管理初始密码,则以资源初始密码为准,为了保证系统安全,建议定期修改密码。
转移使各条链的资产发生了变化。因此,跨链操作需要保证整个跨链交易结束后不同链之间的全局事务保持一致性,即同时记账,或同时不记账。 可信跨链服务基于分布式事务两阶段提交的思想设计了一套能确保全局事务保持一致性的跨链资产交换流程。若您的跨链业务不涉及跨链资产交换,则无需定制编写跨链智
解锁跨链资产(unlockAccount) 在跨链资产交换即将完成时,需要解锁跨链资产交换中涉及的资产。可将上述逻辑封装至一个方法中,便于后续在其他智能合约方法(主要是commitSend、commitRecv、rollbackSend与rollbackRecv)中调用: /*
配置权限 基于不同链上的不同合约,主要有三种权限:跨链读,跨链写,查询账本。不同类型的跨链交易需要不同的权限,例如:发起一次跨链交易需要“跨链写”权限,查询跨链交易结果需要“跨链读”权限,因此需要在进行跨链交易之前设置对应权限。 跨链读:访问链任意合约可以执行被访问链指定合约的读操作。
跨链交易失败。可能存在的原因: 无法连接跨链客户端。 无法生成交易ID。 发送跨链交易失败(例如:有错误的链代码或者函数信息、对方账户不存在、无对方账户相应链码的交易权限等)。 无法获取跨链响应。 权限不足。 表2 查询交易接口 错误码 响应示例 可能原因 TCS.2000000 SUCCESS! 查询交易成功。
跨链智能合约方法定义 下表为涉及跨链资产交换的跨链智能合约必须实现的方法,且必须保证方法名相同,否则可能出现跨链资产交换接口调用超时或调用失败的情况: 表1 方法说明 方法名 说明 preCommitSend 在跨链资产交换发起方所属区块链上执行的预提交操作 preCommitRecv
交易接收方回滚(rollbackRecv) 该方法用于在跨链资产交换接收方所属区块链上执行回滚操作,即还原接收方所属区块链上对应资产至跨链资产交换开始前的状态,并解锁该资产,使得其可以继续处理下一笔跨链操作。 本例中,该方法将根据接收方所属区块链上args[1]对应数据锁中的Pr