概述
本篇文章将描述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指令处理
代码语言:javascript复制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?


