Current State

A few areas could do with some improvement:

• The complete example shows a single-filter example, and if you just drop a multi-filter example into it (which some users are likely to do) you end up with an invalid contract listener request. It would be better if this example was converted to use the multi-filter format (i.e. no top-level event field in the payload) even if it only contains one event
• The example has both event ABI inline, and a reference to an interface. I don't think you need the latter if you have the former?
• Also the FireFly Interface field is described as follows: Deprecated: Please use 'interface' in the array of 'filters' instead but it isn't described as optional, which I believe it is since it isn't needed if you pass the ABI of the event in the filter itself. So it might be useful to remove interface from the examples that include event ABI inline, and possibly have an example that does reference an interface later in the document
• Similarly, the eventPath is only needed when a FireFly Interface is being referenced. So it could probably go in a later example, not the main one.

Desired State

See notes in current state for recommended changes