📢 AdManager - Decentralized Advertising Ecosystem

🌟 Features

💰 Economic System

• Dynamic Pricing: Advertisement costs increase by 5% with each new listing
• Native Token (AdToken): ERC20 token powering rewards and governance
• Referral System: Earn 10% discounts and multi-level rewards
• Engagement Rewards: Get tokens for interacting with advertisements

🎮 Gamification

• Leveling System: Progress based on total engagements
• Achievements: Unlock accomplishments and earn rewards
• Community Challenges: Participate in collective goals with shared rewards
• Special Events: Temporary reward multipliers for increased incentives
• Chief of Advertising: Become the platform leader and earn a percentage of all transactions

🔒 Security

• ReentrancyGuard: Protection against reentrancy attacks
• AccessControl: Role-based permission system
• Pausable: Emergency pause capability
• Audited: All vulnerabilities identified and resolved

🌐 Multi-Chain Ready

Compatible with all EVM networks:

• ✅ Celo (Mainnet & Alfajores)
• ✅ Scroll (Mainnet & Sepolia)
• ✅ Base (Mainnet & Sepolia)
• ✅ Optimism (Mainnet & Sepolia)
• ✅ Arbitrum (One & Sepolia)
• ✅ Polygon (Mainnet & Mumbai)
• ✅ Ethereum (Mainnet & Sepolia)

📊 Project Statistics

🏗️ Architecture

AdManager Ecosystem
├── AdToken (ERC20)
│   ├── Controlled minting
│   └── Role-based access
│
├── Advertisement Management
│   ├── Ad creation
│   ├── Dynamic pricing
│   ├── Referral system
│   └── Deactivation
│
├── Engagement System
│   ├── Engagement rewards
│   ├── 24-hour cooldown
│   ├── Leveling system
│   └── Weekly bonus
│
├── Gamification
│   ├── Achievements
│   ├── Community challenges
│   ├── Special events
│   └── Chief of Advertising
│
└── Admin Functions
    ├── Pause/Unpause
    ├── Fund withdrawal
    ├── Add achievements
    └── Manage events

🚀 Quick Start

1. Prerequisites

# Install Foundry
curl -L https://foundry.paradigm.xyz | bash
foundryup

# Clone repository
git clone <your-repo>
cd admanager

# Install dependencies
forge install

2. Environment Setup

# Copy .env.example
cp .env.example .env

# Edit .env and add:
# - PRIVATE_KEY
# - RPC URLs
# - API Keys

3. Compile

4. Test

# All tests
forge test

# With details
forge test -vvv

# Coverage
forge coverage

5. Deploy

# Testnet (e.g., Celo Alfajores)
forge script script/DeployMultiChain.s.sol:DeployAdvertisementManager \
    --rpc-url $CELO_ALFAJORES_RPC_URL \
    --broadcast \
    --verify

# See DEPLOY_GUIDE.md for more options

🏆 Awards & Recognition

🥇 Reown Hackathon Winner

📊 Impact Metrics

View our comprehensive impact report on Karma GAP:

Key Achievements:

• 🎯 Innovative advertising model on blockchain
• 💡 Sustainable tokenomics design
• 🌍 Multi-chain deployment capability
• 🔒 Security-first approach with complete audit
• 🎮 Gamification driving user engagement

📚 Documentation

File Structure

.
├── src/
│   ├── AdvertisementManager.sol          # Original contract
│   └── AdvertisementManagerFixed.sol     # Audited version (USE THIS!)
├── script/
│   ├── Counter.s.sol                     # Legacy script
│   └── DeployMultiChain.s.sol           # Multi-chain script (USE THIS!)
├── test/
│   └── AdvertisementManager.t.sol        # Complete test suite
├── SECURITY_AUDIT.md                     # Security audit report
├── DEPLOY_GUIDE.md                       # Detailed deployment guide
├── .env.example                          # Configuration template
└── foundry.toml                          # Foundry configuration

Core Functions

Create Advertisement

function createAdvertisement(
    string memory _link,
    string memory _imageUrl,
    address _referrer
) public payable;

Record Engagement

function recordEngagement(uint256 _adIndex) external;

Claim Chief Position

function claimChiefOfAdvertising() public;

For more details, see: API Documentation

🧪 Testing

Run Tests

# All tests
forge test

# Specific tests
forge test --match-test test_CreateAdvertisement

# Gas report
forge test --gas-report

# Coverage
forge coverage

Test Categories

