2019-12-17 03:44:44 -08:00
|
|
|
<!--
|
2019-12-11 09:35:27 -08:00
|
|
|
order: 0
|
|
|
|
|
title: Gov Overview
|
|
|
|
|
parent:
|
|
|
|
|
title: "gov"
|
2019-12-17 03:44:44 -08:00
|
|
|
-->
|
2019-12-11 09:35:27 -08:00
|
|
|
|
2019-12-10 06:29:46 -08:00
|
|
|
# `gov`
|
2018-02-26 07:07:17 -08:00
|
|
|
|
|
|
|
|
## Abstract
|
|
|
|
|
|
2019-05-08 06:51:59 -07:00
|
|
|
This paper specifies the Governance module of the Cosmos-SDK, which was first
|
|
|
|
|
described in the [Cosmos Whitepaper](https://cosmos.network/about/whitepaper) in
|
|
|
|
|
June 2016.
|
2018-02-26 07:07:17 -08:00
|
|
|
|
2019-05-08 06:51:59 -07:00
|
|
|
The module enables Cosmos-SDK based blockchain to support an on-chain governance
|
|
|
|
|
system. In this system, holders of the native staking token of the chain can vote
|
|
|
|
|
on proposals on a 1 token 1 vote basis. Next is a list of features the module
|
|
|
|
|
currently supports:
|
2018-02-26 07:07:17 -08:00
|
|
|
|
2022-02-10 04:07:01 -08:00
|
|
|
* **Proposal submission:** Users can submit proposals with a deposit. Once the
|
2019-05-08 06:51:59 -07:00
|
|
|
minimum deposit is reached, proposal enters voting period
|
2022-02-10 04:07:01 -08:00
|
|
|
* **Vote:** Participants can vote on proposals that reached MinDeposit
|
|
|
|
|
* **Inheritance and penalties:** Delegators inherit their validator's vote if
|
2019-05-08 06:51:59 -07:00
|
|
|
they don't vote themselves.
|
2022-02-10 04:07:01 -08:00
|
|
|
* **Claiming deposit:** Users that deposited on proposals can recover their
|
2019-05-08 06:51:59 -07:00
|
|
|
deposits if the proposal was accepted OR if the proposal never entered voting period.
|
2018-02-26 07:07:17 -08:00
|
|
|
|
2018-02-26 07:35:09 -08:00
|
|
|
This module will be used in the Cosmos Hub, the first Hub in the Cosmos network.
|
2019-05-08 06:51:59 -07:00
|
|
|
Features that may be added in the future are described in [Future Improvements](05_future_improvements.md).
|
2018-02-26 07:07:17 -08:00
|
|
|
|
|
|
|
|
## Contents
|
|
|
|
|
|
2019-05-08 06:51:59 -07:00
|
|
|
The following specification uses *ATOM* as the native staking token. The module
|
|
|
|
|
can be adapted to any Proof-Of-Stake blockchain by replacing *ATOM* with the native
|
|
|
|
|
staking token of the chain.
|
2018-02-26 07:35:09 -08:00
|
|
|
|
2019-02-20 10:21:57 -08:00
|
|
|
1. **[Concepts](01_concepts.md)**
|
2022-02-10 04:07:01 -08:00
|
|
|
* [Proposal submission](01_concepts.md#proposal-submission)
|
|
|
|
|
* [Vote](01_concepts.md#vote)
|
|
|
|
|
* [Software Upgrade](01_concepts.md#software-upgrade)
|
2019-02-20 10:21:57 -08:00
|
|
|
2. **[State](02_state.md)**
|
2022-02-10 04:07:01 -08:00
|
|
|
* [Parameters and base types](02_state.md#parameters-and-base-types)
|
|
|
|
|
* [Deposit](02_state.md#deposit)
|
|
|
|
|
* [ValidatorGovInfo](02_state.md#validatorgovinfo)
|
|
|
|
|
* [Proposals](02_state.md#proposals)
|
|
|
|
|
* [Stores](02_state.md#stores)
|
|
|
|
|
* [Proposal Processing Queue](02_state.md#proposal-processing-queue)
|
2019-02-20 10:21:57 -08:00
|
|
|
3. **[Messages](03_messages.md)**
|
2022-02-10 04:07:01 -08:00
|
|
|
* [Proposal Submission](03_messages.md#proposal-submission)
|
|
|
|
|
* [Deposit](03_messages.md#deposit)
|
|
|
|
|
* [Vote](03_messages.md#vote)
|
2019-06-26 09:03:25 -07:00
|
|
|
4. **[Events](04_events.md)**
|
2022-02-10 04:07:01 -08:00
|
|
|
* [EndBlocker](04_events.md#endblocker)
|
|
|
|
|
* [Handlers](04_events.md#handlers)
|
2019-02-20 10:21:57 -08:00
|
|
|
5. **[Future Improvements](05_future_improvements.md)**
|
2019-05-24 09:18:07 -07:00
|
|
|
6. **[Parameters](06_params.md)**
|
2021-09-21 03:20:36 -07:00
|
|
|
7. **[Client](07_client.md)**
|
2022-02-10 04:07:01 -08:00
|
|
|
* [CLI](07_client.md#cli)
|
|
|
|
|
* [gRPC](07_client.md#grpc)
|
|
|
|
|
* [REST](07_client.md#rest)
|
