Governance System Architecture 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

1

Proposal Passes

Governance proposal is approved by token holders
2

Timelock Execution

Arbitrary calldata is executed on contracts through the Timelock

​
2. Branch Chain Contract Governance

1

Proposal Passes

Governance proposal targeting branch chain contracts is approved
2

Branch Governance Entrypoint

Calldata to be executed on branch chains is passed to the BranchGovernanceEntrypoint through the Timelock on Mitosis Chain
3

Cross-Chain Messaging

BranchGovernanceEntrypoint sends the execution calldata to the GovernanceEntrypoint on the branch chain via cross-chain messaging
4

Registration on Branch Chain

The execution calldata is registered in the branch chain’s Timelock contract
5

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

1

Proposal Passes

Governance proposal targeting consensus layer modules is approved
2

Consensus Governance Entrypoint

Messages to be executed on the consensus layer are passed to the ConsensusGovernanceEntrypoint through the Timelock
3

Event Log Transfer

The ConsensusGovernanceEntrypoint transfers the messages to the x/evmgov module on the consensus layer through event logs
4

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