概述
本篇文章将描述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?