bifrost-snapshots

Bifrost node chain data snapshots for fast node synchronization.

Available Snapshots

Network	Mode	Database	Compressed	Extracted	Node Version	Download
Mainnet	Archive	RocksDB	833 GB	1.7 TB	v2.1.0	mainnet.archive.33408325.tar.zst
Mainnet	Full	ParityDB	130 GB	204 GB	v2.2.2	mainnet.full.39544709.tar.zst
Testnet	Archive	RocksDB	329 GB	472 GB	v2.1.0	testnet.archive.36069834.tar.zst
Testnet	Full	ParityDB	36 GB	63 GB	v2.2.2	testnet.full.42234875.tar.zst

Full snapshots keep state for the latest 201,600 blocks (~7 days). Blocks and transactions are available for the whole chain.

Prerequisites

sudo apt install -y aria2 zstd

Usage

Full and Archive snapshots have different directory layouts, so extract them into different places.

BASE_PATH="/var/lib/bifrost-data"  # Your node's --base-path
CHAIN="mainnet"                    # mainnet or testnet

# Full (ParityDB): contains paritydb/ and frontier/, extract into the chain directory
DEST="$BASE_PATH/chains/$CHAIN"
# Archive (RocksDB)
# DEST="$BASE_PATH"

mkdir -p $DEST && cd $DEST

Option 1: Stream directly (recommended)

Downloads and extracts simultaneously, saving disk space.

LINK="<DOWNLOAD_URL>"  # Copy from table above
wget -q -O - $LINK | zstd -cd | tar xf -

Option 2: Multithreaded download

Faster download with parallel connections. Requires extra disk space for the compressed file.

LINK="<DOWNLOAD_URL>"  # Copy from table above
OUTFILE="bifrost-snapshot.tar.zst"

aria2c -s14 -x14 -k1024M $LINK -o $OUTFILE
zstd -cd $OUTFILE | tar xf -
rm $OUTFILE  # Optional: remove compressed file after extraction

Running a Full node

Full snapshots must be started with these flags:

bifrost-node \
  --base-path "$BASE_PATH" \
  --chain /path/to/bifrost-$CHAIN.json \
  --database paritydb \
  --state-pruning 201600

• Chain specs: specs/ in bifrost-node.
• This database cannot be switched to archive mode (--state-pruning archive fails). For an archive node, use the Archive snapshot.
• State queries (eth_call, eth_getBalance, eth_getStorageAt, ...) older than ~7 days fail. Block and transaction queries work for the whole chain.

Migrating from a RocksDB Full node

Stop the node, remove the old database, then extract the new snapshot and add --database paritydb.

rm -rf "$BASE_PATH/chains/$CHAIN/db" "$BASE_PATH/chains/$CHAIN/frontier/db"