cosmos/slashing

Table of Contents

• cosmos/slashing/module/v1/module.proto
  • MModule
• cosmos/slashing/v1beta1/genesis.proto
  • MGenesisState
  • MMissedBlock
  • MSigningInfo
  • MValidatorMissedBlocks
• cosmos/slashing/v1beta1/query.proto
  • MQueryParamsRequest
  • MQueryParamsResponse
  • MQuerySigningInfoRequest
  • MQuerySigningInfoResponse
  • MQuerySigningInfosRequest
  • MQuerySigningInfosResponse
  • SQuery
• cosmos/slashing/v1beta1/slashing.proto
  • MParams
  • MValidatorSigningInfo
• cosmos/slashing/v1beta1/tx.proto
  • MMsgUnjail
  • MMsgUnjailResponse
  • MMsgUpdateParams
  • MMsgUpdateParamsResponse
  • SMsg
• Scalar Value Types

cosmos/slashing/module/v1/module.proto

Top

Module

Module is the config object of the slashing module.

Field	Type	Label	Description
authority	string		authority defines the custom module authority. If not set, defaults to the governance module.

cosmos/slashing/v1beta1/genesis.proto

Top

GenesisState

GenesisState defines the slashing module's genesis state.

Field	Type	Label	Description
params	Params		params defines all the parameters of the module.
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.

Field	Type	Label	Description
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.

Field	Type	Label	Description
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.

Field	Type	Label	Description
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/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

Field	Type	Label	Description
params	Params

QuerySigningInfoRequest

QuerySigningInfoRequest is the request type for the Query/SigningInfo RPC

method

Field	Type	Label	Description
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

Field	Type	Label	Description
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

Field	Type	Label	Description
pagination	cosmos.base.query.v1beta1.PageRequest

QuerySigningInfosResponse

QuerySigningInfosResponse is the response type for the Query/SigningInfos RPC

method

Field	Type	Label	Description
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 Name	Request Type	Response Type	Description
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.

Field	Type	Label	Description
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.

Field	Type	Label	Description
address	string
start_height	int64		Height at which validator was first a candidate OR was un-jailed
index_offset	int64		Index which is incremented every time a validator is bonded in a block and _may_ have signed a pre-commit or not. This in conjunction with the signed_blocks_window param determines the index in the missed block bitmap.
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 misbehavior.
missed_blocks_counter	int64		A counter of missed (unsigned) blocks. It is used to avoid unnecessary reads in the missed block bitmap.

cosmos/slashing/v1beta1/tx.proto

Top

MsgUnjail

MsgUnjail defines the Msg/Unjail request type

Field	Type	Label	Description
validator_addr	string

MsgUnjailResponse

MsgUnjailResponse defines the Msg/Unjail response type

MsgUpdateParams

MsgUpdateParams is the Msg/UpdateParams request type.

Since: cosmos-sdk 0.47

Field	Type	Label	Description
authority	string		authority is the address that controls the module (defaults to x/gov unless overwritten).
params	Params		params defines the x/slashing parameters to update. NOTE: All parameters must be supplied.

MsgUpdateParamsResponse

MsgUpdateParamsResponse defines the response structure for executing a

MsgUpdateParams message.

Since: cosmos-sdk 0.47

Msg

Msg defines the slashing Msg service.

Method Name	Request Type	Response Type	Description
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.
UpdateParams	MsgUpdateParams	MsgUpdateParamsResponse	UpdateParams defines a governance operation for updating the x/slashing module parameters. The authority defaults to the x/gov module account. Since: cosmos-sdk 0.47

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