feat(swarm): improve `PeerAddresses` configurability

[stormshield-frb]

Description

Our average peer has over 10 advertised addresses. Doing so, identify was continuously (every 1 minute) emitting ToSwarm::NewExternalAddrOfPeer which was overflowing our logs and was making the PeerCache kind of useless.

For this reason, we made some changes in order to be able to configure the number of addresses that should be cached for a peer. We are upstreaming this changes.

Notes & open questions

N/A

Change checklist

• [x] I have performed a self-review of my own code
• [x] I have made corresponding changes to the documentation
• [ ] I have added tests that prove my fix is effective or that my feature works
• [x] A changelog entry has been made in the appropriate crates

[mergify[bot]]

This pull request has merge conflicts. Could you please resolve them @stormshield-frb? 🙏

[mergify[bot]]

This pull request has merge conflicts. Could you please resolve them @stormshield-frb? 🙏

[mergify[bot]]

This pull request has merge conflicts. Could you please resolve them @stormshield-frb? 🙏