GuidesAPI ReferenceCommunityDiscordBlogFAQBug BountyAnnouncements
HomeGuidesAPI ReferenceChangelog
GuidesAPI ReferenceCommunityDiscordBlogFAQBug BountyAnnouncements中文(zh_CN)Change Log
中文(zh_CN)Change Log

Event Log is one of the most important features of TRON virtual machine, which is used to output specific binary data and record it in TransactionInfo while TVM is running a contract. The Event Log can help developers confirm, check, and quickly retrieve specific states of a smart contract. This article introduces the basics of the Event mechanism and how to decode the Event Log.

# How To Define And Trigger Event In Contract

In Solidity contract, you can define an Event with the `event` keyword, and trigger an Event with the `emit` keyword. When defining an Event, you can specify not only the event name, but also several parameters to output specific data. Take the Transfer event of the TRC20 contract as an example:


  • `event Transfer(address indexed from，address indexed to, uint256 value)` defines a `Transfer` event containing three parameters, the first is `from` indicating the sender address, the second is `to` indicating the receiver address, and the third one is `value` indicating the transfer amount
  • `emit Transfer(msg.sender，toAddress, amount)` Specifies to trigger the corresponding Event after the transfer is completed. The Event contains the sender address, the receiver address and the amount.
**Note**：The Solidity specification generally requires that the Event name be capitalized to distinguish it from the corresponding function. For example, the event Transfer and functions transfer.
# LOG
Solidity uses LOG instruction to record event information in TransactionInfo. The event information is in the log field of TransactionInfo. The following uses a TransactionInfo obtained through the `gettransactioninfobyid` API to illustrate the structure of a event:

`log` ： The list of Events triggered in the transaction. For each Event, it contains the following three parts:
  • `address` ： Contract address。In order to be compatible with EVM, the address in TVM is a hex format address without the prefix `0x41`, so if you want to parse the address in the log, you need to add `41` to the beginning of the log address , and then convert it to Base58 format .
  • `topics` ：The topic of the event, including the event itself and parameters marked as `indexed`. The reason for using `topics` to save the `indexed` parameter is that blockchain uses a key-value storage engine such as LevelDB or RockDB. These engines generally support the `prefix-scan` operation. So putting the `indexed` parameter into `topics` can quickly retrieve the `Transfer` event and the `Transfer` event with a specific `toAddress`. 
  • `data` ： Non-indexed parameters of events, such as `amount`.
# LOG Decoding
For the events in the above LOG chapter, if you want to decode them, you must first know the ABI of the event. The following is the ABI of the above Transfer Event:

Check the Event log along the ABI to decode the data:
  • `topics[0]`：ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef is the event itself, the value is the calculation result of `keccak256('Transfer(address,address,uint256)')`, so the event is a Transfer event. The keccak256 hash value of the event can be calculated by [tronweb.sha3()](🔗). Note: The parameter of keccak256 is a string without any spaces, otherwise, the calculated hash value will be different.
  • `topics[1]`：00000000000000000000000079309abcff2cf531070ca9222a1f72c4a5136874 is the first indexed parameter `from`. The address here is the 20-byte address with the prefix 0x41 removed, so for this parameter, get the last 40 bits of data, and add `41` in front to get the TRON HEX format address.
  • `topics[2]`：00000000000000000000000081b64b1c09d448d25c9eeb3ee3b8f3348a694c96 is the second indexed parameter `to`, the recipient account address, the parsing is the same as above.
  • `data` ： 00000000000000000000000000000000000000000000000000000000b2d05e00  is the value of a non-indexed parameter. If there are multiple non-indexed parameters, they are listed in order according to the ABI coding rules. For details, please refer to [ABI coding rules](🔗). For this example, there is only one non-indexed parameter, namely `value`, the transfer amount. Just convert hexadecimal data to decimal.