> For the complete documentation index, see [llms.txt](https://docs.treem.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.treem.io/treem-dao/governance/proposals.md).

# 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**

```markdown
# 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:

```typescript
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

```sql
-- 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

```solidity
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.