Hyperledger Fabric如何查询历史交易?

从以太坊、比特币等其他区块链进入Hyperledger Fabric的新手,常常会问:如何 查询Hyperledger Fabric区块链上的历史交易?的确,既然区块链或账本 上都有交易记录了,怎么找不到一个简单的API来查询历史交易?

在以太坊、比特币等区块链平台中,通常都会提供简单的JSON RPC API接口, 应用程序只需要调用这些RPC API,就可以查询区块或历史交易了。Hyperledger Fabric 也有类似的API,但情况略有不同,根据查询目的区别,可以分为两种方法。

1、使用系统链码qscc

如果你在寻找像以太坊/比特币那样的区块查询、交易查询API,那就应该 使用系统链码QSCC,该链码提供了如下方法:

  • GetChainInfo:获取链信息
  • GetBlockByNumer:按区块号获取区块数据
  • GetBlockByHash:按区块哈希获取区块数据
  • GetTransactionById:按交易ID获取交易数据
  • GetBlockByTxId:按交易ID获取区块数据

调用系统链码和调用自己的链码没什么区别,例如下面是调用 qscc链码的GetChainInfo()方法的go语言测试代码:

1
2
3
4
5
6
response, err := chClient.Query(
chclient.Request{
ChaincodeID: "qscc",
Fcn: "invoke",
Args: integration.ExampleCCQueryArgs("GetChainInfo")
})

原始代码可参考:go sdk test

2、查询指定键的历史交易

如果要查询特定链码中指定状态键的历史交易,可以在链码中使用 ChaincodeStubInterface接口的GetHistoryForKey()方法来查询 其历史记录。例如:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
historyIter, err := stub.GetHistoryForKey(yourKey)

if err != nil {
fmt.Println(errMsg)
return shim.Error(errMsg)
}

if historyIter.HasNext() {
modification, err := historyIter.Next()
if err != nil {
fmt.Println(errMsg)
return shim.Error(errMsg)
}
fmt.Println("Returning information related to", string(modification.Value))
}

上面的链码要正常工作,需要在core.yaml中设置enableHistoryDatabase 配置为true:

1
2
3
ledger:
history:
enableHistoryDatabase: true

汇智网原创,转载请标明出处。