get_alt_blocks_details
Returns alternative blocks details for a specified range.
Request
{
"jsonrpc": "2.0",
"id": 0,
"method": "get_alt_blocks_details",
"params": {
"offset": 1,
"count": 1
}
}
Request parameters
- offset - starting offset in the global list of alternative blocks
- count - number of blocks to be requested
Response
{
"id": 0,
"jsonrpc": "2.0",
"result": {
"blocks": [
{
"actual_timestamp": 1684409286,
"already_generated_coins": "2111612000000000000",
"base_reward": 1000000000000,
"blob": "",
"block_cumulative_size": 429,
"block_tself_size": 0,
"cumulative_diff_adjusted": "14500325479812624",
"cumulative_diff_precise": "14500318612400077",
"difficulty": "6867412547068",
"effective_fee_median": 10000000000,
"height": 2111612,
"id": "3b47ff44a80f2c0ac5f1e4d20ba1a5e5c0e5b4327f1de4c1f6b0d9e3a70cf1d2",
"is_orphan": true,
"miner_text_info": "",
"object_in_json": "{\n \"major_version\": 2, \n \"nonce\": 5464575110210072335, \n \"prev_id\": \"6860a4742f167fcf7c46e121c8e139fd5232537f580a22ae76ce8013c06d0f09\", \n \"minor_version\": 0, \n \"timestamp\": 1684409286, \n \"flags\": 0, \n \"miner_tx\": { }, \n \"tx_hashes\": [ ]\n}",
"penalty": 0,
"pow_seed": "",
"prev_id": "6860a4742f167fcf7c46e121c8e139fd5232537f580a22ae76ce8013c06d0f09",
"summary_reward": 1000000000000,
"this_block_fee_median": 0,
"timestamp": 1684409286,
"total_fee": 0,
"total_txs_size": 0,
"transactions_details": [
{
"amount": 1000000000000,
"blob": "",
"blob_size": 293,
"fee": 0,
"id": "c1a0f0e5b9d24a3f6c8b71e2d5049fa38b7c6e1d904a2f3b58c7d6e1a4b30f92",
"keeper_block": -1,
"object_in_json": "",
"pub_key": "0f2c9a4d7b1e8365c0a9d4f27b6e1035a8c9d2f4b6e70189a3c5d7f2b4e60918",
"timestamp": 1684409286
}
],
"type": 1
},
{
"actual_timestamp": 1684409351,
"already_generated_coins": "2111613000000000000",
"base_reward": 1000000000000,
"blob": "",
"block_cumulative_size": 5806,
"block_tself_size": 0,
"cumulative_diff_adjusted": "14507192892359692",
"cumulative_diff_precise": "14507186024947145",
"difficulty": "6869024118304",
"effective_fee_median": 10000000000,
"height": 2111613,
"id": "5c9d1b6e0a3f47d28b5c1e9a06f3d47b8e2c5a19d0f64b3e7c8a1d5f209b6e34",
"is_orphan": true,
"miner_text_info": "",
"object_in_json": "{\n \"major_version\": 2, \n \"nonce\": 9134422570018345671, \n \"prev_id\": \"3b47ff44a80f2c0ac5f1e4d20ba1a5e5c0e5b4327f1de4c1f6b0d9e3a70cf1d2\", \n \"minor_version\": 0, \n \"timestamp\": 1684409351, \n \"flags\": 0, \n \"miner_tx\": { }, \n \"tx_hashes\": [ \"ee25a5503726368eef558737f81f15fdc5f1e705b678df81315c83d8789ed4b3\" ]\n}",
"penalty": 0,
"pow_seed": "",
"prev_id": "3b47ff44a80f2c0ac5f1e4d20ba1a5e5c0e5b4327f1de4c1f6b0d9e3a70cf1d2",
"summary_reward": 1010000000000,
"this_block_fee_median": 10000000000,
"timestamp": 1684409351,
"total_fee": 10000000000,
"total_txs_size": 5377,
"transactions_details": [
{
"amount": 1010000000000,
"blob": "",
"blob_size": 429,
"fee": 0,
"id": "9d3b7f1c0e5a24689b1d0c7f3a5e29b46d8c0f1a7e35b9d2c4a608f1e5b7302d",
"keeper_block": -1,
"object_in_json": "",
"pub_key": "6b1e0d9c4a3f5827e1b0d6c9a4f37e25b8d1c0a6f4e39b7d25c1a08f6e3b9017",
"timestamp": 1684409351
},
{
"amount": 50000000000000,
"blob": "",
"blob_size": 5377,
"fee": 10000000000,
"id": "ee25a5503726368eef558737f81f15fdc5f1e705b678df81315c83d8789ed4b3",
"keeper_block": -1,
"object_in_json": "",
"pub_key": "76a7575f488a5a32a766fc5da6d190cab4e90b1ab6d0178eed622a79e922a70d",
"timestamp": 1684409351
}
],
"type": 1
}
],
"status": "OK"
}
}
Response information
- status — string; call result.
OKif the request has been processed successfully, otherwise an error string. - blocks — array of block_rpc_extended_info objects, ordered by ascending height. These are exactly the same objects that get_blocks_details returns, so see that method for the description of every field. Two things differ for alternative blocks:
is_orphanis alwaystrue, since every block returned here belongs to an alternative chain rather than to the main chain.keeper_blockof the entries intransactions_detailsis-1, because the transactions of an alternative block are not part of the main chain. For the same reason,transactions_detailsentries other than the coinbase one are returned in short form, withoutins,outs,extraandattachments.
If offset is beyond the end of the alternative block list, or count is 0, blocks is returned as an empty array with status still set to OK.