Skip to content

Voting on Proposals

Once you are a member of a DAO and have delegated voting power (typically by delegating to yourself), you can vote on active governance proposals.

1. Check Proposal Inbox

View all pending and active proposals for your DAO:

sage proposals inbox --dao 0xYourDAO

This will show you: - Proposal IDs - Current status (Pending, Active, Succeeded, Queued, Executed) - Voting deadlines - Current vote counts

2. Preview a Proposal

Before voting, inspect the details of a specific proposal:

sage proposals preview <proposal-id> --dao 0xYourDAO

This command shows: - Proposal description - Calldata breakdown (which contracts/functions will be called) - Current voting status - Time remaining - Required quorum

Example:

sage proposals preview 42 --dao 0xYourDAO

3. Cast Your Vote

To vote, use the proposals vote command:

sage proposals vote <proposal-id> <support> --dao 0xYourDAO
  • <proposal-id>: The ID of the proposal you are voting on
  • <support>: Your vote. Can be for, against, or abstain

Examples:

sage proposals vote 42 for --dao 0xYourDAO
sage proposals vote 42 against --dao 0xYourDAO
sage proposals vote 42 abstain --dao 0xYourDAO

Your vote is weighted by your stake token balance at the proposal's snapshot block.

4. Execute Successful Proposals

After the voting period ends, a successful proposal must be executed after the Timelock delay passes.

sage proposals execute <proposal-id> --dao 0xYourDAO

Anyone can call this function to execute a proposal once: - Quorum is reached - Voting period has ended - Timelock delay has passed

Check Next Steps

Use proposals status to see what action is needed next:

sage proposals status --dao 0xYourDAO

This will show recommended next actions: - "Vote on proposal #X" (if active) - "Queue proposal #X" (if succeeded) - "Execute proposal #X" (if queued and delay passed)

Full Proposal Lifecycle

  1. Created - Proposal submitted to Governor
  2. Active - Voting period is open → Vote here
  3. Succeeded - Quorum reached, majority voted for
  4. Queued - Waiting for Timelock delay
  5. Executed - Proposal actions completed → Library updated