Decentralized social network smart contracts powering meme culture on Base blockchain
BaseBuzz is a decentralized social network built on Base that revolutionizes meme culture through blockchain technology. Our smart contracts enable users to create, mint, trade, and collect meme-based content through innovative hybrid mechanisms.
- 🎯 Hybrid Moments: Trade ERC20 tokens AND/OR mint NFTs for the same content
- 🔥 Dynamic Bonding Curves: Exponential price discovery with 1-5% dynamic fees
- 🎨 Multi-Tier NFT System: Configurable tiers with custom pricing and metadata
- 🛡️ Anti-Spam Protection: Daily limits and progressive fees by user level
- 💎 Creator Bonds: 0.01 ETH bonds prevent rug pulls and ensure delivery
- 🎮 Quest Engine: On-chain engagement mining with BASEBUZZ token rewards
| Contract | Address | Description |
|---|---|---|
| HybridMomentFactoryV2 | 0x2D45...7A02 |
Main factory for creating hybrid moments |
| AntiSpamManager | 0xbeB3...dC75 |
Manages daily limits and spam prevention |
| CreatorBondManager | 0xB146...FaDa |
Handles creator bonds and delivery deadlines |
| QuestRegistry | 0x14D6...4a43 |
Quest system and BASEBUZZ rewards |
| Contract | Address | Description |
|---|---|---|
| DynamicFeeBondingCurve | 0xCE00...aFe6 |
ERC20 bonding curve implementation |
| TieredNFTMinter | 0x1be3...0C4B |
Multi-tier NFT minting implementation |
| Contract | Network | Address | Description |
|---|---|---|---|
| BASEBUZZ | Base Mainnet | 0x893432c814b6e5970e5f86f8cbc3f97417a9c810 |
Main governance and reward token |
basebuzz-contracts/
├── src/ # Smart contract source code
│ ├── HybridMomentFactoryV2.sol # Main factory contract
│ ├── DynamicFeeBondingCurve.sol # ERC20 bonding curve implementation
│ ├── TieredNFTMinter.sol # Multi-tier NFT minting
│ ├── AntiSpamManager.sol # Spam prevention and user levels
│ ├── CreatorBondManager.sol # Creator bond management
│ ├── QuestRegistry.sol # Quest system and rewards
│ ├── BASEBUZZ.sol # Main token contract
│ ├── interfaces/ # Contract interfaces
│ └── mocks/ # Testing utilities
├── script/ # Deployment and utility scripts
├── test/ # Comprehensive test suite
├── deployments/ # Deployment artifacts and records
└── foundry.toml # Foundry configuration
# Clone the repository
git clone https://github.com/base-buzz/basebuzz-contracts.git
cd basebuzz-contracts
# Install dependencies
forge install
# Build contracts
forge build# Run all tests
forge test
# Run tests with verbosity
forge test -vvv
# Run specific test file
forge test --match-path test/HybridMomentFactoryV2.t.sol
# Generate gas report
forge test --gas-report# Deploy to Base Sepolia (testnet)
forge script script/DeployHybridV2.s.sol:DeployHybridV2 \
--rpc-url $BASE_SEPOLIA_RPC \
--private-key $DEPLOYER_PRIVATE_KEY \
--broadcast \
--verify
# Deploy to Base Mainnet (production)
forge script script/DeployHybridV2.s.sol:DeployHybridV2 \
--rpc-url $BASE_MAINNET_RPC \
--private-key $DEPLOYER_PRIVATE_KEY \
--broadcast \
--verify- Current Status: ⏳ Audit in progress
- Audit Firms: Pending selection - submit audit proposals
- Bug Bounty: Contact us for responsible disclosure
- ✅ Creator Bonds: 0.01 ETH deposits prevent malicious behavior
- ✅ Daily Limits: Anti-spam protection with progressive fees
- ✅ Access Controls: Role-based permissions for critical functions
- ✅ Reentrancy Guards: Protection against reentrancy attacks
- ✅ Integer Overflow: SafeMath and Solidity 0.8+ built-in protections
- ✅ Input Validation: Comprehensive parameter validation
- Bonding Curve Pricing: Current exponential curves result in high token prices (>0.1 ETH for small amounts)
- Testnet Only: V2 system currently deployed on Base Sepolia, mainnet deployment pending
- Primary: Base (Chain ID: 8453)
- Testnet: Base Sepolia (Chain ID: 84532)
- Platform Fee: 2.5% on all transactions
- Creator Bond: 0.01 ETH minimum required
- Quest Reward Pool: 10M BASEBUZZ tokens
- Anti-Spam Limits: 5-50 mints, 10-100 trades per day (level-based)
- Proxy Patterns: Minimal proxy (EIP-1167) for cost-efficient deployment
- Batch Operations: Combined transactions for hybrid interactions
- Optimized Storage: Packed structs and efficient data layouts
- 📖 Technical Documentation: Available on request for developers
- 🔧 Integration Guide: Contact team@base.buzz for integration support
- 📋 API Reference: See contract interfaces in
src/interfaces/ - 🔒 Security Guide: Contact security@base.buzz for security documentation
- 📈 Contract Specifications: Available in source code comments
- Website: base.buzz
- Main Repository: github.com/base-buzz/basebuzz
- Documentation: docs.base.buzz (coming soon)
- Discord: discord.gg/basebuzz (coming soon)
- Twitter: @realBaseBuzz
We welcome contributions! Please see our Contributing Guidelines for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Write tests for your changes
- Ensure all tests pass (
forge test) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
This software is provided "as is", without warranty of any kind. The contracts are currently unaudited and should be used at your own risk. Always conduct your own research and due diligence before interacting with smart contracts.
Built with ❤️ by the BaseBuzz team