How to run Nillion accuser

Follow along to learn how to install Nillion accuser on Ubuntu 24.04 LTS

Prerequisites

Before you start, you need to have Keplr wallet installed and funded with some testnet NIL tokens. You can grab the tokens from Nillion faucet: https://faucet.testnet.nillion.com/

You will also need an always-on PC or a VPS to run Nillion accuser. The specs don't matter much, you can grab any that fit your budget, just make sure to have enough SSD space. 50 GB is the minimum I would recommend. The instructions below will cover installation on Ubuntu 24.04 VPS.

Installing docker

Before we install docker, lets update our system:

sudo apt update && sudo apt upgrade -y

Then, paste the command below to install Docker.

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y && sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc && echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null && sudo apt update && sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Now let's check if the docker has been installed correctly:

sudo docker --version

Pull accuser image

docker pull nillion/retailtoken-accuser:v1.0.1

Follow steps 5, 6 and 7 from official docs

Here is the link: https://verifier.nillion.com/verifier

Clarifications on step 7

The command that runs the accuser starts the process in the foreground. To run the process in the background you can either add the -d flag or run the process inside screen/tmux session.

To start a new screen session run the following command:

screen -S accuser

Then you can run the accuser command from step 7 inside the screen session. Note that the --block-start updates automatically, so make sure to refresh the page before you copy and paste the command into your terminal.

When you check the logs and make sure the accuser works you can detach from the screen session by pressing the following key sequence Ctrl-a + Ctrl-d

To reattach to the screen session type screen -r

Backup accuser keys

cat nillion/accuser/credentials.json

Save the output to a secure location.

Checking accuser logs

docker logs -f <container ID> --tail=500

Use sudo docker ps to get a list of docker containers.

Accuser FAQ

How to check registration status?

Accuser has a summary function that displays registration status and the number of secrets:

docker run -v ./nillion/accuser:/var/tmp nillion/retailtoken-accuser:v1.0.1 summary

Alternatively, you can search through logs like this:

docker logs $(docker ps | grep nillion | awk '{print $1}') | grep Registered -A 2

How to find accuser registration block?

Search your wallet (Keplr) transactions on the explorer, there should be a Pay For transaction. That's the block at which you registered the accuser.

RPC list anyone?

https://nillion-testnet-rpc.polkachu.com

https://nillion-testnet.rpc.kjnodes.com

https://nillion-testnet.rpc.nodex.one

https://testnet-nillion-rpc.lavenderfive.com

Tackling disk usage

Docker logs (/var/lib/docker/containers) are the cause of high disk usage, to free some disk space we can do several things. First, lets remove all docker containers other than the one that is currently running. Do not run this command if you have other docker containers that are important to you.

docker rm $(docker ps --filter status=exited -q)

That is a quick fix that will immediately free some disk space, a proper fix is to put logs under control by setting max log size. Read here and here for instructions.

Nillion links

• Official docs - https://verifier.nillion.com/verifier

• Nillion explorer - https://testnet.nillion.explorers.guru/

• Nillion discord - https://discord.gg/nillionnetwork

Thanks for reading and enjoy accusing on the Nillion network,

Njokac