概述

本篇文章将描述Ethereum的Event系统。在以太坊的合约代码中，经常会看到emit SomeEvent(...)的调用，对这里比较有困惑，查找了好些资料，整理出如下文档。

官网描述

在solidity的官方文档，对Event有如下描述：

• Event是以太坊EVM日志功能的顶层抽象；
• 应用程序可以通过Ethereum client的RPC接口来订阅、监听指定的Event。

在Ethereum的节点中，Event通过机制如下实现：

solidity的合约通过编译为字节码，存储至Ethereum的区块链中；当一个交易中有合约调用时，先从区块链的数据库中加载当前Ethereum的合约字节码(通过合约地址标识)，然后依据交易传入的ABI信息，调用合约中相应的功能；当合约中某个功能有Event调用时，字节码指令(LOG?)会将Event参数存储在交易日志中--块链中的特殊数据结构；
该日志结构与合约地址关联，被写入块链存储且永不删除(在以太坊的Frontier、Homestead阶段，永远不会删除这些日志数据；但在Serenity阶段，可能这些Log会从块链数据中删除)。
在以太坊的智能合约中，无法访问这些日志数据。

以太坊的日志也可以提供SPV(simple payment verification)证明；可以通过提供块哈希，以及merkle树路径，来验证某条log存在于指定的区块中。

同时可以给Event中最多三个参数添加索引indexed属性，以太坊会将这些索引参数添加至类似于topics的结构中，而不是放到日志的数据部分；如果使用数组作为索引，会计算该数组的Keccak-256索引，然后存储在topics结构中，因为一个topic只能存放32字节的数据。

所有不带索引indexed属性的参数会被编码进Log的数据部分。

可以使用topics中的条目来搜索一些区块中的特定事件；也可以通过合约地址来过滤事件。

以太坊中的LOG指令处理

LOG0: {
            execute:    makeLog(0),
            ...
        },
LOG1: {
            execute:    makeLog(1),
            ...
        },
...         
LOG4: {
            execute:    makeLog(4),
            ...
        },
    
        
        
// following functions are used by the instruction jump  table

// make log instruction function
func makeLog(size int) executionFunc {
    return func(pc *uint64, interpreter *EVMInterpreter, contract *Contract, memory *Memory, stack *Stack) ([]byte, error) {
        topics := make([]common.Hash, size)
        mStart, mSize := stack.pop(), stack.pop()
        for i := 0; i < size; i++ {
            topics[i] = common.BigToHash(stack.pop())
        }

        d := memory.GetCopy(mStart.Int64(), mSize.Int64())
        interpreter.evm.StateDB.AddLog(&types.Log{
            Address: contract.Address(),
            Topics:  topics,
            Data:    d,
            // This is a non-consensus field, but assigned here because
            // core/state doesn't know the current block number.
            BlockNumber: interpreter.evm.BlockNumber.Uint64(),
        })

        interpreter.intPool.put(mStart, mSize)
        return nil, nil
    }
}

在事件处理中，非索引indexed属性的参数会被编码为LOG的数据部分，放在调用合约数据的第一个参数位置，剩余的索引参数紧随其后。当前以太坊支持5个LOG指令(log0, log1, log2, log3, log4)，log?中的?表示最多支持几个索引；由于Log本身有一个索引，即Event的签名.

查阅的资料

Where do contract event logs get stored in the Ethereum architecture?