go-waku/README.md

110 lines
4.4 KiB
Markdown
Raw Normal View History

# go-waku
2021-04-13 18:52:02 +00:00
A Go implementation of the [Waku v2 protocol](https://specs.vac.dev/specs/waku/v2/waku-v2).
2021-10-09 18:18:53 +00:00
<p align="left">
<a href="https://goreportcard.com/report/github.com/status-im/go-waku"><img src="https://goreportcard.com/badge/github.com/status-im/go-waku" /></a>
<a href="https://godoc.org/github.com/status-im/go-waku"><img src="http://img.shields.io/badge/godoc-reference-5272B4.svg?style=flat-square" /></a>
2022-10-19 19:39:32 +00:00
<a href=""><img src="https://img.shields.io/badge/golang-%3E%3D1.18.0-orange.svg?style=flat-square" /></a>
2021-11-02 00:55:41 +00:00
<a href="https://lgtm.com/projects/g/status-im/go-waku/alerts/"><img alt="Total alerts" src="https://img.shields.io/lgtm/alerts/g/status-im/go-waku.svg?logo=lgtm&logoWidth=18"/></a>
<a href="https://codeclimate.com/github/status-im/go-waku/maintainability"><img src="https://api.codeclimate.com/v1/badges/25b76a20113236b175d8/maintainability" /></a>
2021-10-09 18:18:53 +00:00
<br>
</p>
## Install
2021-10-11 15:46:35 +00:00
#### Building from source
2021-10-09 18:18:53 +00:00
```
git clone https://github.com/status-im/go-waku
cd go-waku
make
2021-10-11 15:46:35 +00:00
# See the available command line options with
./build/waku --help
2021-10-09 18:18:53 +00:00
```
2021-10-11 15:46:35 +00:00
#### Docker
2021-10-09 18:18:53 +00:00
```
2021-10-11 15:46:35 +00:00
docker build -t go-waku:latest .
docker run go-waku:latest --help
2021-10-09 18:18:53 +00:00
```
2022-03-23 18:40:54 +00:00
#### Building on windows
Windows requires the following tools to be installed
- git bash (which is installed as part of [Git](https://git-scm.com/downloads))
- [chocolatey](https://chocolatey.org/install)
- [make](https://community.chocolatey.org/packages/make)
- [mingw](https://community.chocolatey.org/packages/mingw)
- [go](https://go.dev/doc/install)
2021-10-09 18:18:53 +00:00
## Library
```
go get github.com/status-im/go-waku
```
2022-03-21 23:15:53 +00:00
## C Bindings
```
make static-library
make dynamic-library
```
## Mobile libraries
Requires [`gomobile`](https://pkg.go.dev/golang.org/x/mobile/cmd/gomobile)
```
make mobile-android
make mobile-ios
```
2022-05-04 21:08:24 +00:00
## Tutorials and documentation
2022-09-06 22:18:19 +00:00
- [Receive and send messages using Waku Relay](docs/api/relay.md)
- [Send messages using Waku Lightpush](docs/api/lightpush.md)
- [Encrypting and decrypting Waku Messages](docs/api/encoding.md)
- [Retrieve message history using Waku Store](docs/api/store.md)
2022-05-04 21:08:24 +00:00
- [C Bindings](library/README.md)
2021-10-09 18:18:53 +00:00
## Examples
2022-05-04 21:08:24 +00:00
Examples of usage of go-waku as a library can be found in the `examples/` folder:
- [**basic2**](tree/master/examples/basic2) - demonstrates how to send and receive messages
- [**chat2**](tree/master/examples/chat2) - simple chat client using waku relay / lightpush + filter / store protocol to send/receive messages and retrieve message history
- [**filter2**](tree/master/examples/filter2) - demonstrates how to use filter protocol
- [**c-bindings**](tree/master/examples/c-bindings) - simple program to demonstrate how to consume the go-waku library via C FFI
- [**waku-csharp**](tree/master/examples/csharp) - C# console application that uses the go-waku library via FFI
- [**android-kotlin**](tree/master/examples/android-kotlin) - android app that uses a .jar generated by gomobile using kotlin
2021-08-25 20:16:14 +00:00
2021-04-13 18:52:02 +00:00
## Contribution
Thank you for considering to help out with the source code! We welcome contributions from anyone on the internet, and are grateful for even the smallest of fixes!
If you'd like to contribute to go-waku, please fork, fix, commit and send a pull request. If you wish to submit more complex changes though, please check up with the core devs first to ensure those changes are in line with the general philosophy of the project and/or get some early feedback which can make both your efforts much lighter as well as our review and merge procedures quick and simple.
To build and test this repository, you need:
2022-10-19 19:39:32 +00:00
- [Go](https://golang.org/) (version 1.17 or later)
2021-04-13 18:52:02 +00:00
- [protoc](https://grpc.io/docs/protoc-installation/)
- [Protocol Buffers for Go with Gadgets](https://github.com/gogo/protobuf)
2021-10-18 10:13:39 +00:00
To enable the git hooks:
```bash
git config core.hooksPath hooks
```
2021-10-09 18:18:53 +00:00
2022-03-23 18:40:54 +00:00
## Bugs, Questions & Features
If you encounter any bug or would like to propose new features, feel free to [open an issue](https://github.com/status-im/go-waku/issues/new/).
For more general discussion, help and latest news, join **#go-waku** on [Vac Discord](https://discord.com/channels/864066763682218004/865466710924460034) or [Telegram](https://t.me/vacp2p).
2021-04-13 18:52:02 +00:00
## License
Licensed and distributed under either of
* MIT license: [LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT
or
* Apache License, Version 2.0, ([LICENSE-APACHEv2](LICENSE-APACHEv2) or http://www.apache.org/licenses/LICENSE-2.0)
at your option. These files may not be copied, modified, or distributed except according to those terms.