slashing

package
v0.1.9 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 12, 2023 License: MPL-2.0 Imports: 36 Imported by: 3

Documentation

Overview

nolint

Index

Constants

View Source 
const (
	MsgRoute                 = "slashing"
	TypeMsgUnjail            = "unjail"
	TypeMsgSideChainUnjail   = "side_chain_unjail"
	TypeMsgAscSubmitEvidence = "asc_submit_evidence"
)

name to identify transaction types

View Source 
const (
	QueryConsAddrSlashRecords     = "consAddrSlashHistories"
	QueryConsAddrTypeSlashRecords = "consAddrTypeSlashHistories"
)
View Source 
const (
	DoubleSign byte = iota
	Downtime
)
View Source 
const ChannelId = types.ChannelID(11)
View Source 
const ChannelName = "slashing"
View Source 
const (
	DefaultParamspace = "slashing"
)

Default parameter namespace

View Source 
const Topic = pubsub.Topic("slashing")

Variables

View Source 
var (
	SideChainIdAsc    = big.NewInt(56)
	SideChainIdChapel = big.NewInt(97)
	SideChainIdRialto = big.NewInt(714)
)
View Source 
var (
	ValidatorSigningInfoKey         = []byte{0x01} // Prefix for signing info
	ValidatorMissedBlockBitArrayKey = []byte{0x02} // Prefix for missed block bit array
	ValidatorSlashingPeriodKey      = []byte{0x03} // Prefix for slashing period
	AddrPubkeyRelationKey           = []byte{0x04} // Prefix for address-pubkey relation
	SlashRecordKey                  = []byte{0x05} // Prefix for slash record
)

key prefix bytes

View Source 
var (
	KeyMaxEvidenceAge           = []byte("MaxEvidenceAge")
	KeySignedBlocksWindow       = []byte("SignedBlocksWindow")
	KeyMinSignedPerWindow       = []byte("MinSignedPerWindow")
	KeyDoubleSignUnbondDuration = []byte("DoubleSignUnbondDuration")
	KeyDowntimeUnbondDuration   = []byte("DowntimeUnbondDuration")
	KeyTooLowDelUnbondDuration  = []byte("TooLowDelUnbondDuration")
	KeySlashFractionDoubleSign  = []byte("SlashFractionDoubleSign")
	KeySlashFractionDowntime    = []byte("SlashFractionDowntime")
	KeyDoubleSignSlashAmount    = []byte("DoubleSignSlashAmount")
	KeyDowntimeSlashAmount      = []byte("DowntimeSlashAmount")
	KeySubmitterReward          = []byte("SubmitterReward")
	KeyDowntimeSlashFee         = []byte("DowntimeSlashFee")
)

Parameter store key

View Source 
var MsgCdc *codec.Codec

generic sealed codec to be used throughout sdk

Functions

func BeginBlocker 

func BeginBlocker(ctx sdk.Context, req abci.RequestBeginBlock, sk Keeper) (tags sdk.Tags)

slashing begin block functionality

func ErrBadValidatorAddr 

func ErrBadValidatorAddr(codespace sdk.CodespaceType) sdk.Error

func ErrDuplicateDowntimeClaim 

func ErrDuplicateDowntimeClaim(codespace sdk.CodespaceType) sdk.Error

func ErrEvidenceHasBeenHandled 

func ErrEvidenceHasBeenHandled(codespace sdk.CodespaceType) sdk.Error

func ErrExpiredEvidence 

func ErrExpiredEvidence(codespace sdk.CodespaceType) sdk.Error

func ErrFailedToSlash 

func ErrFailedToSlash(codespace sdk.CodespaceType, msg string) sdk.Error

func ErrInvalidClaim 

func ErrInvalidClaim(codespace sdk.CodespaceType, msg string) sdk.Error

func ErrInvalidEvidence 

func ErrInvalidEvidence(codespace sdk.CodespaceType, msg string) sdk.Error

func ErrInvalidInput 

func ErrInvalidInput(codespace sdk.CodespaceType, msg string) sdk.Error

func ErrInvalidSideChainId 

func ErrInvalidSideChainId(codespace sdk.CodespaceType) sdk.Error

