From 43583ba7ee59180d73489431a80300a44baae6d1 Mon Sep 17 00:00:00 2001
From: Hanno Cornelius <68783915+jm-clius@users.noreply.github.com>
Date: Tue, 16 Nov 2021 12:15:32 +0100
Subject: [PATCH] Integrate RFC31. Delete RFC25. (#474)

---
 content/docs/rfcs/10/README.md | 23 ++++++++++++++++++++---
 content/docs/rfcs/25/README.md |  2 +-
 content/menu/index.md          |  1 -
 3 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/content/docs/rfcs/10/README.md b/content/docs/rfcs/10/README.md
index cefa05d1..a94fb894 100644
--- a/content/docs/rfcs/10/README.md
+++ b/content/docs/rfcs/10/README.md
@@ -135,13 +135,24 @@ See [23/WAKU2-TOPICS](/spec/23) for more information about recommended topic usa
 
 ### Discovery domain
 
+#### Discovery methods
+
 Waku v2 can retrieve a list of nodes to connect to using DNS-based discovery as per [EIP-1459](https://eips.ethereum.org/EIPS/eip-1459).
 While this is a useful way of bootstrapping connection to a set of peers,
-it MAY be used in conjunction with an [ambient peer discovery](https://docs.libp2p.io/concepts/publish-subscribe/#discovery) procedure to find still other nodes to connect to.
-Mechanisms for ambient peer discovery are not yet specified for Waku v2.
+it MAY be used in conjunction with an [ambient peer discovery](https://docs.libp2p.io/concepts/publish-subscribe/#discovery) procedure to find still other nodes to connect to,
+such as [Node Discovery v5](https://github.com/ethereum/devp2p/blob/8fd5f7e1c1ec496a9d8dc1640a8548b8a8b5986b/discv5/discv5.md).
+More ambient peer discovery methods are being tested for Waku v2,
+and will be specified for wider adoption.
 It is possible to bypass the discovery domain by specifying static nodes.
 
-<!-- TODO: Document (a) how we map ENR to multiaddr for EIP-1459, once specified, (b) ambient peer discovery. -->
+#### Use of ENR
+
+[31/WAKU2-ENR](/spec/31) describes the usage of [EIP-778 ENR (Ethereum Node Records)](https://eips.ethereum.org/EIPS/eip-778) for Waku v2 discovery purposes.
+It introduces two new ENR fields, `multiaddrs` and `waku2`, that a Waku v2 node MAY use for discovery purposes.
+These fields MUST be used under certain conditions, as set out in the spec.
+Both EIP-1459 DNS-based discovery and Node Discovery v5 operates on ENR,
+and it's reasonable to expect even wider utility for ENR in Waku v2 networks in future.
+
 
 ### Request/Reply domain
 
@@ -411,3 +422,9 @@ Copyright and related rights waived via [CC0](https://creativecommons.org/public
 18. [EIP-1459](https://eips.ethereum.org/EIPS/eip-1459)
 
 19. [Ambient peer discovery](https://docs.libp2p.io/concepts/publish-subscribe/#discovery)
+
+20. [Node Discovery v5](https://github.com/ethereum/devp2p/blob/8fd5f7e1c1ec496a9d8dc1640a8548b8a8b5986b/discv5/discv5.md)
+
+31. [31/WAKU2-ENR spec](/spec/31)
+
+32. [EIP-778](https://eips.ethereum.org/EIPS/eip-778)
diff --git a/content/docs/rfcs/25/README.md b/content/docs/rfcs/25/README.md
index f44c8752..a15e4e2d 100644
--- a/content/docs/rfcs/25/README.md
+++ b/content/docs/rfcs/25/README.md
@@ -2,7 +2,7 @@
 slug: 25
 title: 25/LIBP2P-DNS-DISCOVERY
 name: Libp2p Peer Discovery via DNS
-status: raw
+status: deleted
 editor: Hanno Cornelius <hanno@status.im>
 contributors:
 ---
diff --git a/content/menu/index.md b/content/menu/index.md
index e35c3bb7..15dfa194 100644
--- a/content/menu/index.md
+++ b/content/menu/index.md
@@ -7,7 +7,6 @@ bookMenuLevels: 1
   - [17/WAKU2-RLNRELAY]({{< relref "/docs/rfcs/17/README.md" >}})
   - [20/TOY-ETH-PM]({{< relref "/docs/rfcs/20/README.md" >}})
   - [24/STATUS-CURATION]({{< relref "/docs/rfcs/24/README.md" >}})
-  - [25/LIBP2P-DNS-DISCOVERY]({{< relref "/docs/rfcs/25/README.md" >}})
   - [28/STATUS-FEATURING]({{< relref "/docs/rfcs/28/README.md" >}})
   - [31/WAKU2-ENR]({{< relref "/docs/rfcs/31/README.md" >}})
 - Draft