Skip to main content
Version: v2.2.0

Fast Sync

What is Fast Sync?

The Fast Sync feature, introduced in HOPRd version 2.2.0, speeds up node synchronization by using HOPR logs database files. These files store logs from a previous sync performed via an RPC provider, allowing your node to read on-chain data efficiently. With Fast Sync, your node can complete synchronization in just 10 to 20 minutes, even without a local RPC provider. However, the exact duration may vary based on your hardware specifications.

Preparing for Fast Sync

(1) First, you must upgrade your node to the latest version. To update your node, follow this guide.

(2) You must fully synchronize your node from scratch. Once your node is fully synchronized, check if it is performing normally by following this guide.

(3) Make a backup of your fully synchronized node, select your platform:

(3.1) Find the database log files "hopr_logs.db", "hopr_logs.db-shm", and "hopr_logs.db-wal" at the path "/<computer username>/.hoprd-db-dufour/". Store these files for future use in a Fast Sync.

Enabling Fast Sync on your node

Please select platform to configure Fast Sync feature:

(1) Locate the database log files that you previously gathered from this guide.

(2) Ensure that you have stopped the HOPRd node Docker container. You can find more details here.

(3) On your machine, navigate to the ".hoprd-db-dufour" folder. Inside, locate the "db" folder and delete all files in it.

(4) Extract the recently downloaded file "hopr_logs.tar.gz". This will create an "app" folder. Navigate to the "hoprd-db" directory within it, then go to the "db" folder. Inside, you will find three database files: "hopr_logs.db", "hopr_logs.db-shm", and "hopr_logs.db-wal". Copy all three files into the destination "db" folder.

(5) Configure your node by creating and applying a configuration file. Follow this guide.

(6) Update your configuration file, inside configuration file locate the "chain" section and add the following settings below, aligned with the other configurations: keep_logs: true and fast_sync: true. Save the changes to the configuration file.

(7) Start your HOPRd node. More details can be found here.