cosmos/slashing

Table of Contents

cosmos/slashing/v1beta1/query.proto

Top

QueryParamsRequest

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

QueryParamsResponse

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

FieldTypeLabelDescription
params Params

QuerySigningInfoRequest

QuerySigningInfoRequest is the request type for the Query/SigningInfo RPC

method

FieldTypeLabelDescription
cons_address string

cons_address is the address to query signing info of

QuerySigningInfoResponse

QuerySigningInfoResponse is the response type for the Query/SigningInfo RPC

method

FieldTypeLabelDescription
val_signing_info ValidatorSigningInfo

val_signing_info is the signing info of requested val cons address

QuerySigningInfosRequest

QuerySigningInfosRequest is the request type for the Query/SigningInfos RPC

method

FieldTypeLabelDescription
pagination cosmos.base.query.v1beta1.PageRequest

QuerySigningInfosResponse

QuerySigningInfosResponse is the response type for the Query/SigningInfos RPC

method

FieldTypeLabelDescription
info ValidatorSigningInfo repeated

info is the signing info of all validators

pagination cosmos.base.query.v1beta1.PageResponse

Query

Query provides defines the gRPC querier service

Method NameRequest TypeResponse TypeDescription
Params QueryParamsRequest QueryParamsResponse

Params queries the parameters of slashing module
SigningInfo QuerySigningInfoRequest QuerySigningInfoResponse

SigningInfo queries the signing info of given cons address
SigningInfos QuerySigningInfosRequest QuerySigningInfosResponse

SigningInfos queries signing info of all validators

Methods with HTTP bindings

Method Name Method Pattern Body
Params GET /cosmos/slashing/v1beta1/params
SigningInfo GET /cosmos/slashing/v1beta1/signing_infos/{cons_address}
SigningInfos GET /cosmos/slashing/v1beta1/signing_infos

cosmos/slashing/v1beta1/slashing.proto

Top

Params

Params represents the parameters used for by the slashing module.

FieldTypeLabelDescription
signed_blocks_window int64

min_signed_per_window bytes

downtime_jail_duration google.protobuf.Duration

slash_fraction_double_sign bytes

slash_fraction_downtime bytes

ValidatorSigningInfo

ValidatorSigningInfo defines a validator's signing info for monitoring their

liveness activity.

FieldTypeLabelDescription
address string

start_height int64

Height at which validator was first a candidate OR was unjailed

index_offset int64

Index which is incremented each time the validator was a bonded in a block and may have signed a precommit or not. This in conjunction with the `SignedBlocksWindow` param determines the index in the `MissedBlocksBitArray`.

jailed_until google.protobuf.Timestamp

Timestamp until which the validator is jailed due to liveness downtime.

tombstoned bool

Whether or not a validator has been tombstoned (killed out of validator set). It is set once the validator commits an equivocation or for any other configured misbehiavor.

missed_blocks_counter int64

A counter kept to avoid unnecessary array reads. Note that `Sum(MissedBlocksBitArray)` always equals `MissedBlocksCounter`.

cosmos/slashing/v1beta1/genesis.proto

Top

GenesisState

GenesisState defines the slashing module's genesis state.

FieldTypeLabelDescription
params Params

params defines all the paramaters of related to deposit.

signing_infos SigningInfo repeated

signing_infos represents a map between validator addresses and their signing infos.

missed_blocks ValidatorMissedBlocks repeated

missed_blocks represents a map between validator addresses and their missed blocks.

MissedBlock

MissedBlock contains height and missed status as boolean.

FieldTypeLabelDescription
index int64

index is the height at which the block was missed.

missed bool

missed is the missed status.

SigningInfo

SigningInfo stores validator signing info of corresponding address.

FieldTypeLabelDescription
address string

address is the validator address.

validator_signing_info ValidatorSigningInfo

validator_signing_info represents the signing info of this validator.

ValidatorMissedBlocks

ValidatorMissedBlocks contains array of missed blocks of corresponding

address.

FieldTypeLabelDescription
address string

address is the validator address.

missed_blocks MissedBlock repeated

missed_blocks is an array of missed blocks by the validator.

cosmos/slashing/v1beta1/tx.proto

Top

MsgUnjail

MsgUnjail defines the Msg/Unjail request type

FieldTypeLabelDescription
validator_addr string

MsgUnjailResponse

MsgUnjailResponse defines the Msg/Unjail response type

Msg

Msg defines the slashing Msg service.

Method NameRequest TypeResponse TypeDescription
Unjail MsgUnjail MsgUnjailResponse

Unjail defines a method for unjailing a jailed validator, thus returning them into the bonded validator set, so they can begin receiving provisions and rewards again.

Scalar Value Types

.proto Type Notes Python Type
double float
float float
int32 Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. int
int64 Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. int/long
uint32 Uses variable-length encoding. int/long
uint64 Uses variable-length encoding. int/long
sint32 Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. int
sint64 Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. int/long
fixed32 Always four bytes. More efficient than uint32 if values are often greater than 2^28. int
fixed64 Always eight bytes. More efficient than uint64 if values are often greater than 2^56. int/long
sfixed32 Always four bytes. int
sfixed64 Always eight bytes. int/long
bool boolean
string A string must always contain UTF-8 encoded or 7-bit ASCII text. str/unicode
bytes May contain any arbitrary sequence of bytes. str