Project Overview
Valenor is a decentralized autonomous social fund platform built on the Ethereum Sepolia testnet. It enables transparent, community-driven funding for social impact projects through blockchain technology and democratic governance.
GitHub Page:Valenor
Core Features
1. Donation System
- USDC-based donations to social impact projects
- Transparent tracking of all donations on-chain
- Project-specific funding pools
- Real-time balance updates and statistics
- Milestone-based fund release mechanism
2. Governance System
- Democratic proposal creation (requires 1000 USDC voting power)
- Community voting on fund allocation
- 7-day voting period for each proposal
- Automated execution of passed proposals
- Voting power based on donation amounts
3. ETH Vault
- Secure ETH storage facility
- User-friendly deposit/withdraw interface
- Real-time balance tracking
- Transaction history monitoring
- Maximum amount safety checks
4. AI Integration
- Proposal analysis using AI
- Fraud detection for submitted documents
- Risk assessment for projects
- Automated scoring system
- Recommendation engine for voters
Technical Architecture
Smart Contracts
- TestUSDC (0x249Cd8D3C907ae0565C0Fd1f335b098f5b85121A)
- ERC20 token implementation
- 6 decimal precision
- Minting capability for testing
- Standard transfer and approval functions
- FundContract (0x534d7313353445378519286b81d8B9Ff4084d0e9)
- Donation management
- Project fund tracking
- Milestone release system
- Balance monitoring
- GovernanceContract (0x49cbb6E45f8869ca48537EE162159A3b8FF1Ea86)
- Proposal creation and management
- Voting system implementation
- Power calculation algorithms
- Execution automation
- EthVault (0x7cFf25AD0b8dd107dc40f985631f72a601D50ac9)
- ETH storage management
- Secure withdrawal system
- Balance tracking
- Event emission for transactions
Frontend Architecture
- React + Vite for fast development
- TypeScript for type safety
- Tailwind CSS for styling
- Wagmi for blockchain interactions
- Web3Modal for wallet connections
Backend Services
- Node.js + Express server
- MongoDB for data persistence
- FastAPI for AI service
- PDF processing for document analysis
- Real-time updates via WebSocket
User Flow
A. Donation Process
- Connect wallet
- Select project
- Approve USDC spending
- Make donation
- Receive voting power
B. Proposal Creation
- Verify voting power (≥1000 USDC)
- Submit proposal details
- Get AI analysis
- Confirm submission
- Start voting period
C. Voting Process
- Review active proposals
- Check voting power
- Cast vote (Yes/No)
- Monitor results
- Execute if passed
4. ETH Vault Usage
- Access vault interface
- View balances
- Deposit/Withdraw ETH
- Confirm transactions
- Track history
Security Features
- Reentrancy protection
- Access control systems
- Input validation
- Balance checks
- Transaction limits
- Event logging