Skip to main content

Story Chain Snapshots

Welcome to the Story Chain Snapshots page. Here you can download the latest blockchain snapshots to quickly synchronize your Story node without having to sync from genesis.

What are Snapshots?​

Blockchain snapshots are compressed backups of the blockchain state at a specific block height. They allow new nodes to sync quickly by downloading a recent state instead of processing all blocks from the beginning.

Benefits​

  • ⚡ Fast Synchronization: Sync your node in hours instead of days
  • 💾 Save Bandwidth: Download compressed snapshots instead of syncing block by block
  • 🔄 Regular Updates: Snapshots are updated regularly to ensure minimal catch-up sync
  • ✅ Verified Data: All snapshots are created from fully synchronized nodes

Available Snapshots​

Loading snapshots...

📖 Usage Instructions​

Environment Setup​

First, set up your environment variables. Adjust the paths according to your setup:

export EC_DIR=/data/story/execution  # Default: ~/.story/geth
export CC_DIR=/data/story/consensus  # Default: ~/.story/story
export SNAPSHOT_DIR=/data/story/snapshot

🔗 Consensus Layer Recovery​

mkdir -pv $SNAPSHOT_DIR && cd $SNAPSHOT_DIR

# Backup validator state (important!)
cp ${CC_DIR}/data/priv_validator_state.json ${CC_DIR}/priv_validator_state.json

# Stop service and backup current data
systemctl stop story.service
mv ${CC_DIR}/data ${CC_DIR}/data_bak

# Extract snapshot
tar -I zstd -xvf aeneid-consensus.tar.zst -C ${CC_DIR}/

# Restore validator state and start service
cp ${CC_DIR}/priv_validator_state.json ${CC_DIR}/data/priv_validator_state.json
systemctl start story.service

# After verification, remove backup
rm -rf ${CC_DIR}/data_bak

⚡ Execution Layer Recovery​

cd $SNAPSHOT_DIR

# Stop service and backup current chaindata
systemctl stop story-geth.service
mv ${EC_DIR}/geth/chaindata ${EC_DIR}/geth/chaindata_bak

# Extract snapshot and start service
tar -I zstd -xvf aeneid-execution.tar.zst -C ${EC_DIR}/geth/
systemctl start story-geth.service

# After verification, remove backup
rm -rf ${EC_DIR}/geth/chaindata_bak

⚠️ Important Notes​

  • Always backup your validator state file before applying consensus snapshots
  • Ensure services are completely stopped before applying snapshots
  • Verify node synchronization after applying snapshots before removing backups
  • Snapshots are compressed with zstd for optimal size and speed

Support​

If you encounter any issues with the snapshots or need assistance:

Disclaimer​

Always verify the integrity of downloaded snapshots and ensure you understand the risks involved in using third-party snapshots. It's recommended to backup your validator keys before applying any snapshot.