Advanced

Dataset Specifications

This page outlines the possible datasets and their JSON specifications

Block

The Block dataset provides information about individual blocks on the blockchain. Each block contains a collection of transactions and serves as a fundamental unit of data storage and organization on the blockchain. This dataset typically includes data such as block number, timestamp, hash, parent hash, nonce, difficulty, and the root of the state trie.

JSON Specification
{
    "data" [
        {
            "difficulty": "0xb69de81a22b",
            "extraData": "0xd783010303844765746887676f312e352e31856c696e7578",
            "gasLimit": "0x2fefd8",
            "gasUsed": "0xc444",
            "hash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
            "logsBloom": "0x00000000000000000000000000000000000800000000000000000000000800000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000",
            "miner": "0x2a65aca4d5fc5b5c859090a6c34d164135398226",
            "mixHash": "0x92c4129a0ae2361b452a9edeece55c12eceeab866316195e3d87fc1b005b6645",
            "nonce": "0xcd4c55b941cf9015",
            "number": "0xf4240",
            "parentHash": "0xb4fbadf8ea452b139718e2700dc1135cfc81145031c84b7ab27cd710394f7b38",
            "receiptsRoot": "0x20e3534540caf16378e6e86a2bf1236d9f876d3218fbc03958e6db1c634b2333",
            "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
            "size": "0x300",
            "stateRoot": "0x0e066f3c2297a5cb300593052617d1bca5946f0caa0635fdb1b85ac7e5236f34",
            "timestamp": "0x56bfb415",
            "totalDifficulty": "0x630554d65f2cfe6a",
            "transactions": [
                {
                    "blockHash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
                    "blockNumber": "0xf4240",
                    "from": "0x39fa8c5f2793459d6622857e7d9fbb4bd91766d3",
                    "gas": "0x1f8dc",
                    "gasPrice": "0x12bfb19e60",
                    "hash": "0xea1093d492a1dcb1bef708f771a99a96ff05dcab81ca76c31940300177fcf49f",
                    "input": "0x",
                    "nonce": "0x15",
                    "to": "0xc083e9947cf02b8ffc7d3090ae9aea72df98fd47",
                    "transactionIndex": "0x0",
                    "value": "0x56bc75e2d63100000",
                    "type": "0x0",
                    "v": "0x1c",
                    "r": "0xa254fe085f721c2abe00a2cd244110bfc0df5f4f25461c85d8ab75ebac11eb10",
                    "s": "0x30b7835ba481955b20193a703ebc5fdffeab081d63117199040cdf5a91c68765"
                },
                {
                    "blockHash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
                    "blockNumber": "0xf4240",
                    "from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
                    "gas": "0xc350",
                    "gasPrice": "0xdf8475800",
                    "hash": "0xe9e91f1ee4b56c0df2e9f06c2b8c27c6076195a88a7b8537ba8313d80e6f124e",
                    "input": "0x",
                    "nonce": "0x43eb",
                    "to": "0xdf190dc7190dfba737d7777a163445b7fff16133",
                    "transactionIndex": "0x1",
                    "value": "0x6113a84987be800",
                    "type": "0x0",
                    "v": "0x1c",
                    "r": "0x3b08715b4403c792b8c7567edea634088bedcd7f60d9352b1f16c69830f3afd5",
                    "s": "0x10b9afb67d2ec8b956f0e1dbc07eb79152904f3a7bf789fc869db56320adfe09"
                }
            ],
            "transactionsRoot": "0x65ba887fcb0826f616d01f736c1d2d677bcabde2f7fc25aa91cfbc0b3bad5cb3",
            "uncles": []
        }
    ]
}

Block with Receipts

The Block with Receipts dataset includes transaction receipts for each transaction within the block, in addition to the basic block data. Transaction receipts contain information about the outcome of individual transactions, including whether the transaction was successful or failed.

