58597139fa
## Description Closes: #9404 --- ### Author Checklist *All items are required. Please add a note to the item if the item is not applicable and please add links to any relevant follow up issues.* I have... - [x] included the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title - [ ] added `!` to the type prefix if API or client breaking change - [x] targeted the correct branch (see [PR Targeting](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#pr-targeting)) - [x] provided a link to the relevant issue or specification - [ ] followed the guidelines for [building modules](https://github.com/cosmos/cosmos-sdk/blob/master/docs/building-modules) - [ ] included the necessary unit and integration [tests](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#testing) - [ ] added a changelog entry to `CHANGELOG.md` - [ ] included comments for [documenting Go code](https://blog.golang.org/godoc) - [ ] updated the relevant documentation or specification - [x] reviewed "Files changed" and left comments if necessary - [x] confirmed all CI checks have passed ### Reviewers Checklist *All items are required. Please add a note if the item is not applicable and please add your handle next to the items reviewed if you only reviewed selected items.* I have... - [ ] confirmed the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title - [ ] confirmed `!` in the type prefix if API or client breaking change - [ ] confirmed all author checklist items have been addressed - [ ] reviewed state machine logic - [ ] reviewed API design and naming - [ ] reviewed documentation is accurate - [ ] reviewed tests and test coverage - [ ] manually tested (if applicable)
50 lines
1.6 KiB
Markdown
50 lines
1.6 KiB
Markdown
<!--
|
|
order: 0
|
|
title: Slashing Overview
|
|
parent:
|
|
title: "slashing"
|
|
-->
|
|
|
|
# `x/slashing`
|
|
|
|
## Abstract
|
|
|
|
This section specifies the slashing module of the Cosmos SDK, which implements functionality
|
|
first outlined in the [Cosmos Whitepaper](https://cosmos.network/about/whitepaper) in June 2016.
|
|
|
|
The slashing module enables Cosmos SDK-based blockchains to disincentivize 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.
|
|
|
|
This module will be used by the Cosmos Hub, the first hub in the Cosmos ecosystem.
|
|
|
|
## Contents
|
|
|
|
1. **[Concepts](01_concepts.md)**
|
|
* [States](01_concepts.md#states)
|
|
* [Tombstone Caps](01_concepts.md#tombstone-caps)
|
|
* [ASCII timelines](01_concepts.md#ascii-timelines)
|
|
2. **[State](02_state.md)**
|
|
* [Signing Info](02_state.md#signing-info)
|
|
3. **[Messages](03_messages.md)**
|
|
* [Unjail](03_messages.md#unjail)
|
|
4. **[Begin-Block](04_begin_block.md)**
|
|
* [Evidence handling](04_begin_block.md#evidence-handling)
|
|
* [Uptime tracking](04_begin_block.md#uptime-tracking)
|
|
5. **[05_hooks.md](05_hooks.md)**
|
|
* [Hooks](05_hooks.md#hooks)
|
|
6. **[Events](06_events.md)**
|
|
* [BeginBlocker](06_events.md#beginblocker)
|
|
* [Handlers](06_events.md#handlers)
|
|
7. **[Staking Tombstone](07_tombstone.md)**
|
|
* [Abstract](07_tombstone.md#abstract)
|
|
8. **[Parameters](08_params.md)**
|
|
9. **[Client](09_client.md)**
|
|
* [CLI](09_client.md#cli)
|
|
* [gRPC](09_client.md#grpc)
|
|
* [REST](09_client.md#rest)
|