-
Notifications
You must be signed in to change notification settings - Fork 585
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Tendermint Light Client Documentation #6801
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Great start to these docs! 🙏🏻 Thanks @AdityaSripal!
I agree we can add more and polish them as necessary. I added a couple of suggestions in the PR but feel free to apply them or wait til later and we can add/adjust them post-merge 💅🏻
|
||
### Updates | ||
|
||
Once the initial client state and consensus state are submitted, future consensus states can be added to the client by submitting IBC Headers. These headers contain all necessary information to run the Comet BFT Light Client protocol. For detailed information on the Comet BFT Light Client protocol and its safety properties please refer to the Comet BFT paper. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should we add a link to the paper?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Lgtm. Added some comments
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Are there more files coming? If not maybe this should be broken down to different files?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not from myself. but future tendermint docs can come in and be in new files
Co-authored-by: Damian Nolan <damiannolan@gmail.com>
…o into aditya/tm-light-client-docs
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Excellent start for the client's documentation! Thanks a lot, @AdityaSripal!
Description
This is a start for having documentation on the tendermint light client as we have with localhost and wasm. I give a brief explanation of the main mechanisms of the light client. In the misbehaviour section, I go into detail on the security model embedded in the tendermint light client implementation.
We should flush this out more, but I believe that can be done in subsequent PRs
Before we can merge this PR, please make sure that all the following items have been
checked off. If any of the checklist items are not applicable, please leave them but
write a little note why.
docs/
).godoc
comments.Files changed
in the GitHub PR explorer.SonarCloud Report
in the comment section below once CI passes.