Cryptogram

Decentralized P2P messaging app built on top of LibP2P. Currently only CLI version is available.

Quick start with CLI app

Install Go

macOS

brew install go

Arch Linux

sudo pacman -S go

Download repository

git clone https://github.com/gbaranski/cryptogram # Clone this repo

Run directly

# Run with MDNS peer discovery, nickname will be $USER enviroment variable
go run main.go --mdns

# Run with MDNS peer discovery and custom nickname "Charlie"
go run main.go --mdns --nick Charlie 

# Run with DHT peer discovery with default bootstrap settings and custom nickname "Charlie"
go run main.go --dht --nick Charlie

Compile to single executable

# Compile packages and dependencies into single executable
go build
# Run with DHT peer discovery with default bootstrap settings and custom nickname "Charlie"
./cli -dht --nick Charlie

Configuration

Name	Description
`--nick <string>`	Sets nickname to identify yourself, by default `$USER` env var, fallbacks to generated one
`--dht`	Enables DHT Peer Discovery
`--mdns`	Enables MDNS Peer Discovery
`--insecure`	Disables security protocols, don't use that
`--debug`	Enabled debug mode, more logging
`--room <string>`	Sets the room name you join to at start. Default: `general`
`--mdnsinterval <seconds>`	Configures MDNS packet inerval, default: 900(15min)
`--rendezvousname <string>`	Sets unique string to identify group of nodes. Default: `cryptogram-rendezvous`

Commands

Name	Description
`/help`	Shows available commands
`/join <room-name>`	Join another room, leave the current one
`/topics`	Prints out all subscribed topics
`/free`	Removes messages and memory garbage
`/stats`	Prints out memory statistics
`/exit`	Exits the program

Peer discovery

Available methods of peer discovery

DHT Peer Discovery

Bootstraping nodes, also known as rendezvous host, used for discovery of new peers, by default it uses the following addresses

/dnsaddr/bootstrap.libp2p.io/p2p/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN
/dnsaddr/bootstrap.libp2p.io/p2p/QmQCU2EcMqAqQPR2i9bChDtGNJchTbq5TbXJJ16u19uLTa
/dnsaddr/bootstrap.libp2p.io/p2p/QmbLHAnMoJPWSCR5Zhtx6BHJX9KiKNN6tpvbUcqanj75Nb
/dnsaddr/bootstrap.libp2p.io/p2p/QmcZf59bWwK5XFi76CZX8cbJ4BhTzzA3gU1ZjYZcYW3dwt
/ip4/104.131.131.82/tcp/4001/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ # mars.i.ipfs.io

MDNS Peer discovery

Multicast DNS protocol resolves peers in local network, sends UDP packet every some time to announce ourselfs

onurzdg/cryptogram