Issue

The "Full Example" of using @truffle/contract to interact with contracts should include an example of listening to an event with a filter.

In the past, it used to be possible to pass a filter object on indexed event parameters when listening to an event, as seen for example here (filtering to a particular _candidateName). It is not clear how to do this in the latest version of @truffle/contract, especially since log filter options are no longer passed to web3.eth.filter.

This Issue proposes a documentation change to make this easier to understand.

If you came here looking for a solution, the way to do it is that what used to be the filter object passed in separately now goes in as an object member of the options object, named "filter". So in the linked StackExchange example,

var event = contractInstance.RegisterCandidate( {_candidateName: "Abc"}, {fromBlock: 0, toBlock: 'latest'});

would likely become

var event = contractInstance.RegisterCandidate( {filter: {_candidateName: "Abc"}, fromBlock: 0, toBlock: 'latest'});

Possibly related issue with zero description: #2190