Important
This project is currently under active development as part of the Nervos Community Catalyst initiative and is not yet ready for production use.
A purpose-built open-source gamified engagement platform for the CKB ecosystem, designed to transform community engagement from scattered, ad-hoc efforts into a structured, rewarding, and measurable system that drives participation, incentivizes real contributions, and encourages ecosystem growth.
CKBoost directly supports the goals of the Nervos Community Catalyst initiative by providing the technical backbone for:
- Structured Engagement: Transform random community efforts into organized campaigns with clear goals
- Verifiable Contributions: Implement "proof of participation" for all types of community activities
- Fair Rewards: Distribute on-chain rewards transparently based on actual contributions
- Ecosystem Growth: Drive both off-chain engagement and on-chain activity through gamification
CKBoost addresses key challenges in community management:
- Inclusive Participation: Reward community members who don't have directly transferable skills for formal tracks
- Synergized Effort: Coordinate community action across social media, off-chain, and on-chain platforms
- Fun & Incentivized: Create enthusiasm for participation through gamification and rewards
- On-Chain Activity: Leverage CKB features and encourage more blockchain interaction
- Campaign & Quest Management: Multi-task campaigns with detailed quests, success metrics, and fully funded reward pools
- On-Chain Points & Badges: All achievements tracked via dedicated UDT for transparent rewards
- Gamification Elements: Streak bonuses, difficulty multipliers, dynamic leaderboards, and badge milestones
- Anti-Sybil Verification: Flexible verification starting with manual Telegram proof, expanding to DID/KYC
- Community Tipping: Peer recognition system with democratic approval flow and automated payouts
- Comprehensive Dashboards: Tools for campaign creators, admins, and reviewers to monitor progress
CKBoost/
โโโ dapp/ # Next.js frontend application
โ โโโ app/ # App Router pages and layouts
โ โโโ components/ # Reusable UI components
โ โโโ lib/ # Business logic and data management
โ โ โโโ types/ # TypeScript type definitions
โ โ โโโ mock/ # Development mock data
โ โ โโโ ckb/ # Blockchain integration layer
โ โ โโโ providers/ # React context providers
โ โ โโโ services/ # Data service abstraction
โ โโโ ... # Standard Next.js structure
โโโ contracts/ # Smart contracts (Rust)
โ โโโ contracts/ # Individual contract implementations
โ โ โโโ ckboost-campaign-type/ # Campaign management logic
โ โ โโโ ckboost-campaign-lock/ # Secure fund vaults
โ โ โโโ ckboost-protocol-type/ # Governance & minting
โ โ โโโ ckboost-protocol-lock/ # Protocol governance
โ โ โโโ ckboost-user-type/ # Verification & bindings
โ โ โโโ ckboost-shared/ # Common utilities
โ โโโ tests/ # Integration tests
โโโ docs/ # Documentation and specifications
โ โโโ recipes/ # Transaction skeleton definitions
โ โโโ *.prd.txt # Product requirements documents
โโโ schemas/ # Molecule schema definitions
- Node.js 18+ with pnpm
- Rust toolchain for contract development
- CKB Node for blockchain interaction (development/testnet)
-
Clone the repository
git clone https://github.com/Alive24/CKBoost.git cd CKBoost -
Start the frontend application
cd dapp pnpm install pnpm devThe application will be available at
http://localhost:3000 -
Build smart contracts (optional for frontend development)
cd contracts make build
CKBoost implements a new pattern of decentralization for dApps:
- Anyone-Can-Host Backend: All backend services use open-source Cloudflare Workers that anyone can deploy
- Trustless Operation: No reliance on any single, centralized operator
- Community Infrastructure: Campaign sponsors and community members can host their own services
- Resilient Network: Multiple interoperable services instead of single points of failure
- Framework: Next.js 15 with App Router
- Styling: Tailwind CSS with shadcn/ui components
- State Management: React Context with CKB CCC integration
- Wallet Integration: @ckb-ccc/connector-react for universal wallet support
- Data Layer: Abstracted service layer supporting mock and blockchain data
- ckboost-protocol-type: Governance & Points UDT minting
- ckboost-protocol-lock: Protocol governance and treasury management
- ckboost-campaign-type: Campaign logic and quest management
- ckboost-campaign-lock: Secure vaults for campaign funds
- ckboost-user-type: Submission, verification, and social bindings
- Infrastructure: Open-source Cloudflare Workers
- Hosting: By campaign sponsors and community members
- Purpose: Indexing, proof validation, and coordination
- Critical State: CKB Cell data for all on-chain states
- Non-Critical Data: Anyone-can-host Neon storage for submissions
- Performance: Local cache for fee optimization
Define quests โ Fund campaign โ Set proof requirements โ Get admin approval โ Launch โ Monitor submissions โ Distribute rewards
Connect wallet โ Browse campaigns โ Complete tasks โ Submit proof โ Pass verification โ Claim rewards โ Earn badges & ranking
Propose tip โ Receive 5 peer approvals โ Automated treasury payout โ Permanent profile record
Identity verification โ Campaign sponsor verification โ Campaign approval โ Base campaign creation
- AMA Boost: Points for questions, shares, and Nervos discussion amplification
- Knowledge Boost: Share and summarize Knowledge Base articles
- On-Chain Quests: Lock CKB for iCKB, add DEX liquidity, interact with DeFi
- Community Governance: Engage with proposals and provide feedback
- Escrow Protection: Campaign lock scripts protect all escrowed assets
- Multi-Signature: Support for high-value campaign management
- Time Locks: Campaign duration enforcement and deadline management
- Gradual Rollout: Small initial contract funds with progressive scaling
- Locked Rewards: Rewards remain locked until verification passes
- Multi-Method Verification: Telegram, DID, KYC, and manual review options
- Reputation System: Build trust through consistent participation
- โ Next.js scaffold with CCC wallet integration
- โ Visual and interaction prototyping
- ๐ Smart contract development for core scripts
- ๐ Campaign & quest creation flows
- ๐ Points UDT and reward distribution
- ๐ Expanded verification methods
- ๐ Leaderboards and user profiles
- ๐ Gamification features (streaks, multipliers, badges)
- ๐ Tipping system with peer approvals
- ๐ Admin dashboard and analytics
- ๐ Deploy test campaigns with real users
- ๐ Automated on-chain verification
- ๐ Documentation and onboarding guides
- ๐ Final testing and optimization
- ๐ Community feedback integration
This project is funded by the CKB Community Fund DAO:
- Total Grant: $20,000 USD
- Payment Structure: 10% upfront, 90% across 3 milestones
- Timeline: 3 months from commencement
- Purpose: Support design, development, and deployment of CKBoost
We welcome contributions from the community! Here's how you can help:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes following the coding standards
- Add tests for new functionality
- Submit a pull request with clear description
- TypeScript: Strict type checking enabled
- Code Quality: ESLint/Prettier for formatting
- Commits: Conventional commit format
- Testing: High coverage for critical paths
- Campaign Creation Guide: How to launch engaging campaigns
- Quest Participation: How to complete quests and earn rewards
- Verification Guide: Understanding identity requirements
- Tipping System: How to recognize exceptional contributions
- Architecture Overview: Understanding the decentralized design
- Contract Interface: Smart contract specifications
- API Documentation: Decentralized service APIs
- Integration Guide: Adding CKBoost to your project
cargo bloat --release --target riscv64imac-unknown-none-elf --crates --package ckboost-campaign-type
# Automatic deployment on push to main branch
git push origin main# Deploy your own Cloudflare Worker instance
cd services
wrangler deploycd contracts
make deploy-testnet # Deploy to CKB testnet
make deploy-mainnet # Deploy to CKB mainnet- GitHub Issues: Report bugs or request features
- Discussions: Join the conversation
- Nervos Talk: Community discussions
- Documentation: Full documentation
- Nervos Community Catalyst for sponsoring this initiative
- CKB Community Fund DAO for funding support
- Nervos Foundation for the innovative CKB blockchain
- Community Contributors who make this project possible
This project is licensed under the MIT License - see the LICENSE file for details.
Built with โค๏ธ by Alive24 for the Nervos Community