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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.treem.io/treem-dao/governance/proposals.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.