Skip to main content

Table description

The aptos.move_table_items table tracks the items stored in Move’s table data structures on the Aptos blockchain. The Move table is a high-performance, typed data structure used for storing and querying on-chain data. This table details the key-value pairs stored, facilitating efficient data access and manipulation within smart contracts.

Table Schema

ColumnTypeDescription
block_heightBIGINTSequential number identifying the block’s position in the chain
block_dateDATEDate of the block for daily aggregations
block_timeTIMESTAMPTimestamp when the block was committed
block_hashVARBINARYUnique cryptographic hash identifying the block
block_first_versionUINT256First transaction version included in the block
block_last_versionUINT256Last transaction version included in the block
block_proposerVARBINARYAddress of the validator that proposed the block
block_roundUINT256Consensus round number for the block
block_epochUINT256Epoch number during which the block was created
block_metadata_idVARBINARYUnique identifier for the block metadata event
block_failed_proposer_indicesARRAY(INTEGER)Indices of validators that failed to propose before this block
block_previous_block_votes_bitvecARRAY(SMALLINT)Bit vector of validator votes on the previous block
tx_indexINTEGERPosition of the transaction within the block
tx_typeVARCHARType of the transaction (e.g. user_transaction, block_metadata)
tx_hashVARBINARYUnique hash identifying the transaction
tx_versionUINT256Global sequential version number of the transaction
tx_gas_usedUINT256Amount of gas consumed by the transaction
tx_vm_statusVARCHARDetailed status message returned by the Move VM
tx_successBOOLEANWhether the transaction executed successfully
tx_state_change_hashVARBINARYHash of all state changes produced by the transaction
tx_event_root_hashVARBINARYMerkle root hash of all events emitted by the transaction
tx_state_checkpoint_hashVARBINARYHash of the state checkpoint after this transaction
tx_accumulator_root_hashVARBINARYRoot hash of the transaction accumulator after this transaction
write_set_change_indexINTEGERIndex of this state change within the transaction’s write set
write_set_change_typeVARCHARType of write set change (e.g. write_table_item, delete_table_item)
move_state_key_hashVARBINARYHash of the state key affected by this change
move_is_deletionBOOLEANWhether this change represents a deletion of the table item
move_table_item_handleVARBINARYHandle identifying the on-chain Move table this item belongs to
move_table_item_keyVARBINARYSerialized key of the item within the Move table
move_table_item_valueVARBINARYSerialized value of the item within the Move table
move_dataVARCHARJSON-encoded representation of the table item data

Table Sample