Slashing

Generated from cosmos/cosmos-sdk@c1126e4e5460 on ref main.

Queries

A node exposes only the services its application registers:

gRPC on port 9090
REST on port 1317, if the method has an HTTP binding

Run grpcurl -plaintext localhost:9090 list to see what a node serves. Queries are read-only and never pass through consensus. See Queries. Replace <string> placeholders with real values and omit unused filters. Payloads use protobuf JSON, and some string fields accept enum constants listed under Types. Field tables give the encoding each value takes. Examples assume a local node. For TLS endpoints, use port 443 and omit -plaintext. See gRPC services for reflection, address formats, and decimal encoding.

Params

Params queries the parameters of slashing module


gRPC	`cosmos.slashing.v1beta1.Query/Params`
REST	`GET /cosmos/slashing/v1beta1/params`

Request QueryParamsRequest: This message has no fields. Response QueryParamsResponse:

Field	Type	Description
`params`	`Params`

grpcurl -plaintext localhost:9090 cosmos.slashing.v1beta1.Query/Params

SigningInfo

SigningInfo queries the signing info of given cons address


gRPC	`cosmos.slashing.v1beta1.Query/SigningInfo`
REST	`GET /cosmos/slashing/v1beta1/signing_infos/{consAddress}`

Request QuerySigningInfoRequest:

Field	Type	Description
`cons_address`	`string`	cons_address is the address to query signing info of Encoded as cosmos.ConsensusAddressString.

Response QuerySigningInfoResponse:

Field	Type	Description
`val_signing_info`	`ValidatorSigningInfo`	val_signing_info is the signing info of requested val cons address

grpcurl -plaintext -d '{"cons_address":"<string>"}' \
  localhost:9090 cosmos.slashing.v1beta1.Query/SigningInfo

SigningInfos

SigningInfos queries signing info of all validators


gRPC	`cosmos.slashing.v1beta1.Query/SigningInfos`
REST	`GET /cosmos/slashing/v1beta1/signing_infos`

Request QuerySigningInfosRequest:

Field	Type	Description
`pagination`	`PageRequest`

Response QuerySigningInfosResponse:

Field	Type	Description
`info`	`ValidatorSigningInfo`[]	info is the signing info of all validators
`pagination`	`PageResponse`

grpcurl -plaintext -d '{"pagination":{"limit":"1"}}' \
  localhost:9090 cosmos.slashing.v1beta1.Query/SigningInfos

Transaction messages

These messages are included in signed transactions, not called as endpoints. See Transactions for the execution model, and Sending transactions for the envelope they go into. Examples use CLI transaction JSON. Decimal fields use values such as "0.05", even when their proto type is bytes. The gRPC TxEncode method instead requires the scaled value "50000000000000000". See scalar encodings.

Handler: Generated client method
Signer: Account that must sign
Amino name: Legacy identifier used by hardware wallets and other Amino signers

Unjail

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.


Type URL	`/cosmos.slashing.v1beta1.MsgUnjail`
Handler	`cosmos.slashing.v1beta1.Msg/Unjail`
Signer	`validator_addr`
Amino name	`cosmos-sdk/MsgUnjail`

Field	Type	Description
`validator_addr`	`string`	Encoded as cosmos.ValidatorAddressString.

In a transaction:

{
  "@type": "/cosmos.slashing.v1beta1.MsgUnjail",
  "validator_addr": "<string>"
}

Response MsgUnjailResponse: This message has no fields.

UpdateParams

UpdateParams defines a governance operation for updating the x/slashing module parameters. The authority defaults to the x/gov module account.


Type URL	`/cosmos.slashing.v1beta1.MsgUpdateParams`
Handler	`cosmos.slashing.v1beta1.Msg/UpdateParams`
Signer	`authority`
Amino name	`cosmos-sdk/x/slashing/MsgUpdateParams`

The signer is the governance module account, which no user holds a key for. This message executes only through a passed governance proposal, not as a transaction you submit directly.

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

In a transaction:

{
  "@type": "/cosmos.slashing.v1beta1.MsgUpdateParams",
  "authority": "<string>",
  "params": {
    "signed_blocks_window": "1",
    "min_signed_per_window": "0.05",
    "downtime_jail_duration": "0s",
    "slash_fraction_double_sign": "0.05",
    "slash_fraction_downtime": "0.05"
  }
}

Response MsgUpdateParamsResponse: This message has no fields.

Types

Messages referenced by the fields above. Protocol buffers version 3 has no required fields, so every field is optional on the wire, and a [] suffix marks a repeated field.

cosmos.base.query.v1beta1.PageRequest

PageRequest is to be embedded in gRPC request messages for efficient pagination. Ex: message SomeRequest { Foo some_parameter = 1; PageRequest pagination = 2; }

Field	Type	Description
`key`	`bytes`	key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.
`offset`	`uint64`	offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.
`limit`	`uint64`	limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.
`count_total`	`bool`	count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.
`reverse`	`bool`	reverse is set to true if results are to be returned in the descending order.

cosmos.base.query.v1beta1.PageResponse

PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }

Field	Type	Description
`next_key`	`bytes`	next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
`total`	`uint64`	total is total number of results available if PageRequest.count_total was set, its value is undefined otherwise

cosmos.slashing.v1beta1.Params

Params represents the parameters used for by the slashing module.

Field	Type	Description
`signed_blocks_window`	`int64`
`min_signed_per_window`	`bytes`	Encoded as cosmos.Dec, read back as base64 of an integer string scaled by 10^18 over gRPC.
`downtime_jail_duration`	`Duration`
`slash_fraction_double_sign`	`bytes`	Encoded as cosmos.Dec, read back as base64 of an integer string scaled by 10^18 over gRPC.
`slash_fraction_downtime`	`bytes`	Encoded as cosmos.Dec, read back as base64 of an integer string scaled by 10^18 over gRPC.

cosmos.slashing.v1beta1.ValidatorSigningInfo

ValidatorSigningInfo defines a validator’s signing info for monitoring their liveness activity.

Field	Type	Description
`address`	`string`	Encoded as cosmos.ConsensusAddressString.
`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`	`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.

Overview

gRPC Services

REST (gRPC Gateway)

Queries

Params

SigningInfo

SigningInfos

Transaction messages

Unjail

UpdateParams

Types

cosmos.base.query.v1beta1.PageRequest

cosmos.base.query.v1beta1.PageResponse

cosmos.slashing.v1beta1.Params

cosmos.slashing.v1beta1.ValidatorSigningInfo

​Queries

​Params

​SigningInfo

​SigningInfos

​Transaction messages

​Unjail

​UpdateParams

​Types

​cosmos.base.query.v1beta1.PageRequest

​cosmos.base.query.v1beta1.PageResponse

​cosmos.slashing.v1beta1.Params

​cosmos.slashing.v1beta1.ValidatorSigningInfo

Queries

Params

SigningInfo

SigningInfos

Transaction messages

Unjail

UpdateParams

Types

cosmos.base.query.v1beta1.PageRequest

cosmos.base.query.v1beta1.PageResponse

cosmos.slashing.v1beta1.Params

cosmos.slashing.v1beta1.ValidatorSigningInfo