How thomas-vilte/mls-go works
mls-go is a pure-Go MLS (RFC 9420) library. Its principal workflow creates a client and KeyPackage, creates a group, invites a member through a commit and Welcome, then protects and receives application messages. The graph also preserves proposal/commit processing, external joins, tree synchronization, key scheduling, extensions, and storage as distinct capabilities. Edges are limited to relationships shown in the README or source-index references; unsampled implementation details are not inferred.
Main entry points: group.go Group Lifecycle · tree.go Ratchet Tree · client.go MLS Client · welcome.go Welcome Join
Components 20
Client API
- MLS Client
client.go - Memory Storage
storage/memory/memory.go - File Storage
storage/file/file.go
MLS Protocol
- KeyPackages
keypackages/key_packages.go - Group Lifecycle
group/group.go - Commit Processing
group/commit.go - Welcome Join
group/welcome.go - Wire Messages
messages/messages.go - Message Framing
framing/private_message.go - MLS Extensions
extensions/extensions.go - External Senders
extensions/external_senders.go
Crypto and State
- Ratchet Tree
treesync/tree.go - Tree Nodes
treesync/node.go - Tree Serialization
treesync/serialization.go - Key Schedule
schedule/schedule.go - HPKE
ciphersuite/hpke.go - Cipher Suites
ciphersuite/ciphersuite.go
Interop Service
- Interop gRPC Server
interop/server/handler.go - Interop Runner
interop/testrunner/main.go
Other components
- Application
Connections 25
- Application → MLS Client: uses
- MLS Client → KeyPackages: creates
client.go - MLS Client → Group Lifecycle: manages
client.go - MLS Client → Memory Storage: defaults to
client.go - MLS Client → File Storage: can configure
client.go - MLS Client → Message Framing: protects messages
client.go - Group Lifecycle → Commit Processing: processes
- Group Lifecycle → Welcome Join: joins with
group/group.go - Group Lifecycle → Ratchet Tree: uses
group/group.go - Group Lifecycle → Key Schedule: uses
group/group.go - Group Lifecycle → MLS Extensions: uses
- Welcome Join → Wire Messages: encodes Welcome
messages/messages.go - Welcome Join → Key Schedule: uses
group/welcome.go - Welcome Join → Ratchet Tree: validates tree
group/welcome.go - Message Framing → HPKE: uses
framing/private_message.go - Message Framing → Cipher Suites: uses
framing/private_message.go - Message Framing → Ratchet Tree: uses ratchet
- Ratchet Tree → Tree Nodes: uses
treesync/tree.go - Ratchet Tree → Tree Serialization: serializes via
- KeyPackages → Cipher Suites: uses
keypackages/key_packages.go - KeyPackages → Ratchet Tree: uses
keypackages/key_packages.go - MLS Extensions → Ratchet Tree: encodes ratchet tree
- MLS Extensions → External Senders: includes
- Interop Runner → Interop gRPC Server: calls gRPC
interop/testrunner/main.go - Interop gRPC Server → Group Lifecycle: handles MLS operations
interop/server/handler.go