Chore: Restructure Contract Architecture for Scalable Privacy-First Development

[emarc99]

🗒️ Description:

The current contract codebase has significant architectural issues that prevent proper development and deployment. We need a complete restructuring to support ShadowChat's privacy-first, decentralized social network vision with proper separation of concerns, consistent patterns, and scalable design.

---

⚠️ Current Problems:

1. Mixed Cairo versions - Cairo 0 and Cairo 2 contracts coexist
2. Inconsistent storage patterns - Vec vs Map+Counter mismatches
3. Duplicate contract definitions - Multiple ProfileSystem implementations
4. Poor separation of concerns - All contracts mixed in single files
5. Missing core infrastructure - No encryption, governance, or identity layers
6. Inconsistent naming conventions - Mixed patterns across contracts
7. No clear module boundaries - Hard to maintain and extend

---

🏗️ Proposed Architecture:

contract/
├── src/
│   ├── lib.cairo                 # Main entry point, exports all modules
│   ├── core/
│   │   ├── mod.cairo            # Core module exports
│   │   ├── storage.cairo        # Shared storage patterns and utilities
│   │   ├── events.cairo         # Common event definitions
│   │   └── errors.cairo         # Custom error types
│   ├── messaging/
│   │   ├── mod.cairo           # Messaging module exports
│   │   ├── message_storage.cairo # Message storage contract
│   │   ├── media_sharing.cairo  # Media sharing contract
│   │   └── encryption.cairo     # E2E encryption layer
│   ├── identity/
│   │   ├── mod.cairo           # Identity module exports
│   │   ├── profile_nft.cairo   # User profile NFT contract
│   │   ├── anonymous_identity.cairo # ZK-based anonymous identity
│   │   └── reputation.cairo    # Reputation system
│   ├── governance/
│   │   ├── mod.cairo           # Governance module exports
│   │   ├── community.cairo     # Community/group management
│   │   ├── voting.cairo        # Voting and proposal system
│   │   └── moderation.cairo    # Content moderation
│   └── storage/
│       ├── mod.cairo           # Storage module exports
│       ├── ipfs_manager.cairo  # IPFS integration
│       └── arweave_manager.cairo # Arweave integration
├── tests/
│   ├── integration/            # Integration tests
│   ├── unit/                  # Unit tests by module
│   └── fixtures/              # Test data and utilities
└── migrations/                # Contract upgrade scripts

---

Acceptance Criteria:

🤖 Build & Compilation:

• scarb build succeeds without warnings
• All contracts compile with Cairo 2.11.4
• No duplicate contract definitions
• Consistent storage patterns across all contracts
• Proper module exports and imports

⚒️ Functionality:

• All existing functionality preserved
• Storage operations work consistently
• Events emit correctly for all state changes
• Error handling prevents invalid operations
• Cross-contract calls work properly

🧪 Testing:

• All existing tests pass

📝 Documentation:

• Architecture documentation complete
• Deployment guides for each module
• Integration examples provided

---

Uniti sumus.