1 files changed, 40 insertions, 0 deletions

diff --git a/conn-notes.txt b/conn-notes.txt
new file mode 100644
index 00000000..f4964829
--- /dev/null
+++ b/conn-notes.txt
@@ -0,0 +1,40 @@
+Status of a tox friend netcrypto session.
+-----------------------------------------
+data ToxProgress
+    = AwaitingDHTKey        -- ^ Waiting to receive their DHT key.
+    | AcquiringIPAddress    -- ^ Searching DHT to obtain their node's IP & port.
+    | AcquiringCookie       -- ^ Attempting to obtain a cookie.
+    | AwaitingHandshake     -- ^ Waiting to receive a handshake.
+    | AwaitingSessionPacket -- ^ Connection is "accepted" but not yet "confirmed".
+    deriving (Eq,Ord,Enum,Show)
+
+
+Information about concat toxid and events that provide it.
+----------------------------------------------------------
+        SockAddr
+                receive packet with dhtkey associated with toxid
+                receive query result with dhtkey associated with toxid
+                receive netcrypto session packet from toxid
+        DHTKey
+                receive dhtpk over DataToRoute transport.
+                receive dht message from SockAddr
+                receive dhtpk via dht-request
+
+
+
+Recurring tasks associated with obtaining a connection.
+-------------------------------------------------------
+while (account is active):
+        announce{toxid}
+
+        while (policy=TryingToConnect and friend session is not established)
+                search{toxid} contact, send my dhtkey to results
+
+                while (dhtkey is fresh but sockaddr is stale)
+                        search{node} dhtkey
+
+                while (dhtkey and sockaddr are fresh)
+                        send handshake
+
+
+