# [Title]: Brief Description

## Summary
One paragraph explaining the change.

## Motivation
Why is this change needed? What problem does it solve?

## Specification
Technical details of the change:
- Contract: TrustVault
- Function: updateInterestRate(uint256)
- New value: 500 (5%)

## Security Considerations
Potential risks and mitigations.

## Timeline
When should this be implemented?

const governor = new ethers.Contract(GOVERNOR_ADDRESS, GovernorABI, signer);

// Prepare proposal
const targets = [TRUST_VAULT_ADDRESS];
const values = [0];
const calldatas = [
  trustVault.interface.encodeFunctionData('updateInterestRate', [500])
];
const description = "Proposal #5: Reduce base interest rate to 5%";

// Submit proposal
const tx = await governor.propose(
  targets,
  values,
  calldatas,
  description,
  0, // ProposalType.ParameterChange
  "QmIPFSHash..." // Link to full proposal
);

const receipt = await tx.wait();
const proposalId = receipt.events[0].args.proposalId;

// Vote options: 0 = Against, 1 = For, 2 = Abstain
await governor.castVote(proposalId, 1); // Vote For

// Vote with reason
await governor.castVoteWithReason(
  proposalId,
  1,
  "This will improve capital efficiency"
);

┌─────────────────────────────────────────────────────────────────┐
│  PROPOSAL LIFECYCLE                                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Pending ──► Active ──► Succeeded ──► Queued ──► Executed      │
│     │          │            │                                   │
│     │          │            └──► Defeated (not enough votes)    │
│     │          │                                                │
│     │          └──► Defeated (quorum not met)                   │
│     │                                                           │
│     └──► Cancelled (by proposer)                                │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

// Execute the proposal
await governor.execute(
  targets,
  values,
  calldatas,
  ethers.id(description)
);

await governor.cancel(
  targets,
  values,
  calldatas,
  ethers.id(description)
);

# Get all proposals
curl -X GET "https://api.usmewe.com/v1/governance/proposals"

# Get specific proposal
curl -X GET "https://api.usmewe.com/v1/governance/proposals/{id}"

# Get user's votes
curl -X GET "https://api.usmewe.com/v1/governance/votes/me" \
  -H "Authorization: Bearer YOUR_TOKEN"