README.md

opbnb-snapshot

Endpoint

Snapshots are created and preserved every week, and each snapshot is kept for 30 days. NodeReal, a community developer, is responsible for regularly creating and updating the snapshots.

At present, we offer snapshots for both the mainnet and testnet networks in path-based state scheme and archived formats. It is advisable to utilize the path-based state scheme snapshot for quicker synchronization, improved performance, and reduced storage needs.

For more details about different node type and database scheme, please refer to the official documentation.

Note

In the current version of the pbss snapshot, if the op-node is started with EL (Execution Layer) sync enabled, there may be an issue where the initialization state becomes inconsistent, causing block synchronization to fail. To work around this, disable EL sync by removing the syncmode = execution-layer configuration in op-node config. This issue will be fixed in the next release.

Mainnet

• Path-Base-State-Scheme(recommand):
  • url: https://opbnb-snapshot-mainnet.bnbchain.org/geth-pbss-20241105.tar.gz
  • sha256 checksum: 926ebb95f4335ae5537ee9a553149acaa1d87bfcff88301ae8ac9d8804f01bfd
• Archived:
  • The full archived node status is too large(over 5.6 TB at the end of May, 2024). There is no available archive snapshot at the moment. If you do need a full archived node, you have to sync the node from scratch.
• Pruned Archived: (Note that the pruned snapshot has erased state data before block height: 19598373)
  • url: https://opbnb-snapshot-mainnet.bnbchain.org/geth-prune-20241104.tar.gz
  • sha256 checksum: 1498f3edb2985d5e10c97d24a8b4417aa6edbf1e14e91410050f95f75c869f13

Testnet

• Path-Base-State-Scheme(recommand):
  • url: https://opbnb-snapshot-testnet.bnbchain.org/geth-pbss-20241101.tar.gz
  • sha256 checksum: d8fa7393da7111cdd07fa79824c549e50e16c937f0c6d70426e24c47738da6e6
• Archived:
  • There is no available archive snapshot at the moment.

Additionally, you can get the latest snapshot url and sha256 checksum as below:

$ curl https://opbnb-snapshot-mainnet.bnbchain.org/geth-pbss-latest
geth-pbss-20240525.tar.gz

$ curl https://opbnb-snapshot-mainnet.bnbchain.org/geth-pbss-20240525.tar.gz.sha256
d361af99362f3e6c55984e4aff127fffe9939e5c28274450f4b168b04d87370a  geth-pbss-20240525.tar.gz

Usage

Step 1: Download the snapshot and decompress it.

wget -q -O - https://opbnb-snapshot-mainnet.bnbchain.org/geth-pbss-20240525.tar.gz | tar -xvf -

Step 2: Replace the data.

1. Stop the running op-geth client, ensuring that it has completely shut down.
2. To back up the original data, execute the following commands:

   mv ${OPGeth_DataDir}/geth/chaindata ${OPGeth_DataDir}/geth/chaindata_backup
   mv ${OPGeth_DataDir}/geth/triecache ${OPGeth_DataDir}/geth/triecache_backup
   

3. Replace the data with the snapshot by running:

   mv ./geth/chaindata ${OPGeth_DataDir}/geth/chaindata
   mv ./geth/triecache ${OPGeth_DataDir}/geth/triecache
   

4. Restart the op-geth client and verify the logs.

Build Your Own Snapshot

If you would like to build your own snapshot, you can follow the steps below:

tar -zcvf geth.tar.gz geth/chaindata geth/triecache

The process may take considerable time, depending on the size of the data.

Reminder: The geth/nodekey file is specific to each node. If you plan to create your own snapshot, make sure not to include this file, as it may lead to peer-to-peer (P2P) connectivity problems when using the snapshot.