Awesome
<p align="center"> <img src="images/go-peer_logo.png" alt="go-peer_logo.png"/> </p> <h2> <p align="center"> <strong> Anonymity and Security without compromise </strong> </p> <p align="center"> <a href="https://github.com/topics/golang"> <img src="https://img.shields.io/github/go-mod/go-version/number571/go-peer" alt="Go" /> </a> <a href="https://github.com/number571/go-peer/releases"> <img src="https://img.shields.io/github/v/release/number571/go-peer.svg" alt="Release" /> </a> <a href="https://github.com/number571/go-peer/blob/master/LICENSE"> <img src="https://img.shields.io/github/license/number571/go-peer.svg" alt="License" /> </a> <a href="https://github.com/number571/go-peer/actions"> <img src="https://github.com/number571/go-peer/actions/workflows/build.yml/badge.svg" alt="Build" /> </a> <a href="https://github.com/number571/go-peer/blob/ee4b08c309d6966bd31621ceb7b0826708ca5dfb/Makefile#L55"> <img src="test/result/badge_coverage.svg" alt="Coverage" /> </a> <a href="https://godoc.org/github.com/number571/go-peer"> <img src="https://godoc.org/github.com/number571/go-peer?status.svg" alt="GoDoc" /> </a> <a href="https://github.com/avelino/awesome-go"> <img src="https://awesome.re/mentioned-badge.svg" alt="Awesome" /> </a> </p> <p align="center"> <a href="https://goreportcard.com/report/github.com/number571/go-peer"> <img src="https://goreportcard.com/badge/github.com/number571/go-peer" alt="GoReportCard" /> </a> <a href="https://github.com/number571/go-peer/pulse"> <img src="https://img.shields.io/github/commit-activity/m/number571/go-peer" alt="Activity" /> </a> <a href="https://github.com/number571/go-peer/commits/master"> <img src="https://img.shields.io/github/last-commit/number571/go-peer.svg" alt="Commits" /> </a> <a href="https://github.com/number571/go-peer/blob/ee4b08c309d6966bd31621ceb7b0826708ca5dfb/Makefile#L55"> <img src="test/result/badge_codelines.svg" alt="Code Lines" /> </a> <a href="https://img.shields.io/github/languages/code-size/number571/go-peer.svg"> <img src="https://img.shields.io/github/languages/code-size/number571/go-peer.svg" alt="CodeSize" /> </a> <a href="https://img.shields.io/github/downloads/number571/go-peer/total.svg"> <img src="https://img.shields.io/github/downloads/number571/go-peer/total.svg" alt="Downloads" /> </a> </p> <p align="center"> <a href="https://vk.me/join/6Px6b0Qh/uZIK4ixUYWQm4Krepzq5xbYjYw="> <img src="https://img.shields.io/badge/вконтакте-%232E87FB.svg?&style=for-the-badge&logo=vk&logoColor=white" alt="VKontakte" /> </a> </p> About project </h2>The go-peer
library contains a large number of functions necessary to ensure the security of transmitted or stored information, as well as for the anonymity of nodes in the decentralized form. The library can be divided into several main pkg
modules:
- The
crypto
module represents cryptographic primitives: 1) asymmetric encryption, decryption; 2) asymmetric signing and signature verification; 3) symmetric encryption and decryption; 4) hashing; 5) key building; 6) computational problems (puzzles); 7) cryptographically stable pseudorandom number generator. - The
client
module for encrypting and decrypting information with the attached data integrity (hash) and authentication (signature). It is a basic part of thenetwork/anonymity
module. - The
network
module is a decentralized communication between network nodes. Allows you to delimit networks and give information a random appearance using the network key. - The
network/anonymity
module to ensure anonymity based on the fifth^ stage. Presents the main functions for working with the network on top of thenetwork
andnetwork/anonymity/queue
modules. - The
network/anonymity/queue
module represents the generation, storage and issuance of encrypted messages every time the period specified by the application is reached. Uses theclient
,client/message
andnetwork/message
modules.
Examples of works in the directories pkg/client/examples, pkg/network/examples, pkg/network/anonymity/examples, pkg/network/anonymity/queue/examples;
Coverage map
<p align="center"><img src="test/result/coverage.svg" alt="coverage.svg"/></p>Installation
$ go get github.com/number571/go-peer
Requirements
- Go version
>= 1.23
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/go-peer/releases.
Dependencies
- Go library go.etcd.io/bbolt (used by
pkg/storage/database
) - Go library golang.org/x/crypto (used by
pkg/crypto/keybuilder
) - Go library gopkg.in/yaml.v2 (used by
pkg/encoding
) - Go library github.com/cloudflare/circl (used by
pkg/crypto/asymmetric
)
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:
- golangci-lint github.com/golangci/golangci-lint/cmd/golangci-lintv1.60.0
- go-cover-treemap github.com/nikolaydubina/go-cover-treemap@v1.4.2
Theoretical works
- Theory of the structure of hidden systems
- Monolithic cryptographic protocol
- Abstract anonymous networks
- Decentralized key exchange protocol
Also, the composition of these works can be found in the book The general theory of anonymous communications
(Ridero). This book can be purchased in a tangible form on the Ozon and Wildberries marketplaces. You can download the book in digital form for free here.
How can you help the project
- Find bugs, vulnerabilities, and errors in the code
- Suggest improvements, ask questions, create issues
- Append new theoretical works or update current
- Create new secure / anonymity applications
- Popularize technology and applications
Library based applications
- Anonymous network «Hidden Lake»
- Console messenger «secpy-chat» based on Hidden Lake services
HLT
,HLE
- Generator of asymmetric keys «tkeygen» in
PrivKey{hex}
,PubKey{hex}
format - Serverless and stateless password manager «tpmanager»
Star History
License
Licensed under the MIT License. See LICENSE for the full license text.