feat: metrics draft

Author: geolffreym

metrics.go

@@ -2,11 +2,17 @@ package noise
 
 // metrics hold the statistics related to remote peers.
 // We can add any method related to adaptive lookup logic here.
+// Please see [docs] for more information.
+//
+// [docs]: https://arxiv.org/pdf/1509.04417.pdf
 type metrics struct {
-	handshakeStart uint32
-	handshakeEnd   uint32
-	latency        uint16
-	bandwidth      uint16
+	handshakeTime uint32 // how long took the handshake to complete.
+	latency       uint16 // rtt in ms
+	bandwidth     uint16 // remote peer bandwidth
+	nonce         uint16 // nonce ordering factor
+	sent          uint16 // sent messages
+	recv          uint16 // received messages
 }
 
 // calculate weight
+// builder pattern?

peer.go

@@ -42,13 +42,13 @@ type packet struct {
 }
 
 // peer its the trusty remote peer.
-// Keep needed methods to interact with the secured session.
+// Provide needed methods to interact with the secured session.
 type peer struct {
 	// the attributes orders matters.
 	// ref: https://stackoverflow.com/questions/2113751/sizeof-struct-in-go
 	id   ID
 	s    *session
-	l    *metrics
+	m    *metrics
 	pool BytePool
 }