feat: address manager

Author: gmelodie

README.md

@@ -60,6 +60,8 @@ These specs define abstractions and data types that form the "core" of libp2p
 and are used throughout the system.
 
 - [Addressing][spec_addressing] - Working with addresses in libp2p.
+  - [Address Manager][spec_address_manager] - How a node discovers, confirms
+    and announces its own addresses.
 - [Connections and Upgrading][spec_connections] - Establishing secure,
   multiplexed connections between peers, possibly over insecure, single stream transports.
 - [Peer Ids and Keys][spec_peerids] - Public key types & encodings, peer id calculation, and
@@ -136,6 +138,7 @@ you feel an issue isn't the appropriate place for your topic, please join our
 [spec_connections]: ./connections/README.md
 [spec_plaintext]: ./plaintext/README.md
 [spec_addressing]: ./addressing/README.md
+[spec_address_manager]: ./addressing/address-manager.md
 [spec_noise]: ./noise/README.md
 [spec_mdns]: ./discovery/mdns.md
 [spec_autonat]: ./autonat/README.md

addressing/README.md

@@ -34,6 +34,7 @@ and spec status.
   - [WebSockets](#websockets)
   - [QUIC](#quic)
   - [`p2p-circuit` Relay Addresses](#p2p-circuit-relay-addresses)
+- [Related specs](#related-specs)
 
 ## Overview
 
@@ -324,8 +325,15 @@ Here, the destination peer has the peer id
 relay node with peer id `QmdPU7PfRyKehdrP5A3WqmjyD6bhVpU1mLGKppa2FjGDjZ` running
 on TCP port 5002 of the IPv4 loopback interface.
 
+## Related specs
+
+- [Address Manager][address-manager-spec]: how a node discovers its own
+  addresses, confirms that remote peers can dial them, and decides which of
+  them it announces.
+
 [peer-id-spec]: ../peer-ids/peer-ids.md
 [identify-spec]: ../identify/README.md
 [multiaddr-repo]: https://github.com/multiformats/multiaddr
 [multiaddr-proto-table]: https://github.com/multiformats/multiaddr/blob/master/protocols.csv
 [relay-spec]: ../relay/README.md
+[address-manager-spec]: ./address-manager.md