Architecture

This document provides a comprehensive technical overview of Built By DAO's smart contract architecture and system design.

---

🏗️ Architecture Overview

📊 Layers	📜 Contracts	⛓️ Network	🔧 Pattern
6 functional	20 total	Base (L2)	UUPS Proxy

🎯 Purpose: Secure, upgradeable infrastructure for decentralized housing DAO

🔒 Principle: Layered architecture with clear separation of concerns

---

📊 System Layers

📊 Layered Architecture

Layer Overview

┌─────────────────────────────────────────────┐
│            🏛️ Governance Layer              │
│   Proposals, Voting, QV, 4× Ceiling         │
├─────────────────────────────────────────────┤
│            📊 Registry Layer                │
│   Rank Weights, Activity Tracking           │
├─────────────────────────────────────────────┤
│            👤 Identity Layer                │
│   Member NFTs, Investor NFTs                │
├─────────────────────────────────────────────┤
│            🪙 Token Layer                   │
│   BLTBY (Utility), EQTBLT (Equity)          │
├─────────────────────────────────────────────┤
│            💰 Financial Layer               │
│   Treasury, Bank, Vaults                    │
├─────────────────────────────────────────────┤
│            🏢 Business Layer                │
│   Revenue, Rentals, Redemption              │
└─────────────────────────────────────────────┘

---

Layer Responsibilities

Layer	Contracts	Responsibility
🏛️ Governance	Governance, VotingRegistry	Decision-making
📊 Registry	RankRegistry, ActivityTracker	Status tracking
👤 Identity	MembershipNFT, Investor NFTs	Member/investor identity
🪙 Token	BLTBY, EQTBLT	Value representation
💰 Financial	Treasury, Bank, Vaults	Asset management
🏢 Business	Business, Rental, Redemption	Operations

---

Layer Interactions

From	To	Interaction
🏛️ Governance	💰 Treasury	Execute approved spending
👤 Identity	🏛️ Governance	Voting power lookup
🪙 Token	💰 Financial	Minting, transfers
🏢 Business	🪙 Token	EQTBLT minting
📊 Registry	🏛️ Governance	Weight calculation

📜 Contract Map

🔄 Data Flow

🔐 Access Control

⬆️ Upgrades

🔗 Integrations

---

📊 Contract Interaction Diagram

User Wallet
     │
     ├──► MembershipNFT ──► Governance
     │                          │
     ├──► BLTBY Token          ↓
     │         │          VotingRegistry
     │         ↓               │
     │    BLTBYBank           ↓
     │         │          Treasury
     │         └──────────────┘
     │
     ├──► RentalAndRebate ──► EQTBLT Token
     │
     └──► RedemptionContract

---

🏗️ Architecture Principles

1. 📊 Layered design for maintainability

2. 🔐 Role-based access control

3. ⬆️ Selective upgradeability

4. 🔗 Standard integrations

---

🔗 Related Pages

💻OverviewSmart ContractsSecurityGovernance V2.1