Transaction Filter Processor

Transaction Filter Processor¶

This plugin allows you to filter transactions based on their contents. This is useful for filtering out transactions to the specific ones required for your application.

Filters¶

Filters have two top level logical operators, any and all. These are used to match "sub-expressions" specified in the filters. For any set of expressions, e1, e2, e3, ... any(e1,e2,e3,...eN) will return true if there exists eX for 1 >= X <= N where eX evaluates to true, and all(e1,e2,e3,...eN) will return true if for every X from 1..N, eX evaluates to true.

In simpler terms, any matches the transaction if at least one sub-expression matches, and all matches only if every sub-expression matches.

If there are multiple top level filters defined in the configuration, the transaction match is combined with an AND operation. Meaning the transaction must be matched by all defined filters in order to pass through the filter.

Sub-Expressions¶

So, what defines a sub-expression?

The sub-expression consists of 3 components.

`tag`¶

The tag identifies the field to attempt to match. The fields derive their tags according to the official reference docs. You can also attempt to match against the ApplyData. A complete list of supported tags can be found here.

For now, we programmatically generate these fields into a map located in the filter package, though this is not guaranteed to be the case.

Example:

- tag: 'txn.snd' # Matches the Transaction Sender
- tag: 'txn.apar.c' # Matches the Clawback address of the asset params
- tag: 'txn.amt' # Matches the amount of a payment transaction

`expression-type`¶

The expression type is a selection of one of the available methods for evaluating the expression. The current list of types is * exact: exact match for string values. * regex: applies regex rules to the matching. * less-than applies numerical less than expression. * less-than-equal applies numerical less than or equal expression. * greater-than applies numerical greater than expression. * greater-than-equal applies numerical greater than or equal expression. * equal applies numerical equal expression. * not-equal applies numerical not equal expression.

You must use the proper expression type for the field your tag identifies based on the type of data stored in that field. For example, do not use a numerical expression type on a string field such as address.

`expression`¶

The expression is the data against which each field will be compared. This must be compatible with the data type of the expected field. For string fields you can also use the regex expression type to interpret the input of the expression as a regex.

Configuration¶

```yml @sample.yaml name: filter_processor config: # Whether or not the expression searches inner transactions for matches. search-inner: true

# Whether or not to include the entire transaction group when the filter # conditions are met. omit-group-transactions: true

# The list of filter expressions to use when matching transactions. filters: - any: - tag: txn.rcv expression-type: exact expression: "ADDRESS"

## Examples

Find transactions w/ fee greater than 1000 microalgos
```yaml
filters:
  - any:
    - tag: "txn.fee"
      expression-type: "greater-than"
      expression: "1000"

Find state proof transactions

filters:
  - any:
    - tag: "txn.type"
      expression-type: "exact"
      expression: "stpf"

Find transactions calling app, "MYAPPID"

filters:
  - all:
    - tag: "txn.type"
      expression-type: "exact"
      expression: "appl"
    - tag: "txn.apid"
      expression-type: "exact"
      expression: "MYAPPID"

Find transactions, including inner transactions, sent by "FOO".

search-inner: true
filters:
  - all:
    - tag: "txn.snd"
      expression-type: "exact"
      expression: "FOO"

Find transactions calling app, exclude grouped transactions

omit-group-transactions: true
filters:
  - all:
    - tag: "txn.type"
      expression-type: "exact"
      expression: "appl"

Transaction Filter Processor