responded to comments

channels/adminListener.go

@@ -17,13 +17,14 @@ import (
 	"gitlab.com/xx_network/primitives/id"
 )
 
-// adminListener adheres to the broadcast listener interface and is used when
-// admin messages are received on the channel.
+// adminListener adheres to the [broadcast.ListenerFunc] interface and is used
+// when admin messages are received on the channel.
 type adminListener struct {
 	chID    *id.ID
 	trigger triggerAdminEventFunc
 }
 
+// Listen is called when a message is received for the admin listener
 func (al *adminListener) Listen(payload []byte,
 	receptionID receptionID.EphemeralIdentity, round rounds.Round) {
 

channels/eventModel.go

@@ -75,6 +75,8 @@ type MessageTypeReceiveMessage func(channelID *id.ID,
 	senderUsername string, content []byte, timestamp time.Time,
 	lease time.Duration, round rounds.Round)
 
+// events is an internal structure which processes events and stores the
+// handlers for those events
 type events struct {
 	model      EventModel
 	registered map[MessageType]MessageTypeReceiveMessage

channels/mutateTimestamp.go

@@ -14,8 +14,8 @@ import (
 )
 
 const (
-	// use a prime close to one million to ensure patterns dont arise due to
-	// cofactors with the message ID when doing the modulo
+	// tenMsInNs is a prime close to one million to ensure patterns dont
+	// arise due to cofactors with the message ID when doing the modulo
 	tenMsInNs     = 10000019
 	halfTenMsInNs = tenMsInNs / 2
 )

channels/send.go

@@ -98,7 +98,8 @@ func (m *manager) SendGeneric(channelID *id.ID, messageType MessageType,
 	}
 
 	// TODO: send the send message over to reception manually so it is added to
-	//the database early
+	// the database early This requires an entire project in order to track
+	// round state.
 	rid, ephid, err := ch.broadcast.BroadcastWithAssembler(assemble, params)
 	return msgId, rid, ephid, err
 }
@@ -163,7 +164,8 @@ func (m *manager) SendAdminGeneric(privKey *rsa.PrivateKey, channelID *id.ID,
 	}
 
 	// TODO: send the send message over to reception manually so it is added to
-	//the database early
+	// the database early. This requires an entire project in order to track
+	// round state.
 	rid, ephid, err := ch.broadcast.BroadcastAsymmetricWithAssembler(privKey,
 		assemble, params)
 	return msgId, rid, ephid, err

channels/userListener.go

@@ -18,14 +18,15 @@ import (
 	"time"
 )
 
-// the userListener adheres to the broadcast listener interface and is used
-// when user messages are received on the channel
+// the userListener adheres to the [broadcast.ListenerFunc] interface and is
+// used when user messages are received on the channel
 type userListener struct {
 	name    NameService
 	chID    *id.ID
 	trigger triggerEventFunc
 }
 
+// Listen is called when a message is received for the user listener
 func (gul *userListener) Listen(payload []byte,
 	receptionID receptionID.EphemeralIdentity, round rounds.Round) {