Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
LABS
Glossary

Governance Proposal

A formal, on-chain suggestion for changes to a decentralized protocol's parameters, code, treasury, or governance rules, submitted for community discussion and voting.
Chainscore © 2026
definition
BLOCKCHAIN GOVERNANCE

What is a Governance Proposal?

A formal mechanism for stakeholders to propose, debate, and enact changes to a decentralized protocol or organization.

A governance proposal is a formal, on-chain or off-chain submission that outlines a specific change or action for a decentralized autonomous organization (DAO) or blockchain protocol. It serves as the primary vehicle for stakeholders—typically token holders—to initiate collective decision-making. Proposals can range from simple parameter adjustments, like modifying a fee, to complex upgrades such as deploying new smart contract logic or allocating treasury funds. The proposal's content is codified, creating a clear and immutable record of the intended action for community review and voting.

The lifecycle of a proposal follows a structured path: drafting, temperature check, formal submission, voting period, and execution. During the drafting phase, ideas are socialized in community forums to gauge sentiment. A successful temperature check leads to the formal, on-chain submission, where the proposal is assigned a unique identifier. The subsequent voting period allows token holders to cast votes, often weighted by their stake, to approve or reject the measure. If the proposal passes predefined thresholds (e.g., quorum and majority), it moves to the execution phase, where the encoded changes are automatically implemented by the protocol's smart contracts.

Key technical components of a proposal include the proposal type, which defines the action (e.g., Spend, ParameterChange, SoftwareUpgrade), and the executable calldata, which contains the precise instructions for the smart contract to execute upon approval. Governance frameworks like Compound's Governor Bravo or OpenZeppelin's Governor standardize this process. For example, a proposal to change the reserve factor on a lending protocol would specify the new value and the target contract address in its calldata, ensuring transparent and trustless execution.

Effective proposals require careful construction to ensure security and clarity. They must include a comprehensive specification detailing the change, a rationale explaining the benefits and risks, and often a code implementation or audit report. Poorly written proposals can lead to unintended consequences, such as protocol exploits or treasury loss. Therefore, many communities implement proposal thresholds—minimum token holdings required to submit—and timelocks, which introduce a mandatory delay between a vote's passage and its execution, providing a final safety check.

In practice, governance proposals are the engine of decentralized evolution. Prominent examples include Uniswap's fee switch proposal, which debated activating protocol fees, and MakerDAO's numerous executive votes for adjusting collateral parameters and adding new asset types. These processes demonstrate how on-chain governance moves beyond abstract debate to create enforceable, code-based law for decentralized systems, distributing power from a core development team to a global community of stakeholders.

how-it-works
DECENTRALIZED GOVERNANCE

How a Governance Proposal Works

A governance proposal is the formal mechanism by which token holders in a decentralized autonomous organization (DAO) or protocol submit, debate, and vote on changes to the network's rules, parameters, or treasury.

A governance proposal is a formal, on-chain or off-chain submission that outlines a specific change or action for a decentralized network. This can include modifying protocol parameters (like interest rates or block rewards), allocating funds from a community treasury, upgrading smart contract code, or ratifying a strategic partnership. The proposal is typically drafted in a governance forum, where it undergoes initial community discussion and feedback before moving to a formal vote. This process transforms stakeholder sentiment into executable code or policy, embodying the core principle of on-chain governance.

The lifecycle of a proposal follows a standardized path. First, a proposer, who must often meet a minimum token-holding threshold, submits the proposal to a governance forum (e.g., Discourse or Commonwealth) for a temperature check. Following constructive discussion and revisions, the formal proposal is snapshotted—a record of token holdings is taken to determine voting power—and moved to an on-chain voting contract. Voting mechanisms vary, employing models like token-weighted voting, quadratic voting, or conviction voting. A proposal passes only if it meets predefined criteria for quorum (minimum participation) and a majority or supermajority vote.

