ipcpd: Update DHT for unicast layer

This is a rewrite of the DHT for name-to-address resolution in the
unicast layer. It is now integrated as a proper directory policy. The
dir_wait_running function is removed, instead the a DHT peer is passed
on during IPCP enrolment.

Each DHT request/response gets a random 64-bit ID ('cookie'). DHT
messages to the same peer are deduped, except in the case when the DHT
is low on contacts. In that case, it will contact the per it received
at enrolment for more contacts. To combat packet loss, these messages
are not deduped by means of a 'magic cookie', chosen at random when
the DHT starts.

The DHT parameters (Kademlia) can be set using the configfile or the
IRM command line tools:

if DIRECTORY_POLICY == DHT
        [dht_alpha <search factor> (default: 3)]
        [dht_k <replication factor> (default: 8)]
        [dht_t_expire <expiration (s)> (default: 86400)]
        [dht_t_refresh <contact refresh (s)> (default: 900)]
        [dht_t_replicate <replication (s)> (default: 900)]

This commit also adds support for a protocol debug level (PP).
Protocol debugging for the DHT can be enabled using the
DEBUG_PROTO_DHT build flag.

The DHT has the following message types:

DHT_STORE, sent to k peers. Not acknowledged.

    DHT_STORE --> [2861814146dbf9b5|ed:d9:e2:c4].
      key: bcc236ab6ec69e65 [32 bytes]
      val: 00000000c4e2d9ed [8 bytes]
      exp: 2025-08-03 17:29:44 (UTC).

DHT_FIND_NODE_REQ, sent to 'alpha' peers, with a corresponding
response. This is used to update the peer routing table to iteratively
look for the nodes with IDs closest to the requested key.

    DHT_FIND_NODE_REQ --> [a62f92abffb451c4|ed:d9:e2:c4].
      cookie: 2d4b7acef8308210
      key:    a62f92abffb451c4 [32 bytes]

    DHT_FIND_NODE_RSP <-- [2861814146dbf9b5|ed:d9:e2:c4].
      cookie: 2d4b7acef8308210
      key:    a62f92abffb451c4 [32 bytes]
      contacts: [1]
        [a62f92abffb451c4|9f:0d:c1:fb]

DHT_FIND_VALUE_REQ, sent to 'k' peers, with a corresponding
response. Used to find a value for a key. Will also send its closest
known peers in the response.

    DHT_FIND_VALUE_REQ --> [2861814146dbf9b5|ed:d9:e2:c4].
      cookie: 80a1adcb09a2ff0a
      key:    42dee3b0415b4f69 [32 bytes]

    DHT_FIND_VALUE_RSP <-- [2861814146dbf9b5|ed:d9:e2:c4].
      cookie: 80a1adcb09a2ff0a
      key:    42dee3b0415b4f69 [32 bytes]
        values: [1]
          00000000c4e2d9ed [8 bytes]
        contacts: [1]
          [a62f92abffb451c4|9f:0d:c1:fb]

Also removes ubuntu 20 from appveyor config as it is not supported anymore.

Signed-off-by: Dimitri Staessens <dimitri@ouroboros.rocks>
Signed-off-by: Sander Vrijders <sander@ouroboros.rocks>

1 files changed, 8 insertions, 2 deletions

diff --git a/irmd.conf.in b/irmd.conf.in
index 4fb01c93..dda5ccfd 100644
--- a/irmd.conf.in
+++ b/irmd.conf.in
@@ -86,7 +86,7 @@ ip="127.0.0.1"
 
 [broadcast.bc1]
 bootstrap="broadcast"   # Defaults to not set.
-autobind=true           # Defaults to false.
+# autobind=true           # Defaults to false.
 
 [broadcast.bc2]
 enrol="bc1"
@@ -96,13 +96,19 @@ enrol="bc1"
 bootstrap="LAN"         # Defaults to not set.
 autobind=true           # Defaults to false.
    # BOOTSTRAP CONFIGURATION
-# hash="SHA3_224"       # Defaults to SHA3_256.
 # addr_size=4           # Defaults to 4 (32-bit addresses).
 # eid_size=8            # Defaults to 8 (64-bit endpoint IDs, only accepted option).
 # max_ttl=60            # Defaults to 60 (max 255).
 # addr-auth="flat"      # Defaults to flat (currently only option).
 # routing="lfa"         # Defaults to link-state (options: link-state, lfa, ecmp).
 # congestion="none"     # Defaults to mb-ecn (options: none, mb-ecn).
+# directory=DHT         # Defaults to DHT (options: DHT)
+# hash="SHA3_224"       # Defaults to SHA3_256.
+# dht_alpha=3           # DHT parallel search factor (Default 3, optimal)
+# dht_k=8               # DHT replication factor (Default: 8, same as Mainline DHT)
+# dht_t_expiry=3600     # DHT entry expiry time (s) (Default: 86400 s)
+# dht_t_refresh         # DHT contact refresh interval (s) (Default: 900 s)
+# dht_t_replicate       # DHT replication interval (s) (Default: 900 s)
    # NAMES KNOWN
 reg=["oping"]           # Defaults to [].