Go implementation of Waku v2 protocol
Go to file
Richard Ramos a60213b14b chore: add `agent-string` flag 2022-10-27 11:28:37 -04:00
.github/workflows misc: add new issues and prs to Waku Product project board 2022-09-03 13:35:17 -04:00
build chore: release (#255) 2022-06-19 17:50:37 -04:00
ci ci: separate discord notification into a function 2022-10-19 09:50:27 +02:00
coverage fix: jenkinscript (#304) 2022-09-12 10:13:38 -04:00
dbutils refactor: use db for serving history queries (#243) 2022-05-30 14:48:22 -04:00
docs fix(rln): remove idcommitment and idkey 2022-10-21 11:42:18 -04:00
examples chore: remove rendezvous 2022-10-27 09:16:26 -04:00
hooks feat: add git hook 2021-10-18 14:43:48 +02:00
library feat: expose dns discovery thru c-bindings 2022-10-23 09:27:39 -04:00
logging chore: upgrade libp2p 2022-10-19 15:54:02 -04:00
mobile feat: expose dns discovery thru c-bindings 2022-10-23 09:27:39 -04:00
pkg chore: release (#255) 2022-06-19 17:50:37 -04:00
scripts/linux chore: release (#255) 2022-06-19 17:50:37 -04:00
tests chore: upgrade libp2p 2022-10-19 15:54:02 -04:00
waku chore: add `agent-string` flag 2022-10-27 11:28:37 -04:00
.dockerignore Dockerfile: add commit, log format, and make target (#83) 2021-10-15 12:47:23 +02:00
.gitignore feat: store credentials in a file 2022-08-15 14:40:10 -04:00
.gitmodules chore: use static rln lib and fix lint 2022-08-15 14:40:10 -04:00
.golangci.yaml feat: use generic flags and convert values to specific data types 2022-08-15 15:22:13 -04:00
CHANGELOG.md Initial commit 2021-03-11 16:27:12 -04:00
Dockerfile Dockerfile: update to GO 1.18, update Alpine 2022-10-26 15:31:14 +02:00
LICENSE-APACHEv2 Initial commit 2021-03-11 16:27:12 -04:00
LICENSE-MIT Initial commit 2021-03-11 16:27:12 -04:00
Makefile chore: use "nowatchdog" in ios to remove go-watchdog replacement 2022-10-23 09:31:32 -04:00
README.md chore: upgrade libp2p 2022-10-19 15:54:02 -04:00
VERSION v0.2.2 2022-09-15 15:16:52 -04:00
go.mod chore: remove rendezvous 2022-10-27 09:16:26 -04:00
go.sum chore: remove rendezvous 2022-10-27 09:16:26 -04:00
waku.go chore: add `agent-string` flag 2022-10-27 11:28:37 -04:00
waku_no_rln.go feat: make rln optional 2022-08-15 14:41:58 -04:00
waku_rln.go fix(rln): remove idcommitment and idkey 2022-10-21 11:42:18 -04:00

README.md

go-waku

A Go implementation of the Waku v2 protocol.

Total alerts

Install

Building from source

git clone https://github.com/status-im/go-waku
cd go-waku
make

# See the available command line options with
./build/waku --help

Docker

docker build -t go-waku:latest .

docker run go-waku:latest --help

Building on windows

Windows requires the following tools to be installed

Library

go get github.com/status-im/go-waku

C Bindings

make static-library
make dynamic-library

Mobile libraries

Requires gomobile

make mobile-android
make mobile-ios

Tutorials and documentation

Examples

Examples of usage of go-waku as a library can be found in the examples/ folder:

  • basic2 - demonstrates how to send and receive messages
  • chat2 - simple chat client using waku relay / lightpush + filter / store protocol to send/receive messages and retrieve message history
  • filter2 - demonstrates how to use filter protocol
  • c-bindings - simple program to demonstrate how to consume the go-waku library via C FFI
  • waku-csharp - C# console application that uses the go-waku library via FFI
  • android-kotlin - android app that uses a .jar generated by gomobile using kotlin

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:

To enable the git hooks:

git config core.hooksPath hooks

Bugs, Questions & Features

If you encounter any bug or would like to propose new features, feel free to open an issue.

For more general discussion, help and latest news, join #go-waku on Vac Discord or Telegram.

License

Licensed and distributed under either of

or

at your option. These files may not be copied, modified, or distributed except according to those terms.