diff --git a/proto/neutron/interchainqueries/query.proto b/proto/neutron/interchainqueries/query.proto index 2829badc8..31558f28e 100644 --- a/proto/neutron/interchainqueries/query.proto +++ b/proto/neutron/interchainqueries/query.proto @@ -12,24 +12,26 @@ option go_package = "github.com/neutron-org/neutron/v5/x/interchainqueries/types // Defines the Query interface of the module. service Query { - // Queries the current parameters of the module. + // Fetches the current parameters of the interchainqueries module. rpc Params(QueryParamsRequest) returns (QueryParamsResponse) { option (google.api.http).get = "/neutron/interchainqueries/params"; } - // Queries all the registered Interchain Queries in the module with filtration by owner and/or - // connection ID. + // Retrieves all registered Interchain Queries in the module, with optional filtering by owner + // and/or connection ID. rpc RegisteredQueries(QueryRegisteredQueriesRequest) returns (QueryRegisteredQueriesResponse) { option (google.api.http).get = "/neutron/interchainqueries/registered_queries"; } - // Queries a registered Interchain Query by ID. + // Fetches details of a registered Interchain Query using its ID. rpc RegisteredQuery(QueryRegisteredQueryRequest) returns (QueryRegisteredQueryResponse) { option (google.api.http).get = "/neutron/interchainqueries/registered_query"; } - // Queries the last successfully submitted result of an Interchain Query. + // Retrieves the most recent successfully submitted result of an Interchain Query. This is only + // applicable for KV Interchain Queries. rpc QueryResult(QueryRegisteredQueryResultRequest) returns (QueryRegisteredQueryResultResponse) { option (google.api.http).get = "/neutron/interchainqueries/query_result"; } - // Queries the last height of a remote chain known to the IBC client behind a given connection ID. + // Retrieves the most recent height of a remote chain as known by the IBC client associated with + // a given connection ID. rpc LastRemoteHeight(QueryLastRemoteHeight) returns (QueryLastRemoteHeightResponse) { option (google.api.http).get = "/neutron/interchainqueries/remote_height"; } diff --git a/proto/neutron/interchainqueries/tx.proto b/proto/neutron/interchainqueries/tx.proto index 343257c85..7361a56cd 100644 --- a/proto/neutron/interchainqueries/tx.proto +++ b/proto/neutron/interchainqueries/tx.proto @@ -16,26 +16,28 @@ option go_package = "github.com/neutron-org/neutron/v5/x/interchainqueries/types // Defines the Msg interface of the module. service Msg { option (cosmos.msg.v1.service) = true; - // Registers a new Interchain Query in the interchainqueries module. This message is supposed to - // be issued only by a smart contract. The caller contract is charged a query registration deposit - // automatically in the amount defined as the module's query deposit parameter. The deposit is - // paid back on the query removal. Make sure to have enough assets on the contract's account - // at the time of the message execution. + // Registers a new Interchain Query in the `interchainqueries` module. This message should only + // be issued by a smart contract. The calling contract is automatically charged a query + // registration deposit, based on the module's query deposit parameter. The deposit is refunded + // when the query is removed. Ensure the contract's account has sufficient assets at the time of + // message execution. // - // Returns an ID assigned to the registered query. Handle this message response via a reply - // handler in order to make use of the ID. + // The response includes the ID assigned to the registered query. Use a reply handler to process + // this response and utilize the query ID. rpc RegisterInterchainQuery(MsgRegisterInterchainQuery) returns (MsgRegisterInterchainQueryResponse); - // Submits a result of an Interchain Query execution to the chain. This message handling may - // include passing of the result to the query's owner smart contract for processing which might - // be a pretty gas-consumable operation. + // Submits the result of an Interchain Query execution to the chain. Handling this message may + // involve forwarding the result to the smart contract that owns the query for processing, which + // could require significant gas usage. rpc SubmitQueryResult(MsgSubmitQueryResult) returns (MsgSubmitQueryResultResponse); - // Removes a given Interchain Query and its results from the module. Can be removed only by the - // owner of the query during the query's submit timeout, and by anyone after the query has been - // timed out. The query deposit is returned to the caller on a success call. + // Removes a specific Interchain Query and its results from the module. The query can only be + // removed by its owner during the query's submit timeout. After the timeout, anyone can remove + // it. Upon successful removal, the query deposit is refunded to the caller. rpc RemoveInterchainQuery(MsgRemoveInterchainQueryRequest) returns (MsgRemoveInterchainQueryResponse); - // Updates parameters of a registered Interchain Query. Only callable by the owner of the query. + // Updates the parameters of a registered Interchain Query. This action can only be performed by + // the query's owner. rpc UpdateInterchainQuery(MsgUpdateInterchainQueryRequest) returns (MsgUpdateInterchainQueryResponse); - // Updates params of the interchainqueries module. Only callable by the module's authority. + // Updates the parameters of the `interchainqueries` module. This action can only be performed + // by the module's authority. rpc UpdateParams(MsgUpdateParams) returns (MsgUpdateParamsResponse); } diff --git a/x/contractmanager/types/sudo.go b/x/contractmanager/types/sudo.go index 2ef52b974..893b710d2 100644 --- a/x/contractmanager/types/sudo.go +++ b/x/contractmanager/types/sudo.go @@ -5,11 +5,11 @@ import ( channeltypes "github.com/cosmos/ibc-go/v8/modules/core/04-channel/types" ) -// MessageTxQueryResult is the model of the sudo message sent to a smart contract on a TX -// Interchain Query result submission. The owner of a TX Interchain Query must define a `sudo` -// entry_point for handling `tx_query_result` messages and place the needed logic there. -// The `tx_query_result` handler is treated by the interchainqueries module as a callback that is -// called each time a TX query result is submitted. +// MessageTxQueryResult is the model of the `sudo` message sent to a smart contract when a TX +// Interchain Query result is submitted. The owner of a TX Interchain Query must implement a `sudo` +// entry point to handle `tx_query_result` messages and include the necessary logic in it. The +// `tx_query_result` handler functions as a callback, triggered by the `interchainqueries` module +// each time a TX query result is submitted. type MessageTxQueryResult struct { TxQueryResult struct { // QueryID is the ID of the TX query which result is being submitted. @@ -21,15 +21,14 @@ type MessageTxQueryResult struct { } `json:"tx_query_result"` } -// MessageKVQueryResult is the model of the sudo message sent to a smart contract on a KV -// Interchain Query result submission. If the owner of a KV Interchain Query wants to handle the -// query updates, it must define a `sudo` entry_point for handling `kv_query_result` messages -// and place the needed logic there. The `kv_query_result` handler is treated by the -// interchainqueries module as a callback that is called each time a KV query result is -// submitted. +// MessageKvQueryResult is the model of the `sudo` message sent to a smart contract when a KV +// Interchain Query result is submitted. If the owner of a KV Interchain Query wants to handle +// updates, they must implement a `sudo` entry point to process `kv_query_result` messages and +// include the necessary logic in it. The `kv_query_result` handler acts as a callback, triggered +// by the interchainqueries module whenever a KV query result is submitted. // -// Note that there is no query result sent, only the query ID. In order to access the actual -// result, use the Query/QueryResult RPC of the interchainqueries module. +// Note that the message does not include the actual query result, only the query ID. To access the +// result data, use the `Query/QueryResult` RPC of the `interchainqueries` module. type MessageKVQueryResult struct { KVQueryResult struct { // QueryID is the ID of the KV query which result is being submitted. diff --git a/x/interchainqueries/types/query.pb.go b/x/interchainqueries/types/query.pb.go index 0300e73fa..c2222f9c5 100644 --- a/x/interchainqueries/types/query.pb.go +++ b/x/interchainqueries/types/query.pb.go @@ -422,7 +422,6 @@ func (m *QueryRegisteredQueryResultResponse) GetResult() *QueryResult { return nil } -// Deprecated: Do not use. type Transaction struct { Id uint64 `protobuf:"varint,1,opt,name=id,proto3" json:"id,omitempty"` Height uint64 `protobuf:"varint,2,opt,name=height,proto3" json:"height,omitempty"` @@ -604,56 +603,56 @@ func init() { } var fileDescriptor_2254be23ba3ff3b4 = []byte{ - // 775 bytes of a gzipped FileDescriptorProto + // 770 bytes of a gzipped FileDescriptorProto 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0x9c, 0x56, 0xcf, 0x4f, 0x13, 0x4f, - 0x14, 0xef, 0x94, 0x7e, 0x0b, 0xbc, 0xf2, 0x15, 0x18, 0xd1, 0x94, 0x15, 0x2b, 0x2c, 0x11, 0x0a, - 0xa6, 0xbb, 0xfc, 0x08, 0x8a, 0x8a, 0x98, 0x70, 0x50, 0x49, 0x34, 0x81, 0x55, 0x3c, 0x78, 0x69, - 0xa6, 0xed, 0x64, 0xbb, 0x09, 0xdd, 0x29, 0xbb, 0x53, 0xa4, 0x57, 0x6f, 0xde, 0x8c, 0xfe, 0x0b, - 0xfe, 0x01, 0xde, 0x3c, 0x78, 0xf0, 0x4a, 0x3c, 0x91, 0x78, 0xf1, 0x64, 0x0c, 0xf8, 0x87, 0x98, - 0x9d, 0x99, 0xb6, 0x6c, 0x7f, 0x52, 0x4e, 0x9d, 0x99, 0x7d, 0x9f, 0xf7, 0x3e, 0xef, 0xf3, 0xde, - 0x9b, 0x0e, 0xdc, 0x76, 0x69, 0x85, 0x7b, 0xcc, 0x35, 0x1d, 0x97, 0x53, 0x2f, 0x5f, 0x24, 0x8e, - 0x7b, 0x50, 0xa1, 0x9e, 0x43, 0x7d, 0x33, 0xf8, 0xad, 0x1a, 0x65, 0x8f, 0x71, 0x86, 0x27, 0x95, - 0x99, 0xd1, 0x62, 0xa6, 0x2d, 0xe6, 0x99, 0x5f, 0x62, 0xbe, 0x99, 0x23, 0x3e, 0x95, 0x18, 0xf3, - 0x70, 0x39, 0x47, 0x39, 0x59, 0x36, 0xcb, 0xc4, 0x76, 0x5c, 0xc2, 0x1d, 0xe6, 0x4a, 0x37, 0xda, - 0x84, 0xcd, 0x6c, 0x26, 0x96, 0x66, 0xb0, 0x52, 0xa7, 0x53, 0x36, 0x63, 0xf6, 0x3e, 0x35, 0x49, - 0xd9, 0x31, 0x89, 0xeb, 0x32, 0x2e, 0x20, 0xbe, 0xfa, 0x3a, 0xdf, 0x99, 0xa1, 0x4d, 0x5d, 0xea, - 0x3b, 0x35, 0xc3, 0xb9, 0xce, 0x86, 0x65, 0xe2, 0x91, 0x52, 0xcd, 0x4e, 0xef, 0x6c, 0xc7, 0x8f, - 0xa4, 0x8d, 0x3e, 0x01, 0x78, 0x37, 0x48, 0x65, 0x47, 0x00, 0x2d, 0x7a, 0x50, 0xa1, 0x3e, 0xd7, - 0x5f, 0xc3, 0xd5, 0xd0, 0xa9, 0x5f, 0x66, 0xae, 0x4f, 0xf1, 0x63, 0x88, 0xcb, 0x00, 0x49, 0x34, - 0x8d, 0xd2, 0x89, 0x95, 0x19, 0xa3, 0xa3, 0x5a, 0x86, 0x84, 0x6e, 0xc5, 0x8e, 0x7f, 0xdf, 0x8a, - 0x58, 0x0a, 0xa6, 0x7f, 0x46, 0x70, 0x53, 0x38, 0xb6, 0xa8, 0xed, 0xf8, 0x9c, 0x7a, 0xb4, 0xb0, - 0x2b, 0xed, 0x55, 0x64, 0x7c, 0x1d, 0xe2, 0xec, 0xad, 0x4b, 0xbd, 0x20, 0xc4, 0x40, 0x7a, 0xd8, - 0x52, 0x3b, 0x3c, 0x0b, 0xff, 0xe7, 0x99, 0xeb, 0xd2, 0x7c, 0xa0, 0x58, 0xd6, 0x29, 0x24, 0xa3, - 0xd3, 0x28, 0x3d, 0x6c, 0x8d, 0x34, 0x0e, 0xb7, 0x0b, 0xf8, 0x09, 0x40, 0xa3, 0x12, 0xc9, 0x01, - 0xc1, 0x71, 0xce, 0x90, 0x65, 0x33, 0x82, 0xb2, 0x19, 0xb2, 0xd4, 0xaa, 0x6c, 0xc6, 0x0e, 0xb1, - 0xa9, 0x0a, 0x6c, 0x9d, 0x43, 0xea, 0x3f, 0x10, 0xa4, 0x3a, 0xd1, 0x54, 0x52, 0x64, 0x01, 0x7b, - 0xf5, 0x8f, 0x59, 0x95, 0xb4, 0xe0, 0x9c, 0x58, 0x59, 0xec, 0x22, 0x4b, 0xd8, 0x63, 0x55, 0xe9, - 0x33, 0xee, 0x35, 0x07, 0xc2, 0x4f, 0x43, 0xb9, 0x44, 0x45, 0x2e, 0xf3, 0x3d, 0x73, 0x91, 0xec, - 0x42, 0xc9, 0xac, 0xc3, 0x8d, 0x36, 0xb9, 0x54, 0x6b, 0x82, 0x4f, 0xc2, 0x90, 0x70, 0x14, 0x68, - 0x1a, 0x54, 0x35, 0x66, 0x0d, 0x8a, 0xfd, 0x76, 0x41, 0xaf, 0xc0, 0x54, 0x7b, 0xa4, 0xd2, 0x60, - 0x0f, 0xc6, 0x9a, 0x34, 0xa8, 0xaa, 0xc6, 0xe8, 0x43, 0x01, 0x6b, 0x34, 0x9c, 0x7b, 0x55, 0xdf, - 0x84, 0x99, 0x0e, 0x61, 0x2b, 0xfb, 0xfc, 0x02, 0xb4, 0x0b, 0xa0, 0x77, 0xc3, 0x2b, 0xf2, 0x9b, - 0x10, 0xf7, 0xc4, 0x89, 0xa2, 0x3c, 0xd7, 0x85, 0xf2, 0x79, 0xbc, 0x42, 0xe9, 0x2f, 0x20, 0xf1, - 0xca, 0x23, 0xae, 0x4f, 0x44, 0xf3, 0xe1, 0x2b, 0x10, 0xad, 0x33, 0x89, 0x3a, 0x85, 0xa0, 0x8f, - 0x8b, 0xd4, 0xb1, 0x8b, 0x5c, 0x94, 0x2e, 0x66, 0xa9, 0x1d, 0xc6, 0x10, 0x2b, 0x10, 0x4e, 0x44, - 0x73, 0x8e, 0x58, 0x62, 0xfd, 0x20, 0x9a, 0x44, 0xfa, 0x06, 0x5c, 0x13, 0x51, 0x9e, 0x13, 0x9f, - 0x5b, 0xb4, 0xc4, 0x38, 0x7d, 0x26, 0x01, 0x2d, 0x8d, 0x8f, 0x5a, 0x1b, 0x5f, 0x7f, 0xa9, 0xc6, - 0xaa, 0x19, 0x5d, 0xcf, 0xb6, 0x41, 0x07, 0x85, 0xe8, 0x68, 0x30, 0xe4, 0xd1, 0x43, 0xc7, 0xaf, - 0xf5, 0x58, 0xcc, 0xaa, 0xef, 0x57, 0xde, 0x0f, 0xc2, 0x7f, 0xc2, 0x2b, 0xfe, 0x88, 0x20, 0x2e, - 0xe7, 0x19, 0x67, 0x7a, 0xc9, 0x14, 0xba, 0x48, 0x34, 0xe3, 0xa2, 0xe6, 0x92, 0xa7, 0xbe, 0xf0, - 0xee, 0xe7, 0xdf, 0x4f, 0xd1, 0x59, 0x3c, 0x63, 0xf6, 0xba, 0xe3, 0xf0, 0x77, 0x04, 0xe3, 0x2d, - 0xf3, 0x89, 0xd7, 0x7b, 0x97, 0xb1, 0xfd, 0xcd, 0xa3, 0xdd, 0xbf, 0x04, 0x52, 0xb1, 0x5e, 0x13, - 0xac, 0x4d, 0x9c, 0xe9, 0xc2, 0xba, 0xf5, 0xb6, 0xc0, 0x5f, 0x11, 0x8c, 0x36, 0x35, 0x29, 0xbe, - 0xdb, 0x1f, 0x8b, 0xda, 0x18, 0x6b, 0xf7, 0xfa, 0xc6, 0x29, 0xee, 0xab, 0x82, 0x7b, 0x06, 0xdf, - 0xb9, 0x38, 0xf7, 0x2a, 0xfe, 0x86, 0x20, 0x71, 0x6e, 0x28, 0xf0, 0x46, 0xff, 0xd1, 0x1b, 0xb3, - 0xac, 0x3d, 0xba, 0x24, 0x5a, 0x65, 0x60, 0x8a, 0x0c, 0x16, 0xf0, 0xbc, 0xd9, 0xe3, 0x2f, 0x3e, - 0x2b, 0x47, 0x17, 0x7f, 0x41, 0x30, 0xd6, 0x32, 0x67, 0x4b, 0xbd, 0x48, 0x34, 0x23, 0xb4, 0xf5, - 0x7e, 0x11, 0x75, 0xc6, 0x4b, 0x82, 0xf1, 0x22, 0x4e, 0x77, 0xd5, 0x3c, 0x00, 0x66, 0xe5, 0x9c, - 0x6e, 0xed, 0x1d, 0x9f, 0xa6, 0xd0, 0xc9, 0x69, 0x0a, 0xfd, 0x39, 0x4d, 0xa1, 0x0f, 0x67, 0xa9, - 0xc8, 0xc9, 0x59, 0x2a, 0xf2, 0xeb, 0x2c, 0x15, 0x79, 0xf3, 0xd0, 0x76, 0x78, 0xb1, 0x92, 0x33, - 0xf2, 0xac, 0x54, 0xf3, 0x96, 0x61, 0x9e, 0x5d, 0xf7, 0x7c, 0xb8, 0x66, 0x1e, 0xb5, 0x7b, 0x00, - 0x54, 0xcb, 0xd4, 0xcf, 0xc5, 0xc5, 0x23, 0x60, 0xf5, 0x5f, 0x00, 0x00, 0x00, 0xff, 0xff, 0x17, - 0x6f, 0x80, 0x31, 0x1d, 0x09, 0x00, 0x00, + 0x14, 0xef, 0x94, 0x7e, 0x0b, 0xbc, 0xf2, 0x15, 0x18, 0xd1, 0xc0, 0x8a, 0x15, 0x96, 0x08, 0x05, + 0xd3, 0x5d, 0x7e, 0x04, 0xc5, 0x88, 0x98, 0x70, 0x50, 0x49, 0x3c, 0xc0, 0x2a, 0x1e, 0xbc, 0x34, + 0xd3, 0x76, 0xb2, 0xdd, 0x84, 0xee, 0x94, 0x9d, 0x29, 0xd2, 0xab, 0x37, 0x6f, 0x46, 0xff, 0x05, + 0xff, 0x00, 0x6f, 0x1e, 0x3c, 0x78, 0x25, 0x9e, 0x48, 0xbc, 0x78, 0x32, 0x06, 0xfc, 0x43, 0xcc, + 0xce, 0x4c, 0x5b, 0xfa, 0x9b, 0x72, 0xea, 0xcc, 0xec, 0xfb, 0xbc, 0xf7, 0x79, 0x9f, 0xf7, 0xde, + 0x4c, 0xe1, 0xae, 0x4f, 0xcb, 0x22, 0x60, 0xbe, 0xed, 0xf9, 0x82, 0x06, 0xb9, 0x02, 0xf1, 0xfc, + 0xc3, 0x32, 0x0d, 0x3c, 0xca, 0xed, 0xf0, 0xb7, 0x62, 0x95, 0x02, 0x26, 0x18, 0x9e, 0xd2, 0x66, + 0x56, 0x8b, 0x99, 0xb1, 0x94, 0x63, 0xbc, 0xc8, 0xb8, 0x9d, 0x25, 0x9c, 0x2a, 0x8c, 0x7d, 0xb4, + 0x92, 0xa5, 0x82, 0xac, 0xd8, 0x25, 0xe2, 0x7a, 0x3e, 0x11, 0x1e, 0xf3, 0x95, 0x1b, 0x63, 0xc2, + 0x65, 0x2e, 0x93, 0x4b, 0x3b, 0x5c, 0xe9, 0xd3, 0x69, 0x97, 0x31, 0xf7, 0x80, 0xda, 0xa4, 0xe4, + 0xd9, 0xc4, 0xf7, 0x99, 0x90, 0x10, 0xae, 0xbf, 0x2e, 0x74, 0x66, 0xe8, 0x52, 0x9f, 0x72, 0xaf, + 0x6a, 0x38, 0xdf, 0xd9, 0xb0, 0x44, 0x02, 0x52, 0xac, 0xda, 0x99, 0x9d, 0xed, 0xc4, 0xb1, 0xb2, + 0x31, 0x27, 0x00, 0xef, 0x85, 0xa9, 0xec, 0x4a, 0xa0, 0x43, 0x0f, 0xcb, 0x94, 0x0b, 0xf3, 0x35, + 0x5c, 0x6f, 0x38, 0xe5, 0x25, 0xe6, 0x73, 0x8a, 0x9f, 0x40, 0x5c, 0x05, 0x98, 0x44, 0x33, 0x28, + 0x95, 0x58, 0x9d, 0xb5, 0x3a, 0xaa, 0x65, 0x29, 0xe8, 0x76, 0xec, 0xe4, 0xf7, 0x9d, 0x88, 0xa3, + 0x61, 0xe6, 0x67, 0x04, 0xb7, 0xa5, 0x63, 0x87, 0xba, 0x1e, 0x17, 0x34, 0xa0, 0xf9, 0x3d, 0x65, + 0xaf, 0x23, 0xe3, 0x9b, 0x10, 0x67, 0x6f, 0x7d, 0x1a, 0x84, 0x21, 0x06, 0x52, 0xc3, 0x8e, 0xde, + 0xe1, 0x39, 0xf8, 0x3f, 0xc7, 0x7c, 0x9f, 0xe6, 0x42, 0xc5, 0x32, 0x5e, 0x7e, 0x32, 0x3a, 0x83, + 0x52, 0xc3, 0xce, 0x48, 0xfd, 0x70, 0x27, 0x8f, 0x9f, 0x02, 0xd4, 0x2b, 0x31, 0x39, 0x20, 0x39, + 0xce, 0x5b, 0xaa, 0x6c, 0x56, 0x58, 0x36, 0x4b, 0x95, 0x5a, 0x97, 0xcd, 0xda, 0x25, 0x2e, 0xd5, + 0x81, 0x9d, 0x0b, 0x48, 0xf3, 0x07, 0x82, 0x64, 0x27, 0x9a, 0x5a, 0x8a, 0x0c, 0xe0, 0xa0, 0xf6, + 0x31, 0xa3, 0x93, 0x96, 0x9c, 0x13, 0xab, 0x4b, 0x5d, 0x64, 0x69, 0xf4, 0x58, 0xd1, 0xfa, 0x8c, + 0x07, 0xcd, 0x81, 0xf0, 0xb3, 0x86, 0x5c, 0xa2, 0x32, 0x97, 0x85, 0x9e, 0xb9, 0x28, 0x76, 0x0d, + 0xc9, 0x6c, 0xc0, 0xad, 0x36, 0xb9, 0x54, 0xaa, 0x82, 0x4f, 0xc1, 0x90, 0x74, 0x14, 0x6a, 0x1a, + 0x56, 0x35, 0xe6, 0x0c, 0xca, 0xfd, 0x4e, 0xde, 0x2c, 0xc3, 0x74, 0x7b, 0xa4, 0xd6, 0x60, 0x1f, + 0xc6, 0x9a, 0x34, 0xa8, 0xe8, 0xc6, 0xe8, 0x43, 0x01, 0x67, 0xb4, 0x31, 0xf7, 0x8a, 0xb9, 0x05, + 0xb3, 0x1d, 0xc2, 0x96, 0x0f, 0xc4, 0x25, 0x68, 0xe7, 0xc1, 0xec, 0x86, 0xd7, 0xe4, 0xb7, 0x20, + 0x1e, 0xc8, 0x13, 0x4d, 0x79, 0xbe, 0x0b, 0xe5, 0x8b, 0x78, 0x8d, 0x32, 0x77, 0x20, 0xf1, 0x2a, + 0x20, 0x3e, 0x27, 0xb2, 0xf9, 0xf0, 0x35, 0x88, 0xd6, 0x98, 0x44, 0xbd, 0x7c, 0xd8, 0xc7, 0x05, + 0xea, 0xb9, 0x05, 0x21, 0x4b, 0x17, 0x73, 0xf4, 0x0e, 0x63, 0x88, 0xe5, 0x89, 0x20, 0xb2, 0x39, + 0x47, 0x1c, 0xb9, 0x36, 0x37, 0xe1, 0x86, 0x8c, 0xf0, 0x82, 0x70, 0xe1, 0xd0, 0x22, 0x13, 0xf4, + 0xb9, 0x32, 0x6e, 0x69, 0x7a, 0xd4, 0xda, 0xf4, 0xe6, 0x4b, 0x3d, 0x52, 0xcd, 0xe8, 0x5a, 0xa6, + 0x75, 0x2a, 0xa8, 0x81, 0x8a, 0x01, 0x43, 0x01, 0x3d, 0xf2, 0x78, 0xb5, 0xbf, 0x62, 0x4e, 0x6d, + 0xbf, 0xfa, 0x7e, 0x10, 0xfe, 0x93, 0x5e, 0xf1, 0x47, 0x04, 0x71, 0x35, 0xcb, 0x38, 0xdd, 0x4b, + 0xa2, 0x86, 0x4b, 0xc4, 0xb0, 0x2e, 0x6b, 0xae, 0x78, 0x9a, 0x8b, 0xef, 0x7e, 0xfe, 0xfd, 0x14, + 0x9d, 0xc3, 0xb3, 0x76, 0xaf, 0xfb, 0x0d, 0x7f, 0x47, 0x30, 0xde, 0x32, 0x9b, 0x78, 0xa3, 0x77, + 0x09, 0xdb, 0xdf, 0x3a, 0xc6, 0xc3, 0x2b, 0x20, 0x35, 0xeb, 0x75, 0xc9, 0xda, 0xc6, 0xe9, 0x2e, + 0xac, 0x5b, 0x6f, 0x0a, 0xfc, 0x15, 0xc1, 0x68, 0x53, 0x83, 0xe2, 0xfb, 0xfd, 0xb1, 0xa8, 0x8e, + 0xb0, 0xf1, 0xa0, 0x6f, 0x9c, 0xe6, 0xbe, 0x26, 0xb9, 0xa7, 0xf1, 0xbd, 0xcb, 0x73, 0xaf, 0xe0, + 0x6f, 0x08, 0x12, 0x17, 0x06, 0x02, 0x6f, 0xf6, 0x1f, 0xbd, 0x3e, 0xc7, 0xc6, 0xe3, 0x2b, 0xa2, + 0x75, 0x06, 0xb6, 0xcc, 0x60, 0x11, 0x2f, 0xd8, 0x3d, 0x9e, 0xf7, 0x8c, 0x1a, 0x5b, 0xfc, 0x05, + 0xc1, 0x58, 0xcb, 0x9c, 0x2d, 0xf7, 0x22, 0xd1, 0x8c, 0x30, 0x36, 0xfa, 0x45, 0xd4, 0x18, 0x2f, + 0x4b, 0xc6, 0x4b, 0x38, 0xd5, 0x55, 0xf3, 0x10, 0x98, 0x51, 0x73, 0xba, 0xbd, 0x7f, 0x72, 0x96, + 0x44, 0xa7, 0x67, 0x49, 0xf4, 0xe7, 0x2c, 0x89, 0x3e, 0x9c, 0x27, 0x23, 0xa7, 0xe7, 0xc9, 0xc8, + 0xaf, 0xf3, 0x64, 0xe4, 0xcd, 0x23, 0xd7, 0x13, 0x85, 0x72, 0xd6, 0xca, 0xb1, 0x62, 0xd5, 0x5b, + 0x9a, 0x05, 0x6e, 0xcd, 0xf3, 0xd1, 0xba, 0x7d, 0xdc, 0xee, 0xf1, 0xaf, 0x94, 0x28, 0xcf, 0xc6, + 0xe5, 0x1f, 0x80, 0xb5, 0x7f, 0x01, 0x00, 0x00, 0xff, 0xff, 0x5b, 0xb6, 0x0a, 0x1f, 0x19, 0x09, + 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. @@ -668,16 +667,18 @@ const _ = grpc.SupportPackageIsVersion4 // // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type QueryClient interface { - // Queries the current parameters of the module. + // Fetches the current parameters of the interchainqueries module. Params(ctx context.Context, in *QueryParamsRequest, opts ...grpc.CallOption) (*QueryParamsResponse, error) - // Queries all the registered Interchain Queries in the module with filtration by owner and/or - // connection ID. + // Retrieves all registered Interchain Queries in the module, with optional filtering by owner + // and/or connection ID. RegisteredQueries(ctx context.Context, in *QueryRegisteredQueriesRequest, opts ...grpc.CallOption) (*QueryRegisteredQueriesResponse, error) - // Queries a registered Interchain Query by ID. + // Fetches details of a registered Interchain Query using its ID. RegisteredQuery(ctx context.Context, in *QueryRegisteredQueryRequest, opts ...grpc.CallOption) (*QueryRegisteredQueryResponse, error) - // Queries the last successfully submitted result of an Interchain Query. + // Retrieves the most recent successfully submitted result of an Interchain Query. This is only + // applicable for KV Interchain Queries. QueryResult(ctx context.Context, in *QueryRegisteredQueryResultRequest, opts ...grpc.CallOption) (*QueryRegisteredQueryResultResponse, error) - // Queries the last height of a remote chain known to the IBC client behind a given connection ID. + // Retrieves the most recent height of a remote chain as known by the IBC client associated with + // a given connection ID. LastRemoteHeight(ctx context.Context, in *QueryLastRemoteHeight, opts ...grpc.CallOption) (*QueryLastRemoteHeightResponse, error) } @@ -736,16 +737,18 @@ func (c *queryClient) LastRemoteHeight(ctx context.Context, in *QueryLastRemoteH // QueryServer is the server API for Query service. type QueryServer interface { - // Queries the current parameters of the module. + // Fetches the current parameters of the interchainqueries module. Params(context.Context, *QueryParamsRequest) (*QueryParamsResponse, error) - // Queries all the registered Interchain Queries in the module with filtration by owner and/or - // connection ID. + // Retrieves all registered Interchain Queries in the module, with optional filtering by owner + // and/or connection ID. RegisteredQueries(context.Context, *QueryRegisteredQueriesRequest) (*QueryRegisteredQueriesResponse, error) - // Queries a registered Interchain Query by ID. + // Fetches details of a registered Interchain Query using its ID. RegisteredQuery(context.Context, *QueryRegisteredQueryRequest) (*QueryRegisteredQueryResponse, error) - // Queries the last successfully submitted result of an Interchain Query. + // Retrieves the most recent successfully submitted result of an Interchain Query. This is only + // applicable for KV Interchain Queries. QueryResult(context.Context, *QueryRegisteredQueryResultRequest) (*QueryRegisteredQueryResultResponse, error) - // Queries the last height of a remote chain known to the IBC client behind a given connection ID. + // Retrieves the most recent height of a remote chain as known by the IBC client associated with + // a given connection ID. LastRemoteHeight(context.Context, *QueryLastRemoteHeight) (*QueryLastRemoteHeightResponse, error) } diff --git a/x/interchainqueries/types/tx.pb.go b/x/interchainqueries/types/tx.pb.go index 266884af2..49e731566 100644 --- a/x/interchainqueries/types/tx.pb.go +++ b/x/interchainqueries/types/tx.pb.go @@ -1018,26 +1018,28 @@ const _ = grpc.SupportPackageIsVersion4 // // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type MsgClient interface { - // Registers a new Interchain Query in the interchainqueries module. This message is supposed to - // be issued only by a smart contract. The caller contract is charged a query registration deposit - // automatically in the amount defined as the module's query deposit parameter. The deposit is - // paid back on the query removal. Make sure to have enough assets on the contract's account - // at the time of the message execution. + // Registers a new Interchain Query in the `interchainqueries` module. This message should only + // be issued by a smart contract. The calling contract is automatically charged a query + // registration deposit, based on the module's query deposit parameter. The deposit is refunded + // when the query is removed. Ensure the contract's account has sufficient assets at the time of + // message execution. // - // Returns an ID assigned to the registered query. Handle this message response via a reply - // handler in order to make use of the ID. + // The response includes the ID assigned to the registered query. Use a reply handler to process + // this response and utilize the query ID. RegisterInterchainQuery(ctx context.Context, in *MsgRegisterInterchainQuery, opts ...grpc.CallOption) (*MsgRegisterInterchainQueryResponse, error) - // Submits a result of an Interchain Query execution to the chain. This message handling may - // include passing of the result to the query's owner smart contract for processing which might - // be a pretty gas-consumable operation. + // Submits the result of an Interchain Query execution to the chain. Handling this message may + // involve forwarding the result to the smart contract that owns the query for processing, which + // could require significant gas usage. SubmitQueryResult(ctx context.Context, in *MsgSubmitQueryResult, opts ...grpc.CallOption) (*MsgSubmitQueryResultResponse, error) - // Removes a given Interchain Query and its results from the module. Can be removed only by the - // owner of the query during the query's submit timeout, and by anyone after the query has been - // timed out. The query deposit is returned to the caller on a success call. + // Removes a specific Interchain Query and its results from the module. The query can only be + // removed by its owner during the query's submit timeout. After the timeout, anyone can remove + // it. Upon successful removal, the query deposit is refunded to the caller. RemoveInterchainQuery(ctx context.Context, in *MsgRemoveInterchainQueryRequest, opts ...grpc.CallOption) (*MsgRemoveInterchainQueryResponse, error) - // Updates parameters of a registered Interchain Query. Only callable by the owner of the query. + // Updates the parameters of a registered Interchain Query. This action can only be performed by + // the query's owner. UpdateInterchainQuery(ctx context.Context, in *MsgUpdateInterchainQueryRequest, opts ...grpc.CallOption) (*MsgUpdateInterchainQueryResponse, error) - // Updates params of the interchainqueries module. Only callable by the module's authority. + // Updates the parameters of the `interchainqueries` module. This action can only be performed + // by the module's authority. UpdateParams(ctx context.Context, in *MsgUpdateParams, opts ...grpc.CallOption) (*MsgUpdateParamsResponse, error) } @@ -1096,26 +1098,28 @@ func (c *msgClient) UpdateParams(ctx context.Context, in *MsgUpdateParams, opts // MsgServer is the server API for Msg service. type MsgServer interface { - // Registers a new Interchain Query in the interchainqueries module. This message is supposed to - // be issued only by a smart contract. The caller contract is charged a query registration deposit - // automatically in the amount defined as the module's query deposit parameter. The deposit is - // paid back on the query removal. Make sure to have enough assets on the contract's account - // at the time of the message execution. + // Registers a new Interchain Query in the `interchainqueries` module. This message should only + // be issued by a smart contract. The calling contract is automatically charged a query + // registration deposit, based on the module's query deposit parameter. The deposit is refunded + // when the query is removed. Ensure the contract's account has sufficient assets at the time of + // message execution. // - // Returns an ID assigned to the registered query. Handle this message response via a reply - // handler in order to make use of the ID. + // The response includes the ID assigned to the registered query. Use a reply handler to process + // this response and utilize the query ID. RegisterInterchainQuery(context.Context, *MsgRegisterInterchainQuery) (*MsgRegisterInterchainQueryResponse, error) - // Submits a result of an Interchain Query execution to the chain. This message handling may - // include passing of the result to the query's owner smart contract for processing which might - // be a pretty gas-consumable operation. + // Submits the result of an Interchain Query execution to the chain. Handling this message may + // involve forwarding the result to the smart contract that owns the query for processing, which + // could require significant gas usage. SubmitQueryResult(context.Context, *MsgSubmitQueryResult) (*MsgSubmitQueryResultResponse, error) - // Removes a given Interchain Query and its results from the module. Can be removed only by the - // owner of the query during the query's submit timeout, and by anyone after the query has been - // timed out. The query deposit is returned to the caller on a success call. + // Removes a specific Interchain Query and its results from the module. The query can only be + // removed by its owner during the query's submit timeout. After the timeout, anyone can remove + // it. Upon successful removal, the query deposit is refunded to the caller. RemoveInterchainQuery(context.Context, *MsgRemoveInterchainQueryRequest) (*MsgRemoveInterchainQueryResponse, error) - // Updates parameters of a registered Interchain Query. Only callable by the owner of the query. + // Updates the parameters of a registered Interchain Query. This action can only be performed by + // the query's owner. UpdateInterchainQuery(context.Context, *MsgUpdateInterchainQueryRequest) (*MsgUpdateInterchainQueryResponse, error) - // Updates params of the interchainqueries module. Only callable by the module's authority. + // Updates the parameters of the `interchainqueries` module. This action can only be performed + // by the module's authority. UpdateParams(context.Context, *MsgUpdateParams) (*MsgUpdateParamsResponse, error) }