828a9838ac | ||
---|---|---|
monitoring | ||
postgres_cfg | ||
.env.example | ||
.gitignore | ||
ADVANCED.md | ||
FAQ.md | ||
Makefile | ||
README.md | ||
chkhealth.sh | ||
docker-compose.yml | ||
interactive-cli.sh | ||
register_rln.sh | ||
run_node.sh | ||
set_storage_retention.sh | ||
setup_wizard.sh |
README.md
nwaku-compose
Ready to use docker-compose to run your own nwaku full node:
- nwaku node running relay and store protocols with RLN enabled.
- Simple frontend to interact with your node and the network, to publish and receive messages.
- Grafana dashboard for advanced users or node operators.
- Requires
docker-compose
andgit
.
Running Your nwaku Node
There are two ways to run your nwaku node:
- Interactive CLI: This method provides a user-friendly, guided setup process.
- Manual Setup: This method involves manually configuring and running the node using provided scripts and configuration files.
1. Interactive CLI
The Interactive CLI guides you through the setup process step-by-step, making it easier to configure and run your nwaku node without needing to manually edit configuration files.
To start the Interactive CLI, run the following command:
make run
2. Manual Setup and Run
📝 0. Prerequisites
You need:
- Ethereum Sepolia HTTP endpoint. Get one free from Infura.
- Ethereum Sepolia account with some balance <0.01 Eth. Get some here.
- A password to protect your rln membership.
docker-compose
will read the ./.env
file from the filesystem. There is .env.example
available for you as a template to use for providing the above values. The process when working with .env
files is to copy the .env.example
, store it as .env
and edit the values there.
cp .env.example .env
${EDITOR} .env
Make sure to NOT place any secrets into .env.example
, as they might be unintentionally published in the Git repository.
EXPERIMENTAL - Use wizard script
Run the wizard script. Once the script is done, the node will be started for you, so there is nothing else to do.
The script is experimental, feedback and pull requests are welcome.
./setup_wizard.sh
🔑 1. Register RLN membership
The RLN membership is your access key to The Waku Network. Its registration is done onchain, and allows your nwaku node to publish messages in a decentralized and private way, respecting some rate limits. Messages exceeding the rate limit won't be relayed by other peers.
This command will register your membership and store it in keystore/keystore.json
.
Note that if you just want to relay traffic (not publish), you don't need one.
./register_rln.sh
💽 2. Select storage size
Waku runs a PostgreSQL Database to store messages from the network and serve them to other peers. To prevent the database to grow indefinitely, you need to select how much disk space to allocate. You can either run a script that will estimate and set a good value:
./set_storage_retention.sh
Or select your own value. For example, 50GB
:
echo "STORAGE_SIZE=50GB" >> .env
🖥️ 3. Start your node
Start all processes: nwaku node, database and grafana for metrics. Your RLN membership is loaded into nwaku under the hood.
docker-compose up -d
⚠️ The node might take a few minutes the very first time it runs because it needs to build locally the RLN community membership tree.
###🏄🏼♂️ 4. Interact with your nwaku node
- See localhost:3000 for node metrics.
- See localhost:4000 for a nice frontend to chat with other users.
📬 4. Use the REST API
Your nwaku node exposes a REST API to interact with it.
# get nwaku version
curl http://127.0.0.1:8645/debug/v1/version
# get nwaku info
curl http://127.0.0.1:8645/debug/v1/info
Publish a message to a contentTopic
. Everyone subscribed to it will receive it. Note that payload
is base64 encoded.
curl -X POST "http://127.0.0.1:8645/relay/v1/auto/messages" \
-H "content-type: application/json" \
-d '{"payload":"'$(echo -n "Hello Waku Network - from Anonymous User" | base64)'","contentTopic":"/my-app/2/chatroom-1/proto"}'
Get messages sent to a contentTopic
. Note that any store node in the network is used to reply.
curl -X GET "http://127.0.0.1:8645/store/v1/messages?contentTopics=%2Fmy-app%2F2%2Fchatroom-1%2Fproto&pageSize=50&ascending=true" \
-H "accept: application/json"
For advanced documentation, refer to ADVANCED.md.
How to update to latest version
We regularly announce new available versions in our Discord server.
From v0.29
or older
You will need to delete both the keystore
and rln_tree
folders, and register your membership again before using the new version by running the following commands:
cd nwaku-compose
( go into the root's repository folder )docker-compose down
sudo rm -r keystore rln_tree
git pull origin master
./register_rln.sh
docker-compose up -d
From v0.30
or newer
Updating the node is as simple as running the following:
cd nwaku-compose
( go into the root's repository folder )docker-compose down
git pull origin master
docker-compose up -d
Set size
To improve storage on the network, you can increase the allocated space for the database. To do so, you can simply run:
./set_storage_retention.sh
Check
Once done, check your node is healthy:
./chkhealth.sh
All good:
02:15:51 - node health status is:
{
"nodeHealth": "Ready",
"protocolsHealth": [
{
"Rln Relay": "Ready"
}
]
}
If the ./chkhealth.sh
script is hanging or returns the following, wait a few minutes and run it again:
02:17:57 - node health status is:
{
"nodeHealth": "Initializing",
"protocolsHealth": []
}
Clean-up
Docker artefact can take some precious disk space, run the following commands to free space while your node is running.
Only do this if this machine is solely used for Waku and you have no other docker services.
I repeat, this will clean other docker services and images not running, only do this if this machine is only used for Waku.
# Be sure that your containers **are running**
sudo docker-compose up -d
# Clean docker system files
sudo docker system prune -a
# Delete docker images
sudo docker image prune -a
# Delete docker containers
sudo docker container prune
# Delete docker volumes
sudo docker volume prune