Log Event Trigger Capability Development: Part 1

[kidambisrinivas]

Updates

• Log Event Trigger Capability to listen for specific events from contracts and start a workflow run
• Built as a LOOPP Plugin process
• Fetches ContractReader from RelayerSet passed in capability's Initialise method and uses it to Bind for a specific contract's event
• Integration test with EVM relayer and ChainReader

References

• Chainlink Common changes

  • Expose ContractReader and ChainWriter of relayer in relayerSet PR
  • Add LatestHead relayer method to gRPC client and server implementations
  • Support Type Aliases in values.Value pkg
    • Unwrap
      • Chainlink-common PR1: Handle type aliases in slices in bytes/unwrap
      • Chainlink-common PR2: Remove explicit handling type aliases in slices in int/unwrap and handle it in generic unwrap
      • Chainlink-common PR3: More alias handling in unwrap functionality of Value
      • Chainlink-common PR4: Support passing in a values.Value to the chainreader GetLatestValue method
    • Wrap
      • Fix alias typing and tests
      • Add array support to slice
  • Support passing in a values.Value to the ChainReader GetLatestValue and QueryKey methods
    • Chainlink-common PR
    • Chainlink core PR: Support passing in a values.Value to the GetLatestValue and QueryKey methods

• Chainlink Core changes

  • Log Event Trigger Capability Development: Part 1
  • Log Event Trigger Capability Development: Part 2
  • Log Event Trigger Capability Development: Part 3
  • Set cursor direction

Testing

$ go test -count=1 -v -run="^TestLogEventTriggerEVMHappyPath$" ./core/services/relay/evm/capabilities
            logger.go:146: 2024-09-30T22:32:12.405+0100 DEBUG   LogPoller       logpoller/log_poller.go:925     Polling for logs        {"version": "unset@unset", "currentBlockNumber": 5}
    logger.go:146: 2024-09-30T22:32:12.405+0100 DEBUG   LogPoller       logpoller/log_poller.go:1027    Latest blocks read from chain   {"version": "unset@unset", "latest": 4, "finalized": 2}
    logger.go:146: 2024-09-30T22:32:12.405+0100 DEBUG   LogPoller       logpoller/log_poller.go:937     No new blocks since last poll   {"version": "unset@unset", "currentBlockNumber": 5, "latestBlockNumber": 4}
    logger.go:146: 2024-09-30T22:32:12.438+0100 INFO    LogEventTriggerCapabilityService.LogEventTrigger.       logevent/trigger.go:141 Polling event logs from ContractReader using QueryKey at       {"version": "unset@unset", "time": "2024-09-30T22:32:12.438+0100", "startBlockNum": 0, "cursor": ""}
    logger.go:146: 2024-09-30T22:32:12.442+0100 INFO    testutils/chain_reader.go:119   Received log from ContractReader        {"version": "unset@unset", "event": "2-0-0x1260be74f7eebae959f26943cad3482061ee874a736829b936ecc2055b246f20"}
    logger.go:146: 2024-09-30T22:32:12.442+0100 INFO    capabilities/log_event_trigger_test.go:80       EmitLog {"version": "unset@unset", "output": {"Cursor":"2-0-0x1260be74f7eebae959f26943cad3482061ee874a736829b936ecc2055b246f20","Data":{"Arg0":10},"Head":{"Hash":"WhLchfaH8zTOz8cEAxpY0eywT/abTGjKORcxGH1T63s=","Height":"2","Timestamp":1727645551}}}
    logger.go:146: 2024-09-30T22:32:12.442+0100 INFO    LogEventTriggerCapabilityService        logevent/service.go:145 Stopping LogEventTriggerCapabilityService       {"version": "unset@unset"}
    logger.go:146: 2024-09-30T22:32:12.442+0100 INFO    LogEventTriggerCapabilityService.LogEventTrigger.       logevent/trigger.go:135 Closing trigger server for (waiting for waitGroup)    {"version": "unset@unset", "ChainID": "1337", "ContractName": "LogEmitter", "ContractAddress": "0x16401EFEa459E3C021248618B8Aca311E8e521ac", "ContractEventName": "Log1"}
--- PASS: TestLogEventTriggerEVMHappyPath (1.02s)
PASS
ok      github.com/smartcontractkit/chainlink/v2/core/services/relay/evm/capabilities   2.501s

[bolekk]

It looks like this PR is only a skeleton of the Trigger, it doesn't actually process any logs. Can you modify the PR title to reflect that please?

[cl-sonarqube-production]

Quality Gate passed

Issues
0 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
76.3% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube