Skip to content

Commit

Permalink
Update Tron-event_description.md
Browse files Browse the repository at this point in the history
  • Loading branch information
jiangyy0824 committed Mar 5, 2019
1 parent 19a1340 commit f7f76d6
Showing 1 changed file with 8 additions and 2 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
- contractLogTrigger: 智能合约日志
- contractEventTrigger:智能合约事件


> Filter定义
只针对智能合约日志、事件的订阅,具体包括如下字段:
Expand All @@ -19,6 +20,7 @@ contractAddress:智能合约地址列表
contractTopics:智能合约主题列表
**注意**: 不支持历史数据查询。


> 交易Log
交易信息用TransactionLogTrigger表示,包括如下参数:
Expand All @@ -31,6 +33,7 @@ contractTopics:智能合约主题列表
- originEnergyUsage origin energy usage
- energyUsageTotal, total energy usage total


> 智能合约Log
智能合约日志对象用ContractLogTrigger表示,包括如下参数:
Expand All @@ -44,6 +47,7 @@ contractTopics:智能合约主题列表
- data: Solidity 语言中,Log 能够输出的 data
- removed,如果日志已被删除则为true,有效日志则为false


> 智能合约Event
- transactionId, transaction id
Expand All @@ -56,13 +60,15 @@ contractTopics:智能合约主题列表
- data: Solidity 语言中, Event 能够输出的 data 字段
- removed,如果日志已被删除则为true,有效日志则为false


> Trigger触发
- 区块事件的触发,区块插入时创建blockTrigger
- 交易事件的触发,交易执行之前创建transactionTrigger
- 智能合约日志的触发,在合约执行并且解析之后创建contractLogTrigger
- 智能合约事件的触发,在合约执行并且解析之后创建contractEventTrigger


> Trigger发送
java-tron以异步方式将Trigger发送给插件,Trigger必须满足Filter的条件。
Expand All @@ -77,7 +83,7 @@ contractAddresses: "addressA"

contractTopics: "TopicA"

插件实现
> 插件实现
插件的功能是为了实现Trigger的转储,开发者可依据自己的需求做定制化,消息队列、Kafka、Mongdb或者写文件。

插件独立于java-tron,默认不被加载,可配置命令行参数开启插件。默认只支持智能合约日志的订阅,开发者可以通过修改配置文件实现对其他Trigger的订阅。
Expand All @@ -86,4 +92,4 @@ contractTopics: "TopicA"

以kafka插件为例,在配置文件中定义Kafka server地址,Kafka topics(对应Trigger类别)。插件接收到java-tron发送的Trigger后,依据Trigger类别把Trigger发送到对应的Kafka topic.

插件实现ILogsFilterPlugin接口,包括插件的初始化、启动,接收Trigger,由java-tron依据配置文件加载插件。
插件实现ILogsFilterPlugin接口,包括插件的初始化、启动,接收Trigger,由java-tron依据配置文件加载插件。

0 comments on commit f7f76d6

Please sign in to comment.