func ErrMissingSelfDelegation 

func ErrMissingSelfDelegation(codespace sdk.CodespaceType) sdk.Error

func ErrNoValidatorForAddress 

func ErrNoValidatorForAddress(codespace sdk.CodespaceType) sdk.Error

func ErrSelfDelegationTooLowToUnjail 

func ErrSelfDelegationTooLowToUnjail(codespace sdk.CodespaceType) sdk.Error

func ErrValidatorJailed 

func ErrValidatorJailed(codespace sdk.CodespaceType) sdk.Error

func ErrValidatorNotJailed 

func ErrValidatorNotJailed(codespace sdk.CodespaceType) sdk.Error

func GetSlashRecordKey 

func GetSlashRecordKey(consAddr []byte, infractionType byte, infractionHeight uint64) []byte

func GetSlashRecordsByAddrAndTypeIndexKey 

func GetSlashRecordsByAddrAndTypeIndexKey(sideConsAddr []byte, infractionType byte) []byte

func GetSlashRecordsByAddrIndexKey 

func GetSlashRecordsByAddrIndexKey(sideConsAddr []byte) []byte

func GetValidatorMissedBlockBitArrayKey 

func GetValidatorMissedBlockBitArrayKey(v sdk.ConsAddress, i int64) []byte

stored by *Tendermint* address (not operator address)

func GetValidatorMissedBlockBitArrayPrefixKey 

func GetValidatorMissedBlockBitArrayPrefixKey(v sdk.ConsAddress) []byte

stored by *Tendermint* address (not operator address)

func GetValidatorSigningInfoKey 

func GetValidatorSigningInfoKey(consAddr []byte) []byte

stored by *Tendermint* address (not operator address)

func GetValidatorSlashingPeriodKey 

func GetValidatorSlashingPeriodKey(v sdk.ConsAddress, startHeight int64) []byte

stored by *Tendermint* address (not operator address) followed by start height

func GetValidatorSlashingPeriodPrefix 

func GetValidatorSlashingPeriodPrefix(v sdk.ConsAddress) []byte

stored by *Tendermint* address (not operator address)

func InitGenesis 

func InitGenesis(ctx sdk.Context, keeper Keeper, data GenesisState, sdata types.GenesisState)

InitGenesis initialize default parameters and the keeper's address to pubkey map

func MarshalSlashRecord 

func MarshalSlashRecord(cdc *codec.Codec, record SlashRecord) ([]byte, error)

func MustMarshalSlashRecord 

func MustMarshalSlashRecord(cdc *codec.Codec, record SlashRecord) []byte

func NewHandler 

func NewHandler(k Keeper) sdk.Handler

func NewQuerier 

func NewQuerier(k Keeper, cdc *codec.Codec) sdk.Querier

creates a querier for staking REST endpoints

func NewSlashingHandler 

func NewSlashingHandler(k Keeper) sdk.Handler

func NewTestMsgCreateValidator 

func NewTestMsgCreateValidator(address sdk.ValAddress, pubKey crypto.PubKey, amt int64) stake.MsgCreateValidator

func ParamTypeTable 

func ParamTypeTable() params.TypeTable

ParamTypeTable for slashing module

func RegisterCodec 

func RegisterCodec(cdc *codec.Codec)

Register concrete types on codec codec

func RequestPrepare 

func RequestPrepare(ctx sdk.Context, k Keeper, req abci.RequestQuery, p types.SideChainIder) (newCtx sdk.Context, err sdk.Error)

func SideChainIdFromText 

func SideChainIdFromText(str string) (*big.Int, error)

Types

type BaseParams 

type BaseParams struct {
	SideChainId string
}

BaseParams

func NewBaseParams 

func NewBaseParams(sideChainId string) BaseParams

func (BaseParams) GetSideChainId 

func (p BaseParams) GetSideChainId() string

type CodeType 

type CodeType = sdk.CodeType

Local code type 

