Skip to content

Conversation

@martintomazic
Copy link
Contributor

Closes #1530

Draft as we first have to merge oasisprotocol/cli#621, then update the docs dependency and finally add TODO links here.

Add new `oasis network trust` command. Also removed the part that
suggested taking latest height as a trust, which won't work for the
stateful nodes.
@netlify
Copy link

netlify bot commented Nov 17, 2025

Deploy Preview for oasisprotocol-docs ready!

Name Link
🔨 Latest commit da7d6f1
🔍 Latest deploy log https://app.netlify.com/projects/oasisprotocol-docs/deploys/691b2774e9183f0008befe70
😎 Deploy Preview https://deploy-preview-1552--oasisprotocol-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.


#### Oasis CLI

Query our public Oasis node's endpoint using the Oasis CLI and obtain the
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not suitable for the statefull trust root, but is actually desired for the stateless client state root, as otherwise you will reindex 1 week of the data (wasted resources and slow) - see doc. Given this chapter was original meant and still is for the stateful state sync I am removing it.

My suggestion would be to extend oasis network trust command with --mode (default: stateful), with non-default being stateless. This won't be even breaking. And possibly have sub-chapters here one for statefull and another for stateless. cc @peternose what do you think?

Then as discussed with @amela, we should refactor this into How to Guides for how to set trust root for the state sync (could be per mode). Everything else, i.e. State sync (consensus vs runtime), Trust Root, and Light Client should go under Concepts sections, as these are generic concepts.

This is draft, just want' to brainstorm next steps first. Also splitting this into guides/concepts is a separate issue.

```

This will give you output like the following (non-relevant fields omitted):
#### Oasis CLI
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move to the top, as all other options are more centralized :).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs/Run-your-node/State-sync: Document new recommended trust command

2 participants