Skip to content
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

Merged
merged 9 commits into from
Aug 15, 2024
Merged

Conversation

AdityaSripal
Copy link
Member

@AdityaSripal AdityaSripal commented Jul 10, 2024

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.

  • Targeted PR against the correct branch (see CONTRIBUTING.md).
  • Linked to GitHub issue with discussion and accepted design, OR link to spec that describes this work.
  • Code follows the module structure standards and Go style guide.
  • Wrote unit and integration tests.
  • Updated relevant documentation (docs/).
  • Added relevant godoc comments.
  • Provide a conventional commit message to follow the repository standards.
  • Include a descriptive changelog entry when appropriate. This may be left to the discretion of the PR reviewers. (e.g. chores should be omitted from changelog)
  • Re-reviewed Files changed in the GitHub PR explorer.
  • Review SonarCloud Report in the comment section below once CI passes.

Copy link
Member

@damiannolan damiannolan left a 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 💅🏻

docs/docs/03-light-clients/05-tendermint/01-overview.md Outdated Show resolved Hide resolved
docs/docs/03-light-clients/05-tendermint/01-overview.md Outdated Show resolved Hide resolved

### 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.
Copy link
Member

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?

docs/docs/03-light-clients/05-tendermint/01-overview.md Outdated Show resolved Hide resolved
docs/docs/03-light-clients/05-tendermint/01-overview.md Outdated Show resolved Hide resolved
Copy link
Member

@srdtrk srdtrk left a 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

docs/docs/03-light-clients/05-tendermint/01-overview.md Outdated Show resolved Hide resolved
Copy link
Member

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?

Copy link
Member Author

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

Copy link
Contributor

@crodriguezvega crodriguezvega left a 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!

@crodriguezvega crodriguezvega added this pull request to the merge queue Aug 15, 2024
Merged via the queue into main with commit 4cea99e Aug 15, 2024
26 of 27 checks passed
@crodriguezvega crodriguezvega deleted the aditya/tm-light-client-docs branch August 15, 2024 14:23
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.

4 participants