eth_getBlockByNumberfull - Optimism

eth_getBlockByNumberfull. Retrieves a block by its number, offering detailed information about the block's transactions

eth_getBlockByNumber#full - optimism [Value: 60CU]
Retrieves detailed information about a specific block by its number, including comprehensive details for all transactions within that block
Use cases

Use cases

  • Retrieve full block details for forensic analysis
  • Get all transactions within a specific block
  • Monitor blockchain activity for a specific block
Constraints

Constraints

  • Requires accurate block number or tag
  • Full transaction data increases response size
  • Node must be fully synchronized with network
Get started
Unlock Access to 50+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request POST \
     --url https://optimism.drpc.org \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "finalized",
    true
  ]
}
'
Copy
Response
200
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "difficulty": "0x4ea3f27bc",
    "extraData": "0x65746865726d696e652d6575312d32",
    "gasLimit": "0x47e7c4",
    "gasUsed": "0x6384",
    "hash": "0x5bad55fbd7e0f20eac95f45f55f997216de10aaf176314c236b0c3c93c5d1f17",
    "logsBloom": "0x0",
    "miner": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5",
    "mixHash": "0x75b1f48901cf1d37ad43c2b29eafeb1f3ae5cf5c5d55b1b3be6b2be4a25d6ec6",
    "nonce": "0x539bd4979b50162d",
    "number": "0x1b4",
    "parentHash": "0x8e3d7ea52a14b9d773c37d67e2a4b8e6a12573c3d60a1cd1a58455d3008d1c9d",
    "receiptsRoot": "0xbcdfc35b86bedf72e283106f1f9a03c8d99a6de2b1cba6b01ff3e78e924e05c8",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad0d4e8eeb004cfe8dec7d1f3469a7f5f",
    "size": "0x220",
    "stateRoot": "0x7d00dcd0e0d14e6f7d9dc57116d0e5f76b0abdc716a1d7e6b4df87eae7795b7a",
    "timestamp": "0x55ba467c",
    "totalDifficulty": "0x78ed983323d",
    "transactions": [
      {
        "blockHash": "0x5bad55fbd7e0f20eac95f45f55f997216de10aaf176314c236b0c3c93c5d1f17",
        "blockNumber": "0x1b4",
        "from": "0x5cb2045c43d14a5f5e5f1ea60c5b02e0a93032cf",
        "gas": "0x7d3c",
        "gasPrice": "0xba43b7400",
        "hash": "0x1a85165ac88f73b7a290104f614cf08d8b4f3e193f41f209c3716d9c237139f5",
        "input": "0x",
        "nonce": "0x15",
        "to": "0x3535353535353535353535353535353535353535",
        "transactionIndex": "0x0",
        "value": "0x1bc16d674ec80000",
        "v": "0x1c",
        "r": "0x5e1d3a76fbf824220e68236e2d51cb98f349a5a6e4f43e3f471f5d0421d4aee2",
        "s": "0x5e1d3a76fbf824220e68236e2d51cb98f349a5a6e4f43e3f471f5d0421d4aee2"
      }
    ],
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "uncles": []
  }
}
Copy

Request params

idinteger
jsonrpcstring
methodstring
Parametersarray
array
blockNumberstring
The block number or tag ("latest", "earliest", "pending") at which to get the balance.
  • latest [default] - The most recent block in the blockchain (default).
  • safe - A block that has been validated by the beacon chain.
  • finalized - a block confirmed by over two-thirds of validators
  • earliest - A block approved by more than two-thirds of the validators.
  • pending - Transactions that have been broadcast but not yet included in a block.
transaction_detail_flagboolean
Must be true to retrieve full transaction details.

Response

200
Detailed block object if found, or null if no block is found.

Response params

object
baseFeePerGasstring
Base fee per gas in hexadecimal.
difficultyinteger
Block difficulty as an integer (hexadecimal).
extraDatastring
Extra data field of the block.
gasLimitstring
Maximum gas allowed in the block (hexadecimal string).
gasUsedstring
Total gas used by all transactions (hexadecimal string).
hashstring
Block hash (null if pending).
logsBloomstring
Bloom filter for logs (null if pending).
minerstring
Address of the mining reward recipient.
mixHashstring
256-bit hash as a hexadecimal string.
noncestring
Number of prior transactions from the sender.
numberstring
The block number of the requested block encoded as hexadecimal.
parentHashstring
Parent block hash.
receiptsRootstring
Root of the receipts trie.
sha3Unclesstring
SHA3 hash of uncles data.
sizestring
Block size in bytes.
stateRootstring
Root of the final state trie.
timestampstring
UNIX timestamp of the block's creation.
totalDifficultystring
Total difficulty of the chain up to this block.
transactionsarray
Array of transaction objects, including:
object
blockHashstring
Hash of the block containing the transaction.
blockNumberstring
Block number containing the transaction.
transactionIndexstring
Position of the transaction in the block (null if pending)
noncestring
Number of prior transactions from the sender.
hashstring
32 Bytes - hash of the transaction.
fromstring
Transaction hash.
gasstring
Gas provided by the sender.
gasPricestring
Gas price provided by the sender in wei.
inputstring
Data sent with the transaction.
rstring
ECDSA signature r.
sstring
ECDSA signature r.
tostring
Receiver's address (null if contract creation).
vstring
ECDSA recovery id.
valuestring
Value transferred in Wei.
transactionsRootstring
The root of the transaction trie of the block
unclesarray
Array of uncle block hashes
eth_blockNumbereth_getBlockByHash#full