触发跨链交易
通过控制台界面或者接入点(RESTful接口)触发跨链交易,交易信息会记录在跨链服务中。支持两种方式触发跨链交易:
- 方式1:界面触发,方便用户简单测试。操作方法如下:
- 在“跨链通道”页面,单击对应通道的名称。
- 在新打开页面的“跨链通道测试”下,选择某一个接口,填写参数值,单击“执行调试”后即可查看交易结果。
- 当前仅提供了跨链交易和跨链查询两个接口。
- 交易过程会记录在TCS的可信中继链上,在“跨链浏览器”可以查看对应交易信息。
- 方式2:通过接入点(RESTful接口)触发,方便用户定制开发。操作方法如下:
在“跨链通道”页面,单击对应通道上的“下载证书”,将SSL通信证书下载到本地,用户加载通信证书,通过https协议访问通道的接入点进行触发。具体的URL、参数信息请参考方式1获取。
如果使用Postman调试工具,Postman版本要求:7.27.0及以上的。
“发起交易”和“查询交易”两个接口的返回信息会展示在“响应结果”中,用户可根据具体的错误信息进行排查,错误码信息参考如下表1和表2:
表1 发起交易接口 错误码
响应示例
可能原因
TCS.2000000
SUCCESS!
跨链交易成功。
TCS.4000001
illegal base64 data at input byte 4
请求不合法。
TCS.5000001
Failed to initialize sdk
内部错误,初始化sdk失败。
可能存在的原因:读取证书文件失败、无法连接到peer等。
TCS.5000002
Failed to send cross tx
跨链交易失败。可能存在的原因:
- 无法连接跨链客户端。
- 无法生成交易ID。
- 发送跨链交易失败(例如:有错误的链代码或者函数信息、对方账户不存在、无对方账户相应链码的交易权限等)。
- 无法获取跨链响应。
- 权限不足。
表2 查询交易接口 错误码
响应示例
可能原因
TCS.2000000
SUCCESS!
查询交易成功。
TCS.4000001
illegal base64 data at input byte 4
请求不合法。
TCS.5000001
Failed to initialize sdk
内部错误,初始化sdk失败。
可能存在的原因:读取证书文件失败、无法连接到peer等。
TCS.5000002
Failed to send query tx
查询交易失败,发送请求失败。可能存在的原因:
- 无法连接到跨链的客户端。
- 无法生成交易ID。
- 参数传入错误。
- 无法生成跨链请求。
- 验证交易信息失败。
- 权限不足。