-
Notifications
You must be signed in to change notification settings - Fork 3.6k
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
update core IBC docs #7560
update core IBC docs #7560
Conversation
Codecov Report
@@ Coverage Diff @@
## master #7560 +/- ##
=======================================
Coverage 54.12% 54.12%
=======================================
Files 611 611
Lines 38601 38601
=======================================
Hits 20892 20892
Misses 15576 15576
Partials 2133 2133 |
@AdityaSripal could you do the capabilities section in a follow up 🙏 ? |
…nto colin/6134-core-docs
updated everything except capabilities |
client specific parameters like `TrustLevel` which must be considered valid in relation | ||
to the `Header`. | ||
|
||
Clients may be upgraded. The upgrade should be verified using `VerifyUpgrade`. It is not |
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.
I think it's also relevant to mention how to upgrade the client if one of the chains halts/panics vs if the upgrade is planned
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.
This should go at client specific docs IMO since it could be implemented in a multitude of ways depending on the client
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.
ah yes. Although I think it's still relevant to add that as a comment (i.e that it is up to the light client implementation).
Co-authored-by: Federico Kunze <31522760+fedekunze@users.noreply.github.com>
…nto colin/6134-core-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.
ACK; minor nits/suggestions
x/ibc/core/spec/01_concepts.md
Outdated
transfers will unmarshal the data into proto definitions representing | ||
a token transfer. | ||
|
||
Future optimizations may allow for storage cleanup of stored packet |
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.
Packet commitments are cleaned-up when acknowledgements are processed
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.
(you mention this above)
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.
reworded
Co-authored-by: Christopher Goes <cwgoes@pluranimity.org>
…nto colin/6134-core-docs
* update state * add empty concept fields, update callbacks and messages * update client creation, update and upgrade section * add packet lifecycle concepts * add host and proof section * add connection handshake section * add channel handshakes * state transitions * self review fixes * Apply suggestions from code review Co-authored-by: Federico Kunze <31522760+fedekunze@users.noreply.github.com> * apply @fedekunze review suggestions * packet data section * Apply suggestions from code review Co-authored-by: Christopher Goes <cwgoes@pluranimity.org> * add @cwgoes and @fedekunze review suggestions * fix typos Co-authored-by: Federico Kunze <31522760+fedekunze@users.noreply.github.com> Co-authored-by: Christopher Goes <cwgoes@pluranimity.org> Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>
Description
closes: #6134
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/
) or specification (x/<module>/spec/
)godoc
comments.Unreleased
section inCHANGELOG.md
Files changed
in the Github PR explorerCodecov Report
in the comment section below once CI passes