Key technical components enable this process. The governance module is a smart contract that manages proposal submission, voting, and execution. Voting tokens, which confer proposal and voting rights, are typically the protocol's native asset or a derivative like veTokens (vote-escrowed tokens). For high-stakes upgrades, a timelock contract is often used; it delays the execution of a passed proposal, giving users a safety period to exit if they disagree with the change. This creates a critical buffer between a vote's conclusion and its on-chain implementation.

Real-world examples illustrate the spectrum of proposal types. In Compound Governance, Proposal 62 successfully raised the COMP reward distribution for a specific market. Uniswap governance famously executed a proposal to deploy the protocol to the BNB Chain. Conversely, proposals can also fail, serving as a check on power, such as when a controversial MakerDAO proposal to invest in traditional assets did not reach the necessary quorum. These outcomes demonstrate the dynamic and sometimes contentious nature of decentralized decision-making.

Effective governance requires balancing inclusivity with security. Challenges include voter apathy, where low participation threatens legitimacy, and vote buying or manipulation through mechanisms like flash loans. Many protocols are experimenting with solutions: Optimism uses a Citizens' House for non-financial governance, Aave has a Governance Guardian with emergency powers, and Frax Finance implements a multi-layer system with a Frax Improvement Proposal (FIP) framework. The evolution of proposal mechanics continues to shape how decentralized communities coordinate and evolve.

key-features
DECONSTRUCTED

Key Features of a Governance Proposal

A governance proposal is a formal, on-chain mechanism for stakeholders to propose, debate, and enact changes to a decentralized protocol. This section breaks down its core structural and functional components.

01

Proposal ID & Metadata

Every proposal is assigned a unique on-chain identifier and includes essential metadata such as:

  • Title: A concise, descriptive name.
  • Description: A detailed explanation of the proposed change, often using a standardized format.
  • Author: The address of the proposer.
  • Creation Timestamp: The block number or time the proposal was submitted. This data is permanently recorded on the blockchain, ensuring transparency and auditability.
02

Proposed Actions & Calldata

The core technical component is the executable payload. This defines the specific on-chain actions to be performed if the proposal passes, including:

  • Target Contract(s): The smart contract addresses to be called.
  • Calldata: The encoded function signature and parameters for the call (e.g., setFeePercentage(uint256)).
  • Value: Any native token (e.g., ETH) to be sent with the call. This transforms a vote into a permissioned, automated execution of protocol logic.
03

Voting Parameters & Timeline

Proposals operate within a defined temporal framework controlled by governance parameters:

  • Voting Delay: The time between proposal submission and the start of voting.
  • Voting Period: The fixed duration (e.g., 3-7 days) during which votes can be cast.
  • Execution Delay/Eta: A mandatory waiting period after a successful vote before the proposal can be executed, providing a final safety window.
  • Quorum: The minimum percentage of voting power that must participate for the result to be valid.
04

Voting Mechanism & Options

Defines how token holders express their preference. Common systems include:

  • Weighted Voting: Votes are proportional to the voter's token balance (e.g., 1 token = 1 vote).
  • Quadratic Voting: Voting power increases with the square root of tokens committed, reducing whale dominance.
  • Vote Options: Typically For, Against, and Abstain. Some systems include more granular options or ranked choice. Votes are usually cast on-chain, though snapshot voting (off-chain signaling) is also used for gas-free discussions.
05

Execution & State Machine

A proposal progresses through a series of immutable states:

  1. Pending: Submitted but not yet active for voting.
  2. Active: The voting period is open.
  3. Succeeded/Failed: Determined at the end of voting based on quorum and majority thresholds.
  4. Queued: A successful proposal waits for the execution delay.
  5. Executed: The calldata is successfully executed on-chain.
  6. Canceled/Expired: Terminated by the proposer or after a timeout. This state machine ensures orderly and predictable process flow.
06

Security Parameters & Timelocks

Critical safeguards are embedded to protect the protocol:

  • Timelock: A mandatory delay between a successful vote and execution. This allows users to react to or exit from potentially harmful changes.
  • Proposal Threshold: The minimum token balance required to submit a proposal, preventing spam.
  • Guardian/Pause Mechanism: Some protocols have a multisig or emergency role that can pause or cancel malicious proposals before execution, acting as a final backstop.
