1.合约查询接口调用
参数说明
contractName:合约名称
method:合约方法
kvs:合约参数
timeout:超时时间,单位:s,若传入-1,将使用默认超时时间:10s
QueryContract(contractName,method string,kvs[]common.KeyValuePair,timeout int64)(common.TxResponse,error)
2.构造待发送交易体
参数说明
contractName:合约名称
method:合约方法
txId:交易ID格式要求:长度为64字节,字符在a-z0-9可为空,若为空字符串,将自动生成txId
kvs:合约参数
GetTxRequest(contractName,method,txId string,kvs[]common.KeyValuePair)(common.TxRequest,error)
3.发送已构造好的交易体
参数说明
txRequest:已构造好的交易体
timeout:超时时间,单位:s,若传入-1,将使用默认超时时间:10s
withSyncResult:是否同步获取交易执行结果当为true时,若成功调用,common.TxResponse.ContractResult.Result为common.TransactionInfo当为false时,若成功调用,common.TxResponse.ContractResult为空,可以通过common.TxResponse.TxId查询交易结果
SendTxRequest(txRequestcommon.TxRequest,timeout int64,withSyncResult bool)(common.TxResponse,error)
系统合约接口
4.根据交易Id查询交易
参数说明:
txId:交易ID
GetTxByTxId(txId string)(*common.TransactionInfo,error)
5.根据交易Id查询包含rwset的交易
参数说明
txId:交易ID
GetTxWithRWSetByTxId(txId string)(*common.TransactionInfoWithRWSet,error)
6.根据区块高度查询区块
参数说明
blockHeight:指定区块高度,若为-1,将返回最新区块
withRWSet:是否返回读写集
GetBlockByHeight(blockHeight uint64,withRWSet bool)(*common.BlockInfo,error)
7.根据区块高度查询完整区块
参数说明
blockHeight:指定区块高度,若为-1,将返回最新区块
GetFullBlockByHeight(blockHeight uint64)(*store.BlockWithRWSet,error)
8.根据区块哈希查询区块
参数说明
blockHash:指定区块Hash
withRWSet:是否返回读写集
GetBlockByHash(blockHash string,withRWSet bool)(*common.BlockInfo,error)
9.根据交易Id查询区块
参数说明
txId:交易ID
withRWSet:是否返回读写集
GetBlockByTxId(txId string,withRWSet bool)(*common.BlockInfo,error)
10.查询最新的配置块
参数说明
withRWSet:是否返回读写集
GetLastConfigBlock(withRWSet bool)(*common.BlockInfo,error)
11.查询最新区块
参数说明
withRWSet:是否返回读写集
GetLastBlock(withRWSet bool)(*common.BlockInfo,error)
12.查询节点加入的链信息
返回ChainId清单
GetNodeChainList()(*discovery.ChainList,error)
13.查询链信息
包括:当前链最新高度,链节点信息
GetChainInfo()(*discovery.ChainInfo,error)
14.根据交易Id获取区块高度
参数说明
txId:交易ID
GetBlockHeightByTxId(txId string)(uint64,error)
15.根据区块Hash获取区块高度
参数说明
blockHash:指定区块Hash
GetBlockHeightByHash(blockHash string)(uint64,error)
16.查询当前最新区块高度
GetCurrentBlockHeight()(uint64,error)
17.根据区块高度查询区块头
参数说明
blockHeight:指定区块高度,若为-1,将返回最新区块头
GetBlockHeaderByHeight(blockHeight uint64)(*common.BlockHeader,error)