彻底理解solidity中的事件

在我之前的几篇关于智能合约的文章中，都有提到事件的用法，比如：

event HighestBidIncreased(address bidder, uint amount);
event AuctionEnded(address winner, uint amount);
1
2

这里定义了两个事件，分别表示最高竞价更新了和拍卖结束了。

然后在需要的位置，调用事件，比如：

function bid() external payable {

        //省略其它逻辑
        ...
        highestBidder = msg.sender;
        highestBid = msg.value;
        emit HighestBidIncreased(msg.sender, msg.value);
    }
1
2
3
4
5
6
7
8

我们可以通过emit调用事件方法，然后这个事件就作为日志记录到了以太坊区块链中。日志是以太坊区块链中一种特殊的数据结构，你可以把它当作区块链的一部分，只要区块链在，日志就在。日志和产生它的智能合约的地址事绑定的。

写了日志有啥用呢？它的作用就是可以被订阅。很多智能合约项目都是传统的web项目+智能合约的这种架构，业务系统有些在链外，那么链上发生的事情就可以基于这种发布订阅机制进行通知，从而打通链上和链下。

举个例子，

contract ClientReceipt {
    event Deposit(
        address indexed from,
        bytes32 indexed id,
        uint value
    );

    function deposit(bytes32 id) public payable {
        emit Deposit(msg.sender, id, msg.value);
    }
}

1
2
3
4
5
6
7
8
9
10
11
12

上面定义了一个存钱的合约，存完钱发布一个事件。

然后我们可以通过javascript（web3.js）订阅这个事件，

var abi = /* abi as generated by the compiler */;
var ClientReceipt = web3.eth.contract(abi);
var clientReceipt = ClientReceipt.at("0x1234...ab67" /* address */);

var depositEvent = clientReceipt.Deposit();

// watch for changes
depositEvent.watch(function(error, result){
    // result contains non-indexed arguments and topics
    // given to the `Deposit` call.
    if (!error)
        console.log(result);
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14

我们再稍微深入一点到虚拟机层面。我们知道以太坊的虚拟机是EVM，EVM的指令有几种和日志相关的操作码，分别是：LOG0，LOG1 ， LOG2 ， LOG3 和 LOG4。

日志的数据结构包含主题和数据两个部分，这里的1234代表的事日志包含的主题（topic）数量。如果你用过类似kafka，rocketmq等消息中间价一定对主题这个概念不陌生。主题是用来简单描述事件（日志）的，也可以用来过滤或者搜索日志。

比如我们有这样一个事件定义：

event Transfer(address indexed _from, address indexed _to, uint256 _value);
1

用indexed修饰的参数会被作为主题，而没有修饰的参数会作为日志的数据部分。在这个例子里面，意味着转账的发送方和接收方可以被搜索，而转账金额不能被搜索。

微信公众号：犀牛的技术笔记

---

• https://learnblockchain.cn/2018/05/09/solidity-event/
• https://docs.soliditylang.org/en/develop/contracts.html?highlight=event#events