产品动态

您的位置: 首页产品动态

最新技术更多

web3j教程:以太坊过滤器(filter)筛选和智能合约事件(event)监听

作者: 芒果汁发布时间:2018-07-03

 

web3j过滤器提供以太坊网络发生的某些事件的通知,对java和安卓程序员来说很有用。在Ethereum以太坊中支持三类过滤器:


• 块滤波器(Block filters)

• 未决交易过滤器(Pending transaction filters)

• 主题过滤器(Topic filters)


块过滤器和未决交易过滤器提供了在网络上创建新交易或块的通知。

主题过滤器更灵活。允许根据提供的特定标准创建过滤器。

不幸的是,除非你使用WebSocket连接到Geth,否则通过JSON-RPC API来处理过滤器是一个繁琐的过程,这里需要轮询以太坊客户端,以便了解HTTP和IPC所请求的实时同步特征,是否有任何新的更新到你的过滤器。此外,块和交易过滤器只提供交易或区块链hash值,因此需要进一步的请求来获得hash对应的实际交易或块。

 

web3j的过滤器解决了这些问题,因此你有一个完全异步的基于事件的API来处理过滤器。它使用RXJava的可观测性Observables,它提供了与事件协同工作的一致API,这有助于通过功能组合将JSON-RPC调用链接在一起。

 

注:Infura不支持过滤器。

 

 

块和交易过滤器

 

接收所有新块把它们添加到区块链(false参数指定我们只需要块就ok,而不需要嵌入交易):

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/93148749066427564216941487035162/20190604181539826.png

 

接收所有新交易,把它们添加到块链:

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/05680990289653652688129974135572/20190604181612060.png

 

接收所有待提交交易并提交到网络(即在它们被分组在一起之前):

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/32490656085284830569297994313469/20190604181634810.png

 

不再需要的时候取消订阅unsubscribe:

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/43960120061961212182134060971004/20190604181651810.png

 

另外还提供了其他回调,它们简单地提供了块或交易hash,这些细节涉及Web3JRX接口。

 

再现过滤器

 

webjs还提供用于再现块和交易历史的过滤器。

 

从区块链再现一系列块:

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/56014311850008301648953138399126/20190604181712575.png

 

再现包含在一个块范围内的单个交易:

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/59066504794634379251699089122205/20190604181732700.png

 

也可以获得Web3J再现最新的块,并在你看过后提供通知(通过提交Observable):

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/82713624758919233700037218126613/20190604181749840.png

 

或者,也可以在你再现最新的块后,通知新创建的后续块:

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/97078191780277133180903977903990/20190604181806575.png

 

如上所述,并包含在块内的交易:

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/36952896265851823507356648549940/20190604181852981.png

 

所有上述过滤器都是通过Web3JRX接口导出的。

 

主题过滤器和EVM事件

 

主题过滤器捕获在网络中发生的以太坊虚拟机(EVM)事件的细节。这些事件是由智能合约创建的,并存储在与智能合约相关联的交易日志中。

 

solidity文档提供了EVM事件的良好概述。

 

使用EthFilter类型指定希望应用于过滤器的主题。这可以包括希望应用过滤器的智能合约的地址。你还可以提供特定的主题进行筛选。其中单个主题表示智能合约上的索引参数:

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/72455373584524961642604219380527/20190604181911575.png

 

然后可以使用类似于上面的块和交易过滤器的语法创建该过滤器:

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/83009629688407093183046900100483/20190604181929043.png

 

过滤器主题只能引用索引的Solidity事件参数。不可能对非索引事件参数进行筛选。此外,对于可变长度数组类型(如字符串和字节)的任何索引事件参数,它们的值的Keccak-256 hash 存储在EVM日志上。不可能使用它们的全部值来存储或筛选。

 

如果创建一个没有与之相关联的主题的过滤器实例,则在网络中发生的所有EVM事件都将由过滤器捕获。

 

 

操作组合标注

 

除了send()和sendAsync之外,所有JSON-RPC方法在web3j中都实现了支持observable()方法来创建可观察的异步执行请求。这使得将JSON-RPC调用组合成新的函数是非常容易和直接的。

 

例如, blockObservable本身由许多单独的JSON-RPC调用组成:

 

https://attachfiles.oss-cn-beijing.aliyuncs.com/attachFiles/p2p_article/p2p_article/52485225888880696973496344724980/20190604181949308.png

 

在这里,我们首先创建一个可观察的,它提供每个新创建的块的块哈希的通知。然后,我们使用flatMap调用ethGetBlockByHash,以获得完整的块细节,这是传递给可观察者的订阅服务器的细节。

 

 

原文出处:web3j教程:过滤器(Filters)和事件(Events)

联系我们

400-090-3910

(北京总部:全国统一咨询热线)

北京地址:北京市朝阳区领地OFFICE1号楼A座1403

上海分部:13911340419

上海地址:上海市宝山区泸太路6395号1_2层B区2440室

广州分部:13161766437

广州地址:广州市天河区广汕一路715号2号楼1-7楼405-5房

关注我们 了解最新动态消息
关注微信
关注微博
专题子站: