Page cover

Mawari Network TestNet - Setting up and running the Guardian Node application

1. Setting up Wallet, Tokens and Guardian NFT

a. Don’t have a wallet yet? Check out this detailed guide to set up.

b. After creating your testing wallet, go to the Mawari Network TestNet (https://testnet.mawari.net/) page to:

  • b.1. Connect your wallet at the top of the screen and switch to Mawari Network TestNet. This will enable the following steps.

  • b.2. Copy your wallet address by clicking on the button at the top right:

  • b.3. Then on Step1, go to the https://hub.testnet.mawari.net to fund your wallet with testing MAWARI tokens. Paste your wallet address to the Faucet field and Request the token.

Note: You can request up to 2 tokens on the testnet. Start by adding them to the main wallet you created in the previous step. Later, you’ll need to transfer 1 token from the main wallet to the burner wallet(also know as operator wallet).

b.4. Now, go back to the Mawari Network TestNet (https://testnet.mawari.net) to mint up to 3 testing Guardian NFTs:

These steps will prepare your account for setting up and running the Guardian client node.

2. Setting up the Guardian Node client application

a. First make sure you have Docker installed in your computer, otherwise, follow this guide to setup: https://docs.docker.com/engine/install/

b. Once Docker is installed, open the Console/Terminal app on MacOS/Linux or PowerShell on Windows, for you to be able to run the commands to prepare to run the Guardian Node client as a container application.

c. Set up environment variables on your Operating system:

Linux and MacOS

# set your node image name

export MNTESTNET_IMAGE=us-east4-docker.pkg.dev/mawarinetwork-dev/mwr-net-d-car-uses4-public-docker-registry-e62e/mawari-node:latest

# set your owner wallet address from which Guardian NFTs will be delegated. This is the wallet address you created at the beginning of this guide.

export OWNER_ADDRESS=0x123abc

Windows

set "MNTESTNET_IMAGE=us-east4-docker.pkg.dev/mawarinetwork-dev/mwr-net-d-car-uses4-public-docker-registry-e62e/mawari-node:latest"
set "OWNER_ADDRESS=0x123abc"

d. To run the client, copy and execute this command below to create a folder and initiate the docker container:

Linux and Mac

mkdir -p ~/mawari && docker run --pull always -v ~/mawari:/app/cache  -e OWNERS_ALLOWLIST=$OWNER_ADDRESS $MNTESTNET_IMAGE

Windows

mkdir %USERPROFILE%\\mawari 2>nul & docker run --pull always -v %USERPROFILE%\\mawari:/app/cache -e OWNERS_ALLOWLIST=%OWNER_ADDRESS% %MNTESTNET_IMAGE%

You'll see logs like following:

2025-09-09T13:54:16.086Z	[INFO]	loaded config	{"config": {"network": "ethereum", "heartbeatPeriodSeconds": 43200, "checkJobsPeriodSeconds": 10, "ownersAllowList": ["0xF9c7082CA8a6A882859f16661701c1ad65d12812"], "checkDelegationOfferPeriodSeconds": 10, "disableHeartbeats": false, "disableAutomaticDelegations": false, "eth.rpcNodes": ["<https://mawari-network-testnet.rpc.caldera.xyz/http>"], "eth.privateKey": "...", "eth.chainId": 629274, "eth.registry": "0xB33d2D2a2c84b3a1DEf601608a1F019213a02774", "eth.paginationChunkSize": 100, "eth.gasLimit": 6000000}}
2025-09-09T13:54:16.086Z	[DEBUG]	initializing node ...
2025-09-09T13:54:16.088Z	[DEBUG]	generating burner wallet
2025-09-09T13:54:16.090Z	[DEBUG]	node cache does not exit, initializing empty node cache
2025-09-09T13:54:16.098Z	[DEBUG]	burner wallet cache written	{"file": "/app/cache/flohive-cache.json"}
2025-09-09T13:54:16.098Z	[DEBUG]	generated burner wallet	{"address": "<your burner wallet appears here>"}
2025-09-09T13:54:16.102Z	[INFO]	Using burner wallet	{"address": "<your burner wallet appears here>"}
2025-09-09T13:54:16.106Z	[DEBUG]	loaded plugin	{"path": "plugins/signature-scan-demo.so", "supported types": ["signature-scan-demo"]}
2025-09-09T13:54:17.403Z	[DEBUG]	using delegation hub	{"address": "0x3F1BD1Abc350eD6313Ff7Eaab561DCAbbcc61071"}
2025-09-09T13:54:17.404Z	[DEBUG]	starting delegations offer check
2025-09-09T13:54:17.683Z	[DEBUG]	received delegation offers count	{"delegation offers": "0"}
2025-09-09T13:54:17.683Z	[DEBUG]	received delegation offers	{"delegation offers": 0}
2025-09-09T13:54:17.683Z	[DEBUG]	successfully checked delegation offers
2025-09-09T13:54:17.683Z	[DEBUG]	starting heartbeats
2025-09-09T13:54:18.300Z	[DEBUG]	sending heartbeat	{"tokenIds": []}
2025-09-09T13:54:18.300Z	[WARN]	no delegations, skipping heartbeat

e. Find your burner/operator wallet and add tokens to prepare for delegation.

  • If you requested 2 tokens earlier, send 1 token from your main wallet (the one you created at the beginning of this guide) to your burner wallet.

  • If you requested only 1 token earlier, go back to the Mawari chain Hub at https://hub.testnet.mawari.net/ and request an additional token directly for your burner wallet address.

To get the burner wallet address, check your node logs for the following output:

[INFO]  Using burner wallet {"address": "<your burner wallet appears here>"}

3. Activating the Guardian Node Client

a. To activate your Guardian Node, you must delegate it to the burner/operator wallet address of your machine (the address you retrieved in the previous step). To proceed, open the Mawari Guardian Dashboard at https://app.testnet.mawari.net/

b. Connect your testing wallet created for this setup at the beginning of the guide:

c. Select all the IDs, and click on “Delegate”, enter your burner/operator wallet address in the field, and confirm by clicking “Delegate” again.

d. Make sure you sign the transaction on your Wallet, so the delegation can effectively be initiated on-chain.

e. Check the output of your node client. If you see messages in the expected format, it means your delegations have been successfully detected.

[DEBUG]	received delegation offers count	{"delegation offers": "1"}
[DEBUG]	received delegations offers from eth	{"length": 1}
[DEBUG]	received delegation offers	{"delegation offers": 1}
[DEBUG]	accepting delegation offer	{"hash": "cf9cede70c3934d7952af1e94d8ca631aff3528375cd94765abb66e11f8f1de9"}
[DEBUG]	received unfinished jobs count	{"delegations": "0"}
[DEBUG]	received unfinished jobs	{"jobs": 0}
[DEBUG]	transaction submitted	{"hash": "0x7f396478018f2b1e56cc2d0ea456ec15e6462936161fa2dcbf89bbb30d7c63b2"}
[INFO]	delegation offer accepted	{"hash": "cf9cede70c3934d7952af1e94d8ca631aff3528375cd94765abb66e11f8f1de9"}

f. You can also confirm node status in the Guardian Dashboard. Open the Guardian Dashboard and make sure your node is displayed as running.

If you run into any issues or would like to share feedback about setting up the Guardian client on TestNet, please let us know by filling out this form.

Last updated

Was this helpful?