目录
- 一、Ethereum事件日志查询参数
- 二、需求
- 三、实现
- 四、其他
一、Ethereum事件日志查询参数
- addresses:合约地址列表
- fromBlock:开始区块
- toBlock:结束区块
- topics:主题数组
- blockhash:区块哈希,优先级高于fromBlock、toBlock
这里主要介绍topics参数,其他参数都比较好理解,topics是长度为4的数组集合,topic分为2种:一种事件签名topic,另一种indexed索引参数值topic。
topics的的0号位子数组放事件签名哈希,1/2/3号位子数组对应放事件的indexed索引参数值对应的哈希。
以demo合约举例:
pragma solidity ^0.4.4;
contract Hello {
string name;
event LogSet(string s);
event LogSet1(string indexed s1);
event LogSet2(string indexed s1, string indexed s2);
event LogSet3(string indexed s1, string indexed s2, string indexed s3);
constructor() public {
name = "hello";
}
function get() public view returns (string) {
return name;
}
function set(string newName) public {
name = newName;
emit LogSet(newName);
emit LogSet1(newName);
emit LogSet2(newName, "name2");
emit LogSet3(newName, "name2", "name3");
}
}
如果合约调用set(“Tom”),事件LogSet3的1号位indexed索引参数值为"Tom",2号位为"name2",3号位为"name3"。
注意:
合约事件里最多只能有3个indexed索引参数。
如果事件定义改为:
event LogSet3(string indexed s1, string s2, string indexed s3);
事件LogSet3的1号位indexed索引参数值为"Tom",2号位为"name3",没有3号位。
二、需求
部署一个新的Hello合约,并调用一次set函数,以触发生成4条不同的事件日志。要求查询该合约的LogSet3事件日志。
三、实现
第一步,合约部署前,获取到最新块高,作为fromBlock,假设9684。
第二步,部署Hello合约,并调用set函数,入参newName=“Tom”,假设获取到新合约地址0x0dba67483eddb71a84ac0834cd4c8c89dc971d4b。
第三步,再次获取最新块高,作为toBlock,假设9686。
第四步,计算事件LogSet3(string,string,string)
的签名,得到0x3e03ccf7099c79040ac78f368a6a038e5d7918b8504f8cc99fd4d1ae71181e7b。
第五步,计算第一个indexed索引参数值"Tom"的哈希0x6984758a5a2907300d836a0ed6101bb5426c0a4422c0d996e8bbf9e59bb8c7cc,计算第二个indexed索引参数值"name2"的哈希0x7d51639d4f8290223cffdcc7a75498fd9c00ab65e7daf27837046fec6a6d6504,计算第三个indexed索引参数值"name3"的哈希0x289ff8670e65b79f5a7c14daf83f381a29ae238fff49f37396cc9100fb243074。
第六步,组装日志查询请求参数,如下:
{
"addresses": [
"0x0dba67483eddb71a84ac0834cd4c8c89dc971d4b"
],
"toBlock": "9686",
"topics": [
[
"0x3e03ccf7099c79040ac78f368a6a038e5d7918b8504f8cc99fd4d1ae71181e7b"
],
[
"0x6984758a5a2907300d836a0ed6101bb5426c0a4422c0d996e8bbf9e59bb8c7cc"
],
[
"0x7d51639d4f8290223cffdcc7a75498fd9c00ab65e7daf27837046fec6a6d6504"
],
[
"0x289ff8670e65b79f5a7c14daf83f381a29ae238fff49f37396cc9100fb243074"
]
],
"fromBlock": "9684"
}
实际上,如果指定了具体的Hello合约地址,请求参数里不需要第一个和第二个索引参数topic,也可以唯一区分开该合约的其他三个事件,如此,请求参数如下:
{
"addresses": [
"0x0dba67483eddb71a84ac0834cd4c8c89dc971d4b"
],
"toBlock": "9686",
"topics": [
[
"0x3e03ccf7099c79040ac78f368a6a038e5d7918b8504f8cc99fd4d1ae71181e7b"
],
null,
null,
[
"0x289ff8670e65b79f5a7c14daf83f381a29ae238fff49f37396cc9100fb243074"
]
],
"fromBlock": "9684"
}
四、其他
如果事件参数中包含枚举类型,如何正确计算该事件签名的topic。
在solidity中的enum
类型,实际上是无符号整数,当枚举数量是小于等于256(2的8次方)个,则enum是uint8类型的,如果大于256且小于等于65536(2的16次方),则enum是uint16类型的,以次类推。其实在remix中也可以看到,枚举内的数量小于256,枚举类型自动使用uint8,如下:
所以对上面的例子,事件签名DataSaved(ProofType,bytes)
是错误的,DataSaved(enum,bytes)
也是错误的。正确应该是DataSaved(uint8,bytes)
。
如果ProofType枚举的类型从2种变为257种,在remix里重新部署合约后,可以看到uint8自动变为uint16,如下: