-
Notifications
You must be signed in to change notification settings - Fork 95
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
feat: refactor ICQ module documentation [NTRN-349] #646
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
repeated cosmos.base.v1beta1.Coin deposit = 10 [ | ||
(gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins", | ||
(gogoproto.nullable) = false | ||
]; | ||
|
||
// 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
// Defines amount of blocks required before query becomes available for | ||
// 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
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
.proto
andsudo
definitions of theinterchainqueries
module with comments aiming to make use of the descriptions via links to code based documentation (e.g. QueryRegisteredQueriesRequest)related PRs