Governance

Read a proposal

Every panel on a proposal page, and what the states, blocks and hashes mean.

Read a proposal

A proposal page is at /proposal/<proposal id>, and you reach it by selecting any proposal title. No wallet is needed to read it. The page mixes what the indexer recorded when the proposal was created with values it reads from the governor contract live, so what you see is the state of the chain right now.

The header

The title, and next to it the state. The state comes from the governor itself, and hovering the little question mark next to anything on this page explains what it is.

Under the title stand the proposer's address, which links to the block explorer, and the moment the proposal was created. When the proposal can still be settled, a Queue or Execute button sits here as well. See Queue and execute a proposal.

The states

State What it means
Pending Created, but voting has not opened yet. It opens after the voting delay
Active Voting is open
Succeeded Voting closed, quorum was reached and the For votes won
Defeated Voting closed and it did not pass, either on votes or on quorum
Queued It passed and is sitting in the timelock, waiting out the delay
Executed The timelock expired and the change has been applied on-chain
Canceled It was withdrawn before it could be decided
Expired It was queued but never executed in time

Description

The text the proposer wrote, exactly as it went on-chain. The first heading of that text became the title you see everywhere else on the site.

Tally

The bar and the three figures below it: For, Against and Abstain, each with the number of votes and its share of the votes cast. Quorum is the minimum number of votes the proposal has to reach to be valid at all. A proposal that beats the Against votes but misses quorum still fails, which is why abstaining matters: it counts towards quorum without taking a side.

Your vote

This panel appears once your wallet is connected. It shows your voting power for this proposal, meaning the votes you had at the snapshot block rather than the coins you hold today, and then either the vote buttons or the vote you already cast, with the weight it carried.

Status

The block numbers behind the proposal. Every one of them links to the block explorer.

Field What it is
Proposal ID The proposal's unique identifier on-chain
Start block Where voting opens
End block Where voting closes
Snapshot block Where your voting power is measured. Coins received after it do not count for this vote
Deadline block Where voting closes, as the governor reports it
Queue Once queued, the moment the timelock lets it be executed
Transaction The transaction that created the proposal

On-chain actions

What the proposal actually does when it is executed. For a parameter change that is one call to the GovHub contract:

  • Target. The contract being called. A green Whitelisted badge means the governor accepts it, and only whitelisted targets can ever be executed.
  • Value. The amount of L2P sent with the call. For a parameter change this is 0.
  • Calldata. The encoded instruction. Hover it to see it in full.
  • Description hash. A fingerprint of the description, which is what ties the text you just read to this exact call.

A signal proposal carries no real instruction. It either lists no actions at all, or an empty calldata of 0x, and it cannot be queued or executed.

Voters

Every vote cast, heaviest first, twenty-five at a time. Load more fetches the next page. Per voter you see which way they voted, their address, the weight they carried, the moment they voted and a link to their transaction. If a voter attached a reason to their vote it is shown under their address.

Governor configuration

The governor's own settings, read from the contract as it currently stands: its name and version, the voting delay, the voting period and the proposal threshold. These are themselves governable: they are listed in What governance can change.