diff --git a/skill/references/ecosystem/node-operations.md b/skill/references/ecosystem/node-operations.md index 78cdcce..0eae4ac 100644 --- a/skill/references/ecosystem/node-operations.md +++ b/skill/references/ecosystem/node-operations.md @@ -47,13 +47,13 @@ seid init --chain-id pacific-1 # seid init --chain-id pacific-1 --mode validator ``` -> **Never start from genesis on a live network** — it panics with `integer divide by zero`. Bootstrap via state sync (below) or a snapshot. +> **Never start from genesis on a live network** — it panics with `integer divide by zero`. Bootstrap via state sync (below). A provider snapshot is a fallback that requires trusting the provider — see Provider Snapshots below. --- ## State Sync (Recommended for Fast Bootstrap) -State sync fetches a recent snapshot instead of replaying all history — reduces sync from days to minutes. +State sync fetches a recent snapshot instead of replaying all history — reduces sync from days to minutes. It is the only officially supported bootstrap method for Sei Mainnet. ### Automated State Sync @@ -96,6 +96,18 @@ State sync peers: --- +## Provider Snapshots (Trust Required) + +A provider snapshot is a third-party archive of another node's `data/` and `wasm/` directories, extracted into `$HOME/.sei`. + +- Restoring one **requires trusting the provider**. A malicious or compromised provider can corrupt a snapshot in ways that are not immediately detectable. +- The node **cannot verify the historical State Store (SS) data** in a snapshot at all. +- State sync, by contrast, verifies the restored state against the app hash in a block header that the light client has verified. + +Recommend state sync. Suggest a provider snapshot only when state sync cannot do the job — for example, an archive node, which needs history that state sync does not restore — and always say that it requires trusting the provider. For an archive node, the snapshot itself must be an archive (unpruned) snapshot: a snapshot keeps the source node's pruning, so restoring a pruned one and then turning pruning off cannot bring back the missing history. For the restore procedure, link https://docs.sei.io/node/snapshot. + +--- + ## Directory Structure ``` diff --git a/skill/references/resources.md b/skill/references/resources.md index 58905d8..4a9c6f3 100644 --- a/skill/references/resources.md +++ b/skill/references/resources.md @@ -123,7 +123,7 @@ Additional RPC providers: https://docs.sei.io/learn/rpc-providers | Resource | URL | |---|---| -| Polkachu snapshots | https://polkachu.com/tendermint_snapshots/sei | +| Polkachu snapshots (⚠️ third-party — restoring one requires trusting the provider; prefer state sync) | https://polkachu.com/tendermint_snapshots/sei | | NodeJumper | https://nodejumper.io/sei | | State sync (testnet) | https://rpc-testnet.sei-apis.com |