proposal-types
GOVERNANCE

Common Types of Governance Proposals

Governance proposals are formal, on-chain suggestions for protocol changes, categorized by their scope and impact. Here are the most prevalent types.

05

Informational & Signaling

A non-binding proposal used to gauge community sentiment on a topic before submitting a binding on-chain proposal. It serves as a temperature check.

Typical uses:

  • Signaling support for a broad strategic direction.
  • Gathering feedback on a potential parameter change or partnership.
  • Officially stating the community's stance on an external event.

While not executable, these proposals are vital for building consensus and reducing governance friction.

GOVERNANCE MECHANISMS

Proposal Formats: On-Chain vs. Off-Chain

A comparison of the core technical and procedural characteristics of on-chain and off-chain governance proposals.

FeatureOn-Chain ProposalOff-Chain Proposal

Execution Mechanism

Code is executed automatically upon successful vote

Result signals intent; requires manual execution by privileged actors

Transaction Cost

High (pays for on-chain execution gas)

Low or Zero (hosted on forums, Snapshot)

Finality & Immutability

Immutable and cryptographically verifiable

Malleable; subject to social consensus and interpretation

Execution Speed

Deterministic, bound by blockchain finality (e.g., timelocks)

Variable, depends on human coordination and response time

Technical Barrier

High (requires smart contract deployment knowledge)

Low (accessible via web interfaces)

Typical Use Case

Parameter changes, treasury disbursements, protocol upgrades

Temperature checks, signaling, meta-governance, community sentiment

Sybil Resistance

Native (based on token holdings/proof-of-stake)

Delegated (often via token-weighted snapshot)

Example Platforms

Compound Governor, Aave Governance, Uniswap Governance

Discourse, Commonwealth, Snapshot, Tally

ecosystem-usage
KEY CONCEPTS

Governance Proposals in Practice

A governance proposal is a formal, on-chain submission for a protocol change, requiring token-holder approval. This section details its lifecycle, common types, and the mechanisms that ensure secure and transparent decision-making.

01

The Proposal Lifecycle

A governance proposal follows a structured path from ideation to execution.

  • Drafting & Discussion: Initial ideas are debated in community forums (e.g., governance forums, Discord) to gauge sentiment.
  • Temperature Check: A preliminary, often off-chain, vote to measure broad support before committing on-chain resources.
  • Formal Submission: The proposal, including executable code or detailed specifications, is submitted on-chain, locking a proposal bond.
  • Voting Period: Token holders cast votes, typically weighted by their stake, during a fixed window (e.g., 3-7 days).
  • Execution: If the vote passes the required quorum and approval threshold, the proposal's changes are automatically executed via a timelock contract after a delay.
02

Common Proposal Types

Proposals can mandate various levels of change to a protocol's operation.

  • Parameter Changes: Adjusting system variables (e.g., interest rates, fee percentages, collateral factors).
  • Treasury Management: Allocating funds from the community treasury for grants, development, or other initiatives.
  • Protocol Upgrades: Authorizing smart contract upgrades or migrations, often the most critical type of proposal.
  • Informational Proposals: Signaling votes to guide future development without immediate on-chain execution.
03

Voting Mechanisms & Power

How votes are cast and counted is fundamental to governance integrity.

  • Token-Weighted Voting: One token equals one vote. This is the most common model, aligning voting power with economic stake.
  • Quadratic Voting: Voting power increases with the square root of tokens committed, designed to reduce whale dominance.
  • Delegation: Token holders can delegate their voting power to representatives or delegates who vote on their behalf.
  • Snapshot Voting: A gas-free, off-chain signing mechanism used for signaling; final execution still requires an on-chain proposal.
04

Security Safeguards

Critical mechanisms protect protocols from malicious or erroneous proposals.

  • Proposal Bond: A deposit required to submit a proposal, which is slashed if the proposal fails to meet a minimum participation (quorum).
  • Timelock: A mandatory delay between a proposal's approval and its execution. This provides a final review period where users can exit the system if they disagree with the change.
  • Multisig Execution: In some systems, a multisig wallet controlled by elected delegates or a foundation holds the final execution power, acting as an additional check.