• ✅ Deployment: Verification of correct deployment
• ✅ Advertisement Creation: Creation and validation
• ✅ Engagement: Engagement system and rewards
• ✅ Referral System: Referral mechanics
• ✅ Chief System: Chief of Advertising logic
• ✅ Achievements: Achievements and progression
• ✅ Admin Functions: Administrative operations
• ✅ Security: Reentrancy attacks and fuzzing
• ✅ View Functions: Read operations

Coverage Report

| File                              | % Lines        | % Statements   | % Branches    |
|-----------------------------------|----------------|----------------|---------------|
| src/AdvertisementManagerFixed.sol | 95.23% (200/210) | 96.15% (250/260) | 88.46% (92/104) |

🛡️ Security

Vulnerabilities Resolved

Security Measures

• ✅ OpenZeppelin Contracts
• ✅ ReentrancyGuard
• ✅ AccessControl
• ✅ Pausable
• ✅ Checks-Effects-Interactions
• ✅ Input Validation
• ✅ Gas Optimization
• ✅ Comprehensive Testing

Audit Report

Read the complete audit: SECURITY_AUDIT.md

📊 Gas Optimization

Optimizations achieved through PRB-Math and epoch-based tracking

🌍 Supported Networks

Mainnets

Testnets

🔧 Advanced Configuration

Gas Optimization

The contract employs several optimization techniques:

1. Via IR Compilation: Advanced compiler optimizations
2. PRB-Math: Fixed-point mathematics for precise calculations
3. Epoch-based Tracking: Avoiding expensive loops
4. Storage Packing: Efficiently packed variables
5. Caching: Local variables for multiple reads

Customization

Adjust Parameters

Edit constants in AdvertisementManagerFixed.sol:

UD60x18 public constant INITIAL_PRICE = UD60x18.wrap(300000000000000); // 0.0003 ETH
UD60x18 public constant PRICE_MULTIPLIER = UD60x18.wrap(1.05e18); // 5%
uint256 public constant REFERRAL_DISCOUNT = 1e17; // 10%
uint256 public constant ENGAGEMENT_REWARD = 2e18; // 2 tokens

Add New Features

1. Create a branch for your feature
2. Implement tests first (TDD)
3. Add functionality
4. Run tests
5. Commit and create PR

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Guidelines

• Write tests for new features
• Maintain coverage above 90%
• Follow Solidity coding conventions
• Document public functions
• Add events for state changes

👨‍💻 Author

Project Background

AdManager was conceived and developed by codingsh as an innovative solution to bridge traditional advertising with blockchain technology. The project emerged victorious at the Reown Hackathon, showcasing its potential to revolutionize the advertising industry through decentralization.

Key Contributions:

• 🏗️ Complete smart contract architecture
• 🔒 Security audit and vulnerability resolution
• 🧪 Comprehensive testing suite (95%+ coverage)
• 📚 Extensive documentation
• 🌐 Multi-chain deployment infrastructure
• 🎮 Gamification mechanics design

📝 Roadmap

Phase 1 - Foundation ✅

• Core smart contract development
• Security audit and fixes
• Multi-chain deployment scripts
• Comprehensive testing
• Documentation

Phase 2 - Launch 🚀

• Testnet deployment
• External security audit
• Bug bounty program
• Community testing
• Mainnet deployment

Phase 3 - Enhancement 🎯

• Governance system (DAO)
• NFT advertisement support
• Oracle integration
• Mobile app development
• Analytics dashboard

Phase 4 - Expansion 🌍

• Additional chain support
• Cross-chain messaging
• Partnerships program
• Marketing campaign
• Ecosystem growth

📄 License

This project is licensed under the MIT License - see LICENSE for details.

🙏 Acknowledgments

• OpenZeppelin - Secure smart contract libraries
• PRB-Math - Fixed-point mathematics
• Foundry - Development framework
• Reown - For recognizing the project's potential
• Celo Community - For support and feedback
• The Ethereum ecosystem and all contributors

🔗 Useful Links

• Official Documentation
• Deployment Guide
• Security Audit Report
• Usage Examples
• FAQ
• Impact Report (Karma GAP)
• Reown Hackathon Announcement

📞 Contact & Support

Community

Join our growing community:

• 💬 Discord Server
• 🐦 Twitter
• 📱 Telegram
• 📖 Blog

🌟 Show Your Support

If you find this project useful, please consider:

• ⭐ Starring the repository
• 🐦 Following @codingsh on Twitter
• 🔄 Sharing the project with others
• 🤝 Contributing to the codebase
• 💰 Supporting through sponsorship