5.4.4.7 获取交易回执接口
在智能合约执行一笔交易后,可以使用该接口根据交易的哈希值 获取交易的回执信息。
1. 接口地址:https://节点网关地址/api/fiscobcos/v1/node/getTxReceiptByTxHash
2. 通讯方式:POST
3. 签名算法:详见5.4.4.1 应用接入签名算法
4. 请求参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 用户唯一标识 | userCode | String | 是 | |
2 | 应用唯一标识 | appCode | String | 是 | |
Body: | |||||
1 | 交易哈希 | txHash | String | 是 |
示例:
{
"header":{
"appCode":"cl0006202003181926573677572",
"userCode":"USER0006202003181951281835816"
},
"body":{
"txHash":"0x755f3e7833778f674e1b025f513f05722ba7248be43a3c9168b880847814021a"
},"mac":"MEUCIQDTFe2Gerdf7YJrG1a1Yt99M0ZQ3T1lGpsXdNmFV7WuTgIgSkZ19abUhAJbMrJMBoD8N7f26xhpQRuR4vNAfY7EEbs="
}
5. 响应参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 响应标识 | code | int | 是 | 0:校验成功 -1:校验失败 |
2 | 响应信息 | msg | String | 否 | code=0 时可为 null |
body: | |||||
1 | 交易回执信息 | txId | string | 否 | code 不为 0 时为空 |
2 | 块哈希 | blockHash | string | 否 | |
3 | 块号 | blockNumber | string | 否 | |
4 | 使用 gas | gasUsed | Int | 否 | |
5 | 发送者的地址 | from | string | 否 | |
6 | 接收者的地址 | to | string | 否 | |
7 | 合约地址 | contractAddress | string | 否 |
示例:
{
"code": "0",
"msg": "处理成功",
"data": {
"blockHash": "0x199eca276b60473dd65f8b36641684456694b419d89ef41b4953a9cdac848305",
"gasUsed": 2154887,
"blockNumber": 1,
"txId": "0x8ee0c68e222742b5b70878265d3fdbd3a8e0d549da42a298a4ae872ca4fbfd89",
"contractAddress": "0x20453db36c492fa49da9fab1b80db7fa5f46b01e",
"from": "0x08ac3132a6c7e6ca5a7fbaf0521bb8b6f370ed35",
"to": "0x0000000000000000000000000000000000000000"
}
}