05

Real-World Example: Uniswap

Uniswap's governance process illustrates a mature DAO structure.

  • Governance Token: UNI holders govern the protocol.
  • Process: Proposals move from the Uniswap Forum → Snapshot temperature check → on-chain vote.
  • Delegation: Most UNI is delegated to entities like a16z, GFX Labs, and other delegates.
  • Execution: The Uniswap Governor Bravo contract manages proposals, with a 2-day voting period and a 2-day timelock. A famous example is the successful proposal to deploy Uniswap v3 to Polygon via a consensus grant.
security-considerations
GOVERNANCE PROPOSAL

Security & Governance Risks

A governance proposal is a formal, on-chain mechanism for stakeholders to submit, debate, and vote on changes to a decentralized protocol's parameters, code, or treasury. This section details the technical risks inherent in this process.

01

Voter Apathy & Low Participation

A critical vulnerability where a small minority of token holders can dictate protocol changes due to widespread voter abstention. This undermines decentralization and can lead to hostile takeovers.

  • Example: A proposal with 5% voter turnout can pass with just 2.6% of total supply.
  • Risk: Concentrates power, enabling whale manipulation or apathy-driven attacks.
02

Proposal Spam & Griefing

The act of flooding the governance system with low-quality or malicious proposals to exhaust community attention, waste gas fees, and create operational chaos.

  • Mechanism: Attackers exploit low proposal submission costs.
  • Impact: Creates noise, obscures legitimate proposals, and can trigger emergency measures that centralize power.
03

Time-Based Attacks (Time Bandit)

An attack vector where a malicious actor manipulates the timing of proposal execution to exploit market conditions or protocol states.

  • How it works: An attacker passes a benign proposal, then front-runs its execution with a malicious transaction when market volatility or specific on-chain conditions are favorable.
  • Defense: Requires robust timelocks and execution delay mechanisms.
04

Parameter Manipulation Risk

The risk that a passed proposal inadvertently or maliciously changes a critical protocol parameter, causing systemic failure.

  • Critical parameters: Include slashing penalties, collateral ratios, fee structures, and oracle configurations.
  • Consequence: A single bad parameter update can lead to insolvency, mass liquidations, or protocol freeze.
05

Smart Contract Implementation Risk

The risk that the code executing the proposal's outcome contains bugs, allowing unintended behavior or exploitation.

  • Scope: Affects the proposal's execution contract, not the core protocol.
  • Example: A bug in a treasury disbursement contract could allow funds to be drained post-approval.
  • Mitigation: Requires rigorous auditing and formal verification of proposal payloads.
06

Vote Buying & Collusion

A coordination attack where entities bribe or collude to accumulate voting power and pass proposals against the network's economic interests.

  • Mechanisms: Include on-chain bribery markets (e.g., using protocols like Hidden Hand) or off-chain deals.
  • Threat: Converts governance from a one-token-one-vote system to a one-dollar-one-vote system, subverting decentralization.
GOVERNANCE PROPOSAL

Frequently Asked Questions

Essential questions and answers about on-chain governance proposals, the formal mechanism for enacting changes to decentralized protocols.

A governance proposal is a formal, on-chain submission that outlines a specific change or action for a decentralized protocol, requiring approval from its token holders or delegates. It functions as the primary mechanism for decentralized autonomous organizations (DAOs) and other community-led protocols to manage upgrades, treasury allocations, and parameter adjustments. Proposals are typically submitted via a smart contract, where they are assigned a unique identifier and enter a structured voting period. The process ensures that protocol evolution is transparent, auditable, and driven by the collective will of its stakeholders, rather than a centralized development team.

ENQUIRY

Get In Touch
today.

Our experts will offer a free quote and a 30min call to discuss your project.

NDA Protected
24h Response
Directly to Engineering Team
10+
Protocols Shipped
$20M+
TVL Overall
NDA Protected Directly to Engineering Team