const (
	// Default slashing codespace
	DefaultCodespace sdk.CodespaceType = 10

	CodeInvalidInput                 CodeType = 100
	CodeInvalidValidator             CodeType = 101
	CodeValidatorJailed              CodeType = 102
	CodeValidatorNotJailed           CodeType = 103
	CodeMissingSelfDelegation        CodeType = 104
	CodeSelfDelegationTooLowToUnjail CodeType = 105
	CodeInvalidClaim                 CodeType = 106

	CodeExpiredEvidence        CodeType = 201
	CodeFailSlash              CodeType = 202
	CodeHandledEvidence        CodeType = 203
	CodeInvalidEvidence        CodeType = 204
	CodeInvalidSideChain       CodeType = 205
	CodeDuplicateDowntimeClaim CodeType = 206
)

type GenesisState 

type GenesisState struct {
	Params Params
}

GenesisState - all slashing state that must be provided at genesis

func DefaultGenesisState 

func DefaultGenesisState() GenesisState

HubDefaultGenesisState - default GenesisState used by Cosmos Hub

type Hooks 

type Hooks struct {
	// contains filtered or unexported fields
}

Wrapper struct

func (Hooks) OnDelegationCreated 

func (h Hooks) OnDelegationCreated(_ sdk.Context, _ sdk.AccAddress, _ sdk.ValAddress)

func (Hooks) OnDelegationRemoved 

func (h Hooks) OnDelegationRemoved(_ sdk.Context, _ sdk.AccAddress, _ sdk.ValAddress)

func (Hooks) OnDelegationSharesModified 

func (h Hooks) OnDelegationSharesModified(_ sdk.Context, _ sdk.AccAddress, _ sdk.ValAddress)

func (Hooks) OnSelfDelDropBelowMin 

func (h Hooks) OnSelfDelDropBelowMin(ctx sdk.Context, operator sdk.ValAddress)

Implements sdk.ValidatorHooks

func (Hooks) OnSideChainValidatorBeginUnbonding 

func (h Hooks) OnSideChainValidatorBeginUnbonding(ctx sdk.Context, sideConsAddr []byte, operator sdk.ValAddress)

func (Hooks) OnSideChainValidatorBonded 

func (h Hooks) OnSideChainValidatorBonded(ctx sdk.Context, sideConsAddr []byte, operator sdk.ValAddress)

Implements sdk.ValidatorHooks

func (Hooks) OnValidatorBeginUnbonding 

func (h Hooks) OnValidatorBeginUnbonding(ctx sdk.Context, address sdk.ConsAddress, operator sdk.ValAddress)

Implements sdk.ValidatorHooks

func (Hooks) OnValidatorBonded 

func (h Hooks) OnValidatorBonded(ctx sdk.Context, address sdk.ConsAddress, operator sdk.ValAddress)

Implements sdk.ValidatorHooks

func (Hooks) OnValidatorCreated 

func (h Hooks) OnValidatorCreated(_ sdk.Context, _ sdk.ValAddress)

nolint - unused hooks

func (Hooks) OnValidatorModified 

func (h Hooks) OnValidatorModified(_ sdk.Context, _ sdk.ValAddress)

func (Hooks) OnValidatorRemoved 

func (h Hooks) OnValidatorRemoved(_ sdk.Context, _ sdk.ValAddress)

type Keeper 

type Keeper struct {

	// codespace
	Codespace sdk.CodespaceType

	BankKeeper bank.Keeper
	ScKeeper   *sidechain.Keeper

	PbsbServer *pubsub.Server
	// contains filtered or unexported fields
}

Keeper of the slashing store

func NewKeeper 

func NewKeeper(cdc *codec.Codec, key sdk.StoreKey, vs sdk.ValidatorSet, paramspace param.Subspace, codespace sdk.CodespaceType, bk bank.Keeper) Keeper

NewKeeper creates a slashing keeper

func (Keeper) AddValidators 

func (k Keeper) AddValidators(ctx sdk.Context, vals []abci.ValidatorUpdate)

AddValidators adds the validators to the keepers validator addr to pubkey mapping.

func (Keeper) DoubleSignSlashAmount 

func (k Keeper) DoubleSignSlashAmount(ctx sdk.Context) (slashAmt int64)

func (Keeper) DoubleSignUnbondDuration 

func (k Keeper) DoubleSignUnbondDuration(ctx sdk.Context) (res time.Duration)

