Read Transactions
A transaction is a request for a change on the blockchain, which can either be a transfer of VET or the execution of a contract's function. Each transaction is signed and submitted by a single entity and may contain multiple instructions, known as multi-clause, to interact with various recipients on the blockchain.
The most relevant information of a transaction includes:
id: The unique identifier of the transaction.
chainTag: Identifies the chain to which the transaction belongs.
blockRef: The block on which the call was based.
expiration: The maximum number of blocks within which the transaction must be included in the blockchain (based on
blockRef
), or it will fail.dependsOn: Requires this transaction id to be successful first before being included in the blockchain.
origin: The sender of the transaction.
meta: Information about the block where this transaction was included, providing more details about time and block through blockID, blockNumber, and blockTimestamp.
reverted: Indicates whether the transaction failed.
clauses: The instructions to be executed, including a list of the recipients to be called, the data sent, and potential VET transfer values.
outputs: Events that have been emitted as a result of the executed instructions.
A transaction's complete details are comprised of two main components:
The basic version, which includes all input data and details on how the transaction is stored.
The receipt, which lists all changes emitted by the blockchain, including:
the reverted flag,
the address of a newly deployed contract,
VET transfers,
events initiated by contracts.
Example snippet to access transaction details:
Test it yourself:
Type definition and documentation of all attributes:
The same information is available using the JSON-API:
Successful Transaction Receipt: https://mainnet.vechain.org/transactions/0xfc99fe103fccbe61b3c042c1da3499b883d1b17fb40160ed1170ad5e63751e07/receipt
Unsuccessful Transaction Receipt: https://mainnet.vechain.org/transactions/0xae4a0ce2423c49cdb286cdde6691bdc77e9d06e2f5a4d0c3205c79af7d89bf7b/receipt
Last updated