Governance

📋 Contract Overview

Property	Value
📁 File	src/Governance.sol
🔧 Type	Upgradeable UUPS Proxy
⚙️ Solidity	0.8.33
📜 License	MIT

🎯 Purpose: Implements Built By DAO's V2.1 governance system with quadratic voting, 4× power ceiling, and recency-weighted activity.

---

🌟 V2.1 Features

🌟 Governance V2.1 Features

Feature	Description
📊 Quadratic Voting	Power = √(EQTBLT balance)
🔝 4× Power Ceiling	Maximum voting multiplier
📈 Rank Weighting	1.00×-1.25× by rank
⏱️ Recency Weighting	Recent activity weighted more
💰 Investor Multipliers	NFT-based, capped at 5×
🪙 Proposal Staking	2 BLTBY required

⚙️ Specifications

🔐 Roles

---

📋 Proposal System

📊 Structure

📊 Proposal Structure

struct Proposal {
    uint256 id;
    address proposer;
    string title;
    string description;
    ProposalType proposalType;
    uint256 startTime;
    uint256 endTime;
    uint256 forVotes;
    uint256 againstVotes;
    uint256 abstainVotes;
    ProposalStatus status;
    bytes[] calldatas;
    address[] targets;
    uint256[] values;
}

🏷️ Types

📊 Status

---

🔧 Functions

📝 Create

📝 Create Proposal

function createProposal(
    string calldata title,
    string calldata description,
    ProposalType proposalType,
    address[] calldata targets,
    uint256[] calldata values,
    bytes[] calldata calldatas
) external returns (uint256)

Access: Any member with 2 BLTBY stake

Requirements

Requirement	Details
🎫 Membership	Must hold Membership NFT
🪙 Stake	Must have 2 BLTBY
✅ Valid structure	Proper proposal format

🗳️ Vote

⚡ Execute

❌ Cancel

---

🗳️ Voting Power Calculation

Voting power combines multiple factors with a 4× maximum cap.

function getVotingPower(address voter) public view returns (uint256) {
    // Base: Quadratic on EQTBLT
    uint256 basePower = sqrt(eqtbltToken.balanceOf(voter)) * 100;

    // Apply multipliers
    uint256 rankMultiplier = rankRegistry.getWeight(rank);
    uint256 activityMultiplier = activityTracker.getRecencyMultiplier(voter);
    uint256 investorMultiplier = getInvestorMultiplier(voter);

    // Calculate and cap at 4×
    uint256 totalPower = basePower * rankMultiplier * activityMultiplier * investorMultiplier;
    uint256 maxPower = basePower * MAX_POWER_MULTIPLIER;
    return totalPower > maxPower ? maxPower : totalPower;
}

---

🔝 The 4× Ceiling

The ceiling prevents any single member from dominating governance.

Scenario	Without Ceiling	With Ceiling
🐋 Whale with 1M EQTBLT	1000× base	4× base
📈 High-rank + high-balance	Unlimited	Capped at 4×
💰 Major investor	Could outweigh community	Limited

---

📊 Quadratic Voting

Quadratic voting provides diminishing returns, preventing plutocracy.

EQTBLT Balance	Linear Power	Quadratic Power
100	100	10
1,000	1,000	~31.6
10,000	10,000	100
100,000	100,000	~316

Result: 100 members with 100 EQTBLT each have more power than 1 member with 10,000 EQTBLT.

---

⏱️ Recency Weighting

Activity is weighted by recency—active members have more power.

Time Window	Weight
Last 30 days	100%
31-90 days	70%
91-180 days	40%
>180 days	20%

---

📜 Events & Errors

📢 Events

event ProposalCreated(
    uint256 indexed proposalId,
    address indexed proposer,
    string title,
    ProposalType proposalType
);
event VoteCast(
    uint256 indexed proposalId,
    address indexed voter,
    VoteType voteType,
    uint256 weight
);
event ProposalExecuted(uint256 indexed proposalId);
event ProposalCancelled(uint256 indexed proposalId);
event ProposalStatusChanged(uint256 indexed proposalId, ProposalStatus status);

⛔ Errors

---

🔗 Contract Interactions

Contract	Interaction
🪙 BLTBYToken	Stakes for proposals
💎 EQTBLTToken	Reads balance for voting power
🎫 MembershipNFT	Verifies membership, reads rank
🗳️ VotingRegistry	Gets rank-based weights
📊 ActivityTracker	Gets recency multipliers
🏦 Treasury	Executes approved withdrawals

---

💻 Integration Examples

Creating a Proposal

// Approve BLTBY stake
await bltbyToken.approve(governanceAddress, stakeAmount);

// Create proposal
const tx = await governance.createProposal(
    "Fund Foundry Equipment",
    "Allocate 50,000 USDC for equipment upgrade",
    0, // Operational
    [treasuryAddress],
    [0],
    [withdrawCalldata]
);

Voting

await governance.vote(proposalId, 0); // 0 = For

Checking Power

const power = await governance.getVotingPower(voterAddress);

---

🔗 Related Pages

Treasuryhttps://github.com/urbanarray/builtbydocs/blob/main/docs/developers/contracts/voting-registry.mdhttps://github.com/urbanarray/builtbydocs/blob/main/docs/developers/contracts/activity-tracker.mdDAOMembershipNFTGovernance V2.1Voting Power