-
Notifications
You must be signed in to change notification settings - Fork 131
feat: refactor ICQ module documentation [NTRN-349] #646
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
Conversation
…tor-icq-module-documentation
852a6ae to
f591f09
Compare
5203ec0 to
ecdff56
Compare
8851318 to
05acc43
Compare
05acc43 to
c5b2703
Compare
…tor-icq-module-documentation
| ]; | ||
|
|
||
| // Timeout before query becomes available for everybody to remove. | ||
| // Duration in blocks that is required to pass since the query registration/update for the |
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.
What the 'update' word means here. How to keep query alive
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.
yeah, that's a good catch. especially given the ambiguity behind the 'update' term which in the API means the query parameters update. will fix
| // removal by anybody | ||
| // The amount of blocks required to pass since an Interchain Query registration/update for the | ||
| // query to become available for removal by anybody. | ||
| uint64 query_submit_timeout = 1; |
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.
How is this param related to submit_timeout of an interchain query
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.
will rephrase, too
| // Response type for the Query/Params RPC method. | ||
| message QueryParamsResponse { | ||
| // params holds all the parameters of this module. | ||
| // Stores all parameters of the module. |
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.
Is the stores word correct for this certain usecase?
|
|
||
| // is the Merkle Proof which proves existence of key-value pair in IAVL | ||
| // storage | ||
| // The Merkle Proof which proves existence of key-value pair in IAVL storage. Is used to verify |
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.
Or proves nonexistance if no key-value pair in IAVL storage, not sure is it obvious from the comment.
dd24540
task
https://hadronlabs.atlassian.net/browse/NTRN-349
this PR
.protoandsudodefinitions of theinterchainqueriesmodule with comments aiming to make use of the descriptions via links to code based documentation (e.g. QueryRegisteredQueriesRequest)related PRs