# Running a PoB Prover Client

#### Prerequisites

Before you begin, ensure you have the following

* **Docker** (version 23.0.0 or above, refer: <https://docs.docker.com/desktop/install/linux-install/>)
* **Instance** comparable to a t2 micro (1 vcpu, 1GB RAM and 1GB harddisk),

## Running your Prover client

There are two aspects in setting up the prover,

* Registration: so the challengers are aware of it
* Running: so the challengers can engage with it

Here's how to get the provers successfully running&#x20;

### <mark style="color:red;">Key Points to consider before proceeding...</mark>

1. **Ports to be opened if using public IP:**&#x20;

```
Incoming ports to be opened (TCP & UDP ):

11112
22223
33334
44445
55556

Outgoing ports: Allow all
```

## Setting up the Prover

You can provide the private key (for example, generated from Metamask) which will be used by the Witnesschain's PoB  Prover client.

{% hint style="success" %}
Use ECDSA Keypairs
{% endhint %}

1. Store the prover's private key in the file (Make sure you keep track of the file name and its location, as it would be refered later) <br>

   ```sh
   echo "YOUR_PROVER_PRIVATE_KEY" > my_prover_private.key
   ```

2. Prepare a configuration file `my_prover_config.json` with the following entries<br>

   ```
   {

   "// 1" : "----- Please change the values that has TODO -----",

   	"claims" : {

   		"uplink_bandwidth"	: 11.0,						"// 2" : "Required, uplink_bandwidth is in Mbps",
   		"downlink_bandwidth"	: 11.0,						"// 3" : "Required, downlink_bandwidth is in Mbps"
   	},

   	"projectName"		: "My-DEPIN-Project-Name",			"// 4" : "Required",

   	"walletPublicKey"	: {						"// 5" : "Required - The wallet addresses where your rewards go",
   		"ethereum"	: "0x630391b032F444cB40B3603b579064817f312353",	"// 6" : "TODO: Please change this to your wallet address"
   	},

   	"maxChallengesPerDay"	: 100,						"// 7" : "The MAX no. of challenges you wish to participate per day",

   "// 8" : "CAREFUL :Set below two values to true - ONLY if you have public IP, but due to some issue with ISP the code is unable to detect it",

   	"havePublicIPv4Address"	: false,
   	"havePublicIPv6Address"	: false,

   "// 9" : "CAREFUL : Set below two values to true - ONLY if you want to force to have private IP",

   	"havePrivateIPv4Address": false,
   	"havePrivateIPv6Address": false,

   "// 10" : "Save the login, session, and challenge related data in a .sqlite file",

   	"saveResultsInDatabase" : false
   }
   ```

   \
   **Note:**

   1. The field `claims.uplink_bandwidth` and `claims.downlink_bandwidth`  are the claimed bandwidth supported by the prover (a.k.a. upload speeds and download speeds).
   2. [`projectName`](#user-content-fn-1)[^1] is the DePIN project with which the Prover is registered to provide infra services.
   3. `walletPublicKey.ethereum` is the wallet address which is used&#x20;
   4. `havePublicIPv4Address` (and `havePublicIPv6Address`) set them to **true** if you have a public IPv4 (or IPv6)&#x20;
   5. `havePrivateIPv4Address` (and `havePrivateIPv6Address`) set them to **true** if you want to force the use of private IP
   6. `saveResultsInDatabase` saves the login, session, and challenge related data in a .sqlite file within the container<br>

3. Once you have the `config.json` ready, the prover client can be started with<br>

   ```sh
   docker run -d \
     --network=host \
     --name pob-prover \
     -v ./my_prover_config.json:/app/dart/bin/pob/config/prover.json \
     -v ./my_prover_private.key:/root/.config/ethereum/private.key \
     witnesschain/pob-prover
   ```

   \
   If you are running a docker engine version < 21.0, you would want to give the full path to `my_prover_config.json` and  `my_prover_private.key`

**Explanation**:

* `docker run -d`: Runs the container in detached mode (in the background).
* ```
  --network=host
  Uses the host's network stack.
  ```
* ```
  --name pob-prover
  Names the container as 'pob-prover'.
  ```
* ```
  -v ./my_prover_config.json:/app/dart/bin/pob/config/prover.json 
  Mounts your local config file into the container at the specified path.
  ```
* ```
  -v ./my_prover_private.key:/root/.config/ethereum/provate.key 
  Mounts your local private key file folder into the container at the specified path.
  ```
* ```
  witnesschain/pob-prover: The name of the Docker image to run.
  ```

\
You can verify that the prover is running by looking at the container status<br>

```sh
docker ps 
```

{% hint style="info" %}
Now the prover is running successfully but not yet registered, you may find the logs stating the same. \
The prover will function as intended as soon as registration is done.
{% endhint %}

## Registering the Prover

You can register the prover easily with the help of our registration cli, to do so

1. Download our **dcl-operator-cli**<br>

   ```sh
   curl -sSfL https://witnesschain-com.github.io/install-dcl-cli | bash
   ```

   \
   Follow the steps as directed in the output of the script to add the CLI to the shell profile to be able to use the CLI from anywhere.<br>
2. Prepare the [config (prover registration config)](https://github.com/witnesschain-com/dcl-operator-cli/blob/main/dcl-operator/operator-prover-config.json.template), (The above command also downloads a template which you can refer to) make sure you set the `prover_private_keys` to the one you provided to the client (Setting the prover Step 2)
3. Run the following command for registration<br>

   ```
   dcl-operator-cli registerProver --config-file <path-to-prover-registration-config.json>
   ```

## Post Setup

Once the setting up and registration is successful, you can check the logs from the prover client ready for challenges. (`docker logs pob-prover`). Congratulations, you are now a part of our DePIN family!<br>

{% hint style="info" %}
We publish images (x86 & arm64) with the tag `latest` and by the git tag, the `latest` will always point to the new and up to date image. In order to pull the latest image, make sure you don't have an older release of latest to avoid using cached images.&#x20;

You can remove the older images by

```bash
docker rmi witnesschain/pob-prover
```

{% endhint %}

## Troubleshooting

As the only prerequisite is docker, make sure you are running atleast version 23.0.0 or above for the commands mentioned in the doc to work. \
\
The days might be rainy or snowy, but we've got umbrellas and sweaters!\
Join our [Discord](https://discord.gg/Y9Eu2U5s) or Telegram—we're happy to help. :D

[^1]: