Rollback Blocks

This guide describes how to revert the Pharos node to a previous block height.

Step 1: Stop the Node

Docker:

cd /data/$WORKSPACE
docker compose down

Binary:

cd /data/$WORKSPACE
./ops stop

Step 2: Backup local_storage

mv /data/$WORKSPACE/data/local_storage /data/$WORKSPACE/data/local_storage.bak

Step 3: Revert Blocks

Revert to latest stable block:

cd /data/$WORKSPACE/bin
./pharos_cli revert -c ../pharos.conf -t stable

Revert to a specific block number:

cd /data/$WORKSPACE/bin
./pharos_cli revert -c ../pharos.conf -t stable -n 1234567

You will see an interactive confirmation prompt:

You are trying to revert stable block to 1234567, are you sure? [y/n]

Enter y to confirm.

Step 4: Start the Node

Docker:

cd /data/$WORKSPACE
docker compose up -d

Binary:

./ops start --config ./pharos.conf