从以太坊交易日志中监听智能合约事件event

以太坊智能合约中，有一类特殊的回调函数，没有函数体，以大写字母开头，一般用来记录函数状态，这类回调函数称为事件event。事件event由合约函数调用，web3.js可以轻松监听此类event，并返回需要的数据。在网上搜索到的相关文章都是关于用web3.js来实现监听event的，今天我们就来从c++代码层面来看看怎么实现这个功能。
我们先来看看一个简单的智能合约例子：

contract Contract {
    event Incremented(bool indexed odd, uint x, uint y);
    function Contract() {
        x = 69;
        y = 20;
    }
    function inc() {
        ++x;
        ++y;
        Incremented(x % 2 == 0, x, y);
    }
    uint x;
    uint y;
}

这个合约只有两个变量x, y，一个函数inc()和一个事件Incremented，如果我们调用Contract中的inc()函数，则事件Incremented会被执行，我们的目的就是监听这个事件。

首先我们在私有链上来部署这个合约，部署的过程就不赘述了，简单说就是执行一笔交易，交易的data为合约的二进制代码。

同样调用智能合约的函数也是向智能合约发送一笔交易，将函数以及相关参数放到交易的data中，也就是调用Client::submitTransaction()这个函数，返回值是h256类型，为交易的hash值，也就是交易的id。如果此笔交易在区块链上得到确认，则智能合约中的函数会被执行，函数中的事件会被触发，事件触发的结果记录在交易的日志中。那么我们去哪里找交易的日志呢？
当一笔交易得到确认，我们可以根据交易id去区块链上找到该笔交易的收据(receipt)，receipt中记录交易的执行情况。

执行以下代码可以得到交易收据

toJson(m_pClient->localisedTransactionReceipt(h)).toStyledString();

其中m_pClient是dev::eth::Client类实例，h是交易id。
我们执行inc()后，得到的收据内容为

{
   "blockHash" : "0x862b329c8f5e8310ed5cc6decc18ccc61a96c984aeb3003627abdd9789bd73d9",
   "blockNumber" : 798,
   "contractAddress" : "0x46f74069282ce80249112a50c5fdea621436c2e7",
   "cumulativeGasUsed" : "0x85ba",
   "from" : "0x8fc41de977db1d49cff206ad8b25605e2b63e56e",
   "gasUsed" : "0x85ba",
   "logs" : [
      {
         "address" : "0x59a1181c37245f8b4d7c7a5cec19d22dd5da4331",
         "blockHash" : "0x862b329c8f5e8310ed5cc6decc18ccc61a96c984aeb3003627abdd9789bd73d9",
         "blockNumber" : 798,
         "data" : "0x00000000000000000000000000000000000000000000000000000000000000460000000000000000000000000000000000000000000000000000000000000015",
         "logIndex" : 0,
         "polarity" : false,
         "topics" : [
            "0x9b44895fef8929cca514f54bb4c52d35b5f403b960a39478ed7f4408e46eb69e",
            "0x0000000000000000000000000000000000000000000000000000000000000001"
         ],
         "transactionHash" : "0xc5659816ee1239f48cba7d99ea7defeb7b927dff8a9d074f618aa308fb1e9eb4",
         "transactionIndex" : 0,
         "type" : "mined"
      }
   ],
   "logsBloom" : "0x00000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000010000000040000000000000800000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000008000000000000000000000000000000000000000000000000000040000020000000000000000000000000000000000000000000000000000000000000",
   "stateRoot" : "0x2ff5b94c86fb021d6c354f827278ec48bd037a9b3981253f383717fe8f022eda",
   "to" : "0x59a1181c37245f8b4d7c7a5cec19d22dd5da4331",
   "transactionHash" : "0xc5659816ee1239f48cba7d99ea7defeb7b927dff8a9d074f618aa308fb1e9eb4",
   "transactionIndex" : 0
}

我们要从日志从寻找需要的东西，因此我们关注logs这部分内容。再看topics，这是一个数组，第一行的内容应该为事件名称的hash值，我们来计算一下：

auto sh = dev::sha3("Incremented(bool,uint256,uint256)");
std::cout << "0x" << sh.hex() << std::endl;

结果正是0x9b44895fef8929cca514f54bb4c52d35b5f403b960a39478ed7f4408e46eb69e，因此我们就知道这个事件得到了触发。
再来看这个事件的参数，第一个参数是x % 2 == 0的值，应该true, 也就是1，正是topics中第二行的值，注意到合约代码中Incremented第一个参数是indexed的，也就是这个标志的参数都会记录在topics的第2-n行中。那么没有这个标志的参数在哪呢？注意到上面还有个data，内容为0x00000000000000000000000000000000000000000000000000000000000000460000000000000000000000000000000000000000000000000000000000000015，这个可以分为两部分：
0x0000000000000000000000000000000000000000000000000000000000000046和0x0000000000000000000000000000000000000000000000000000000000000015，正是后面两个参数x和y的值，因此通过解析交易收据receipt，我们就能够得到事件触发的完整信息，也就是能够监听这个事件了。

更多文章请欢迎光临个人博客