Skip to content

Glossary ​

These are the terms used across SnapsVault, so the docs, the Marketplace, the API and the CLI mean the same thing by them. Each entry links to the page where the term is used.

Networks and chains ​

TermDefinitionUsed in
NetworkA blockchain network, such as Celestia. A network has one or more chain IDs.Introduction
Chainmainnet or testnet. Every chain ID belongs to one of the two.REST API
Chain IDThe identifier of one chain of a network: celestia (mainnet), mocha-4 and mocha-5 (testnets). Snapshots are listed per chain ID.Registry file

Snapshots ​

TermDefinitionUsed in
SnapshotA copy of a node's data at one block height. A node restored from it starts at that height instead of syncing from genesis.Marketplace
PrunedA snapshot type that keeps recent state only. It is small.Registry file
ArchiveA snapshot type that keeps the full history. It is very large and may start at genesis, with block height 0.Feed format
Checksum (SHA256)A 64-character fingerprint of the snapshot file. Comparing it with the hash of the downloaded file shows that the file is complete and unchanged.Quickstart
TX indexWhether a snapshot includes the transaction index. The contributor sets it as tx_index and the snapshot page shows Enabled or Disabled.Registry file
PeriodHow often a contributor publishes a new snapshot, such as 4h or 1d. It drives the "next update" estimate on the snapshot page.Registry file

Contributors and listings ​

TermDefinitionUsed in
ContributorA snapshot provider: a person or team that publishes snapshots and lists them on SnapsVault.Contribute snapshots
FeedA JSON file served over HTTPS with one entry per current snapshot of a contributor, for one chain ID and snapshot type.Feed format
RegistryThe public registry repository on GitHub that lists every contributor and its feeds.How it works
Registry fileOne JSON file per contributor and chain ID in the registry. It holds the contributor profile and the URL of each feed with its type and period.Registry file

Tools ​

TermDefinitionUsed in
MarketplaceThe SnapsVault web app, where snapshots are searched, filtered and compared. The Quickstart calls it the web interface.Marketplace
SnapsOS CLIThe SnapsVault command-line client, snapsos.sh, a single bash script that finds snapshots, prints their links and can download them with a checksum check.SnapsOS CLI
REST APIThe public JSON endpoints over the same snapshot data.REST API

SnapsVault, Open Snapshot Marketplace