README.md

dmsg

dmsg is a distributed messaging system comprised of three types of services:

• dmsg.Client represents a user/client that wishes to use the dmsg network to establish dmsg.Sessions and dmsg.Streams.
• dmsg.Server represents a service that proxies dmsg.Streams between dmsg.Clients.
• dmsg.Discovery acts like a DNS of dmsg.Servers and dmsg.Clients, identifying them via their public keys.

           [D]

     S(1)        S(2)
   //   \\      //   \\
  //     \\    //     \\
 C(A)    C(B) C(C)    C(D)

Legend:

• [D] - dmsg.Discovery
• S(X) - dmsg.Server
• C(X) - dmsg.Client

dmsg.Clients and dmsg.Servers are identified via secp256k1 public keys, and store records of themselves in the dmsg.Discovery. Records of dmsg.Clients also includes public keys of dmsg.Servers that are delegated to proxy data between it and other dmsg.Clients.

The connection between a dmsg.Client and dmsg.Server is called a dmsg.Session. A connection between two dmsg.Clients (via a dmsg.Server) is called a dmsg.Stream. A data unit of the dmsg network is called a dmsg.Frame.

Dmsg tools and libraries

• dmsgget - Simplified wget over dmsg.
• dmsgpty - Simplified SSH over dmsg.

Additional resources

• dmsg examples.
• dmsg.Discovery documentation.
• Starting a local dmsg environment.