JSON Specification
{
    "data" [
        {
            "block": {
                "difficulty": "0xb69de81a22b",
                "extraData": "0xd783010303844765746887676f312e352e31856c696e7578",
                "gasLimit": "0x2fefd8",
                "gasUsed": "0xc444",
                "hash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
                "logsBloom": "0x00000000000000000000000000000000000800000000000000000000000800000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000",
                "miner": "0x2a65aca4d5fc5b5c859090a6c34d164135398226",
                "mixHash": "0x92c4129a0ae2361b452a9edeece55c12eceeab866316195e3d87fc1b005b6645",
                "nonce": "0xcd4c55b941cf9015",
                "number": "0xf4240",
                "parentHash": "0xb4fbadf8ea452b139718e2700dc1135cfc81145031c84b7ab27cd710394f7b38",
                "receiptsRoot": "0x20e3534540caf16378e6e86a2bf1236d9f876d3218fbc03958e6db1c634b2333",
                "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
                "size": "0x300",
                "stateRoot": "0x0e066f3c2297a5cb300593052617d1bca5946f0caa0635fdb1b85ac7e5236f34",
                "timestamp": "0x56bfb415",
                "totalDifficulty": "0x630554d65f2cfe6a",
                "transactions": [
                    {
                        "blockHash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
                        "blockNumber": "0xf4240",
                        "from": "0x39fa8c5f2793459d6622857e7d9fbb4bd91766d3",
                        "gas": "0x1f8dc",
                        "gasPrice": "0x12bfb19e60",
                        "hash": "0xea1093d492a1dcb1bef708f771a99a96ff05dcab81ca76c31940300177fcf49f",
                        "input": "0x",
                        "nonce": "0x15",
                        "to": "0xc083e9947cf02b8ffc7d3090ae9aea72df98fd47",
                        "transactionIndex": "0x0",
                        "value": "0x56bc75e2d63100000",
                        "type": "0x0",
                        "v": "0x1c",
                        "r": "0xa254fe085f721c2abe00a2cd244110bfc0df5f4f25461c85d8ab75ebac11eb10",
                        "s": "0x30b7835ba481955b20193a703ebc5fdffeab081d63117199040cdf5a91c68765"
                    },
                    {
                        "blockHash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
                        "blockNumber": "0xf4240",
                        "from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
                        "gas": "0xc350",
                        "gasPrice": "0xdf8475800",
                        "hash": "0xe9e91f1ee4b56c0df2e9f06c2b8c27c6076195a88a7b8537ba8313d80e6f124e",
                        "input": "0x",
                        "nonce": "0x43eb",
                        "to": "0xdf190dc7190dfba737d7777a163445b7fff16133",
                        "transactionIndex": "0x1",
                        "value": "0x6113a84987be800",
                        "type": "0x0",
                        "v": "0x1c",
                        "r": "0x3b08715b4403c792b8c7567edea634088bedcd7f60d9352b1f16c69830f3afd5",
                        "s": "0x10b9afb67d2ec8b956f0e1dbc07eb79152904f3a7bf789fc869db56320adfe09"
                    }
                ],
                "transactionsRoot": "0x65ba887fcb0826f616d01f736c1d2d677bcabde2f7fc25aa91cfbc0b3bad5cb3",
                "uncles": []
            },
            "receipts": [
                {
                    "blockHash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
                    "blockNumber": "0xf4240",
                    "contractAddress": null,
                    "cumulativeGasUsed": "0x723c",
                    "effectiveGasPrice": "0x12bfb19e60",
                    "from": "0x39fa8c5f2793459d6622857e7d9fbb4bd91766d3",
                    "gasUsed": "0x723c",
                    "logs": [
                        {
                            "address": "0xc083e9947cf02b8ffc7d3090ae9aea72df98fd47",
                            "topics": [
                                "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c"
                            ],
                            "data": "0x00000000000000000000000039fa8c5f2793459d6622857e7d9fbb4bd91766d30000000000000000000000000000000000000000000000056bc75e2d63100000",
                            "blockNumber": "0xf4240",
                            "transactionHash": "0xea1093d492a1dcb1bef708f771a99a96ff05dcab81ca76c31940300177fcf49f",
                            "transactionIndex": "0x0",
                            "blockHash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
                            "logIndex": "0x0",
                            "removed": false
                        }
                    ],
                    "logsBloom": "0x00000000000000000000000000000000000800000000000000000000000800000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000",
                    "root": "0x284d35bf53b82ef480ab4208527325477439c64fb90ef518450f05ee151c8e10",
                    "to": "0xc083e9947cf02b8ffc7d3090ae9aea72df98fd47",
                    "transactionHash": "0xea1093d492a1dcb1bef708f771a99a96ff05dcab81ca76c31940300177fcf49f",
                    "transactionIndex": "0x0",
                    "type": "0x0"
                },
                {
                    "blockHash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
                    "blockNumber": "0xf4240",
                    "contractAddress": null,
                    "cumulativeGasUsed": "0xc444",
                    "effectiveGasPrice": "0xdf8475800",
                    "from": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
                    "gasUsed": "0x5208",
                    "logs": [],
                    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
                    "root": "0xfa28ef92787192b577a8628e520b546ab58b72102572e08191ddecd51d0851e5",
                    "to": "0xdf190dc7190dfba737d7777a163445b7fff16133",
                    "transactionHash": "0xe9e91f1ee4b56c0df2e9f06c2b8c27c6076195a88a7b8537ba8313d80e6f124e",
                    "transactionIndex": "0x1",
                    "type": "0x0"
                }
            ]
        }
    ]
}

