Skip to content

Repository files navigation

ContentVault - Decentralized Content Monetization Platform

Project Overview

ContentVault is a revolutionary decentralized content platform built on Walrus protocol that enables creators to monetize their content directly through programmable storage, encryption, and blockchain-based payments.

πŸš€ Features

For Creators

  • Decentralized Content Storage: Upload content to Walrus with permanent, censorship-resistant storage
  • Programmable Access Control: Set custom pricing and access rules for your content
  • Direct Monetization: Receive payments directly from fans without intermediaries
  • Content Encryption: End-to-end encryption with creator-controlled keys
  • Revenue Analytics: Track earnings and content performance

For Fans

  • Direct Creator Support: Tip or pay for exclusive content directly
  • Wallet Integration: Connect with MetaMask or WalletConnect
  • AI Recommendations: Discover content based on preferences and behavior
  • Secure Access: Encrypted content delivery with automatic decryption
  • Governance Participation: Earn tokens for platform governance

πŸ›  Technology Stack

Blockchain & Storage

  • Walrus Protocol: Decentralized storage and content delivery
  • Ethereum: Smart contracts and payment processing
  • Solidity: Smart contract development

Frontend

  • React.js: User interface framework
  • Next.js: Server-side rendering and optimization
  • Web3Modal: Multi-wallet integration
  • Tailwind CSS: Styling framework

Backend

  • Node.js: Server runtime
  • Express.js: API framework
  • MongoDB: Metadata storage
  • TensorFlow.js: AI recommendation engine

πŸ“ Project Structure

contentvault/
β”œβ”€β”€ frontend/                 # React.js frontend application
β”‚   β”œβ”€β”€ components/          # Reusable UI components
β”‚   β”œβ”€β”€ pages/              # Next.js pages
β”‚   β”œβ”€β”€ hooks/              # Custom React hooks
β”‚   β”œβ”€β”€ utils/              # Utility functions
β”‚   └── web3/               # Web3 integration
β”œβ”€β”€ backend/                 # Node.js backend API
β”‚   β”œβ”€β”€ controllers/        # API controllers
β”‚   β”œβ”€β”€ models/             # Data models
β”‚   β”œβ”€β”€ routes/             # API routes
β”‚   β”œβ”€β”€ services/           # Business logic
β”‚   β”œβ”€β”€ middleware/         # Express middleware
β”‚   └── walrus/             # Walrus integration
β”œβ”€β”€ contracts/               # Smart contracts
β”‚   β”œβ”€β”€ ContentAccess.sol   # Access control contract
β”‚   β”œβ”€β”€ ContentPayments.sol # Payment processing
β”‚   β”œβ”€β”€ ContentVault.sol    # Main platform contract
β”‚   └── CreatorToken.sol    # Governance token
└── scripts/                 # Deployment scripts

🚦 Quick Start

Prerequisites

  • Node.js 16+
  • MetaMask browser extension
  • Git

Installation

  1. Clone the repository
git clone https://github.com/yourusername/contentvault.git
cd contentvault
  1. Install frontend dependencies
cd frontend
npm install
  1. Install backend dependencies
cd ../backend
npm install
  1. Install contract dependencies
cd ../contracts
npm install
  1. Set up environment variables
# Frontend .env.local
NEXT_PUBLIC_WALRPC_URL=your_walrus_rpc_url
NEXT_PUBLIC_CHAIN_ID=1
NEXT_PUBLIC_CONTRACT_ADDRESS=your_contract_address

# Backend .env
WALRUS_PRIVATE_KEY=your_private_key
MONGODB_URI=your_mongodb_uri
JWT_SECRET=your_jwt_secret

Running the Application

  1. Start the backend server
cd backend
npm run dev
  1. Start the frontend
cd frontend
npm run dev
  1. Deploy contracts (if not deployed)
cd contracts
npm run deploy

πŸ’‘ Use Cases

Content Creators

  • Musicians: Release exclusive tracks and albums
  • Writers: Publish premium articles and stories
  • Artists: Showcase digital art and NFTs
  • Educators: Create paid courses and tutorials
  • Influencers: Share behind-the-scenes content

Content Types Supported

  • Images and artwork
  • Videos and animations
  • Audio files and podcasts
  • Documents and e-books
  • Code repositories
  • 3D models and assets

πŸ” Security Features

  • End-to-End Encryption: Content encrypted before upload
  • Creator Key Management: Creators control their encryption keys
  • Smart Contract Security: Audited contracts with best practices
  • Multi-Signature Support: Enhanced wallet security
  • Access Expiration: Time-limited content access

🎯 Walrus Integration

Why Walrus?

  • Decentralized Storage: No single point of failure
  • Programmable Access: Smart contract controlled permissions
  • Global CDN: Fast content delivery worldwide
  • Cost Effective: Efficient storage pricing
  • Censorship Resistant: Immutable content storage

Walrus Features Used

  • Blob storage for large files
  • Programmable access controls
  • Content versioning and updates
  • Encrypted storage support
  • Real-time content delivery

🎨 AI Recommendations

Our AI engine analyzes:

  • User viewing history
  • Content preferences
  • Creator following patterns
  • Payment behavior
  • Social interactions

To provide:

  • Personalized content feeds
  • Creator recommendations
  • Trending content alerts
  • Similar content suggestions
  • Optimal pricing suggestions

πŸ’° Monetization Model

For Creators

  • Direct Payments: 95% goes to creators
  • Tipping System: Fans can tip any amount
  • Subscription Models: Recurring revenue options
  • Token Rewards: Governance token earnings
  • Analytics Insights: Performance tracking

Platform Fees

  • Content upload: Free
  • Payment processing: 5% fee
  • Premium features: Subscription-based
  • API usage: Pay-per-request

πŸ—³ Governance

  • Creator Tokens: Earned through platform participation
  • Proposal Voting: Platform improvement decisions
  • Fee Structure: Community-driven pricing
  • Feature Prioritization: User-requested features
  • Treasury Management: Community fund allocation

πŸš€ Roadmap

Phase 1 (Current)

  • Basic content upload and access
  • Payment processing
  • Wallet integration
  • Simple AI recommendations

Phase 2

  • Advanced encryption features
  • Social features (follow, like, comment)
  • Creator analytics dashboard
  • Mobile app development

Phase 3

  • Cross-chain support
  • Advanced AI features
  • Enterprise solutions
  • API marketplace

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

πŸ“„ License

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

πŸ™ Acknowledgments

  • Walrus Protocol team for the amazing storage solution
  • Ethereum community for smart contract standards
  • Open source contributors and libraries
  • Hackathon organizers and judges

πŸ“ž Support


Built with ❀️ for the decentralized future of content creation.

About

ContentVault

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages