ONCHAIN SYSTEMS · COURSE 001

Who Gets to Change the Protocol?

Turn community governance into a replayable state machine: who proposes a change, who can vote, when it can execute, and how an emergency cancel protects the treasury.

4 lessonsabout 52 minbeginner friendly
COURSE EXAMPLEWho gets to change the protocol?

Follow one proposal through snapshots, quorum, delegation, a timelock, a treasury ledger, and an emergency cancel path.

PARTICIPANTS
  • PProposer: turns an intention into an exact action
  • VVoters: bring snapshot power and participation
  • TTimelock: exposes the operation before execution
  • GGuardian: can stop an unsafe transfer before it runs
COURSE OUTLINE

One question per lesson

The lessons are ordered so that each one uses concepts introduced earlier.

  1. 01
    PROPOSAL · TARGET · ACTION

    A Proposal Is a Pending State Change

    KEY QUESTIONA proposal gets 99% YES. Why might the protocol remain unchanged?

    Turn “change the fee” into a target, action, parameter, and pre-execution state so everyone votes on the same operation.

    ProposalTargetCalldataState transition
    12 MIN
  2. 02
    SNAPSHOT · DELEGATION · QUORUM

    How Much Does One Vote Count?

    KEY QUESTIONCan borrowed tokens seize a vote after it starts?

    Delegate Alice’s power to Bob, freeze the snapshot, and compare participation with quorum and support.

    Voting snapshotDelegationQuorumAbstain
    14 MIN
  3. 03
    QUEUE · TIMELOCK · EXECUTION

    Why Can’t a Passed Vote Execute Immediately?

    KEY QUESTIONDoes a two-day timelock guarantee a malicious proposal cannot hurt the protocol?

    Queue a passed proposal behind a timelock, wait until it becomes ready, and replay every event before execution.

    QueueTimelockReaction windowExecution
    13 MIN
  4. 04
    TREASURY · GUARDIAN · RISK

    A Treasury Is Not an ATM

    KEY QUESTIONAn emergency multisig can save a protocol. Why is it also a risk?

    Execute a grant, switch to low quorum, and cancel an unsafe operation to compare capital efficiency with attack surface.

    TreasuryGuardianQuorum riskEmergency stop
    13 MIN
WHAT IT COVERS

Questions covered in this course

01

Why a proposal is a state transition, not a headline

02

How delegation and snapshots prevent the same power being counted twice

03

Why quorum, majority, and timelock are separate boundaries

04

How treasury conservation and emergency cancellation change risk