aptos.events

Aptos on-chain events — emitted by Move modules during transaction execution.

Table description

The aptos.events table captures the events that are emitted by smart contracts on the Aptos blockchain. Events are used to log significant actions and changes in smart contracts, such as token transfers or updates to contract states. Each event is linked to the transaction that triggered it, providing a detailed audit trail of contract interactions.

Table Schema

Column	Type	Description
block_height	BIGINT	Sequential number identifying the block’s position in the chain
block_date	DATE	Date of the block for daily aggregations
block_time	TIMESTAMP	Timestamp when the block was committed
block_hash	VARBINARY	Unique cryptographic hash identifying the block
block_first_version	UINT256	First transaction version included in the block
block_last_version	UINT256	Last transaction version included in the block
block_proposer	VARBINARY	Address of the validator that proposed the block
block_round	UINT256	Consensus round number for the block
block_epoch	UINT256	Epoch number during which the block was created
block_metadata_id	VARBINARY	Unique identifier for the block metadata event
block_failed_proposer_indices	ARRAY(INTEGER)	Indices of validators that failed to propose before this block
block_previous_block_votes_bitvec	ARRAY(SMALLINT)	Bit vector of validator votes on the previous block
tx_index	INTEGER	Position of the transaction within the block
tx_type	VARCHAR	Type of the transaction (e.g. user_transaction, block_metadata)
tx_hash	VARBINARY	Unique hash identifying the transaction that emitted this event
tx_version	UINT256	Global sequential version number of the transaction
tx_gas_used	UINT256	Amount of gas consumed by the transaction
tx_vm_status	VARCHAR	Detailed status message returned by the Move VM after execution
tx_success	BOOLEAN	Whether the transaction executed successfully
tx_state_change_hash	VARBINARY	Hash of all state changes produced by the transaction
tx_event_root_hash	VARBINARY	Merkle root hash of all events emitted by the transaction
tx_state_checkpoint_hash	VARBINARY	Hash of the state checkpoint after this transaction
tx_accumulator_root_hash	VARBINARY	Root hash of the transaction accumulator after this transaction
event_index	INTEGER	Position of this event within the transaction’s event list
event_type	VARCHAR	Fully qualified Move type identifier of the event (e.g. 0x1::coin::WithdrawEvent)
guid_account_address	VARBINARY	Account address associated with the event’s globally unique identifier
guid_creation_number	UINT256	Creation number of the event handle, unique per account
event_sequence_number	UINT256	Sequence number of this event within its event handle
data	VARCHAR	JSON-encoded payload of the event containing event-specific fields

Table Sample