Core Mechanisms
Detailed governance system implementation and execution mechanisms
The governance system provides an on-chain governance mechanism based on OpenZeppelin v5’s Governance library. MITOGovernance and Timelock are the main contracts of the governance system and are based on OpenZeppelin v5’s Governor and Timelock.
Governance Scope
Mitosis’s on-chain governance governs three distinct areas:
Contracts on Mitosis Chain
When governance proposals pass, arbitrary calldata can be executed on contracts through the Timelock
Contracts on Branch Chains
Calldata execution on branch chains via BranchGovernanceEntrypoint
and cross-chain messaging
Modules on Consensus Layer
Message execution on consensus layer through ConsensusGovernanceEntrypoint
and x/evmgov
module
1. Mitosis Chain Contract Governance
Proposal Passes
Governance proposal is approved by token holders
Timelock Execution
Arbitrary calldata is executed on contracts through the Timelock
2. Branch Chain Contract Governance
Proposal Passes
Governance proposal targeting branch chain contracts is approved
Branch Governance Entrypoint
Calldata to be executed on branch chains is passed to the BranchGovernanceEntrypoint
through the Timelock
on Mitosis Chain
Cross-Chain Messaging
BranchGovernanceEntrypoint
sends the execution calldata to the GovernanceEntrypoint
on the branch chain via cross-chain messaging
Registration on Branch Chain
The execution calldata is registered in the branch chain’s Timelock
contract
Delayed Execution
After a certain time period, arbitrary calldata can be executed on the branch chain’s contracts through the branch chain’s Timelock
3. Consensus Layer Module Governance
Proposal Passes
Governance proposal targeting consensus layer modules is approved
Consensus Governance Entrypoint
Messages to be executed on the consensus layer are passed to the ConsensusGovernanceEntrypoint
through the Timelock
Event Log Transfer
The ConsensusGovernanceEntrypoint
transfers the messages to the x/evmgov
module on the consensus layer through event logs
Module Execution
The x/evmgov
module executes the messages received from the ConsensusGovernanceEntrypoint
Key Contracts
MITOGovernance
- Based on OpenZeppelin v5’s Governor contract
- Handles proposal creation, voting, and execution logic
- Integrates with MITOGovernanceVP for voting power calculations
Timelock
- Based on OpenZeppelin v5’s Timelock contract
- Provides time-delayed execution of approved proposals
- Acts as the executor for governance decisions across all three governance areas
BranchGovernanceEntrypoint
- Facilitates governance execution on branch chains
- Interfaces for cross-chain messaging
- Ensures secure transmission of governance decisions
ConsensusGovernanceEntrypoint
- Enables governance control over consensus layer modules
- Communicates with
x/evmgov
module through event logs - Provides interface between EVM governance and consensus layer