Double-sign unbond duration

func (Keeper) DowntimeSlashAmount 

func (k Keeper) DowntimeSlashAmount(ctx sdk.Context) (slashAmt int64)

func (Keeper) DowntimeSlashFee 

func (k Keeper) DowntimeSlashFee(ctx sdk.Context) (downtimeSlashFee int64)

func (Keeper) DowntimeUnbondDuration 

func (k Keeper) DowntimeUnbondDuration(ctx sdk.Context) (res time.Duration)

Downtime unbond duration

func (*Keeper) ExecuteAckPackage 

func (k *Keeper) ExecuteAckPackage(ctx sdk.Context, payload []byte) sdk.ExecuteResult

func (*Keeper) ExecuteFailAckPackage 

func (k *Keeper) ExecuteFailAckPackage(ctx sdk.Context, payload []byte) sdk.ExecuteResult

When the ack application crash, payload is the payload of the origin package.

func (*Keeper) ExecuteSynPackage 

func (k *Keeper) ExecuteSynPackage(ctx sdk.Context, payload []byte, _ int64) sdk.ExecuteResult

implement cross chain app

func (Keeper) Hooks 

func (k Keeper) Hooks() Hooks

Return the wrapper struct

func (Keeper) MaxEvidenceAge 

func (k Keeper) MaxEvidenceAge(ctx sdk.Context) (res time.Duration)

MaxEvidenceAge - Max age for evidence - 21 days (3 weeks) MaxEvidenceAge = 60 * 60 * 24 * 7 * 3

func (Keeper) MinSignedPerWindow 

func (k Keeper) MinSignedPerWindow(ctx sdk.Context) int64

Downtime slashing thershold - default 50% of the SignedBlocksWindow

func (Keeper) SetParams 

func (k Keeper) SetParams(ctx sdk.Context, params Params)

set the params

func (*Keeper) SetPbsbServer 

func (k *Keeper) SetPbsbServer(server *pubsub.Server)

func (*Keeper) SetSideChain 

func (k *Keeper) SetSideChain(scKeeper *sidechain.Keeper)

func (Keeper) SignedBlocksWindow 

func (k Keeper) SignedBlocksWindow(ctx sdk.Context) (res int64)

SignedBlocksWindow - sliding window for downtime slashing

func (Keeper) SlashFractionDoubleSign 

func (k Keeper) SlashFractionDoubleSign(ctx sdk.Context) (res sdk.Dec)

SlashFractionDoubleSign - currently default 5%

func (Keeper) SlashFractionDowntime 

func (k Keeper) SlashFractionDowntime(ctx sdk.Context) (res sdk.Dec)

SlashFractionDowntime - currently default 1%

func (Keeper) SubmitterReward 

func (k Keeper) SubmitterReward(ctx sdk.Context) (submitterReward int64)

func (*Keeper) SubscribeParamChange 

func (k *Keeper) SubscribeParamChange(hub types.ParamChangePublisher)

func (Keeper) TooLowDelUnbondDuration 

func (k Keeper) TooLowDelUnbondDuration(ctx sdk.Context) (res time.Duration)

func (Keeper) Unjail 

func (k Keeper) Unjail(ctx sdk.Context, validatorAddr sdk.ValAddress) sdk.Error

type MsgAscSubmitEvidence added in v0.1.4 

type MsgAscSubmitEvidence struct {
	Submitter sdk.AccAddress `json:"submitter"`
	Headers   []asc.Header   `json:"headers"`
}

func NewMsgAscSubmitEvidence added in v0.1.4 

func NewMsgAscSubmitEvidence(submitter sdk.AccAddress, headers []asc.Header) MsgAscSubmitEvidence

func (MsgAscSubmitEvidence) GetInvolvedAddresses added in v0.1.4 

func (msg MsgAscSubmitEvidence) GetInvolvedAddresses() []sdk.AccAddress

func (MsgAscSubmitEvidence) GetSignBytes added in v0.1.4 

func (msg MsgAscSubmitEvidence) GetSignBytes() []byte

func (MsgAscSubmitEvidence) GetSigners added in v0.1.4 

func (msg MsgAscSubmitEvidence) GetSigners() []sdk.AccAddress

