eth_getBlockByNumber | Cronos
Cronos API method that returns information about the block matching the given block number. This method can retrieve a wide range of information about the block, such as its hash, timestamp, difficulty, and gas limit. You can also retrieve transaction objects included in the block if needed.
Get you own node endpoint today
Start for free and get your app to production levels immediately. No credit card required.
You can sign up with your GitHub, X, Google, or Microsoft account.
Parameters
-
quantity or tag
— the integer of a block encoded as hexadecimal or the string with:latest
— the most recent block in the blockchain and the current state of the blockchain at the most recent block. A chain reorganization is to be expected.safe
—the block that received justification from the beacon chain. Although this block could be involved in a chain reorganization, it would necessitate either a coordinated attack by the majority of validators or severe propagation latency.finalized
—the block accepted as canonical by more than 2/3 of the validators. A chain reorganization is extremely unlikely, requiring burning at least 1/3 of the staked amount.earliest
— the earliest available or genesis block.pending
—the pending state and transactions block. This is the current state of transactions that have been broadcast to the network but have not yet been included in a block.
See the default block parameter.
boolean
— iftrue
, it returns the details of each transaction. Iffalse
, only the hashes of the transactions.
Response
object
— a block object, ornull
when no block was found.number
— the block number of the requested block, encoded as hexadecimal.null
if the block is pending.hash
— the block hash of the requested block.null
if the block is pending.parenthash
— the previous block’s hash used to generate the current block, also known as the ‘parent block’.nonce
— the hash used to demonstrate proof-of-work.null
if the block is pending. It returns0x0000000000000000
when the consensus is proof-of-stake.sha3uncles
— the hash of the list of uncles included in the block. It is used to identify the block uniquely and to verify the integrity of the block’s data.logsbloom
— the bloom filter for the block logs, a data structure that allows for efficient membership testing of elements in a set, in this case, the logs included in the block.null
if pending.transactionsroot
— the root of the transaction trie of the block. ThetransactionsRoot
field allows nodes to verify the integrity of the transactions in a block.stateroot
— the root of the final state trie of the block. Thestateroot
field is included in the block header and is used to verify the integrity of the state at the time the block was processedreceiptsroot
— the root of the block’s receipts trie. This is a 32-byte hash of the root node of the receipts trie for all transactions in the block. It is used to verify the integrity of the receipt data for all transactions in the block.miner
— the address of the miner receiving the reward.difficulty
— a measure of how hard it is to find a valid block for the blockchain. It is a number that increases as more miners join the network and more blocks are added to the chain. Encoded as hexadecimal.totaldifficulty
—null
. This field is obsolete as it was used during Ethereum’s Proof of Work (PoW) era. Cronos uses Tendermint consensus with Proof of Authority (PoA) and this value is not relevant.extradata
— extra data included in a block by the miner who mined it. It often includes messages or other information related to the block.size
— the size of this block in bytes as an integer value, encoded as hexadecimal.gaslimit
— the maximum gas allowed in this block, encoded as hexadecimal.gasused
— the total used gas by all transactions in this block, encoded as hexadecimal.timestamp
— the Unix timestamp for when the block was collated.transactions
— an array of transaction objects. See eth_getTransactionByHash for the exact shape.uncles
— array of uncle hashes.
eth_getBlockByNumber
code examples
Use case
The eth_getBlockByNumber
method can determine whether a block you are analyzing has been included in the main chain or was forked due to a ‘reorg’.
A block hash is generated through a cryptographic hash function. This function takes the block’s data, including transactions and other information, and the hash of the parent block (the previous block) and outputs a unique, fixed-length digest. This hash represents the current block within the blockchain.
Body
The block number or tag.