chore: rate limit peer exchange protocol, enhanced response status in RPC

[NagyZoltanPeter]

Description

As part of DOS protection for req-res protocols and metrics Waku PeerExchange protocol must be protected just as Lightpush/Store and Filter.

Changes

• [x] Ratlimit config and check was added to WakuPeerExchange
• [x] Due to the protocol RPC structure limiter status response capabilities, new fields had been added (status and optional descritpion)
• [x] Better error handling and reporting in WakuPeerExchange request/response side.
• [x] Test adjustments.
• [x] Enhance Waku CLI Rate Limit configuration (allow multiple configuration added, separately for each protocol)
• [x] Added new gauge to help dashboard show effective applied rate limit of protocols

Warning

The last bullet point introduces a refactored rate limit configuration over CLI/TOML file. This was necessary as identified different needs for different protocols (out of dogfooding and dashboard data) This change will break former CLI as removed two former rate-limit option and replaced them by one - formatted string - that can be repeated.

As rate-limit configuration is not yet used this breaking change shall not cause trouble, just we need to handle upgrades with care.

New CLI option is --rate-limit which has to be set as string in a proper format. Examples:

• --rate-limit="lightpush:13/10s"
• --rate-limit="storev3:15/1500ms"
• --rate-limit="px:1/1m"
• --rate-limit="100/10m"
  • this last one is taken as global and will be used as default for protocols not set otherwise

As this option can be repeated rate limit configuration can be fine-grained for every needs.

How to test

Tests are adjusted and extended. Every peer exchange test must run without error.

Issue

https://github.com/waku-org/nwaku/issues/3028

Further actions:

• [x] https://github.com/waku-org/specs/blob/master/standards/core/peer-exchange.md must be adjusted
• [x] Configuration documentation must be pulled after.
• [ ] Add dashboard panel for PeerExchange metrics

[github-actions[bot]]

You can find the image built from this PR at

quay.io/wakuorg/nwaku-pr:3035

Built from cf4e1673d3c0d5e9240d614de57fc419b04320a5

[NagyZoltanPeter]

Latest changes done on the peer-exchange specification is reflected now in nwaku code. This was necessary to ensure backward compatibility of the protocol while allowing added status to return. Also all review findings addressed.