跳到主要内容

7. 查询与测试接口

查询与测试接口


查询与测试接口

POST chain_queryTransaction (测试交易执行)

接口用途:

  • 测试交易在单机试运行中执行,根据返回结果决定是否实际向网络提交交易。
  • 查询结果操作统一通过试运行接口执行,可立即返回结果,不消耗 Gas 费用。
参数
nametypedata typedescription
fromrequiredstring发送方地址
torequiredstring接收方地址
valuerequiredstring (hex)交易金额
slicenorequiredstring (hex)元空间编号
响应
http codecontent-typeresponse
0application/json{"ret_data":"...","err":"..."}

响应字段说明:

  • ret_data - 交易执行返回值(十六进制编码)
  • err - 交易执行返回错误
示例 cURL
{
"jsonrpc": "3.0",
"method": "chain_queryTransaction",
"params": [{
"from": "0xc3b6472d6370eaf4eb58fff19ce1724c9d61892c",
"to": "0x6268af5542c4b0ccbb650a0aaccbfcdfbabf6b52",
"value": "0x2E90EDD00",
"sliceno": "0x2"
}, "", "encryp=none"],
"id": "d2c8fe196f9f8d8ace952e9e"
}
响应示例
{
"jsonrpc": "3.0",
"id": "055169b80c4e2ef96c2b2cbb",
"result": {
"ret": "0",
"err": "",
"content": {
"ret_data": "",
"err": ""
}
}
}