github.com/Finschia/finschia-sdk@v0.48.1/proto/cosmos/staking/v1beta1/query.proto (about)

     1  syntax = "proto3";
     2  package cosmos.staking.v1beta1;
     3  
     4  import "cosmos/base/query/v1beta1/pagination.proto";
     5  import "gogoproto/gogo.proto";
     6  import "google/api/annotations.proto";
     7  import "cosmos/staking/v1beta1/staking.proto";
     8  
     9  option go_package = "github.com/Finschia/finschia-sdk/x/staking/types";
    10  
    11  // Query defines the gRPC querier service.
    12  service Query {
    13    // Validators queries all validators that match the given status.
    14    rpc Validators(QueryValidatorsRequest) returns (QueryValidatorsResponse) {
    15      option (google.api.http).get = "/cosmos/staking/v1beta1/validators";
    16    }
    17  
    18    // Validator queries validator info for given validator address.
    19    rpc Validator(QueryValidatorRequest) returns (QueryValidatorResponse) {
    20      option (google.api.http).get = "/cosmos/staking/v1beta1/validators/{validator_addr}";
    21    }
    22  
    23    // ValidatorDelegations queries delegate info for given validator.
    24    rpc ValidatorDelegations(QueryValidatorDelegationsRequest) returns (QueryValidatorDelegationsResponse) {
    25      option (google.api.http).get = "/cosmos/staking/v1beta1/validators/{validator_addr}/delegations";
    26    }
    27  
    28    // ValidatorUnbondingDelegations queries unbonding delegations of a validator.
    29    rpc ValidatorUnbondingDelegations(QueryValidatorUnbondingDelegationsRequest)
    30        returns (QueryValidatorUnbondingDelegationsResponse) {
    31      option (google.api.http).get = "/cosmos/staking/v1beta1/validators/"
    32                                     "{validator_addr}/unbonding_delegations";
    33    }
    34  
    35    // Delegation queries delegate info for given validator delegator pair.
    36    rpc Delegation(QueryDelegationRequest) returns (QueryDelegationResponse) {
    37      option (google.api.http).get = "/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/"
    38                                     "{delegator_addr}";
    39    }
    40  
    41    // UnbondingDelegation queries unbonding info for given validator delegator
    42    // pair.
    43    rpc UnbondingDelegation(QueryUnbondingDelegationRequest) returns (QueryUnbondingDelegationResponse) {
    44      option (google.api.http).get = "/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/"
    45                                     "{delegator_addr}/unbonding_delegation";
    46    }
    47  
    48    // DelegatorDelegations queries all delegations of a given delegator address.
    49    rpc DelegatorDelegations(QueryDelegatorDelegationsRequest) returns (QueryDelegatorDelegationsResponse) {
    50      option (google.api.http).get = "/cosmos/staking/v1beta1/delegations/{delegator_addr}";
    51    }
    52  
    53    // DelegatorUnbondingDelegations queries all unbonding delegations of a given
    54    // delegator address.
    55    rpc DelegatorUnbondingDelegations(QueryDelegatorUnbondingDelegationsRequest)
    56        returns (QueryDelegatorUnbondingDelegationsResponse) {
    57      option (google.api.http).get = "/cosmos/staking/v1beta1/delegators/"
    58                                     "{delegator_addr}/unbonding_delegations";
    59    }
    60  
    61    // Redelegations queries redelegations of given address.
    62    rpc Redelegations(QueryRedelegationsRequest) returns (QueryRedelegationsResponse) {
    63      option (google.api.http).get = "/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations";
    64    }
    65  
    66    // DelegatorValidators queries all validators info for given delegator
    67    // address.
    68    rpc DelegatorValidators(QueryDelegatorValidatorsRequest) returns (QueryDelegatorValidatorsResponse) {
    69      option (google.api.http).get = "/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators";
    70    }
    71  
    72    // DelegatorValidator queries validator info for given delegator validator
    73    // pair.
    74    rpc DelegatorValidator(QueryDelegatorValidatorRequest) returns (QueryDelegatorValidatorResponse) {
    75      option (google.api.http).get = "/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/"
    76                                     "{validator_addr}";
    77    }
    78  
    79    // HistoricalInfo queries the historical info for given height.
    80    rpc HistoricalInfo(QueryHistoricalInfoRequest) returns (QueryHistoricalInfoResponse) {
    81      option (google.api.http).get = "/cosmos/staking/v1beta1/historical_info/{height}";
    82    }
    83  
    84    // Pool queries the pool info.
    85    rpc Pool(QueryPoolRequest) returns (QueryPoolResponse) {
    86      option (google.api.http).get = "/cosmos/staking/v1beta1/pool";
    87    }
    88  
    89    // Parameters queries the staking parameters.
    90    rpc Params(QueryParamsRequest) returns (QueryParamsResponse) {
    91      option (google.api.http).get = "/cosmos/staking/v1beta1/params";
    92    }
    93  }
    94  
    95  // QueryValidatorsRequest is request type for Query/Validators RPC method.
    96  message QueryValidatorsRequest {
    97    // status enables to query for validators matching a given status.
    98    string status = 1;
    99  
   100    // pagination defines an optional pagination for the request.
   101    cosmos.base.query.v1beta1.PageRequest pagination = 2;
   102  }
   103  
   104  // QueryValidatorsResponse is response type for the Query/Validators RPC method
   105  message QueryValidatorsResponse {
   106    // validators contains all the queried validators.
   107    repeated Validator validators = 1 [(gogoproto.nullable) = false];
   108  
   109    // pagination defines the pagination in the response.
   110    cosmos.base.query.v1beta1.PageResponse pagination = 2;
   111  }
   112  
   113  // QueryValidatorRequest is response type for the Query/Validator RPC method
   114  message QueryValidatorRequest {
   115    // validator_addr defines the validator address to query for.
   116    string validator_addr = 1;
   117  }
   118  
   119  // QueryValidatorResponse is response type for the Query/Validator RPC method
   120  message QueryValidatorResponse {
   121    // validator defines the the validator info.
   122    Validator validator = 1 [(gogoproto.nullable) = false];
   123  }
   124  
   125  // QueryValidatorDelegationsRequest is request type for the
   126  // Query/ValidatorDelegations RPC method
   127  message QueryValidatorDelegationsRequest {
   128    // validator_addr defines the validator address to query for.
   129    string validator_addr = 1;
   130  
   131    // pagination defines an optional pagination for the request.
   132    cosmos.base.query.v1beta1.PageRequest pagination = 2;
   133  }
   134  
   135  // QueryValidatorDelegationsResponse is response type for the
   136  // Query/ValidatorDelegations RPC method
   137  message QueryValidatorDelegationsResponse {
   138    repeated DelegationResponse delegation_responses = 1
   139        [(gogoproto.nullable) = false, (gogoproto.castrepeated) = "DelegationResponses"];
   140  
   141    // pagination defines the pagination in the response.
   142    cosmos.base.query.v1beta1.PageResponse pagination = 2;
   143  }
   144  
   145  // QueryValidatorUnbondingDelegationsRequest is required type for the
   146  // Query/ValidatorUnbondingDelegations RPC method
   147  message QueryValidatorUnbondingDelegationsRequest {
   148    // validator_addr defines the validator address to query for.
   149    string validator_addr = 1;
   150  
   151    // pagination defines an optional pagination for the request.
   152    cosmos.base.query.v1beta1.PageRequest pagination = 2;
   153  }
   154  
   155  // QueryValidatorUnbondingDelegationsResponse is response type for the
   156  // Query/ValidatorUnbondingDelegations RPC method.
   157  message QueryValidatorUnbondingDelegationsResponse {
   158    repeated UnbondingDelegation unbonding_responses = 1 [(gogoproto.nullable) = false];
   159  
   160    // pagination defines the pagination in the response.
   161    cosmos.base.query.v1beta1.PageResponse pagination = 2;
   162  }
   163  
   164  // QueryDelegationRequest is request type for the Query/Delegation RPC method.
   165  message QueryDelegationRequest {
   166    option (gogoproto.equal)           = false;
   167    option (gogoproto.goproto_getters) = false;
   168  
   169    // delegator_addr defines the delegator address to query for.
   170    string delegator_addr = 1;
   171  
   172    // validator_addr defines the validator address to query for.
   173    string validator_addr = 2;
   174  }
   175  
   176  // QueryDelegationResponse is response type for the Query/Delegation RPC method.
   177  message QueryDelegationResponse {
   178    // delegation_responses defines the delegation info of a delegation.
   179    DelegationResponse delegation_response = 1;
   180  }
   181  
   182  // QueryUnbondingDelegationRequest is request type for the
   183  // Query/UnbondingDelegation RPC method.
   184  message QueryUnbondingDelegationRequest {
   185    option (gogoproto.equal)           = false;
   186    option (gogoproto.goproto_getters) = false;
   187  
   188    // delegator_addr defines the delegator address to query for.
   189    string delegator_addr = 1;
   190  
   191    // validator_addr defines the validator address to query for.
   192    string validator_addr = 2;
   193  }
   194  
   195  // QueryDelegationResponse is response type for the Query/UnbondingDelegation
   196  // RPC method.
   197  message QueryUnbondingDelegationResponse {
   198    // unbond defines the unbonding information of a delegation.
   199    UnbondingDelegation unbond = 1 [(gogoproto.nullable) = false];
   200  }
   201  
   202  // QueryDelegatorDelegationsRequest is request type for the
   203  // Query/DelegatorDelegations RPC method.
   204  message QueryDelegatorDelegationsRequest {
   205    option (gogoproto.equal)           = false;
   206    option (gogoproto.goproto_getters) = false;
   207  
   208    // delegator_addr defines the delegator address to query for.
   209    string delegator_addr = 1;
   210  
   211    // pagination defines an optional pagination for the request.
   212    cosmos.base.query.v1beta1.PageRequest pagination = 2;
   213  }
   214  
   215  // QueryDelegatorDelegationsResponse is response type for the
   216  // Query/DelegatorDelegations RPC method.
   217  message QueryDelegatorDelegationsResponse {
   218    // delegation_responses defines all the delegations' info of a delegator.
   219    repeated DelegationResponse delegation_responses = 1 [(gogoproto.nullable) = false];
   220  
   221    // pagination defines the pagination in the response.
   222    cosmos.base.query.v1beta1.PageResponse pagination = 2;
   223  }
   224  
   225  // QueryDelegatorUnbondingDelegationsRequest is request type for the
   226  // Query/DelegatorUnbondingDelegations RPC method.
   227  message QueryDelegatorUnbondingDelegationsRequest {
   228    option (gogoproto.equal)           = false;
   229    option (gogoproto.goproto_getters) = false;
   230  
   231    // delegator_addr defines the delegator address to query for.
   232    string delegator_addr = 1;
   233  
   234    // pagination defines an optional pagination for the request.
   235    cosmos.base.query.v1beta1.PageRequest pagination = 2;
   236  }
   237  
   238  // QueryUnbondingDelegatorDelegationsResponse is response type for the
   239  // Query/UnbondingDelegatorDelegations RPC method.
   240  message QueryDelegatorUnbondingDelegationsResponse {
   241    repeated UnbondingDelegation unbonding_responses = 1 [(gogoproto.nullable) = false];
   242  
   243    // pagination defines the pagination in the response.
   244    cosmos.base.query.v1beta1.PageResponse pagination = 2;
   245  }
   246  
   247  // QueryRedelegationsRequest is request type for the Query/Redelegations RPC
   248  // method.
   249  message QueryRedelegationsRequest {
   250    option (gogoproto.equal)           = false;
   251    option (gogoproto.goproto_getters) = false;
   252  
   253    // delegator_addr defines the delegator address to query for.
   254    string delegator_addr = 1;
   255  
   256    // src_validator_addr defines the validator address to redelegate from.
   257    string src_validator_addr = 2;
   258  
   259    // dst_validator_addr defines the validator address to redelegate to.
   260    string dst_validator_addr = 3;
   261  
   262    // pagination defines an optional pagination for the request.
   263    cosmos.base.query.v1beta1.PageRequest pagination = 4;
   264  }
   265  
   266  // QueryRedelegationsResponse is response type for the Query/Redelegations RPC
   267  // method.
   268  message QueryRedelegationsResponse {
   269    repeated RedelegationResponse redelegation_responses = 1 [(gogoproto.nullable) = false];
   270  
   271    // pagination defines the pagination in the response.
   272    cosmos.base.query.v1beta1.PageResponse pagination = 2;
   273  }
   274  
   275  // QueryDelegatorValidatorsRequest is request type for the
   276  // Query/DelegatorValidators RPC method.
   277  message QueryDelegatorValidatorsRequest {
   278    option (gogoproto.equal)           = false;
   279    option (gogoproto.goproto_getters) = false;
   280  
   281    // delegator_addr defines the delegator address to query for.
   282    string delegator_addr = 1;
   283  
   284    // pagination defines an optional pagination for the request.
   285    cosmos.base.query.v1beta1.PageRequest pagination = 2;
   286  }
   287  
   288  // QueryDelegatorValidatorsResponse is response type for the
   289  // Query/DelegatorValidators RPC method.
   290  message QueryDelegatorValidatorsResponse {
   291    // validators defines the the validators' info of a delegator.
   292    repeated Validator validators = 1 [(gogoproto.nullable) = false];
   293  
   294    // pagination defines the pagination in the response.
   295    cosmos.base.query.v1beta1.PageResponse pagination = 2;
   296  }
   297  
   298  // QueryDelegatorValidatorRequest is request type for the
   299  // Query/DelegatorValidator RPC method.
   300  message QueryDelegatorValidatorRequest {
   301    option (gogoproto.equal)           = false;
   302    option (gogoproto.goproto_getters) = false;
   303  
   304    // delegator_addr defines the delegator address to query for.
   305    string delegator_addr = 1;
   306  
   307    // validator_addr defines the validator address to query for.
   308    string validator_addr = 2;
   309  }
   310  
   311  // QueryDelegatorValidatorResponse response type for the
   312  // Query/DelegatorValidator RPC method.
   313  message QueryDelegatorValidatorResponse {
   314    // validator defines the the validator info.
   315    Validator validator = 1 [(gogoproto.nullable) = false];
   316  }
   317  
   318  // QueryHistoricalInfoRequest is request type for the Query/HistoricalInfo RPC
   319  // method.
   320  message QueryHistoricalInfoRequest {
   321    // height defines at which height to query the historical info.
   322    int64 height = 1;
   323  }
   324  
   325  // QueryHistoricalInfoResponse is response type for the Query/HistoricalInfo RPC
   326  // method.
   327  message QueryHistoricalInfoResponse {
   328    // hist defines the historical info at the given height.
   329    HistoricalInfo hist = 1;
   330  }
   331  
   332  // QueryPoolRequest is request type for the Query/Pool RPC method.
   333  message QueryPoolRequest {}
   334  
   335  // QueryPoolResponse is response type for the Query/Pool RPC method.
   336  message QueryPoolResponse {
   337    // pool defines the pool info.
   338    Pool pool = 1 [(gogoproto.nullable) = false];
   339  }
   340  
   341  // QueryParamsRequest is request type for the Query/Params RPC method.
   342  message QueryParamsRequest {}
   343  
   344  // QueryParamsResponse is response type for the Query/Params RPC method.
   345  message QueryParamsResponse {
   346    // params holds all the parameters of this module.
   347    Params params = 1 [(gogoproto.nullable) = false];
   348  }