Skip to content
You are reading Consensys Quorum Plugins development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.

Event Stream Structure

Hyperledger Besu events are streamed to brokers in serialized JSON format.

Events are structured as follows:

{
  "uuid":"9bd9efec-b0b7-4656-9856-e18750cc5ff5",
  "type":"BlockPropagated",
  "timestamp":1573563320223,
  "event":{...}
}
Key Description
uuid ID of the event
type Event type. Possible types are BlockPropagated, TransactionAdded, TransactionDropped, or SyncStatusChanged
timestamp Unix formatted timestamp of the event
event Details of the event type. For more information, see BlockPropagated, TransactionAdded, TransactionDropped, and SyncStatusChanged

BlockPropagated

This event is sent when a block is created.

Key Description
parentHash Parent block’s hash
miner Miner address
difficulty Difficulty level of this block
totalDifficulty Total difficulty of the chain until this block
number Block number
gasLimit Block gas limit
timestamp Unix timestamp of the block creation
sha3Uncles Block uncle’s hashes
stateRoot Block state root hash
transactionsRoot Block transaction root hash
receiptsRoot Block receipt root hash
logsBloom Log bloom filter
gasUsed Total gas used for transactions in this block
extraData Block extra data added by the miner or validator (Clique or IBFT 2.0)
mixHash Block Proof of Work (POW) mix hash. For IBFT 2.0 or Clique, this is the same as the value in the Genesis file
nonce Block POW nonce challenge. For IBFT 2.0 or Clique, this is the same as the value in the Genesis file
hash Block hash

TransactionAdded

This event is sent when a transaction is added to the transaction pool.

Key Description
nonce Number of transactions sent by the sender
gasPrice Gas price for the transaction, in Wei
gas Amount of gas used for the transaction
value Ether value transferred, in Wei
v, r, and s Transaction signature components
from Transaction sender address
input Transaction payload
hash Transaction hash
to Transaction recipient (if present)
chainId ID of the chain on which the transaction should be executed

TransactionDropped

This event is sent when a transaction is dropped from the transaction pool.

Key Description
nonce Number of transactions sent by the sender
gasPrice Gas price for the transaction, in Wei
gas Amount of gas used for the transaction
value Ether value transferred, in Wei
v, r, and s Transaction signature components
from Transaction sender address
input Transaction payload
hash Transaction hash
to Transaction recipient (if present)
chainId ID of the chain on which the transaction should be executed

SyncStatusChanged

This event is indicates the synchronization progress.

Key Description
startingBlock Block number when starting the synchronization process
currentBlock Current block number during the synchronization process
highestBlock Highest known block number of the chain
ConsenSys has acquired Quorum from J.P. Morgan. Please read the FAQ.
Questions or feedback? You can obtain paid professional support by ConsenSys at quorum@consensys.net