Proposals

Proposals are the core mechanism for making decisions in Treem DAO. This guide covers the proposal lifecycle, types, creation process, and voting procedures.

Proposal Types

General Proposals

Purpose: Protocol changes, parameter updates, general governance decisions

Examples:

• Updating governance parameters (voting period, quorum)

• Protocol upgrades and improvements

• Treasury allocation strategies

• Partnership approvals

• Community guidelines changes

Requirements:

• Creation: Must hold proposal threshold (5,000,000 TREEM)

• Voting: All stakers (6+ months) can vote

• Execution: Requires majority approval and quorum

Grant Proposals

Purpose: Funding requests for community projects and initiatives

Examples:

• Development grants for new features

• Community event funding

• Research project funding

• Marketing and outreach initiatives

• Infrastructure improvements

Requirements:

• Creation: 12-month stakers only

• Voting: All stakers (6+ months) can vote

• Special Fields: Grant amount, recipient, detailed budget

Proposal Lifecycle

1. Creation Phase

Duration: Instant

Activities:

• Proposal submitted to blockchain

• Proposal ID generated

• Initial state: "Pending"

2. Voting Delay

Duration: 1 day (7,200 blocks)

Purpose:

• Allow community to review proposal

• Prevent last-minute vote manipulation

• Enable stake adjustments before voting

3. Active Voting

Duration: 7 days (50,400 blocks)

Activities:

• Community members cast votes

• Voting power calculated at proposal creation time

• Vote tallies updated in real-time

4. Voting Results

Outcomes:

• Succeeded: Majority approval + quorum met

• Defeated: Majority rejection or quorum not met

• Queued: Successful proposal queued for execution

5. Execution Delay (Timelock)

Duration: 2 days (for successful proposals)

Purpose:

• Security measure against malicious proposals

• Allow time for emergency interventions

• Transparent execution timeline

6. Execution

Final States:

• Executed: Proposal actions performed

• Expired: Execution window missed

• Cancelled: Emergency cancellation (rare)

Creating Proposals

Prerequisites

For General Proposals:

• Hold at least 5,000,000 TREEM tokens

• Tokens must be available at proposal creation time

For Grant Proposals:

• Active 12-month stake

• Tokens locked for at least 365 days

Proposal Creation Process

1. Navigate to Creation Interface

   • Go to Governance → Create Proposal

   • Select proposal type (General or Grant)

2. Fill Proposal Details

   Required Fields:

   • Title: Clear, descriptive title (max 100 characters)

   • Summary: Brief overview (max 500 characters)

   • Description: Detailed explanation (no limit)

   Grant-Specific Fields:

   • Grant Amount: Requested TREEM tokens

   • Recipient: Individual or organization name

   • Budget Breakdown: Detailed fund allocation

3. Add Supporting Materials

   • Resources: Links to relevant documents

   • Actions: Smart contract calls (advanced)

   • Timeline: Project milestones and deadlines

4. Review and Submit

   • Verify all information

   • Estimate gas costs

   • Submit proposal transaction

   • Confirm in wallet

Best Practices for Proposal Creation

Title Guidelines

• Be specific and clear

• Include proposal type

• Keep under 100 characters

• Example: "Grant Proposal: Community Education Platform Development"

Summary Guidelines

• Explain the core proposal in 1-2 sentences

• Include key metrics (amounts, timelines)

• Make it scannable for quick understanding

Description Guidelines

• Background: Explain the problem or opportunity

• Solution: Describe your proposed approach

• Impact: Explain expected outcomes

• Timeline: Provide clear milestones

• Budget: Justify requested amounts (for grants)

• Team: Introduce key contributors

Grant Proposal Template

# Grant Proposal: [Project Name]

## Summary
Brief 1-2 sentence description of the project and funding request.

## Background
- Current situation/problem
- Why this project is needed
- Alignment with DAO goals

## Proposed Solution
- Detailed project description
- Technical approach
- Deliverables and milestones

## Team
- Team member backgrounds
- Relevant experience
- Past contributions to DAO

## Budget Breakdown
| Item | Amount (TREEM) | Justification |
|------|---------------|---------------|
| Development | X,XXX | Description |
| Marketing | X,XXX | Description |
| Operations | X,XXX | Description |
| **Total** | **X,XXX** | |

## Timeline
- Month 1-2: Initial development
- Month 3-4: Testing and refinement
- Month 5-6: Launch and promotion

## Success Metrics
- Specific, measurable outcomes
- Timeline for evaluation
- Reporting commitments

## Risk Assessment
- Potential challenges
- Mitigation strategies
- Contingency plans

Voting Process

Voting Mechanism

Vote Types:

• For: Support the proposal

• Against: Oppose the proposal

• Abstain: Neutral position (not implemented in current version)

Voting Power:

• Equal to staked TREEM tokens

• Calculated at proposal creation time

• Cannot be changed during voting period

Casting Votes

1. Navigate to Proposal

   • Go to Governance → Active Proposals

   • Click on proposal to view details

