Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
June 19, 2022 17:50
November 10, 2023 13:54
June 19, 2022 17:50
November 15, 2023 12:31
March 11, 2021 16:27
October 17, 2023 09:00
March 11, 2021 16:27
March 11, 2021 16:27
November 20, 2023 08:51
November 15, 2023 12:31
October 17, 2023 09:00
September 18, 2023 11:20


A Go implementation of the Waku v2 protocol.


Building from source

git clone
cd go-waku

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


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 run -i -t -p 60000:60000 -p 9000:9000/udp \
  wakuorg/go-waku:latest \ 
    --dns-discovery \
    --dns-discovery-url enrtree:// \

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


go get

C Bindings

make static-library
make dynamic-library

Mobile libraries

Requires gomobile

make mobile-android
make mobile-ios

Tutorials and documentation


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


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.


Licensed and distributed under either of


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