Governance
The Aptos on-chain governance is a process by which the Aptos community members can create and vote on proposals that minimize the cost of blockchain upgrades. The following describes the scope of these proposals for the Aptos on-chain governance:
- Changes to the blockchain parameters, for example, the epoch duration, and the minimum required and maximum allowed validator stake.
- Changes to the core blockchain code.
- Upgrades to the Aptos Framework modules for fixing bugs or for adding or enhancing the Aptos blockchain functionality.
- Deploying new framework modules (at the address
0x1
-0xa
).
How a proposal becomes ready to be resolved
See below for a summary description of how a proposal comes to exist and when it becomes ready to be resolved:
- The Aptos community can suggest an Aptos Improvement Proposal (AIP) in the Aptos Foundation AIP GitHub.
- When appropriate, an on-chain proposal can be created for the AIP via the
aptos_governance
module. - Voters can then vote on this proposal on-chain via the
aptos_governance
module. If there is sufficient support for a proposal, then it can be resolved. - Governance requires a minimal number of votes to be cast by an expiration threshold. However, if sufficient votes, more than 50% of the total supply, are accumulated prior to that threshold, the proposal can be executed without waiting for the full voting period.
Who can propose
- To either propose or vote, you must stake, but you are not required to run a validator node. However, we recommend that you run validator with a stake as part of the validator set to gain rewards from your stake.
- To create a proposal, the proposer’s backing stake pool must have the minimum required proposer stake. The proposer’s stake must be locked up for at least as long as the proposal’s voting period. This is to avoid potential spam proposals.
- Proposers can create a proposal by calling
aptos_governance::create_proposal
.
Who can vote
- To vote, you must stake, though you are not required to run a validator node. Your voting power is derived from the backing stake pool.
- Voting power is calculated based on the current epoch’s active stake of the proposer or voter’s backing stake pool. In addition, the stake pool’s lockup must be at least as long as the proposal’s duration.
- Verify proposals before voting. Ensure each proposal is linked to its source code, and if there is a corresponding AIP, the AIP is in the title and description.
If you are a staking pool voter, follow the instructions for voting [her../nodes/validator-node/connect-nodes/staking-pool-voter.mdxmdx).
If you are a delegated staker, follow the instructions for voting [her../nodes/validator-node/connect-nodes/staking-pool-voter.mdxmdx#delegation-pool-voter).
Who can resolve
- Anyone can resolve an on-chain proposal that has passed voting requirements by using the
aptos governance execute-proposal
command from Aptos CLI.
Aptos Improvement Proposals (AIPs)
AIPs are proposals created by the Aptos community or the Aptos Labs team to improve the operations and development of the Aptos chain.
To submit an AIP, create an issue in Aptos Foundation's GitHub repository
using the template
To keep up with new AIPs, check the #aip-announcements
channel on Aptos’ discord channel.
To view and vote on on-chain proposals, go to Aptos' Governance website
.
Technical Implementation of Aptos Governance
The majority of the governance logic is in aptos_governance.move and voting.move
.
The aptos_governance
module outlines how users can interact with Aptos Governance. It’s the external-facing module of the Aptos on-chain governance process and contains logic and checks that are specific to Aptos Governance.
The voting
module is the Aptos governance standard that can be used by DAOs on the Aptos chain to create their own on-chain governance process.
If you are thinking about creating a DAO on Aptos, you can refer to aptos_governance
’s usage of the voting
module as an example.
In aptos_governance
, we rely on the voting
module to create, vote on, and resolve a proposal.
aptos_governance::create_proposal
callsvoting::create_proposal
to create a proposal on-chain, when an off-chain AIP acquires sufficient importance.aptos_governance::vote
callsvoting::vote
to record the vote on a proposal on-chain;aptos_governance::resolve
can be called by anyone. It callsvoting::resolve
to resolve the proposal on-chain.