GetBlock/获取指定哈希的区块
getblock
调用返回指定哈希的区块,根据参数不同,返回结果可以是序列化码流
或者JSON对象。
参数
- HeaderHash:区块哈希
- Format:结果格式,可选项如下:
- 0:串流格式
- 1:json格式
- 2:json格式,同时解码区块中的交易
- 0:串流格式
返回值
getblock
调用根据参数Format的不同返回值有所区别。
如果Format是0,那么返回的就是16进制字符串表示的序列化交易。
如果Format是1,那么返回的就是JSON对象,其中的交易不解码,结构如下:
- hash:区块哈希
- confirmations:确认数
- size:区块字节数
- strippedsize:剔除隔离见证数据后的区块字节数
- weight:BIP141定义的区块权重
- height:区块高度
- version:版本
- versionHex:16进制表示的版本
- merkleroot:区块的默克尔树根
- tx:区块内所有交易组成的数组,成员为交易id
- time:区块创建时间戳
- mediantime:区块中值时间戳
- nonce:nonce值
- bits:
- difficulty:难度
- chainwork:
- previousblockhash:前一区块的哈希
- nextblockhash :下一区块的哈希
如果Format是2,那么返回的JSON对象中tx数组成员是解码的交易对象。
示例代码
下面的代码返回指定哈希区块的序列化表示:
~$ bitcoin-cli getblock \
00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 \
false
输出结果如下:
010000006fe28c0ab6f1b372c1a6a246ae63f74f931e8365e15a089c68d61900\
00000000982051fd1e4ba744bbbe680e1fee14677ba1a3c3540bf7b1cdb606e8\
57233e0e61bc6649ffff001d01e3629901010000000100000000000000000000\
00000000000000000000000000000000000000000000ffffffff0704ffff001d\
0104ffffffff0100f2052a0100000043410496b538e853519c726a2c91e61ec1\
1600ae1390813a627c66fb8be7947be63c52da7589379515d4e0a604f8141781\
e62294721166bf621e73a82cbf2342c858eeac00000000
下面的代码则返回该区块的JSON表示:
~$ bitcoin-cli getblock \
00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048
输出结果如下:
{
"hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048",
"confirmations": 447014,
"strippedsize": 215,
"size": 215,
"weight": 860,
"height": 1,
"version": 1,
"versionHex": "00000001",
"merkleroot": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098",
"tx": [
"0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098"
],
"time": 1231469665,
"mediantime": 1231469665,
"nonce": 2573394689,
"bits": "1d00ffff",
"difficulty": 1,
"chainwork": "0000000000000000000000000000000000000000000000000000000200020002",
"previousblockhash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f",
"nextblockhash": "000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd"
}