Logs

The Logs dataset focuses specifically on transaction logs generated during transaction execution within blocks. Transaction logs contain additional information emitted by smart contracts during execution, providing insights into contract interactions and events triggered within the blockchain network.

JSON Specification
{
    "data" [
        [
            {
                "address": "0xc083e9947cf02b8ffc7d3090ae9aea72df98fd47",
                "topics": [
                    "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c"
                ],
                "data": "0x00000000000000000000000039fa8c5f2793459d6622857e7d9fbb4bd91766d30000000000000000000000000000000000000000000000056bc75e2d63100000",
                "blockNumber": "0xf4240",
                "transactionHash": "0xea1093d492a1dcb1bef708f771a99a96ff05dcab81ca76c31940300177fcf49f",
                "transactionIndex": "0x0",
                "blockHash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e",
                "logIndex": "0x0",
                "removed": false,
                "timestamp": "0x56bfb415"
            }
        ]
    ]
}

Block with Traces

The Block with Traces dataset includes detailed execution traces for each transaction within a block, in addition to the basic block data. Execution traces provide a step-by-step breakdown of transaction execution, including internal contract calls, opcode-level operations, and gas usage.

This dataset is essential for analyzing smart contract behavior, debugging transactions, and understanding low-level execution flows within the blockchain.

