docs: Fix state sync documentation#1363
Merged
martintomazic merged 3 commits intomainfrom Aug 25, 2025
Merged
Conversation
✅ Deploy Preview for oasisprotocol-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
martintomazic
commented
Jul 28, 2025
martintomazic
commented
Jul 28, 2025
martintomazic
force-pushed
the
martin/fix/state-sync-documentation
branch
from
2fb4ca0 to
f77a601
Compare
matevz
reviewed
Jul 28, 2025
matevz
reviewed
Jul 29, 2025
matevz
approved these changes
Jul 31, 2025
martintomazic
force-pushed
the
martin/fix/state-sync-documentation
branch
from
f77a601 to
a341e18
Compare
Contributor
Author
Sorry just saw this. I have added fixup commit explaining how to set correct trust |
Contributor
Author
It is simpler as you use reindexed history (roothash service). In a way consensus is light client for the runtimes, so you don't have this issues with trust period and sufficiently old checkpoints as for every consensus checkpoint checkpointer also creates runtime checkpoint. The only think you can configure is disabling checkpoint sync and sync via diffs instead from the genesis I think. |
Instead of genesis doc a trusted block header is used, which implicitly defines trusted validator set used by the light client protocol (I omitted this detail). Finally, data is fetched from all nodes not just full nodes.
martintomazic
force-pushed
the
martin/fix/state-sync-documentation
branch
from
a341e18 to
e955ab6
Compare
matevz
approved these changes
Aug 25, 2025
martintomazic
force-pushed
the
martin/fix/state-sync-documentation
branch
from
e955ab6 to
2f48edd
Compare
martintomazic
force-pushed
the
martin/fix/state-sync-documentation
branch
from
2f48edd to
9f411ae
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Document how to set correct trusted height and hash for the state sync so that they point to sufficiently old block header, to ensure there are available checkpoints.