eth_getBlockTransactionCountByNumber | Aurora

Aurora API method that returns the number of transactions in a block specified by block number or tag. This information can be useful for analytics purposes.

​

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.

​

Response

• quantity — an integer value representing how many transactions are included in the block.

​

eth_getBlockTransactionCountByNumber code examples

const { Web3 } = require("web3");

const NODE_URL = "CHAINSTACK_NODE_URL";

const web3 = new Web3(NODE_URL);



async function getTransactionsCount(blockId) {

  const count = await web3.eth.getBlockTransactionCount(blockId)

  console.log(count);

}



getTransactionsCount('latest')

​

Use case

eth_getBlockTransactionCountByNumber can be used to analyze how many transactions are included on the Aurora blockchain in a certain period. For instance, on average, a new block is generated on the Aurora mainnet every 1.3 seconds, resulting in approximately 2769 blocks per hour. Using a Web3 library, one can inspect the past 2769 blocks starting from the latest block and use eth_getBlockTransactionCountByNumber to find the number of transactions in each block to sum them.