A decentralized affiliate marketing platform built on ØG Chain that enables instant USDC payouts for Web3 task completion with multi-level referral rewards.
Homare is a Web3 affiliate platform that operates on ØG Chain, where advertisers (protocols) set up "campaign tasks" (e.g., Swap, Bridge, SNS participation) that users complete to earn instant USDC rewards. The platform features a tree-structured referral network that automatically distributes earnings to direct and indirect referrers.
- Instant USDC Payouts: Immediate reward distribution upon task completion
- Multi-level Referral System: Automatic revenue sharing across referral tree
- Sybil Attack Prevention: AI-powered fraud detection using ØG Compute
- On-chain & Off-chain Verification: Supports both blockchain transactions and social media tasks
- Transparent & Auditable: All transactions and rewards are verifiable on ØG Chain
- ØG Chain: Task Registry, Payout Splitter, and verification logic
- ØG Compute: AI-powered sybil detection and verification adapters
- ØG Storage/DA: Tamper-proof log storage
- EVM Smart Contracts: Solidity contracts for task management and payouts
- Oracle Layer: On-chain transaction analysis and off-chain API verification
- Frontend: Next.js with TypeScript, Tailwind CSS, and Radix UI
- Web3 Integration: Wagmi, RainbowKit, and ethers.js
- Manages campaign task creation and completion
- Handles task verification and reward distribution
- Integrates with verification oracle for fraud detection
- Implements multi-level referral system
- Automatically distributes rewards to referrers
- Supports up to 3 levels of indirect referrals
- Gateway for ØG Compute verification services
- Handles both on-chain and off-chain task verification
- Manages sybil resistance scoring
- Node.js 18+
- pnpm (recommended) or npm
- WalletConnect Project ID
- Clone the repository:
git clone https://github.com/your-username/homare.git
cd homare- Install dependencies:
pnpm install- Set up environment variables:
cp env.example .env.local-
Update the environment variables with your actual values:
NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID: Your WalletConnect project ID- Contract addresses for deployed smart contracts
- API keys for social media integrations
-
Run the development server:
pnpm dev- Open http://localhost:3000 in your browser
- Deploy contracts to ØG Chain:
# Deploy TaskRegistry
npx hardhat deploy --network ogchain --contract TaskRegistry
# Deploy PayoutSplitter
npx hardhat deploy --network ogchain --contract PayoutSplitter
# Deploy VerifierGateway
npx hardhat deploy --network ogchain --contract VerifierGateway- Update contract addresses in environment variables
Deploy to Vercel or your preferred platform:
pnpm build
pnpm start┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Frontend │ │ ØG Chain │ │ ØG Compute │
│ (Next.js) │◄──►│ Smart Contracts│◄──►│ AI Models │
│ │ │ │ │ │
│ - Task UI │ │ - TaskRegistry │ │ - Sybil Det. │
│ - Wallet Conn │ │ - PayoutSplit │ │ - Verification│
│ - Dashboard │ │ - VerifierGate │ │ - Scoring │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │ │
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Social APIs │ │ ØG Storage │ │ Oracle Layer │
│ │ │ │ │ │
│ - Twitter │ │ - Task Logs │ │ - On-chain │
│ │ │ - Proof Data │ │ - Off-chain │
│ │ │ - Audit Trail │ │ - Social │
└─────────────────┘ └──────────────────┘ └─────────────────┘
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - 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.
For support and questions:
- Create an issue on GitHub
- Follow us on Twitter
- Mobile app development
- Advanced AI verification models
- Cross-chain task support
- NFT-based achievements
- Governance token integration
- Advanced analytics dashboard