Go implementation of Waku v2 protocol
Go to file
Richard Ramos ae423936ed
fix: remove bandwidth metrics that were commited to `master` by mistake
2024-10-01 18:24:47 -04:00
.github Update add-action-project.yml (#1210) 2024-08-30 13:54:50 -04:00
build chore: release (#255) 2022-06-19 17:50:37 -04:00
ci Revert "ci: use GIT_REF for building docker image when set (#1218)" 2024-09-11 12:53:26 +05:30
cmd/waku fix: check subscription when relay publish message (#1212) 2024-08-31 09:22:59 +08:00
coverage chore: automate cc-test-reporter install 2023-04-14 12:08:48 -04:00
docker Test: container image workflow (#792) 2023-10-05 08:34:36 +08:00
docs fix: replace references to old statusim.net domain 2024-07-31 13:31:16 +02:00
examples chore: bump go-libp2p and go-libp2p-pubsub (#1208) 2024-09-26 12:21:17 -04:00
hooks Chore/pre commit check to run go.mod for all examples (#647) 2023-08-16 17:56:57 +05:30
library feat: add clusterID and shards config to c-bindings (#1228) 2024-10-01 10:21:13 +05:30
libs fix: use https for cloning submodules instead of ssh (#780) 2023-09-30 13:57:49 -04:00
logging chore: use utc time in logs to avoid user location getting disclosed (#1192) 2024-08-14 06:17:00 +05:30
pkg chore: release (#255) 2022-06-19 17:50:37 -04:00
scripts/linux feat: v0.9.0 (#902) 2023-11-15 12:31:18 -04:00
tests chore: move filter manager from status-go to go-waku (#1177) 2024-08-06 13:10:56 +05:30
waku fix: remove bandwidth metrics that were commited to `master` by mistake 2024-10-01 18:24:47 -04:00
.codeclimate.yml chore(rln-relay): use the only key from keystore if only 1 exists 2023-09-08 12:05:32 -04:00
.dockerignore fix: dockerfile (#1105) 2024-05-21 14:28:37 -04:00
.gitignore feat: shard aware pruning of peer store (#1193) 2024-08-21 18:08:11 +05:30
.gitmodules fix: use https instead of ssh for submodules 2023-12-08 14:40:30 -04:00
.golangci.full.yaml feat: make RLN available by default 2023-09-14 09:03:18 -04:00
CHANGELOG.md Initial commit 2021-03-11 16:27:12 -04:00
Dockerfile chore: bump Go to 1.21 in Dockerfile (#1152) 2024-07-03 10:30:19 -04: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 fix: do not write tcp port 0 and remove 100 chars length limit for multiaddresses (#1129) 2024-06-20 12:50:15 +05:30
README.md chore: switch wakuv2 fleet to waku 2024-03-20 11:38:48 +01:00
VERSION feat: v0.9.0 (#902) 2023-11-15 12:31:18 -04:00
default.nix chore: bump go-libp2p and go-libp2p-pubsub (#1208) 2024-09-26 12:21:17 -04:00
flake.lock chore: upgrade to go1.21 (#1091) 2024-06-04 18:46:28 -04:00
flake.nix fix: remove duplicate buildPackage function from flake.nix 2024-08-20 09:53:25 +02:00
go.mod chore: bump go-libp2p and go-libp2p-pubsub (#1208) 2024-09-26 12:21:17 -04:00
go.sum chore: bump go-libp2p and go-libp2p-pubsub (#1208) 2024-09-26 12:21:17 -04:00

README.md

go-waku

A Go implementation of the Waku v2 protocol.


Install

Building from source

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

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

Nix

You can build Waku v2 node using Nix Flakes:

nix build github:waku-org/go-waku

Or build the library using:

nix build github:waku-org/go-waku#library

To start a shell with build dependencies use:

nix develop

Docker

docker run -i -t -p 60000:60000 -p 9000:9000/udp \
  wakuorg/go-waku:latest \ 
    --dns-discovery \
    --dns-discovery-url enrtree://AIRVQ5DDA4FFWLRBCHJWUWOO6X6S4ZTZ5B667LQ6AJU6PEYDLRD5O@sandbox.waku.nodes.status.im \
    --discv5-discovery

or use the image:tag of your choice.

or build and run the image with:

docker build -t wakuorg/go-waku:latest .

docker run wakuorg/go-waku:latest --help

Building on windows

Windows requires the following tools to be installed

Library

go get github.com/waku-org/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.