2. Review Proposal

   • Read title, summary, and full description

   • Check supporting resources

   • Consider community discussions

3. Cast Vote

   • Select vote type (For/Against)

   • Optionally add reasoning comment

   • Click "Cast Vote"

   • Confirm transaction in wallet

4. Verify Vote

   • Check vote appears in proposal

   • Verify voting power counted correctly

   • Track in personal voting history

Voting Strategy

Research Phase:

• Read proposal thoroughly

• Check creator's background

• Review community feedback

• Consider long-term implications

Decision Framework:

• Alignment with DAO mission

• Financial impact assessment

• Technical feasibility

• Community benefit analysis

Proposal States

State Definitions

State	Description	Duration
Pending	Proposal created, voting not yet active	1 day
Active	Voting period in progress	7 days
Succeeded	Majority approval + quorum met	-
Defeated	Majority rejection or quorum not met	-
Queued	Successful proposal queued for execution	2 days
Executed	Proposal actions completed	-
Cancelled	Proposal cancelled (emergency only)	-
Expired	Execution window missed	-

State Transitions

Created → Pending → Active → [Succeeded/Defeated]
                      ↓
Succeeded → Queued → Executed

Quorum and Approval Requirements

Quorum Calculation

Quorum = 4% of Total TREEM Supply
Current Quorum = 40,000,000 TREEM (4% of 1B total supply)

Approval Threshold

Approval = For Votes > Against Votes
Minimum Participation = Total Votes ≥ Quorum

Example Scenarios

Scenario 1 - Successful Proposal:

• For: 45,000,000 TREEM

• Against: 15,000,000 TREEM

• Total: 60,000,000 TREEM

• Result: ✅ Succeeds (majority + quorum met)

Scenario 2 - Failed Quorum:

• For: 25,000,000 TREEM

• Against: 10,000,000 TREEM

• Total: 35,000,000 TREEM

• Result: ❌ Defeated (quorum not met)

Scenario 3 - Majority Rejection:

• For: 20,000,000 TREEM

• Against: 30,000,000 TREEM

• Total: 50,000,000 TREEM

• Result: ❌ Defeated (majority against)

Advanced Features

Proposal Actions

Proposals can include executable actions:

interface ProposalAction {
  target: string;    // Contract address
  value: bigint;     // ETH value to send
  calldata: string;  // Function call data
}

Example Actions:

• Update governance parameters

• Transfer treasury funds

• Upgrade smart contracts

• Grant administrative roles

Emergency Procedures

Emergency Cancellation:

• Multi-sig wallet can cancel malicious proposals

• Used only for security threats

• Requires transparent justification

• Community review after cancellation

Analytics and Tracking

Proposal Metrics

Participation Metrics:

• Total votes cast

• Unique voters

• Voting power distribution

• Participation rate by stake tier

Outcome Analysis:

• Proposal success rate

• Average voting period

• Quorum achievement rate

• Execution success rate

Individual Tracking

User Dashboard:

• Proposals created

• Votes cast

• Voting history

• Reward earnings

• Participation statistics

Integration Points

Database Schema

-- Proposals table
CREATE TABLE proposals (
    id UUID PRIMARY KEY,
    title TEXT NOT NULL,
    summary TEXT,
    body TEXT,
    proposal_type TEXT DEFAULT 'general',
    grant_amount INTEGER,
    grant_recipient TEXT,
    status TEXT DEFAULT 'active',
    votes_for INTEGER DEFAULT 0,
    votes_against INTEGER DEFAULT 0,
    creator_id UUID NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

-- Proposal votes table  
CREATE TABLE proposal_votes (
    id UUID PRIMARY KEY,
    proposal_id UUID NOT NULL,
    user_id UUID NOT NULL,
    vote_type TEXT NOT NULL,
    voting_power INTEGER NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

Smart Contract Events

event ProposalCreated(
    uint256 proposalId,
    address proposer,
    address[] targets,
    uint256[] values,
    string[] signatures,
    bytes[] calldatas,
    uint256 startBlock,
    uint256 endBlock,
    string description
);

event VoteCast(
    address indexed voter,
    uint256 proposalId,
    uint8 support,
    uint256 weight,
    string reason
);

Troubleshooting

Common Issues

Cannot Create Proposal:

• Check TREEM balance meets threshold

• Verify wallet connection

• Ensure sufficient gas

• Check for existing pending proposals

Voting Power Shows Zero:

• Verify tokens were staked before proposal creation

• Check delegation settings

• Confirm stake is active

• Wait for blockchain confirmation

Transaction Fails:

• Increase gas limit

• Check network congestion

• Verify wallet balance

• Try during off-peak hours

Error Messages

Error	Cause	Solution
"Below proposal threshold"	Insufficient TREEM balance	Acquire more tokens or delegate
"Proposal not active"	Voting period not started/ended	Wait or check proposal status
"Already voted"	Vote already cast	Cannot change vote once cast
"Insufficient voting power"	No staked tokens	Stake tokens before voting

This comprehensive proposals documentation covers all aspects of creating, managing, and voting on proposals in Treem DAO.