func (MsgAscSubmitEvidence) Route added in v0.1.4 

func (MsgAscSubmitEvidence) Route() string

func (MsgAscSubmitEvidence) Type added in v0.1.4 

func (MsgAscSubmitEvidence) Type() string

func (MsgAscSubmitEvidence) ValidateBasic added in v0.1.4 

func (msg MsgAscSubmitEvidence) ValidateBasic() sdk.Error

type MsgSideChainUnjail 

type MsgSideChainUnjail struct {
	ValidatorAddr sdk.ValAddress `json:"address"` // address of the validator operator
	SideChainId   string         `json:"side_chain_id"`
}

MsgSideChainUnjail - struct for unjailing jailed side chain validator

func NewMsgSideChainUnjail 

func NewMsgSideChainUnjail(validatorAddr sdk.ValAddress, sideChainId string) MsgSideChainUnjail

func (MsgSideChainUnjail) GetInvolvedAddresses 

func (msg MsgSideChainUnjail) GetInvolvedAddresses() []sdk.AccAddress

func (MsgSideChainUnjail) GetSignBytes 

func (msg MsgSideChainUnjail) GetSignBytes() []byte

get the bytes for the message signer to sign on

func (MsgSideChainUnjail) GetSigners 

func (msg MsgSideChainUnjail) GetSigners() []sdk.AccAddress

func (MsgSideChainUnjail) Route 

func (msg MsgSideChainUnjail) Route() string

nolint

func (MsgSideChainUnjail) Type 

func (msg MsgSideChainUnjail) Type() string

func (MsgSideChainUnjail) ValidateBasic 

func (msg MsgSideChainUnjail) ValidateBasic() sdk.Error

quick validity check

type MsgUnjail 

type MsgUnjail struct {
	ValidatorAddr sdk.ValAddress `json:"address"` // address of the validator operator
}

MsgUnjail - struct for unjailing jailed validator

func NewMsgUnjail 

func NewMsgUnjail(validatorAddr sdk.ValAddress) MsgUnjail

func (MsgUnjail) GetInvolvedAddresses 

func (msg MsgUnjail) GetInvolvedAddresses() []sdk.AccAddress

func (MsgUnjail) GetSignBytes 

func (msg MsgUnjail) GetSignBytes() []byte

get the bytes for the message signer to sign on

func (MsgUnjail) GetSigners 

func (msg MsgUnjail) GetSigners() []sdk.AccAddress

func (MsgUnjail) Route 

func (msg MsgUnjail) Route() string

nolint

func (MsgUnjail) Type 

func (msg MsgUnjail) Type() string

func (MsgUnjail) ValidateBasic 

func (msg MsgUnjail) ValidateBasic() sdk.Error

quick validity check

type Params 

type Params struct {
	MaxEvidenceAge           time.Duration `json:"max_evidence_age"`
	SignedBlocksWindow       int64         `json:"signed_blocks_window"`
	MinSignedPerWindow       sdk.Dec       `json:"min_signed_per_window"`
	DoubleSignUnbondDuration time.Duration `json:"double_sign_unbond_duration"`
	DowntimeUnbondDuration   time.Duration `json:"downtime_unbond_duration"`
	TooLowDelUnbondDuration  time.Duration `json:"too_low_del_unbond_duration"`
	SlashFractionDoubleSign  sdk.Dec       `json:"slash_fraction_double_sign"`
	SlashFractionDowntime    sdk.Dec       `json:"slash_fraction_downtime"`
	DoubleSignSlashAmount    int64         `json:"double_sign_slash_amount"`
	DowntimeSlashAmount      int64         `json:"downtime_slash_amount"`
	SubmitterReward          int64         `json:"submitter_reward"`
	DowntimeSlashFee         int64         `json:"downtime_slash_fee"`
}

Params - used for initializing default parameter for slashing at genesis

func DefaultParams 

func DefaultParams() Params

Default parameters used by Cosmos Hub

func (*Params) GetParamAttribute 

func (p *Params) GetParamAttribute() (string, bool)

func (*Params) KeyValuePairs 

func (p *Params) KeyValuePairs() params.KeyValuePairs

