Skip to content

Gamified Community Engagement Platform built proudly with CKB and other decentralized technology

Notifications You must be signed in to change notification settings

Alive24/CKBoost

Repository files navigation

CKBoost - Gamified Community Engagement Platform

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.

๐ŸŽฏ Mission

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

๐ŸŒŸ Overview

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

Key Features

  • 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

๐Ÿ—๏ธ Project Structure

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

๐Ÿš€ Getting Started

Prerequisites

  • Node.js 18+ with pnpm
  • Rust toolchain for contract development
  • CKB Node for blockchain interaction (development/testnet)

Quick Start

  1. Clone the repository

    git clone https://github.com/Alive24/CKBoost.git
    cd CKBoost
  2. Start the frontend application

    cd dapp
    pnpm install
    pnpm dev

    The application will be available at http://localhost:3000

  3. Build smart contracts (optional for frontend development)

    cd contracts
    make build

๐Ÿ› ๏ธ Technical Architecture

Decentralized Design Philosophy

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

Technology Stack

Frontend (dApp)

  • 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

Smart Contracts

  • 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

Decentralized API Services

  • Infrastructure: Open-source Cloudflare Workers
  • Hosting: By campaign sponsors and community members
  • Purpose: Indexing, proof validation, and coordination

Data Storage Strategy

  • 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

๐Ÿ“‹ Core User Flows

Campaign Creation Flow

Define quests โ†’ Fund campaign โ†’ Set proof requirements โ†’ Get admin approval โ†’ Launch โ†’ Monitor submissions โ†’ Distribute rewards

Contributor Flow

Connect wallet โ†’ Browse campaigns โ†’ Complete tasks โ†’ Submit proof โ†’ Pass verification โ†’ Claim rewards โ†’ Earn badges & ranking

Tipping Flow

Propose tip โ†’ Receive 5 peer approvals โ†’ Automated treasury payout โ†’ Permanent profile record

Admin Flow

Identity verification โ†’ Campaign sponsor verification โ†’ Campaign approval โ†’ Base campaign creation

๐ŸŽฎ Example Campaign Types

  • 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

๐Ÿ” Security & Risk Management

Security Measures

  • 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

Anti-Sybil Protection

  • 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

๐Ÿ“ˆ Development Roadmap

Milestone 1: Foundation & Core MVP (~Month 1)

  • โœ… 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

Milestone 2: Advanced Features (~Month 2)

  • ๐Ÿ“… Expanded verification methods
  • ๐Ÿ“… Leaderboards and user profiles
  • ๐Ÿ“… Gamification features (streaks, multipliers, badges)
  • ๐Ÿ“… Tipping system with peer approvals
  • ๐Ÿ“… Admin dashboard and analytics

Milestone 3: Launch Preparation (~Month 3)

  • ๐Ÿ“… Deploy test campaigns with real users
  • ๐Ÿ“… Automated on-chain verification
  • ๐Ÿ“… Documentation and onboarding guides
  • ๐Ÿ“… Final testing and optimization
  • ๐Ÿ“… Community feedback integration

๐Ÿ’ฐ Funding

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

๐Ÿค Contributing

We welcome contributions from the community! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes following the coding standards
  4. Add tests for new functionality
  5. Submit a pull request with clear description

Development Standards

  • TypeScript: Strict type checking enabled
  • Code Quality: ESLint/Prettier for formatting
  • Commits: Conventional commit format
  • Testing: High coverage for critical paths

๐Ÿ“š Documentation

For Users

  • 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

For Developers

  • Architecture Overview: Understanding the decentralized design
  • Contract Interface: Smart contract specifications
  • API Documentation: Decentralized service APIs
  • Integration Guide: Adding CKBoost to your project

Key Resources

Utilities

Size Analysis

cargo bloat --release --target riscv64imac-unknown-none-elf --crates --package ckboost-campaign-type

๐ŸŒ Deployment

Netlify Frontend

# Automatic deployment on push to main branch
git push origin main

Decentralized Services

# Deploy your own Cloudflare Worker instance
cd services
wrangler deploy

Smart Contracts

cd contracts
make deploy-testnet    # Deploy to CKB testnet
make deploy-mainnet    # Deploy to CKB mainnet

๐Ÿ†˜ Support & Community

๐Ÿ™ Acknowledgments

  • 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

๐Ÿ“„ License

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


Built with โค๏ธ by Alive24 for the Nervos Community

About

Gamified Community Engagement Platform built proudly with CKB and other decentralized technology

Resources

Stars

Watchers

Forks