JSON Specification
{
"block": {
"hash": "0xb46d0966654dad16ebef5d3e274fea5dbaab6e1c61ee08712489d94d0f1bf678",
"parentHash": "0x225e9f2919beda98eaf148eb152c116e05bab5a3614e8308dcc10c66a3b5e48c",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"miner": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
"stateRoot": "0xbd9849accc07c8d004f2d2fb4cf4be3916905f99005dc30e601f178ad813e0e9",
"transactionsRoot": "0xbc5669453b6e18d27b1bf996f86f4343add354e21d4848fbbf0e731583c99394",
"receiptsRoot": "0x768efebc58fa9110826cd0d001cdfcb88092e938aabe0ef01e4534f734228012",
"logsBloom": "0x972bf26fc9b3fb5ffd994993f43fdacf6bf7bef37dc543f06fdd843b6cc5d357b155e72ea5dc1ab7bf3b7bf97cae439cdfe7ecfe9f796fa576b73de8fabeeff7aa35fc5b1e3eefb8fc0f736acc5342f676570c7d7f6eccb51fbf959fd56007eecdd5df6cfbe5f37527decf127b2d6ced8efde6eb14be1fd83e0d4d97d8fbdf4ef6be1fff353d399d0bcf5ffd8ba0d922dd195e9f77fa72dd47f5f85e3eff5fba7fe7f7f6ffb7f8d94bd6d3f399eff5f5aee6ddbcdeb4d3be7feb467f39bf0bf52faf5cffbc9dcfd8aadfa6f70ffaf835ccfc35c6cf8f857ced0bfdebe83cef77e379fefd21e0c52654dfbae9a4a5affecd27f79c6fbe9ecddd8fea1e7ceadcdb",
"difficulty": "0x0",
"number": "0x15277cd",
"gasLimit": "0x22550bb",
"gasUsed": "0x1a863b6",
"timestamp": "0x67ed4a23",
"extraData": "0x6265617665726275696c642e6f7267",
"mixHash": "0xb51a7b82e947b0e7412fddbd8f7c92d459e7b1f2854bfa39fc803bd7d38eefe8",
"nonce": "0x0000000000000000",
"baseFeePerGas": "0x48d8f2a9",
"withdrawalsRoot": "0xa3fc2c510101105938ef6cfa2dd8d16bba2869373974351378d7a3116addc475",
"blobGasUsed": "0x60000",
"excessBlobGas": "0x920000",
"parentBeaconBlockRoot": "0x06267a225a858684a0d5733d41c34ae999f0ba90fbf9208424d23a462f578ac1",
"size": "0x1f29d",
"uncles": [],
"transactions": [
{
"type": "0x2",
"chainId": "0x1",
"nonce": "0x6f",
"gas": "0x434ab",
"maxFeePerGas": "0x505396bea",
"maxPriorityFeePerGas": "0x4a817c800",
"to": "0x80a64c6d7f12c47b7c66c5b4e20e72bc1fcd5d9e",
"value": "0x2386f26fc10000",
"accessList": [],
"input": "0x088890dc00000000000000000000000000000000000000000000000000011589e175f87d00000000000000000000000000000000000000000000000000000000000000a00000000000000000000000006cc9eb4609e249e57d4a8cefbfadf88750755cd70000000000000000000000000000000000000000000000000000000067ed4a240000000000000000000000005c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000fefe694100bdba2421801088e11af4b558ac744d",
"r": "0x1fbede0028f488365e74cc1d2efafffcf6759c4e5a007376ceb2d0ee3c4e8743",
"s": "0x695ccc0bf445601146907f6f7e5e8c7cee1a294d56aed91d5dcaf1671eacaca4",
"yParity": "0x0",
"v": "0x0",
"hash": "0x7fe11002075bba3cc5487050aaccf68113acb9d19f25a97964e7df9759834aab",
"blockHash": "0xb46d0966654dad16ebef5d3e274fea5dbaab6e1c61ee08712489d94d0f1bf678",
"blockNumber": "0x15277cd",
"transactionIndex": "0x0",
"from": "0x6cc9eb4609e249e57d4a8cefbfadf88750755cd7",
"gasPrice": "0x4f0f0baa9"
},
{
"type": "0x2",
"chainId": "0x1",
"nonce": "0x277",
"gas": "0x434ab",
"maxFeePerGas": "0x10ff201ea",
"maxPriorityFeePerGas": "0xb2d05e00",
"to": "0x80a64c6d7f12c47b7c66c5b4e20e72bc1fcd5d9e",
"value": "0x12dfb0cb5e88000",
"accessList": [],
"input": "0x088890dc00000000000000000000000000000000000000000000000000103366b43a3e8000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000ba1cfa3196b7de8d87dccc55a586b575733251530000000000000000000000000000000000000000000000000000000067ed4a240000000000000000000000005c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000fefe694100bdba2421801088e11af4b558ac744d",
"r": "0xcb9aa81e1caa07a33341bbb99d8b1489e4d9539996b537797f3177effccfef5d",
"s": "0x802a82e0a2736e2f2937293354e94725efd6c69e70dd81f75e0ff395a7a5568",
"yParity": "0x1",
"v": "0x1",
"hash": "0x5dd37c1163fa49dccc4869dd1160c95f7907183cb220293826c6a48623ee360b",
"blockHash": "0xb46d0966654dad16ebef5d3e274fea5dbaab6e1c61ee08712489d94d0f1bf678",
"blockNumber": "0x15277cd",
"transactionIndex": "0x1",
"from": "0xba1cfa3196b7de8d87dccc55a586b57573325153",
"gasPrice": "0xfba950a9"
}]}

Block with Storage

The Block with Storage dataset captures blockchain state storage at the time of each block, alongside the basic block data. This includes account storage, contract storage slots, and any modifications made to the state during transaction execution. The dataset is valuable for tracking changes in smart contract states, analyzing historical storage data, and optimizing decentralized application performance by understanding storage patterns.

Previous

Blockchain Reorganizations

Next

Example Block Functions

On this page