Implements params.ParamStruct

func (*Params) UpdateCheck 

func (p *Params) UpdateCheck() error

type QueryConsAddrParams 

type QueryConsAddrParams struct {
	BaseParams
	ConsAddr []byte
}

type QueryConsAddrTypeParams 

type QueryConsAddrTypeParams struct {
	BaseParams
	ConsAddr       []byte
	InfractionType byte
}

type SideDowntimeSlashPackage 

type SideDowntimeSlashPackage struct {
	SideConsAddr  []byte        `json:"side_cons_addr"`
	SideHeight    uint64        `json:"side_height"`
	SideChainId   types.ChainID `json:"side_chain_id"`
	SideTimestamp uint64        `json:"side_timestamp"`
}

type SideSlashEvent 

type SideSlashEvent struct {
	Validator              sdk.ValAddress
	InfractionType         byte
	InfractionHeight       int64
	SlashHeight            int64
	JailUtil               time.Time
	SlashAmt               int64
	ToFeePool              int64
	SideChainId            string
	Submitter              sdk.AccAddress
	SubmitterReward        int64
	ValidatorsCompensation map[string]int64
}

func (SideSlashEvent) GetTopic 

func (event SideSlashEvent) GetTopic() pubsub.Topic

type SlashRecord 

type SlashRecord struct {
	ConsAddr         []byte
	InfractionType   byte
	InfractionHeight uint64
	SlashHeight      int64
	JailUntil        time.Time
	SlashAmt         int64
	SideChainId      string
}

func MustUnmarshalSlashRecord 

func MustUnmarshalSlashRecord(cdc *codec.Codec, key []byte, value []byte) SlashRecord

func UnmarshalSlashRecord 

func UnmarshalSlashRecord(cdc *codec.Codec, key []byte, value []byte) (SlashRecord, error)

func (SlashRecord) HumanReadableString 

func (r SlashRecord) HumanReadableString() (string, error)

type ValidatorSigningInfo 

type ValidatorSigningInfo struct {
	StartHeight         int64     `json:"start_height"`          // height at which validator was first a candidate OR was unjailed
	IndexOffset         int64     `json:"index_offset"`          // index offset into signed block bit array
	JailedUntil         time.Time `json:"jailed_until"`          // timestamp validator cannot be unjailed until
	MissedBlocksCounter int64     `json:"missed_blocks_counter"` // missed blocks counter (to avoid scanning the array every time)
}

Signing info for a validator

func NewValidatorSigningInfo 

func NewValidatorSigningInfo(startHeight int64, indexOffset int64, jailedUntil time.Time, missedBlocksCounter int64) ValidatorSigningInfo

Construct a new `ValidatorSigningInfo` struct

func (ValidatorSigningInfo) HumanReadableString 

func (i ValidatorSigningInfo) HumanReadableString() string

Return human readable signing info

type ValidatorSlashingPeriod 

type ValidatorSlashingPeriod struct {
	ValidatorAddr sdk.ConsAddress `json:"validator_addr"` // validator which this slashing period is for
	StartHeight   int64           `json:"start_height"`   // starting height of the slashing period
	EndHeight     int64           `json:"end_height"`     // ending height of the slashing period, or sentinel value of 0 for in-progress
	SlashedSoFar  sdk.Dec         `json:"slashed_so_far"` // fraction of validator stake slashed so far in this slashing period
}

Slashing period for a validator

func NewValidatorSlashingPeriod 

func NewValidatorSlashingPeriod(startHeight int64, endHeight int64, slashedSoFar sdk.Dec) ValidatorSlashingPeriod

Construct a new `ValidatorSlashingPeriod` struct

func (ValidatorSlashingPeriod) HumanReadableString 

func (p ValidatorSlashingPeriod) HumanReadableString() string

Return human readable slashing period

type ValidatorSlashingPeriodValue 

type ValidatorSlashingPeriodValue struct {
	EndHeight    int64   `json:"end_height"`
	SlashedSoFar sdk.Dec `json:"slashed_so_far"`
}

Value part of slashing period (validator address & start height are stored in the key)

Source Files

View all Source files

Directories

Path Synopsis
client
cli
rest

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.