Ethereum中Event解读

概述

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

官网描述

solidity官方文档,对Event有如下描述:

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

在Ethereum的节点中,Event通过机制如下实现:

solidity的合约通过编译为字节码,存储至Ethereum的区块链中;当一个交易中有合约调用时,先从区块链的数据库中加载当前Ethereum的合约字节码(通过合约地址标识),然后依据交易传入的ABI信息,调用合约中相应的功能;当合约中某个功能有Event调用时,字节码指令(LOG?)会将Event参数存储在交易日志中–块链中的特殊数据结构;
该日志结构与合约地址关联,被写入块链存储且永不删除(在以太坊的FrontierHomestead阶段,永远不会删除这些日志数据;但在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?

官方文档

1 Like