hidden-lake

README

Theoretically Provable Anonymous Network

About project

[!IMPORTANT] The project is being actively developed, the implementation of some details may change over time. More information about the changes can be obtained from the CHANGELOG.md file.

The Hidden Lake is an anonymous network built on a micro-service architecture. At the heart of HL is the core - HLS (service), which generates anonymizing traffic and combines many other services (for example, HLF and HLM). Thus, Hidden Lake is not a whole and monolithic solution, but a composition of several combined services. The HL is a friend-to-friend (F2F) network, which means building trusted communications. Due to this approach, members of the HL network can avoid spam in their direction, as well as possible attacks if vulnerabilities are found in the code.

Coverage map

Releases

All cmd programs are compiled for {amd64, arm64} ARCH and {windows, linux, darwin} OS as pattern = appname_arch_os. In total, one application is compiled into six versions. The entire list of releases can be found here: github.com/number571/hidden-lake/releases.

Dependencies

1. Go library github.com/number571/go-peer (used by cmd/hls,cmd/hle)
2. Go library golang.org/x/net (used by cmd/hlm)
3. CSS/JS library getbootstrap.com (used by cmd/hlm,cmd/hlf)

Makefile

There are a number of dependencies that represent separate applications for providing additional information about the quality of the code. These applications are not entered into the project, but are loaded via the make install-deps command. The list of applications is as follows:

1. golangci-lint github.com/golangci/golangci-lint/cmd/golangci-lintv1.60.0
2. go-cover-treemap github.com/nikolaydubina/go-cover-treemap@v1.4.2

How it works

The Hidden Lake assigns the task of anonymity to the QB-problem (queue based).

Actions within the QB-problem

Figure QB-network with three nodes

Each message m is encrypted with the recipient's key k: c = Ek(m) Message c is sent during period = T to all network participants The period T of one participant is independent of the periods T1, T2, ..., Tn of other participants If there is no message for the period T, then a false message v is sent to the network without a recipient (with a random key r): c = Er(v) Each participant tries to decrypt the message they received from the network: m = Dk(c)

---------------------------------------------------------------- ----------------------------------------------------------------

More information about Hidden Lake and QB-problem in research paper: hidden_lake_anonymous_network.pdf

List of applications

1. Basic:
   • HLS - anonymizes traffic using the QB-problem
   • HLC - runs many HL services as one application
   • HLA - adapts HL traffic to external environments
2. Applied:
   • HLM - messenger with a web interface
   • HLF - file sharing with a web interface
   • HLR - executes remote access commands
3. Helpers:
   • HLT - retransmits and saves encrypted traffic
   • HLL - distributes the stored traffic between nodes
   • HLE - encrypts and decrypts messages

Build and run

Launching an anonymous network is primarily the launch of an anonymizing HLS service. There are two ways to run HLS: through source code, and through the release version.

1. Running from source code

$ go install github.com/number571/hidden-lake/cmd/hls@latest
$ hls

2. Running from release version

$ wget https://github.com/number571/hidden-lake/releases/latest/download/hls_amd64_linux
$ chmod +x hls_amd64_linux
$ ./hls_amd64_linux

Production

The HLS node is easily connected to the production environment. To do this, you just need to specify the network at startup. You can find them in the networks.yml file.

$ hls -network=oi4r9NW9Le7fKF9d

After such a launch, the hls.yml file will be created or overwritten (if it existed). The settings and connections fields will be substituted in it. When overwriting a file, only the above fields will be changed. The remaining fields of the friends, services, address, etc. type will not be overwritten.

Examples of running HL apps in a prod environment: echo_service, anon_messenger, anon_filesharer.

Star History

License

Licensed under the MIT License. See LICENSE for the full license text.

⬆ back to top