How it works
How a Terra proposal goes from idea to done, and what your vote does.
From idea to done
- Someone puts up 5,000 LUNAAnyone can write a proposal. It goes to a vote once 5,000 LUNA is deposited within a week. The deposit comes back unless the proposal is vetoed.
- Seven days of votingEveryone with staked LUNA can vote yes, no, no with veto or abstain, and change the vote until the end. A vote weighs as much as the LUNA behind it.
- If you do not vote, your validator doesStake whose owner does not vote follows its validator. So a few large validators decide most proposals.
- Three rules decideQuorum: 30% of all stake must take part. Veto: above 33.4% no with veto, it fails. Threshold: more than half of yes, no and veto must be yes.
- Passed means doneA passed proposal’s messages run in the same block: an upgrade is scheduled, a parameter changes, or LUNA leaves the community pool. Governance has no say over what the recipient does next; the community pool pages follow it.
Try the three rules
A made-up proposal on a chain with 1,000,000 LUNA staked.
PassingFinal count
- Yes 220k
- No 80k
- No with veto 20k
- Abstain 80k
Who votes for your LUNA?
You stake 1,000 LUNA with a validator. Pick what each of you does.
Your validator votes
You
Your 1,000 LUNA counts as Yes, because you left it to your validator.
Words used on this site
- Community pool
- LUNA held by the chain itself. No one has a key to it; only a passed governance proposal can send it anywhere.
- Proposal
- A request put to a vote of everyone who stakes LUNA. It is text only (a signal) or carries messages, such as a transfer from the community pool, that run by themselves if it passes.
- Deposit
- A proposal needs 5,000 LUNA deposited before it goes to a vote. The deposit is returned unless the proposal is vetoed.
- Voting period
- Seven days. Votes can be changed until the end; the last one counts. The chain counts and acts in the block where the period ends.
- Expedited proposal
- A faster track: a one-day vote with a higher bar (two thirds yes). If it misses that bar it continues as a normal proposal.
- Quorum
- At least 30% of all staked LUNA has to take part (abstain counts). Below that the proposal fails, however the votes split.
- Pass threshold
- More than 50% of the votes that are not abstain must be yes.
- No with veto
- A stronger no. If more than 33.4% of all votes are no with veto, the proposal fails whatever the yes share, and its deposit is burned.
- Abstain
- Counts toward quorum, but not as yes or no.
- Validator
- An operator that runs a node producing Terra’s blocks. It votes on proposals with the stake delegated to it.
- Delegation (staking)
- Staking LUNA with a validator. You keep ownership, receive staking rewards and get voting power.
- If you do not vote
- Your staked LUNA votes the way your validator voted. If you vote yourself, your vote replaces theirs for your stake only.
- Voting power
- Staked LUNA, including the “virtual” stake the alliance module places on validators for alliance assets. A vote’s weight is measured against all bonded stake.
- Multisig
- An account that acts only when several keyholders approve. The ones here are DAO DAO, cw3 and Enterprise contracts, which store every decision with the exact transfers inside.
- Phoenix Directive Treasury
- A contract created by proposal 4822. It receives the staking rewards of its own alliance asset and pays out through “actions” (payments, milestone grants, sale orders), each logged in the contract with a name and a USD value.
- Alliance
- Terra’s alliance module gives assets other than native LUNA stake a share of staking rewards, sized by their reward weight. Creating or changing an alliance takes a governance vote.
- Reward weight
- An alliance’s claim on staking rewards next to native LUNA stake, which counts as 1. With weights adding up to W, an alliance with weight w receives about w ÷ (1 + W) of all staking rewards.
- Emissions
- New LUNA minted with every block, 7% a year by the mint parameters, and paid out as staking rewards. Blocks come faster than the parameter assumes, so more is minted in practice.
- Amplifier (ampLUNA)
- ERIS Protocol’s liquid staking. LUNA goes in, ampLUNA comes out; the LUNA is staked with validators and ampLUNA grows in LUNA terms as rewards come in.
- Sale order (OTC)
- An on-chain offer to sell a fixed amount at a fixed price, which anyone can fill. The contract shows how much is still unsold; a cancelled order returns what is left to its owner.
- Liquidity (LP)
- Tokens deposited into a trading pool so others can swap against them. The depositor receives LP tokens and can redeem them later for their share of the pool.
- Milestone grant
- A grant paid in parts, each part released when a named deliverable is met.
- Phoenix Directive
- The group that has submitted Terra governance proposals from the address terra1kefa…klgzl since July 2024, and whose proposals created the multisigs and the treasury shown here.
- Commission
- The share of staking rewards a validator keeps before passing the rest to its delegators.
- Missed blocks
- Blocks a validator failed to sign in the chain’s current window of 10,000 blocks (about 16 hours). A validator that misses more than 95% of them is jailed.
- Virtual stake
- LUNA the alliance module stakes on validators on behalf of alliance assets, so they share in staking rewards. It counts as voting power like any stake, and since the module never votes, the validator it sits on votes with it. Where it sits follows the delegations of each alliance asset’s holders.
- Where old votes come from
- The chain deletes individual votes when voting ends; the tally stays. After that, votes are only in the transactions that cast them, and public nodes keep a limited history of those. Votes from proposal 4844 on could be recovered; older ones could not and are not shown.