Skip to main content

Node Snapshots

This page explains how to use snapshots to quickly spin up Gate Layer nodes (full and archive), including when to use them, how to download and verify, and how to replace the data directory safely.

1. When to use snapshots​

  • Faster sync: Start from an official data directory to significantly reduce initial sync time.
  • Archive needs: Required for deep historical tracing and complete chain data.
  • Disaster recovery: Rapidly restore a failed node to a known point-in-time.

Notes: The execution client is gatelayer-geth; snapshots primarily target its data directory.

2. Snapshot catalog & downloads​

Mainnet (Gate Layer)​

Node TypeSnapshot DateSizeDownloadxxHash128
Full2025-11-1744Ghttps://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/chaindata-2025-11-17.tar.zst896af659234f242006e4ed3fb9205d33
Archive2025-11-17443Ghttps://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/archive/chaindata-2025-11-17.tar.zstd6e3c3d247e4fd85d5a003494e08a4ac

3. Usage tutorial​

3.1 Download and verify​

3.1 Download via aria2/wget​

# Faster parallel download via aria2c (Mainnet Full)
aria2c -x 16 -s 16 https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/chaindata-2025-11-17.tar.zst

# Or wget
wget https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/chaindata-2025-11-17.tar.zst

3.2 Verify xxHash128​

# If a .xxh file is provided, download it first
wget https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/chaindata-2025-11-17.tar.zst.xxh

# Verify with xxhsum
xxhsum -H128 -c chaindata-2025-11-17.tar.zst.xxh

Compare the output with the published checksum. Re-download if they mismatch.

3.3 Decompress​

# Method 1:
tar -I zstd -xf chaindata-2025-11-17.tar.zst

# Method 2:
zstd -d < chaindata-2025-11-17.tar.zst | tar -xf -

Note: The snapshot includes only geth/chaindata.

3.4 Replace the data directory (gatelayer-geth)​

Stop gatelayer-geth cleanly before proceeding:

# 1) Stop the execution client (ensure it fully exits)
#    systemctl stop gatelayer-geth  OR  pkill -f gatelayer-geth

# 2) Backup existing data
mv ${OPGeth_DataDir}/geth/chaindata ${OPGeth_DataDir}/geth/chaindata_backup

# 3) Move snapshot data into place
mv ./chaindata ${OPGeth_DataDir}/geth/chaindata

# 4) Restart the execution client and watch logs
#    systemctl start gatelayer-geth  OR  re-run your start command

Path note: $OPGeth_DataDir is the gatelayer-geth data directory (must match your --datadir path).

4. Important notes​

  • Checksum integrity: Always verify xxHash128sum to avoid database errors caused by corrupted downloads.
  • Do not include geth/nodekey when building your own snapshot: each node must have a unique P2P nodekey or P2P connectivity issues may occur.
  • State DB scheme: Use a snapshot that matches the chain’s configured state scheme. Official Gate Layer snapshots will match the network configuration.
  • Archive size: Archive snapshots can be very large; expect longer download/decompression and significantly more disk usage.

For end-to-end node deployment, see Run L2 RPC Node under Gate Layer Development.

Last updated on 2025/11/19