Celorefer SDK

CeloRefer is a decentralized referral and reputation infrastructure built for the Celo blockchain. It features Solidity smart contracts powering quests, seasons, and soulbound Reputation NFTs with dynamic metadata. The celorefer-sdk, a production-ready TypeScript SDK with 70+ methods, enables type-safe integration for developers. Its live Frontend Demo DApp showcases referral tracking, seasonal leaderboards, animated NFT badges, staking, and admin controls. Comprehensive documentation, including full API references and integration guides, supports seamless adoption. CeloRefer empowers projects to launch gamified, trust-driven referral programs with user tiers, quests, and real-time leaderboards—making decentralized community growth effortless and transparent on Celo.

Github Link: Click Here

CeloRefer’s mission is to supercharge growth across the Celo ecosystem by transforming every user into a trusted ambassador through decentralized referrals and on-chain reputation. Built for Celo and fully aligned with its mobile-first, identity-driven vision, CeloRefer enables transparent, automated, and gamified user acquisition. By leveraging SocialConnect’s phone-based identity layer and rewarding real contributions with dynamic Reputation NFTs and cUSD incentives, the protocol bridges the gap between Web2-style virality and Web3 trust. Its universal SDK empowers developers to integrate referral, quest, and leaderboard systems in minutes—creating sustainable, community-powered growth loops that strengthen Celo’s global adoption.

🔥 The Problem & Why Celo Needs This

Web3 Growth is Broken

Current challenges in the Celo ecosystem:

• ❌ No on-chain referral tracking - dApps can't verify who referred whom
• ❌ Centralized solutions - Traditional referral systems are gameable and off-chain
• ❌ Zero recognition - Users get no credit for community building efforts
• ❌ Missing identity layer - No verifiable reputation system across Celo

Why Existing Solutions Fall Short

• Attrace, Layer3 - Not on Celo, focus only on quests
• Galxe - Centralized points system, no phone-based identity
• Traditional affiliate tools - Off-chain tracking, no crypto rewards

The Celo Opportunity

Celo has 3M+ MiniPay users with phone numbers already mapped to wallets via SocialConnect — but zero infrastructure to leverage this for growth.

What makes Celo uniquely positioned:

• ✅ SocialConnect integration - Phone number = wallet address
• ✅ Real-world identity - Users have verified phone numbers
• ✅ Mobile-first ecosystem - 3M+ MiniPay users ready to refer
• ✅ Stablecoin economy - Easy to reward in cUSD/USDC

This protocol unlocks:

• 📱 Phone-based viral loops - Share referral links via WhatsApp/SMS
• 🏆 On-chain reputation - Portable, verifiable across all Celo dApps
• 💰 Automated crypto rewards - 5-25% commission based on performance tier
• 🔌 Universal SDK - Any dApp can integrate in < 30 lines of code

🎯 What We've Built

CeloRefer is a complete decentralized referral and reputation infrastructure for the Celo blockchain. It consists of:

Core Components

1. Smart Contracts (Solidity)

   • CeloReferEnhanced.sol - Main referral logic with quest & season systems
   • ReputationNFT.sol - Soulbound NFTs with dynamic metadata
   • DemoDApp.sol - Example integration for testing

2. TypeScript SDK (celorefer-sdk)

   • 70+ methods covering all protocol features
   • Type-safe viem-based blockchain interactions
   • Published on npm, production-ready

3. Frontend Demo DApp (HTML/CSS/JS + ethers.js)

   • Live working demo at celo-dapp/frontend/
   • User dashboard with referral tracking
   • Quest progress & seasonal leaderboards
   • NFT reputation display with animated badges
   • Staking functionality and admin panel

4. Comprehensive Documentation

   • Full API reference: https://celoref.mintlify.app
   • Integration guides for developers
   • Platform workflow documentation

Key Features

The CeloRefer SDK simplifies building decentralized referral programs on Celo:

• User Management - Registration with referral codes, profile management
• Tiered Badge System - Dynamic rewards (Bronze → Silver → Gold → Platinum)
• Gamification Engine - Quests, milestones, seasonal competitions
• Reputation NFTs - Soulbound tokens reflecting on-chain achievements
• Partner Integration - Subscription system for dApp monetization
• Leaderboard - Real-time rankings and social proof

Result: Create viral growth loops powered by crypto incentives

India