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: InstantActivities:
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
Navigate to Creation Interface
Go to Governance → Create Proposal
Select proposal type (General or Grant)
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
Add Supporting Materials
Resources: Links to relevant documents
Actions: Smart contract calls (advanced)
Timeline: Project milestones and deadlines
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
Navigate to Proposal
Go to Governance → Active Proposals
Click on proposal to view details
Review Proposal
Read title, summary, and full description
Check supporting resources
Consider community discussions
Cast Vote
Select vote type (For/Against)
Optionally add reasoning comment
Click "Cast Vote"
Confirm transaction in wallet
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
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
"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.
Last updated
Was this helpful?