FounderFund

📋 Contract Overview

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

🎯 Purpose: Manages the founder's revenue allocation from Built By DAO operations—implementing controlled withdrawal mechanisms with vesting, limits, and full transparency to align founder incentives with long-term DAO success.

---

📊 Mechanics

📊 Fund Mechanics

Feature	Description
💰 Allocation	5% of all DAO revenue
📅 Vesting	50% immediate, 50% over 24 months
📆 Monthly Limit	Max 20% of balance per month
🔍 Transparency	Full on-chain history

This design aligns founder success with DAO success.

⚙️ Specifications

🔐 Roles

---

📊 Alignment Mechanisms

The FounderFund is designed to align founder and DAO interests through multiple mechanisms.

Mechanism	Purpose
💰 Revenue-based	Founder income tied to DAO success
⏱️ Vesting	Incentivizes long-term commitment
📆 Monthly limits	Prevents rapid extraction
🔍 Transparency	Builds community trust
⚖️ Governance limits	Community controls terms

---

🔧 Functions

📥 Deposits

📥 Deposit Functions

Deposit Tokens

function deposit(address token, uint256 amount) external

Access: Anyone (typically DAOBusiness)

Flow:

function deposit(address token, uint256 amount) external {
    IERC20(token).safeTransferFrom(msg.sender, address(this), amount);

    // Apply vesting
    uint256 vestedAmount = (amount * vestingPercentage) / 10000;
    uint256 unvestedAmount = amount - vestedAmount;

    vestedBalances[token] += vestedAmount;
    unvestedBalances[token] += unvestedAmount;
    tokenBalances[token] += amount;
}

Deposit ETH

function depositETH() external payable

📤 Withdrawals

⏱️ Vesting

👁️ View

---

📊 Monthly Limit Mechanics

The monthly limit prevents rapid fund extraction.

function _checkAndUpdateMonthlyLimit(uint256 amount, address token) internal {
    uint256 currentMonth = block.timestamp / 30 days;

    // Reset if new month
    if (currentMonth > lastWithdrawalMonth) {
        currentMonthWithdrawals = 0;
        lastWithdrawalMonth = currentMonth;
    }

    // Calculate limit
    uint256 totalValue = _getTotalValueUSD();
    uint256 monthlyLimit = (totalValue * monthlyWithdrawalLimit) / 10000;

    // Check limit
    require(
        currentMonthWithdrawals + _getValueUSD(token, amount) <= monthlyLimit,
        "Monthly limit exceeded"
    );

    currentMonthWithdrawals += _getValueUSD(token, amount);
}

---

📊 Default Limits

Limit	Value	Description
📆 Monthly	20%	Max 20% of balance per month
⏱️ Immediate Vest	50%	50% vests immediately
📅 Vesting Duration	24 months	Remaining vests over 24 months

---

📜 Events & Errors

📢 Events

event Deposited(
    address indexed token,
    uint256 amount,
    uint256 vestedAmount,
    uint256 unvestedAmount
);
event Withdrawn(
    address indexed token,
    uint256 amount,
    string purpose
);
event MonthlyLimitUpdated(
    uint256 oldLimit,
    uint256 newLimit
);
event WithdrawalsPaused(address indexed by);
event WithdrawalsResumed(address indexed by);
event VestingUpdated(
    address indexed token,
    uint256 newlyVested
);

⛔ Errors

---

🚨 Emergency Functions

⏸️ Pause

function pauseWithdrawals() external onlyRole(EMERGENCY_ROLE)

Pauses all withdrawals immediately.

▶️ Resume

---

🔍 Transparency Features

All founder fund activity is fully transparent:

Feature	Description
📜 On-chain History	All withdrawals recorded with purposes
💰 Public Balances	Anyone can query balances
📢 Event Logging	All activities emit events
⚖️ Governance Oversight	Limits set by governance

---

🔗 Contract Interactions

Contract	Interaction
💼 DAOBusiness	Deposits founder allocation
⚖️ Governance	Can modify limits
🏦 Treasury	Emergency recovery destination

---

💻 Integration Examples

Depositing (from DAOBusiness)

// In DAOBusiness.distributeRevenue()
await founderFund.deposit(usdcAddress, founderAmount);

Withdrawing (Founder)

// Check available
const available = await founderFund.getAvailableToWithdraw(usdcAddress);
console.log(`Available: $${formatUnits(available, 6)}`);

// Withdraw
await founderFund.withdraw(
    usdcAddress,
    parseUnits("10000", 6),
    "Personal expenses - January 2024"
);

Checking Balances

const { total, vested, unvested } = await founderFund.getBalances(usdcAddress);
console.log(`Total: $${formatUnits(total, 6)}`);
console.log(`Vested: $${formatUnits(vested, 6)}`);
console.log(`Unvested: $${formatUnits(unvested, 6)}`);

---

🔗 Related Pages

DAOBusinessGovernanceTreasury