Skip to main content

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. OK if 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_orphan is always true, since every block returned here belongs to an alternative chain rather than to the main chain.
    • keeper_block of the entries in transactions_details is -1, because the transactions of an alternative block are not part of the main chain. For the same reason, transactions_details entries other than the coinbase one are returned in short form, without ins, outs, extra and attachments.

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.