查询接口

查询区块头

queryBlockHeader

按区块哈希查询区块头。

• 函数原型

public QueryBlockHeaderResponse queryBlockHeader(Hash hash)

• 请求参数

• 返回字段

QueryBlockHeaderResponse，具体参数见下表。

BlockHeader，具体参数见下表。

• 示例

public void testQueryBlockHeader() {
        //查询最后一个区块头
        QueryLastBlockHeaderResponse queryLastBlockHeaderResponse = sdk.getQueryService().queryLastBlockHeader();
        if (!queryLastBlockHeaderResponse.isSuccess()) {
            logger.error("queryLastBlockHeader failed, errorCode :{}, errorDesc: {}", queryLastBlockHeaderResponse.getErrorCode().getErrorCode(), queryLastBlockHeaderResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryLastBlockHeader success.返回信息: {}", queryLastBlockHeaderResponse.toString());
            BlockHeader blockHeader = queryLastBlockHeaderResponse.getHeader();
            logger.info("blockHeader: {}", blockHeader.toString());
        }
        //按区块哈希查询区块头
        Hash hash = queryLastBlockHeaderResponse.getHeader().getHash();
        QueryBlockHeaderResponse queryBlockHeaderResponse = sdk.getQueryService().queryBlockHeader(hash);
        if (!queryBlockHeaderResponse.isSuccess()) {
            logger.error("queryBlockHeader failed, errorCode :{}, errorDesc: {}", queryBlockHeaderResponse.getErrorCode().getErrorCode(), queryBlockHeaderResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryBlockHeader success.返回信息: {}", queryBlockHeaderResponse.toString());
            BlockHeader blockHeader = queryBlockHeaderResponse.getBlockHeader();
            logger.info("blockHeader: {}", blockHeader.toString());
        }
    }

queryBlockHeaderByNumber

按区块编号查询区块头。

• 函数原型

public QueryBlockHeaderResponse queryBlockHeaderByNumber(BigInteger blockNumber)

• 请求参数

• 返回字段

QueryBlockHeaderResponse，具体参数见下表。

• 示例

public void testQueryBlockHeaderByNumber() {
        //查询最后一个区块头
        QueryLastBlockHeaderResponse queryLastBlockHeaderResponse = sdk.getQueryService().queryLastBlockHeader();
        if (!queryLastBlockHeaderResponse.isSuccess()) {
            logger.error("queryLastBlockHeader failed, errorCode :{}, errorDesc: {}", queryLastBlockHeaderResponse.getErrorCode().getErrorCode(), queryLastBlockHeaderResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryLastBlockHeader success.返回信息: {}", queryLastBlockHeaderResponse.toString());
            BlockHeader blockHeader = queryLastBlockHeaderResponse.getHeader();
            logger.info("blockHeader: {}", blockHeader.toString());
        }
        //根据区块编号查询区块头
        BigInteger blockNumber = queryLastBlockHeaderResponse.getHeader().getNumber();
        QueryBlockHeaderResponse queryBlockHeaderResponse = sdk.getQueryService().queryBlockHeaderByNumber(blockNumber);
        if (!queryBlockHeaderResponse.isSuccess()) {
            logger.error("queryBlockHeaderByNumber failed, errorCode :{}, errorDesc: {}", queryBlockHeaderResponse.getErrorCode().getErrorCode(), queryBlockHeaderResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryBlockHeaderByNumber success.返回信息: {}", queryBlockHeaderResponse.toString());
            BlockHeader blockHeader = queryBlockHeaderResponse.getBlockHeader();
            logger.info("blockHeader: {}", blockHeader.toString());
        }
    }

queryLastBlockHeader

查询最后一个区块头。

• 函数原型

public QueryLastBlockHeaderResponse queryLastBlockHeader()

• 请求参数：无

• 返回字段

QueryBlockHeaderResponse，具体参数见下表。

• 示例

public void testQueryLastBlockHeader() {
        //查询最后一个区块头
        QueryLastBlockHeaderResponse queryLastBlockHeaderResponse = sdk.getQueryService().queryLastBlockHeader();
        if (!queryLastBlockHeaderResponse.isSuccess()) {
            logger.error("queryLastBlockHeader failed, errorCode :{}, errorDesc: {}", queryLastBlockHeaderResponse.getErrorCode().getErrorCode(), queryLastBlockHeaderResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryLastBlockHeader success.返回信息: {}", queryLastBlockHeaderResponse.toString());
            BlockHeader blockHeader = queryLastBlockHeaderResponse.getHeader();
            logger.info("blockHeader: {}", blockHeader.toString());
        }
    }

查询区块

queryBlock

按区块哈希查询区块。

• 函数原型

public QueryBlockResponse queryBlock(Hash hash)

• 请求参数

• 返回字段

QueryBlockResponse，具体参数见下表。

Block，具体参数见下表。

BlockBody，具体参数见下表。

Transaction，具体参数见下表。

TransactionType，枚举值，具体参数见下表。

TransactionReceipt，具体参数见下表。

• 示例

public void testQueryBlock() {
        //查询最后一个区块
        QueryLastBlockResponse queryLastBlockResponse = sdk.getQueryService().queryLastBlock();
        if (!queryLastBlockResponse.isSuccess()) {
            logger.error("queryLastBlock failed, errorCode :{}, errorDesc: {}", queryLastBlockResponse.getErrorCode().getErrorCode(), queryLastBlockResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryLastBlock success.返回信息: {}", queryLastBlockResponse.toString());
            Block block = queryLastBlockResponse.getBlock();
            logger.info("block: {}", block.toString());
        }
        //根据区块hash查询区块
        Hash hash = queryLastBlockResponse.getBlock().getBlockHeader().getHash();
        QueryBlockResponse queryBlockByHashResponse = sdk.getQueryService().queryBlock(hash);
        if (!queryBlockByHashResponse.isSuccess()) {
            logger.error("queryBlock failed, errorCode :{}, errorDesc: {}", queryBlockByHashResponse.getErrorCode().getErrorCode(), queryBlockByHashResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryBlock success.返回信息: {}", queryBlockByHashResponse.toString());
            Block block = queryLastBlockResponse.getBlock();
            logger.info("block: {}", block.toString());
        }
    }

queryBlockByNumber

按区块编号查询区块。

• 函数原型

public QueryBlockResponse queryBlock(BigInteger blockNumber)

• 请求参数

• 返回字段

QueryBlockResponse，具体参数见下表。

Block，具体参数下表。

• 示例

public void testQueryBlockByNumber() {
        //查询最后一个区块
        QueryLastBlockResponse queryLastBlockResponse = sdk.getQueryService().queryLastBlock();
        if (!queryLastBlockResponse.isSuccess()) {
            logger.error("queryLastBlock failed, errorCode :{}, errorDesc: {}", queryLastBlockResponse.getErrorCode().getErrorCode(), queryLastBlockResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryLastBlock success.返回信息: {}", queryLastBlockResponse.toString());
            Block block = queryLastBlockResponse.getBlock();
            logger.info("block: {}", block.toString());
        }
        //根据区块编号查询区块
        BigInteger blockNumber = queryLastBlockResponse.getBlock().getBlockHeader().getNumber();
        QueryBlockResponse queryBlockByNumberResponse = sdk.getQueryService().queryBlock(blockNumber);
        if (!queryBlockByNumberResponse.isSuccess()) {
            logger.error("queryBlock failed, errorCode :{}, errorDesc: {}", queryBlockByNumberResponse.getErrorCode().getErrorCode(), queryBlockByNumberResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryBlock success.返回信息: {}", queryBlockByNumberResponse.toString());
            Block block = queryLastBlockResponse.getBlock();
            logger.info("block: {}", block.toString());
        }
    }

queryLastBlock

查询最后一个区块。

• 函数原型

public QueryLastBlockResponse queryLastBlock()

• 返回字段

QueryBlockResponse，具体参数见下表。

Block，具体参数见下表。

• 示例

public void testQueryLastBlock() {
        //查询最后一个区块
        QueryLastBlockResponse queryLastBlockResponse = sdk.getQueryService().queryLastBlock();
        if (!queryLastBlockResponse.isSuccess()) {
            logger.error("queryLastBlock failed, errorCode :{}, errorDesc: {}", queryLastBlockResponse.getErrorCode().getErrorCode(), queryLastBlockResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryLastBlock success.返回信息: {}", queryLastBlockResponse.toString());
            Block block = queryLastBlockResponse.getBlock();
            logger.info("block: {}", block.toString());
        }
    }

查询交易

queryTransaction，通过交易哈希查询交易。

• 函数原型

public QueryTransactionResponse queryTransaction(Hash hash)
public QueryTransactionResponse queryTransaction(Hash hash, BaseFixedSizeByteArray.Fixed20ByteArray myChainId)

• 请求参数

• 返回字段

QueryTransactionResponse，具体参数见下表。

• 示例

public void queryTransaction() {
        //创建一个交易，以转账为例
        TransferBalanceRequest transferBalanceRequest = new TransferBalanceRequest(Utils.getIdentityByName("Administrator"),
                Utils.getIdentityByName("Tester001"), BigInteger.valueOf(100));
        TransferBalanceResponse transferBalanceResponse = sdk.getAccountService().transferBalance(transferBalanceRequest);
        if (!transferBalanceResponse.isSuccess()) {
            logger.error("transferBalance failed, errorCode :{}, errorDesc: {}", transferBalanceResponse.getErrorCode().getErrorCode(), transferBalanceResponse.getErrorCode().getErrorDesc());
        } else {
            // 交易收据
            TransactionReceipt transactionReceipt = transferBalanceResponse.getTransactionReceipt();
            if (transactionReceipt.getResult() != 0) {
                logger.error("transferBalance failed, errorCode :{}, errorDesc: {}", ErrorCode.valueOf((int) transactionReceipt.getResult()).getErrorCode(), ErrorCode.valueOf((int) transactionReceipt.getResult()).getErrorDesc());
            } else {
                logger.info("transferBalance success.返回信息: {}", transactionReceipt.toString());
            }
        }
        //查询转账交易的交易内容
        QueryTransactionResponse queryTransactionResponse = sdk.getQueryService().queryTransaction(transferBalanceResponse.getTxHash());
        if (!queryTransactionResponse.isSuccess()) {
            logger.error("queryTransaction failed, errorCode :{}, errorDesc: {}", queryTransactionResponse.getErrorCode().getErrorCode(), queryTransactionResponse.getErrorCode().getErrorDesc());
        } else {
            Transaction transaction = queryTransactionResponse.getTransaction();
            logger.info("queryTransaction success.返回信息: {}", transaction.toString());
        }
    }

查询收据

queryTransactionReceipt，通过交易哈希查询收据。

• 函数原型

public QueryTransactionReceiptResponse queryTransactionReceipt(Hash hash)
public QueryTransactionReceiptResponse queryTransactionReceipt(Hash hash, BaseFixedSizeByteArray.Fixed20ByteArray groupId)

• 请求参数

• 返回字段

QueryTransactionReceiptResponse，具体参数见下表。

• 示例

public void queryTransactionReceipt() {
        //创建一个交易，以转账为例
        TransferBalanceRequest transferBalanceRequest = new TransferBalanceRequest(Utils.getIdentityByName("Administrator"),
                Utils.getIdentityByName("Tester001"), BigInteger.valueOf(100));
        TransferBalanceResponse transferBalanceResponse = sdk.getAccountService().transferBalance(transferBalanceRequest);
        if (!transferBalanceResponse.isSuccess()) {
            logger.error("transferBalance failed, errorCode :{}, errorDesc: {}", transferBalanceResponse.getErrorCode().getErrorCode(), transferBalanceResponse.getErrorCode().getErrorDesc());
        } else {
            // 交易收据
            TransactionReceipt transactionReceipt = transferBalanceResponse.getTransactionReceipt();
            if (transactionReceipt.getResult() != 0) {
                logger.error("transferBalance failed, errorCode :{}, errorDesc: {}", ErrorCode.valueOf((int) transactionReceipt.getResult()).getErrorCode(), ErrorCode.valueOf((int) transactionReceipt.getResult()).getErrorDesc());
            } else {
                logger.info("transferBalance success.返回信息: {}", transactionReceipt.toString());
            }
        }
        //查询转账交易的交易收据
        Hash hash = transferBalanceResponse.getTxHash();
        QueryTransactionReceiptResponse queryTransactionReceiptResponse = sdk.getQueryService().queryTransactionReceipt(hash);
        if (!queryTransactionReceiptResponse.isSuccess()) {
            logger.error("queryTransactionReceipt failed, errorCode :{}, errorDesc: {}", queryTransactionReceiptResponse.getErrorCode().getErrorCode(), queryTransactionReceiptResponse.getErrorCode().getErrorDesc());
        } else {
            // 交易收据
            TransactionReceipt transactionReceipt = queryTransactionReceiptResponse.getTransactionReceipt();
            if (transactionReceipt.getResult() != 0) {
                logger.error("queryTransactionReceipt failed, errorCode :{}, errorDesc: {}", ErrorCode.valueOf((int) transactionReceipt.getResult()).getErrorCode(), ErrorCode.valueOf((int) transactionReceipt.getResult()).getErrorDesc());
            } else {
                logger.info("queryTransactionReceipt success.返回信息: {}", transactionReceipt.toString());
            }
        }
    }

查询账户

queryAccount，通过账户号查询账户。

• 函数原型

public QueryAccountResponse queryAccount(Identity acctId)

• 请求参数

• 返回字段

QueryAccountResponse，具体参数见下表。

Account，具体参数见下表。

AuthMap，具体参数见下表。

PublicKey，具体参数见下表。

• 示例

public void queryAccount() {
        //根据账户名称查询账号
        Identity acctId = Utils.getIdentityByName("Tester001");
        QueryAccountResponse queryAccountResponse = sdk.getQueryService().queryAccount(acctId);
        if (!queryAccountResponse.isSuccess()) {
            logger.error("queryAccount failed, errorCode: {}, errorDesc: {}", queryAccountResponse.getErrorCode().getErrorCode(), queryAccountResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryAccount success: {}" + queryAccountResponse.toString());
            Account account = queryAccountResponse.getAccount();
            logger.info("account :{}", account.toString());
        }
    }

查询合约

queryContract，通过合约账户查询合约。

• 函数原型

public QueryContractResponse queryContract(Identity contractId)

• 请求参数

• 返回字段

QueryContractResponse，具体参数见下表。

Contract，具体参数见下表。

• 示例

public void queryContract() {
        //根据合约名称查询合约
        QueryContractResponse queryContractResponse = sdk.getQueryService().queryContract(
                Utils.getIdentityByName("contractName"));
        if (!queryContractResponse.isSuccess()) {
            logger.error("queryContract failed, errorCode: {}, errorDesc: {}", queryContractResponse.getErrorCode().getErrorCode(), queryContractResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryContract success: {}" + queryContractResponse.toString());
            Contract contract = queryContractResponse.getContract();
            logger.info("contract :{}", contract.toString());
        }
    }

查询区块里面的交易回执

queryBlockTxReceipts，通过块高查询区块里面的交易回执。

• 函数原型

public QueryBlockTxReceiptsResponse queryBlockTxReceipts(BigInteger blockNumber);

• 请求参数

• 返回字段

QueryBlockTxReceiptsResponse

查询区块里面交易回执响应的参数：

BlockInfo，具体参数见下表。

• 示例

public void queryBlockTxReceipts() {
        //获取最后一个区块，以便获取区块编号
        QueryLastBlockResponse queryLastBlockResponse = sdk.getQueryService().queryLastBlock();
        //通过区块编号查询交易收据
        QueryBlockTxReceiptsResponse queryBlockTxReceiptsResponse = sdk.getQueryService().queryBlockTxReceipts(queryLastBlockResponse.getBlock().getBlockHeader().getNumber());
        if (!queryBlockTxReceiptsResponse.isSuccess()) {
            logger.error("queryBlockTxReceipts failed, errorCode :{}, errorDesc: {}", queryBlockTxReceiptsResponse.getErrorCode().getErrorCode(), queryBlockTxReceiptsResponse.getErrorCode().getErrorDesc());
        } else {
            logger.info("queryBlockTxReceipts success: {}" + queryBlockTxReceiptsResponse.toString());
            BlockInfo blockInfo = queryBlockTxReceiptsResponse.getBlockInfo();
            logger.info("blockInfo : {}", blockInfo.toString());
        }
    }

查询区块里面的交易数量

queryBlockTxCount，通过块高查询区块里面的交易数量。

• 函数原型

public QueryBlockTxCountResponse queryBlockTxCount(BigInteger blockNumber)

• 请求参数

• 返回字段

QueryBlockTxCountResponse

查询区块里面交易数量响应的参数：

• 示例

public void testQueryBlockTxCountResponse(){
        QueryBlockTxCountResponse queryBlockcTxCountResponse = sdk.getQueryService().queryBlockTxCount(BigInteger.ZERO);
        if(queryBlockcTxCountResponse.isSuccess()){
            //区块编号
            BigInteger blockNumber = queryBlockcTxCountResponse.getBlockNumber();
            //交易数量
            BigInteger transactionCount = queryBlockcTxCountResponse.getTransactionCount();
        }
}

交易内容解析

存证交易内容解析

对于存证的交易内容，其加密方式是由业务系统自己定的，SDK并不会对存证内容进行加密，只是将存证的内容（或业务系统加密后的存证内容）转成二进制存到链上。因此，如需对存证交易内容进行解密查看，需由业务系统根据存证内容的加密方式进行针对性解密。

在以下给出的一段示例中，可以清楚地了解存证内容 hello world 进行Base64编码进行上链，然后查询这个交易，最终将交易数据使用Base64解码器进行解码还原的全过程。

private void deposit() {
    String data = "hello world";
    //将存证内容转为Base64编码
    byte[] encodeData = Base64.getEncoder().encode(data.getBytes());

    //发送存证请求
    DepositDataRequest request = new DepositDataRequest(userIdentity,
            userIdentity, encodeData, BigInteger.valueOf(100));
    DepositDataResponse result = sdk.getAccountService().depositData(request);

    //查询交易
    QueryTransactionResponse queryResult = sdk.getQueryService().queryTransaction(
            request.getTransaction().getHash());
    
    //存证内容解码
    byte[] sourceData = queryResult.getTransaction().getData();
    byte[] decodeData= Base64.getDecoder().decode(sourceData);
    log.info("deposit decode={}",new String(decodeData));
}

合约交易内容解析

调用查询结果接口得到的output需要使用EVMOutput或WasmOutput进行数据解析，具体介绍可参见EVM 数据解析或WASM 数据解析。

在以下给出的一段示例中，可以清楚地了解调用合约后处理可能出现的错误信息，并将错误信息进行解码的全过程。

//调用合约
CallContractResponse replyTransactionReceipt = sdk.getContractService().callContract(request); 

//如果response返回的code是 10201，按照以下方式解析
output String errorDesc = EVMOutput.evmRevertDecoder(replyTransactionReceipt.getTransactionReceipt().getOutput());
System.out.println(errorDesc);