Running a PoL Watchtower
Steps to run a PoL Watchtower multi-client
The PoL Watchtower multi-client node is a DePIN watchtower node that participates in the PoL (Proof-of-Location) protocol and measures the location claims made by a DePIN Prover. It can also act as a Prover to prove it's own location claim when challenged.
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 5GB harddisk)
Running your Watchtower client
Key Points to consider before proceeding...
We have 2 sets of keys - Operator Key and Watchtower Key.
Operator Key is your EigenLayer Operator Key that you have been using with various AVSes including our Witness Chain AVS. Continue to use that here too. This key is used for registering the Watchtower Key(s).
Watchtower Key - This is the signing key for the PoL Watchtower Client. Create a new Key for the same. Don't reuse the Operator Key for the Watchtower Key. It has to be a ECDSA Key.
You are encouraged to setup as many unique watchtowers as you can support (ideally 1 per region of your infrastructure operating). All of the should be registered with the same operator key in the process described in this doc.
Ports to be opened if using public IP:
0. Creating the Watchtower Key
Use ECDSA Keypairs
Create a ECDSA private key using Metamask or other utilities that will be used as Watchtower Key.
Store the watchtower's private key in the file (Make sure you keep track of the file name and its location, as it would be refered later)
1. Registering the Watchtower Key
You can register the watchtower key easily with the help of our registration cli, to do so
Download our witness-cli
After the installation is completed, register your watchtower key on WitnessChain's Layer 2 Chain: Use the KeyPair that you would have exported or created (watchtower key).
Prepare the config (challenger registration config),
The above command also downloads a template which you can refer to.
Make sure you set the
challenger_private_keys
attribute in the json file with the key, that you provided inmy_watchtower_private.key
(watchtower private key)
Run the following command for challenger registration of watchtower
Prepare the config (prover registration config),
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 inmy_watchtower_private.key
(watchtower private key)
Run the following command for prover registration of watchtower
2. Setting up the watchtower
Prepare a environment file
watchtower.env
with the following entries as example shown below:
Explanation:
privateKey
is your PoL signing key (Watchtower Key)walletPublicKey
is the wallet addresses where your contributions go (Operator address)havePublicIPv4Address
(andhavePublicIPv6Address
) set them to true if you have a public IPv4 (or IPv6)havePrivateIPv4Address
(andhavePrivateIPv6Address
) set them to true if you want to force the use of private IPsaveResultsInDatabase
saves the login, session, and challenge related data in a .sqlite file within the containerprojectName
is the tagging mechanism to ensure we can identify our operators. It is a required field in the formateigenlayer-<your operator name>
We collect various telemetry data from your node, such as the logs etc. You can choose to opt-out by setting TELEMETRY=false
in the watchtower.env
file
Once you have the
config.json
ready, the challenger client can be started with
you can verify that the challenger is running by looking at the container status
Explanation:
docker run -d
: Runs the container in detached mode (in the background).
Post Setup
Once the setting up and registration is successful, you can check the logs from the watchtower client ready for challenges. (docker logs pol-watchtower
). Congratulations, you are now a part of our Watchtower family!
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 or Telegram—we're happy to help. :D
Last updated