How to Sync Blocks Using a Snapshot

To expedite the process of fully syncing the blocks of Kroma from the genesis block, the Kroma team uploads a snapshot of the latest finalized block every day at 00:00 UTC. Follow the guide below to sync your new kroma-geth and kroma-node clients.

Prerequisites

  • Ensure that your kroma-geth and kroma-node clients are fully set up and running.

Note: If you need guidance on how to run the nodes, please refer to this link.

  • You must have the latest version of the kroma-up git repository to run the command. To update the kroma-up repository, run the following command in the directory you cloned the kroma-up git repository:

git pull origin main

Step-by-step Guide

  1. While your kroma-geth and kroma-node are up and running, execute the following command:

./sync_block.sh {network_name} // mainnet or sepolia
  1. Wait for the entire syncing process to complete. The duration may vary depending on your internet speed, but it might take up to 3 hours.

Notes

  • A new snapshot is uploaded daily at 00:00 UTC, allowing you to sync the latest finalized block efficiently.

  • Even after the ./sync_block.sh process is completed, please be aware that your kroma-geth client may still need to sync the blocks that were generated after the snapshot was taken. This process may take up to 3 hours, assuming normal internet speed.

Last updated