…port.

and use them across the crate. Deprecate the old ones.

…he crate

…cross the crate

and use them across the crate. Deprecate the v2 ones.

With libp2p#2712 merged, this can be marked as done.

…ibp2p#3208)

Addresses libp2p#2885

Currently, we create a new cache for each workflow run for each crate. That ends up blowing the maximum allowed cache size of 10GB and GitHub deletes the least-recently used cache again. Effectively, this means we don't have any caching.

This patch introduces a cache factory workflow that only runs on master and always _saves_ a new cache. The CI workflow run for pull-requests on the other hand only restore these caches but don't save them.

)

This patch deprecates 3 out of 4 functions on `PollParameters`:

- `local_peer_id`
- `listened_addresses`
- `external_addresses`

The addresses can be obtained by inspecting the `FromSwarm` event. To make this easier, we introduce two utility structs in `libp2p-swarm`:

- `ExternalAddresses`
- `ListenAddresses`

A node's `PeerId` is always known to the caller, thus we can require them to pass it in.

Related: libp2p#3124.

- rename RelayTransport in client doc to transport
- make behaviour mod private re-exporting CircuitId
- make client mod private re-exporting pub types.

use client::new instead.
Update client module doc.

- dcutr tests use relay::client instead of just client::
- rename RelayedConnection to RelayedConnection
- improve deprcated wording for types, remove the renamed references.

rename RelayedDial to Dial.