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

update core IBC docs #7560

Merged
merged 27 commits into from
Oct 27, 2020
Merged

update core IBC docs #7560

merged 27 commits into from
Oct 27, 2020

Conversation

colin-axner
Copy link
Contributor

@colin-axner colin-axner commented Oct 15, 2020

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.

  • Targeted PR against 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.
  • Wrote unit and integration tests
  • Updated relevant documentation (docs/) or specification (x/<module>/spec/)
  • Added relevant godoc comments.
  • Added a relevant changelog entry to the Unreleased section in CHANGELOG.md
  • Re-reviewed Files changed in the Github PR explorer
  • Review Codecov Report in the comment section below once CI passes

@colin-axner colin-axner added T:Docs Changes and features related to documentation. x/ibc labels Oct 15, 2020
@fedekunze fedekunze added the spec label Oct 16, 2020
@codecov
Copy link

codecov bot commented Oct 19, 2020

Codecov Report

Merging #7560 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #7560   +/-   ##
=======================================
  Coverage   54.12%   54.12%           
=======================================
  Files         611      611           
  Lines       38601    38601           
=======================================
  Hits        20892    20892           
  Misses      15576    15576           
  Partials     2133     2133           

@colin-axner
Copy link
Contributor Author

@AdityaSripal could you do the capabilities section in a follow up 🙏 ?

@colin-axner
Copy link
Contributor Author

updated everything except capabilities

x/ibc/core/spec/01_concepts.md Outdated Show resolved Hide resolved
x/ibc/core/spec/01_concepts.md Show resolved Hide resolved
x/ibc/core/spec/01_concepts.md Show resolved Hide resolved
x/ibc/core/spec/01_concepts.md Show resolved Hide resolved
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
Copy link
Collaborator

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

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 should go at client specific docs IMO since it could be implemented in a multitude of ways depending on the client

Copy link
Collaborator

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).

x/ibc/core/spec/01_concepts.md Outdated Show resolved Hide resolved
x/ibc/core/spec/01_concepts.md Show resolved Hide resolved
Copy link
Contributor

@cwgoes cwgoes left a 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 Show resolved Hide resolved
x/ibc/core/spec/01_concepts.md Show resolved Hide resolved
transfers will unmarshal the data into proto definitions representing
a token transfer.

Future optimizations may allow for storage cleanup of stored packet
Copy link
Contributor

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

Copy link
Contributor

Choose a reason for hiding this comment

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

(you mention this above)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

reworded

x/ibc/core/spec/01_concepts.md Outdated Show resolved Hide resolved
x/ibc/core/spec/01_concepts.md Outdated Show resolved Hide resolved
x/ibc/core/spec/01_concepts.md Outdated Show resolved Hide resolved
@fedekunze fedekunze added the A:automerge Automatically merge PR once all prerequisites pass. label Oct 27, 2020
@mergify mergify bot merged commit e306a85 into master Oct 27, 2020
@mergify mergify bot deleted the colin/6134-core-docs branch October 27, 2020 14:51
clevinson pushed a commit that referenced this pull request Oct 29, 2020
* 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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A:automerge Automatically merge PR once all prerequisites pass. spec T:Docs Changes and features related to documentation.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Pending IBC docs
3 participants