feature request: Add filtering capability about history-tools

[gituser]

I agree on this, there should be similar mechanism for filtering as in original history plugin or some sort of. To be able to filter transactions on certain token, receiver and sender.

[alexander-a-semin]

Same as history plugin, but at least code and receiver account name.

[gituser]

@tbfleming adding similar filter-on as in deprecated history plugin should be a good start!

[alexander-a-semin]

@tbfleming is there any forecast for the implementation of the feature?

[alexander-a-semin]

Add filtering capability is the most important feature for out team and for EOSIO future. Please, do it ASAP.

[tbfleming]

Let's expand on this a bit. What kinds of things should it support filtering on?

[tbfleming]

I'm working on this now. Here's a snippet describing it which will go into the documentation:

Transaction filters

--fill-trx creates a set of transaction filtering rules. It has the following syntax:

--fill-trx include:status:receiver:act_account:act_name

It ignores whitespace within the pattern.

Field	May be empty?	Description
include	No	"+" to pass a matching action, or "-" to not pass
status	Yes	Transaction status. May be one of: executed, soft_fail, hard_fail, delayed, expired
receiver	Yes	The account which originally received the action, or the account which received a copy (require_recipient).
act_account	Yes	The account which received the original. This is called code or first_receiver in the CDT.
act_name	Yes	The name of the action

--fill-trx may be specified multiple times. This creates a list of rules. The filter checks an action against each rule in order. As soon as it finds a rule which matches the action it stops. The action passes if include is +. The action doesn't pass if include is -. If no rules match, then the action doesn't pass.

The filler writes a transaction to the database if any of the transaction's actions pass the filter. When this happens, it writes all actions in the transaction, including ones that didn't pass.

Transaction filter examples

• Include all transactions. Includes deferred transactions which haven't executed
  yet or have failed. This is the default if no --fill-trx is provided:

--fill-trx "+:        :            :            :"

• Include all executed transactions. Excludes deferred transactions which haven't executed
  yet or have failed:

--fill-trx "+:executed:            :            :"

• Include all executed transactions, but exclude some spam:

--fill-trx "-:        :blocktwitter:blocktwitter:"
--fill-trx "+:executed:            :            :"

• Include all executed transfers. Includes all token contracts.

--fill-trx "+:executed:            :            :transfer"

• Include all executed transfers. Includes only eosio.token.

--fill-trx "+:executed:            :eosio.token :transfer"

• Include all executed transfers which notify specific accounts. Includes all token contracts.

--fill-trx "+:executed:myaccount1  :            :transfer"
--fill-trx "+:executed:myaccount2  :            :transfer"

• Include all executed transfers which notify specific accounts. Only includes eosio.token.

--fill-trx "+:executed:myaccount1  :eosio.token :transfer"
--fill-trx "+:executed:myaccount2  :eosio.token :transfer"

[tbfleming]

It's now in the develop branch

[alexander-a-semin]

@tbfleming Thanks a lot !