OperatingBudgetVault

📋 Contract Overview

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

🎯 Purpose: Manages day-to-day operational funds for Built By DAO—providing controlled access to funds for operational expenses without requiring full governance approval for each transaction, while maintaining appropriate oversight.

---

📊 Budget Categories

📊 Budget Categories

Category	Monthly Budget	Description
💰 Payroll	$150,000	Staff salaries
🔧 Contractors	$75,000	Contract workers
🏢 Facilities	$30,000	Building costs
⚡ Utilities	$15,000	Power, water, etc.
📣 Marketing	$25,000	Promotion
⚖️ Legal	$20,000	Legal services
💻 Technology	$35,000	Tech infrastructure
✈️ Travel	$10,000	Business travel
📦 Supplies	$10,000	Office supplies
📋 Miscellaneous	$30,000	Other expenses

⚙️ Specifications

🔐 Roles

---

📊 Operating Budget Flow

DAOBusiness Revenue
        ↓
   [Allocation]
        ↓
 OperatingBudgetVault
        ↓
   [Approved Spending]
        ↓
Operational Expenses

---

👥 Spending Authority Levels

Different roles have different spending limits.

Level	Single Limit	Daily Limit	Categories
📋 Coordinator	$1,000	$3,000	Supplies, Travel
👔 Manager	$5,000	$15,000	+ Contractors, Marketing
📈 Director	$20,000	$50,000	+ Facilities, Technology
👑 Executive	$50,000	$100,000	All categories

---

🔧 Functions

💳 Spending

💳 Spending Functions

Spend Tokens

function spend(
    address token,
    address recipient,
    uint256 amount,
    BudgetCategory category,
    string calldata description,
    bytes32 referenceId
) external onlyRole(SPENDER_ROLE) nonReentrant

Requirements:

• Within spender's single transaction limit

• Within spender's daily limit

• Within vault's daily limit

• Within monthly budget for category

• Category is allowed for spender

Spend ETH

function spendETH(
    address recipient,
    uint256 amount,
    BudgetCategory category,
    string calldata description,
    bytes32 referenceId
) external onlyRole(SPENDER_ROLE) nonReentrant

📊 Budget

👤 Spenders

👁️ View

---

✅ Spending Validation

Every expense is validated against multiple limits.

function _validateSpending(
    address spender,
    uint256 amount,
    BudgetCategory category
) internal view {
    SpenderAuth storage auth = authorizedSpenders[spender];

    // Check spender authorization
    require(auth.authorized, "Not authorized");

    // Check single transaction limit
    require(amount <= auth.singleLimit, "Exceeds single limit");
    require(amount <= singleTransactionLimit, "Exceeds vault single limit");

    // Check daily limit
    require(
        _getSpenderDailySpent(spender) + amount <= auth.dailyLimit,
        "Exceeds spender daily limit"
    );
    require(
        dailySpent + amount <= dailySpendingLimit,
        "Exceeds vault daily limit"
    );

    // Check category
    require(_isAllowedCategory(spender, category), "Category not allowed");

    // Check category budget
    CategoryBudget storage budget = categoryBudgets[category];
    require(budget.active, "Category not active");
    require(
        budget.spent + amount <= budget.monthlyBudget,
        "Exceeds category budget"
    );
}

---

📜 Events & Errors

📢 Events

event FundsDeposited(
    address indexed token,
    uint256 amount
);
event ExpenseProcessed(
    address indexed spender,
    address indexed recipient,
    address indexed token,
    uint256 amount,
    BudgetCategory category,
    bytes32 referenceId
);
event SpenderAuthorized(
    address indexed spender,
    uint256 singleLimit,
    uint256 dailyLimit
);
event SpenderRevoked(address indexed spender);
event CategoryBudgetSet(
    BudgetCategory indexed category,
    uint256 budget
);
event MonthlyBudgetsReset(uint256 timestamp);
event ExcessTransferred(
    address indexed treasury,
    uint256 amount
);

⛔ Errors

---

🔍 Audit Features

Every expense is recorded with complete audit trail.

Field	Description
⏱️ Timestamp	When expense occurred
👤 Spender	Who initiated
📤 Recipient	Payment destination
💰 Amount/Token	Value transferred
📁 Category	Budget category
📝 Description	Expense description
🔗 Reference ID	External reference

Audit Report

function generateAuditReport(
    uint256 month,
    uint256 year
) external view returns (
    uint256 totalSpent,
    uint256[] memory byCategory,
    ExpenseRecord[] memory expenses
)

---

🔗 Contract Interactions

Contract	Interaction
💼 DAOBusiness	Deposits operating allocation
🏦 Treasury	Receives excess funds
📤 Payment Recipients	Receives expenses

---

💻 Integration Examples

Processing an Expense

// As authorized spender
await operatingBudget.spend(
    usdcAddress,
    vendorAddress,
    parseUnits("2500", 6),
    4, // BudgetCategory.Marketing
    "Social media campaign - Q1 2024",
    ethers.utils.formatBytes32String("INV-2024-0142")
);

Checking Available Budget

const available = await operatingBudget.getAvailableBudget(4); // Marketing
console.log(`Marketing budget remaining: $${formatUnits(available, 6)}`);

Getting Expense Report

const { budget, spent, remaining, percentUsed } =
    await operatingBudget.getCategoryReport(4);
console.log(`Marketing: $${formatUnits(spent, 6)} / $${formatUnits(budget, 6)} (${percentUsed}%)`);

Authorizing a Spender

await operatingBudget.authorizeSpender(
    managerAddress,
    parseUnits("5000", 6),   // Single limit
    parseUnits("15000", 6),  // Daily limit
    [1, 4, 6]  // Contractors, Marketing, Technology
);

---

🔗 Related Pages

DAOBusinessTreasuryGovernance