diff --git a/.gitignore b/.gitignore index 79b5594..87d7420 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,4 @@ **/.DS_Store +keystore +postgresql +rln_tree \ No newline at end of file diff --git a/README.md b/README.md index 401f6df..e713e72 100644 --- a/README.md +++ b/README.md @@ -1,38 +1,67 @@ # nwaku-compose -Ready to use docker-compose to run your own [nwaku](https://github.com/waku-org/nwaku) full node. Description: +Ready to use docker-compose to run your own [nwaku](https://github.com/waku-org/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` and `git`. -**1. Get the code:** -```console -git clone git@github.com:waku-org/nwaku-compose.git -cd nwaku-compose + +**📝 0. Prerequisites** + +You need: +* Ethereum Sepolia ws endpoint. Get one free from [Infura](https://www.infura.io/). +* Ethereum Sepolia account with some balance <0.01 Eth. Get some [here](https://www.infura.io/faucet/sepolia). +* A password to protect your rln membership. + +``` +export ETH_CLIENT_ADDRESS=wss://sepolia.infura.io/ws/v3/YOUR_INFURA_KEY +export ETH_TESTNET_KEY=REPLACE_BY_YOUR_KEY +export KEYSTORE_PASSWORD=PICK_A_PASSWORD ``` -**2. Provide your Ethereum node** -Waku needs an Ethereum Sepolia node, either yours or from a third party. Provide a websockets endpoint. You can get one for free from [Infura](https://www.infura.io/). +**🔑 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. This command will register it and store in `keystore/keystore.json`. Note that if you just want to relay traffic (not publish), you don't need one. + ``` -export ETH_CLIENT_ADDRESS=wss://sepolia.infura.io/ws/v3/USE_YOUR_INFURA_KEY_HERE +./register_rln.sh ``` -**3. Start everything** +**🖥️ 2. Start everything** + +Start all processes. Your RLN membership is loaded into nwaku under the hood. ```console docker-compose up -d ``` -**4. Register your RLN membership** -If you just want to relay traffic in the network, you are all set. But if you want to publish messages, you need an RLN membership. Its a simple onchain transaction, you need: -* A wallet with some Sepolia Eth, <0.1 Eth. -* Go to [localhost:4000](http://localhost:4000) and `Register Credentials`. Set a `password` and `Export` it as `keystore.json` -* In your nwaku node, set. TODO: Improve manual process. - * `rln-relay-cred-password` to the `password` you chose. - * `rln-relay-cred-path` to `keystore.json` +**🏄🏼‍♂️ 3. Interact with your nwaku node** +* See [localhost:3000](http://localhost:3000) for node metrics. +* See [localhost:4000](http://localhost:4000). Under development 🚧 -**5. Interact with your nwaku node** -* See [localhost:4000](http://localhost:4000) to interact with your node -* See [localhost:3000](http://localhost:3000) for advanced metrics. +**📬 4. Use the REST API** + +Your nwaku node exposes a [REST API](https://waku-org.github.io/waku-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 +``` + +You can publish a message to a `contentTopic` that everyone subscribed to it will receive. 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":"XaaabsQ==","contentTopic":"/my-app/2/chatroom-1/proto"}' +``` + +You can fetch all messages sent in that topic. +``` +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](https://github.com/waku-org/nwaku-compose/blob/master/ADVANCED.md). \ No newline at end of file diff --git a/docker-compose.yml b/docker-compose.yml index a5eecea..2584da8 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -31,23 +31,6 @@ x-pg-exporter-env: &pg_exp_env # Services definitions services: nwaku: - # Provide the image using any of these methods - - # Method 1. Custom build - # For a custom build, requires building your image - # from nwaku repo: docker build -t nwaku:mytag . - #image: nwaku:mytag - - # Method 2. Pre-built image (master commit) - # For a pre-built image, use the firt 8 digits of the commit hash - # all commits in nwaku master al built and pushed to dockerhub - # See: hub.docker.com/r/statusteam/nim-waku - #image: statusteam/nim-waku:982cd282 - - # Method 3. Pre-built release - # For a pre-built release. See available releases: - # github.com/waku-org/nwaku/releases - image: ${NWAKU_IMAGE:-wakuorg/nwaku:v0.21.2-rc.0} restart: on-failure ports: @@ -73,7 +56,7 @@ services: - ./run_node.sh:/opt/run_node.sh:Z - ./certs:/etc/letsencrypt/:Z - ./rln_tree:/etc/rln_tree/:Z - - ./keystore.json:/keystore.json/:Z + - ./keystore/keystore.json:/keystore/keystore.json/:Z entrypoint: sh command: - /opt/run_node.sh diff --git a/register_rln.sh b/register_rln.sh new file mode 100755 index 0000000..7750a21 --- /dev/null +++ b/register_rln.sh @@ -0,0 +1,17 @@ +#!/bin/sh + +if test -f ./keystore/keystore.json; then + echo "keystore/keystore.json alredy exists. Use it instead of creating a new one." + echo "Exiting" + exit 1 +fi + +# TODO: Set nwaku release when ready instead of quay + +docker run -v ./keystore:/keystore/:Z quay.io/wakuorg/nwaku-pr:2189 generateRlnKeystore \ +--rln-relay-eth-client-address=$ETH_CLIENT_ADDRESS \ +--rln-relay-eth-private-key=$ETH_TESTNET_KEY \ +--rln-relay-eth-contract-address=0xF471d71E9b1455bBF4b85d475afb9BB0954A29c4 \ +--rln-relay-cred-path=/keystore/keystore.json \ +--rln-relay-cred-password=$KEYSTORE_PASSWORD \ +--execute \ No newline at end of file diff --git a/run_node.sh b/run_node.sh index 948f3ee..40fd77c 100644 --- a/run_node.sh +++ b/run_node.sh @@ -96,7 +96,7 @@ exec /usr/bin/wakunode\ --rln-relay-eth-client-address="${ETH_CLIENT_ADDRESS}"\ --rln-relay-tree-path="/etc/rln_tree"\ --rln-relay-cred-password="password"\ - --rln-relay-cred-path="keystore.json"\ + --rln-relay-cred-path="/keystore/keystore.json"\ ${RLN_RELAY_CRED_PATH}\ ${RLN_RELAY_CRED_PASSWORD}\ ${DNS_WSS_CMD}\