Skip to main content

Table description

The aptos.user_transactions table specifically tracks transactions initiated by users of the Aptos blockchain. It includes details such as the sender, the type of transaction, and the gas used, providing insights into how users interact with the network and its 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 (always user_transaction for this table)
hashVARBINARYUnique hash identifying this transaction
versionUINT256Global sequential version number assigned to this transaction
gas_usedUINT256Amount of gas consumed by the transaction
vm_statusVARCHARDetailed status message returned by the Move VM after execution
successBOOLEANWhether the transaction executed successfully
state_change_hashVARBINARYHash of all state changes produced by the transaction
event_root_hashVARBINARYMerkle root hash of all events emitted by the transaction
state_checkpoint_hashVARBINARYHash of the state checkpoint after this transaction
accumulator_root_hashVARBINARYRoot hash of the transaction accumulator after this transaction
timestampUINT256Unix timestamp of the transaction in microseconds
senderVARBINARYAddress of the account that submitted the transaction
max_gas_amountUINT256Maximum gas units the sender is willing to pay
gas_unit_priceUINT256Price per gas unit in octas (1 APT = 10^8 octas)
sequence_numberUINT256Sender’s account sequence number at the time of this transaction
expiration_timestamp_secsUINT256Unix timestamp (seconds) after which the transaction expires
events_countINTEGERNumber of events emitted by this transaction
changes_countINTEGERNumber of state changes produced by this transaction
payload_typeVARCHARType of transaction payload (e.g. entry_function_payload, script_payload)
entry_function_nameVARCHARName of the entry function called (empty if script payload)
entry_function_module_nameVARCHARModule containing the entry function called
entry_function_module_addressVARBINARYAddress of the module containing the entry function
script_bytecodeVARBINARYCompiled bytecode of the script payload (empty if entry function)
script_abiVARCHARABI definition of the script payload
type_argumentsARRAY(VARCHAR)Generic type arguments passed to the entry function or script
argumentsARRAY(VARCHAR)Arguments passed to the entry function or script

Table Sample