Skip to main content

Filecoin Validated Snapshot

Background​

We provide chaindata snapshots of Mainnet and Calibnet to the Filecoin community. This service creates and uploads lightweight snapshots of the blockchain states at regular intervals:

  • 🕒 Calibnet: Every 1 hour
  • 🕑 Mainnet: Every 1 hour

These snapshots include messages and state-trees but do not include message receipts.

🔎 The snapshot service exports Forest snapshots and performs an integrity check (validation) against Lotus before uploading to R2.

🌐 Snapshot Endpoints​

Snapshot Content​

Each snapshot includes the following data:

End height: 		  Recent Block
Message start height: Recent block - 2000 blocks
State start height:	  Current block - 2000 blocks

Hosts for Snapshot Generation​

We use hosts for snapshot generation for both Calibnet and Mainnet:

  • fil-prod-ovh-forest-mainnet-archive: 🔄 Continuous snapshots creation for Mainnet:

    • Latest F3 snapshot uploads every 1 hour
    • generation diff snapshots every 24 hours
    • generation lite snapshots every 10 days.

  • fil-prod-ovh-forest-calibnet-archive: 🔄 Continuous snapshots creation for Calibnet:

    • Latest F3 snapshot uploads every 1 hour
    • generation diff snapshots every 24 hours
    • generation lite snapshots every 10 days.

Legacy Snapshots

  • fil-prod-ovh-forest-snapshot-0:
    🔄 Continuous snapshot uploads every 1 hour for Mainnet and 1 hour for Calibnet.

  • fil-prod-ovh-forest-snapshot-1:
    🛠️ Used for manual snapshot generation for both Mainnet and Calibnet.

⚙️ Steps to Generate On-Demand Snapshot​

  1. Go to the GitHub Workflow here.
  2. Keep the branch set to main and select the desired network.
  3. Monitor the process using Loki logs at chainsafe.grafana.net with the following filters:
    • instance=fil-prod-ovh-forest-snapshot-1
    • job=snapshot-service

R2 Storage Buckets​

ChainSafe uses R2 storage for organizing and managing snapshot data:

  1. forest-archive bucket:
    Contains snapshot diffs and lite versions for both Mainnet and Calibnet.

  2. infra-team-filecoin-archive bucket:
    Hosts the legacy snapshots for the past 14 days for both Mainnet and Calibnet.

  3. forest-snapshots-v2 bucket: Hosts the latest F3 snapshots for the past 14 days for both Mainnet and Calibnet.

  4. forbidden-snapshot bucket: Stores snapshots that encountered errors during processing.

  5. backup-filecoin-archive bucket: Maintains backup snapshots of the Mainnet archive node.

Architecture Diagram​

The link to the snapshot generation workflow is available here.