# 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](https://docs.mawari.net/decentralized-infrastructure-offering-dio/how-to-get-a-wallet-how-to-set-up-metamask-web3-wallet-in-a-browser) 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.

<figure><img src="https://405131306-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoGiIfiFbtSPHFZ2OdQm9%2Fuploads%2F1iqjle9gn2Nyc8VFsEhz%2Fimage.png?alt=media&#x26;token=9e241075-6421-45cb-956a-35dd220ec20f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://405131306-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoGiIfiFbtSPHFZ2OdQm9%2Fuploads%2FGF07WxgSssgB9sMSrzdS%2Fimage.png?alt=media&#x26;token=a9d863c4-30c3-4181-b988-459c57f3b828" alt=""><figcaption></figcaption></figure>

* **b.3.** Then on Step1, go to the [https://hub.testnet.mawari.net](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.

{% hint style="info" %}
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).

$ZMAWARI is not the official $MAWARI token, it’s a test token used within our closed testnet and currently holds no real-world or monetary value
{% endhint %}

<figure><img src="https://405131306-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoGiIfiFbtSPHFZ2OdQm9%2Fuploads%2FrOI0QXTBelgv6KaNfZxD%2Fimage.png?alt=media&#x26;token=a23fffea-ad73-4e8b-bd0e-3f59f9a1933a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://405131306-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoGiIfiFbtSPHFZ2OdQm9%2Fuploads%2FpV5kii9HHAgvfp3RuLWn%2Fimage.png?alt=media&#x26;token=feefee80-b852-4fe2-9151-722d676670ed" alt=""><figcaption></figcaption></figure>

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/>&#x20;

**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

```sh
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.

```sh
export OWNER_ADDRESS=0x123abc
```

#### Windows

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

```sh
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

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

#### Windows

```sh
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:

```log
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:

```log
[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/>&#x20;

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

<figure><img src="https://405131306-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoGiIfiFbtSPHFZ2OdQm9%2Fuploads%2FRr1JKxWGRKMDUUS5WXWc%2Fimage.png?alt=media&#x26;token=fc704c3a-e831-4ef1-9677-6a9326f8dc39" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://405131306-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoGiIfiFbtSPHFZ2OdQm9%2Fuploads%2F5HvZyR0PE5Z8dn4fPlNZ%2Fimage.png?alt=media&#x26;token=987c25d0-96e4-435f-b0e1-0309666106b1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://405131306-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoGiIfiFbtSPHFZ2OdQm9%2Fuploads%2FJRMhHNDXTFDJGqXRAWtZ%2Fimage.png?alt=media&#x26;token=c76229bc-6f27-44c1-85a6-280f0267b2f7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://405131306-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoGiIfiFbtSPHFZ2OdQm9%2Fuploads%2Fie7f25fFA21JtxiQWAv6%2Fimage.png?alt=media&#x26;token=aab34e4e-245c-43e1-94a7-115b160e86ba" alt=""><figcaption></figcaption></figure>

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

```log
[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**.

<figure><img src="https://405131306-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoGiIfiFbtSPHFZ2OdQm9%2Fuploads%2Fc2MyWQgr0y75FHBBFMfC%2Fimage.png?alt=media&#x26;token=7dd7ec38-7860-43f4-aeab-6e4fe4491b81" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Important node: $ZMAWARI is not the official $MAWARI token, it’s a test token used within our closed testnet and currently holds no real-world or monetary value

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](https://forms.gle/kkNz1quSiEUPqkD27).

{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mawari.net/decentralized-infrastructure-offering-dio/operating-the-guardian-node-testnet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.