Skip to main content
logo
BlogForum

slashing

The slashing module is responsible for validator punishment mechanisms, or disincentivizing any attributable action by a protocol-recognized actor with value at stake by penalizing them ("slashing"). Penalties may include, but are not limited to:

  • burning some amount of their stake
  • removing their ability to vote on future blocks for a period of time

For more information, visit https://docs.cosmos.network/main/modules/slashing/

Message Types​

Msg defines the slashing Msg service.

tx.proto
Copy

_6
service Msg {
_6
// Unjail defines a method for unjailing a jailed validator, thus returning
_6
// them into the bonded validator set, so they can begin receiving provisions
_6
// and rewards again.
_6
rpc Unjail(MsgUnjail) returns (MsgUnjailResponse);
_6
}

MsgUnjail​

MsgUnjail defines the Msg/Unjail request type.

tx.proto
Copy

_8
message MsgUnjail {
_8
option (cosmos.msg.v1.signer) = "validator_addr";
_8
_8
option (gogoproto.goproto_getters) = false;
_8
option (gogoproto.goproto_stringer) = true;
_8
_8
string validator_addr = 1 [(cosmos_proto.scalar) = "cosmos.AddressString", (gogoproto.jsontag) = "address"];
_8
}

MsgUnjailResponse​

MsgUnjailResponse defines the Msg/Unjail response type.

tx.proto
Copy

_1
message MsgUnjailResponse {}

Queries​

Query provides defines the gRPC querier service.

query.proto
Copy

_16
service Query {
_16
// Params queries the parameters of slashing module
_16
rpc Params(QueryParamsRequest) returns (QueryParamsResponse) {
_16
option (google.api.http).get = "/cosmos/slashing/v1beta1/params";
_16
}
_16
_16
// SigningInfo queries the signing info of given cons address
_16
rpc SigningInfo(QuerySigningInfoRequest) returns (QuerySigningInfoResponse) {
_16
option (google.api.http).get = "/cosmos/slashing/v1beta1/signing_infos/{cons_address}";
_16
}
_16
_16
// SigningInfos queries signing info of all validators
_16
rpc SigningInfos(QuerySigningInfosRequest) returns (QuerySigningInfosResponse) {
_16
option (google.api.http).get = "/cosmos/slashing/v1beta1/signing_infos";
_16
}
_16
}

QueryParamsRequest​

QueryParamsRequest is the request type for the Query/Params RPC method.

query.proto
Copy

_1
message QueryParamsRequest {}

QueryParamsResponse​

QueryParamsResponse is the response type for the Query/Params RPC method.

query.proto
Copy

_3
message QueryParamsResponse {
_3
Params params = 1 [(gogoproto.nullable) = false];
_3
}

QuerySigningInfoRequest​

QuerySigningInfoRequest is the request type for the Query/SigningInfo RPC method.

query.proto
Copy

_4
message QuerySigningInfoRequest {
_4
// cons_address is the address to query signing info of
_4
string cons_address = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
_4
}

QuerySigningInfoResponse​

QuerySigningInfoResponse is the response type for the Query/SigningInfo RPC method.

query.proto
Copy

_4
message QuerySigningInfoResponse {
_4
// val_signing_info is the signing info of requested val cons address
_4
ValidatorSigningInfo val_signing_info = 1 [(gogoproto.nullable) = false];
_4
}

QuerySigningInfosRequest​

QuerySigningInfosRequest is the request type for the Query/SigningInfos RPC method.

query.proto
Copy

_3
message QuerySigningInfosRequest {
_3
cosmos.base.query.v1beta1.PageRequest pagination = 1;
_3
}

QuerySigningInfosResponse​

QuerySigningInfosResponse is the response type for the Query/SigningInfos RPC method.

query.proto
Copy

_5
message QuerySigningInfosResponse {
_5
// info is the signing info of all validators
_5
repeated cosmos.slashing.v1beta1.ValidatorSigningInfo info = 1 [(gogoproto.nullable) = false];
_5
cosmos.base.query.v1beta1.PageResponse pagination = 2;
_5
}