CRS查询接口参考

查询接口

查询当前最大区块高度

• 开放
• 接口描述： 查询当前最大的区块高度
• 请求地址：GET:/v4/queryMaxHeight

• 请求参数： 无

• 响应参数：

属性	类型	说明
height	long	当前链的最大高度

响应实例

   {"height":18}

根据txId查询交易数据

• 开放
• 接口描述： 根据txId查询交易数据
• 请求地址：GET:/v4/queryTxByTxId/{txId}
• 请求参数：

属性	类型	最大长度	必填	是否签名	说明
txId	string	40	Y	Y	txId

• 响应参数：

属性	类型	说明
coreTx	json	交易原始内容
policyData	json	policy投票内容(交易未上链，返回为null)
transactionReceipt	json	交易执行结果(交易未上链，返回为null)
blockHeight	string	区块高度 (交易未上链，返回为null)
blockTime	string	区块时间(交易未上链，返回为null)

• coreTx:

属性	类型	最大长度	必填	是否签名	说明
txId	string	40	Y	Y	txId
bdId	string	32	Y	Y	所有业务交易都需要指定bdCode
templateId	string	32	N	Y	发布合约或执行合约方法时的合约templateCode
functionId	string	32	Y	Y	BD的functionId，如果是BD的初始化或者合约的发布：CONTRACT_CREATION
submitter	string	40	Y	Y	操作提交者地址
actionDatas	string	...	Y	Y	业务参数JSON格式化数据，json数据包含{"version":"4.0.0","datas":{}}
version	string	40	Y	Y	交易版本号
subType	string	32	N	Y	子业务类型
sessionId	string	64	N	Y	会话id
merchantId	string	32	N	Y	商户id
merchantSign	string	128	N	Y	商户签名
extensionDatas	string	1024	N	Y	交易存证新消息
submitterSign	string	64	Y	N	提交者submitter的ECC对交易的签名,该字段不参与签名

合约状态查询

• 开放
• 接口描述： 合约状态查询
  1. blockHeight传0或null返回当前最新区块高度的合约状态;
  2. 如果链查询时区块链高度为1返回查询结果为合约不存在错误信息;
  3. 传的高度大于实际链的最大高度返回the block is not exist错误信息
• 请求地址：POST:/v4/queryContract
• 请求参数：

属性	类型	最大长度	必填	是否签名	说明
blockHeight	long	64	N		指定查询合约的区块高度，不指定使用链的最大高度
contractAddress	string	40	Y		指定查询合约地址，需要满足地址格式
methodSignature	string	256	Y		指定查询合约方法
parameters	jsonArray	256	N		如果查询的方法参数列表为空，可以不指定参数，需要和methodSignature参数列表对应

• 响应参数：

属性	类型	最大长度	必填	是否签名	说明
data	array	64	Y		返回的是一个数组，取决于合约方法返回值的定义

交易返回属性结果

• policyData结构

属性	类型	最大长度	必填	是否签名	说明
policyId	string	64	Y		policy id(唯一)
label	string	64	N		policy 名称
policyVersion	string	64	Y		policy投票内容
actionType	string	64	Y		methodSign
sender	string	64	Y		区块高度
sendTime	date	64	Y		区块时间
voteInfos	json[]	64	Y		投票信息
decision	string	64	Y		决议

• voteInfos结构

属性	类型	最大长度	必填	是否签名	说明
domainId	string	64	Y		Domain
owner	string	64	Y		投票节点
decision	boolean	64	Y		投票回执结果
signType	string	64	Y		签名类型(BIZ/CONSENSUS)
sign	date	64	Y		投票节点签名

• transactionReceipt结构

属性	类型	最大长度	必填	是否签名	说明
txId	string	64	Y		交易id
result	boolean	64	Y		交易执行结果
errorCode	string	64	N		错误码
errorMessage	string	64	N		错误描述
receiptData	json	64	Y		action回执
version	string	64	Y		交易版本号

根据高度查询区块内所有交易数据

• 开放
• 接口描述： 根据高度查询区块内所有已经被所有domain确认的交易数据
• 请求地址：GET:/v4/queryBlockVO
• 请求参数：

属性	类型	最大长度	必填	是否签名	说明
startHeight	long	64	Y		要查询的起始高度(startHeight必须大于等于1)
size	int	8	Y		起始高度后的多少个(size必须在1-10之间)

• 响应参数(数组中单个对象属性)：

属性	类型	最大长度	必填	说明
genesis	boolean	6	Y	是否为创世块
blockHeader	BlockHeader	64	Y	BlockHeader对象
transactionList	JSONArray<Transaction>	64	Y	含有Transaction的集合

• Transaction:

属性	类型	最大长度	必填	是否签名	说明
coreTx	json	64	Y		交易原始内容
policyData	json	64	Y		policy投票内容
transactionReceipt	json	64	Y		交易执行结果
blockHeight	string	64	Y		区块高度
blockTime	string	64	Y		区块时间

• BlockHeader对象属性：

属性	类型	最大长度	必填	说明
version	string	8	Y	区块版本号
previousHash	string	64	Y	上个区块的hash
blockHash	string	64	Y	当前区块的hash
height	long	64	Y	区块高度
stateRootHash	StateRootHash	64	Y	rootHash对象
blockTime	long	64	Y	区块时间
txNum	int	8	Y	当前区块内交易数量
totalBlockSize	BigDecimal	64	Y	区块大小
totalTxNum	long	64	Y	到此区块时，总的交易数量

• StateRootHash对象属性：

属性	类型	最大长度	必填	说明
attestation	string	64	Y	存证信息的MPT根hash
domainInfo	string	64	Y	domain信息的存储(MPT)树根hash
stacsConfig	string	64	Y	系统属性的存储(MPT)树根hash
contract	string	64	Y	合约数据的存储(MPT)树根hash
permission	string	64	Y	perimission的存储(MPT)树根hash
domainMerchant	string	64	Y	商户信息的存储(MPT)树根hash
businessDefine	string	64	Y	businessDefine的存储(MPT)树根hash
identity	string	64	Y	identity的存储(MPT)树根hash
ca	string	64	Y	ca的存储(MPT)树根hash
transaction	string	64	Y	交易数据的存储(MPT)树根hash
policy	string	64	Y	policy的存储(MPT)树根hash