Every African story deserves to live forever - and reward its keeper
- 🎬 Quick Demo
- 📸 Screenshots
- 🚨 The Cultural Crisis
- 🚀 Key Features
- 🏗️ Technical Architecture
- ⚙️ Quickstart
- ✅ TODO
Note: To keep pushes fast, the large MP4 demo may be excluded from the remote. If the inline player below does not load on GitHub, clone locally or check project releases.
- Demo video file path (for local clones):
acces/WhatsApp Video 2025-10-01 at 01.33.55_5708530a.mp4
Inline preview (works when the file is present locally)
Below are selected screenshots highlighting key flows. All assets are available in acces/.
- Implement governance-based split (40/30/20/10) with transparent distribution addresses
- Add IPFS pinning and media upload flow for audio/video/images with metadata
- Require multi-validator threshold (e.g., 3-of-N) before
verified = true - Add dispute resolution and community governance token mechanics
- Expand i18n: language detection + translations across UI
- Improve mobile-first layouts and offline-friendly assets
- Add unit tests (Solidity + frontend) and basic analytics dashboard
- 📉 Every 14 days, another African language dies forever
- 👴 90% of African elders will take their stories to the grave - unrecorded, unlicensed, unrewarded
- 🏛️ $2.6 billion annual revenue from "African-inspired" content goes to foreign companies, not creators
- 📱 85% of African youth can't name 5 traditional stories from their own community
African cultural artifacts, traditional knowledge, and intangible heritage face extinction due to:
- 📉 Cultural Erasure: Urbanization and globalization are wiping out traditions faster than we can preserve them
- 💸 Economic Exploitation: Our ancestors' wisdom generates billions for others while communities stay poor
- 🏛️ Digital Colonialism: Western institutions monetize African elements without compensation or credit
- 👥 Knowledge Gap: Elders die with untold stories while youth disconnect from their roots
- ⚖️ No Ownership: Zero systems to prove authenticity or claim rightful compensation for our heritage
The Clock is Ticking: We're not just losing stories - we're losing our identity, our economic power, and our children's birthright.
🌍 Our Vision
KANDA is more than a platform — it’s a movement. We envision a future where African culture is not just preserved but also valued globally as a source of pride, wealth, and identity. By combining blockchain technology with community-driven validation, we ensure that every story, song, and tradition becomes a living digital asset — owned by its people, accessible to the world, and rewarding to its guardians. Our goal is to transform cultural heritage from something at risk of extinction into a sustainable economy that empowers Africans and inspires generations.
- Traditional storytellers, craftspeople, musicians
- Elders with deep cultural knowledge
- Community wisdom keepers
- Museums, universities, educational organizations
- Documentary filmmakers and media companies
- Global collectors of authentic cultural NFTs
- Heritage Ambassadors (tech-savvy youth)
- Cultural organizations and NGOs
- Government cultural preservation agencies
- Voice-First Interface: Record stories in native languages with AI translation
- Multi-Media Support: Audio, video, images, and text documentation
- Metadata Enrichment: Cultural context, historical significance, usage rights
- IPFS Storage: Permanent, decentralized preservation
- Cross-Community Validation: Prevents local corruption through distributed verification
- Reputation Scoring: Validators earn reputation tokens for accurate verifications
- Dispute Resolution: Community governance for contested heritage items
- Current demo (implemented in contract):
Revenue Split (Demo):
├── Creator : 60%
└── Platform Sustainability: 40%- Roadmap split (governed by community DAO):
Revenue Split (Planned):
├── Creator : 40%
├── Community Fund: 30%
├── Elder Validators: 20%
└── Platform Sustainability: 10%- Curated Collections: Organized by culture, region, and type
- Licensing Tiers: Personal, Educational, Commercial, Exclusive usage rights
- Global Discovery: Multi-language search and recommendation system
- Impact Tracking: Show community benefit from each purchase
- ⚡ Next.js Frontend: React-based UI with TypeScript autocompletion
- 🔗 Smart Contracts: Solidity contracts with hot reload development
- 🌈 RainbowKit Integration: Seamless wallet connection experience
- 🪝 Custom Hooks: Simplified Web3 interactions with wagmi wrappers
- 🧱 Reusable Components: Pre-built Web3 components for rapid development
packages/nextjs/
├── app/
│ ├── page.tsx // Landing page with problem statement
│ ├── create/page.tsx // Heritage creation form
│ ├── marketplace/page.tsx // Browse and license heritage
│ └── community/page.tsx // Dashboard with integrated verification
├── components/
│ └── HeritageCard.tsx // Reusable heritage display component
├── hooks/
│ └── useKanda.ts // Single custom hook for all contract interactions
└── styles/
└── globals.css // Tailwind + custom stylingSimplified single-hook approach leveraging Scaffold-ETH2:
useKanda() {
├── allHeritages // Query all minted items
├── myHeritages // User's created heritage
├── isValidator // Check validator status
├── mintHeritage() // Create new heritage NFT
├── verifyHeritage() // Elder validation
├── licenseHeritage() // Purchase and distribute payment
└── Loading states // isMinting, isVerifying, isLicensing
}KANDA is a blockchain-powered revolution where Africans finally:
- OWN their cultural assets as verified digital property
- PROFIT from their heritage when others use it commercially
- CONTROL how their traditions are shared with the world
- CELEBRATE being African with economic pride, not just cultural pride
- PRESERVE their legacy for children and grandchildren forever
Stop watching others get rich from your heritage. Start earning from your own stories.
- 🎙️ Record & Mint cultural assets (stories, music, crafts, wisdom) as verified NFTs
- 👴 Community Validation through multi-elder approval systems
- 💰 Earn Royalties when content is licensed commercially or educationally
- 🌍 Global Access connecting authentic African heritage with worldwide audiences
- 🏘️ Community Benefit automatic revenue sharing with communities and validators
Before you begin, you need to install the following tools:
- Node (>= v20.18.3)
- Yarn (v1 or v2+)
- Git
To get started with Scaffold-ETH 2, follow the steps below:
- Install dependencies if it was skipped in CLI:
cd KANDA-scarfold
yarn install
- Run a local network in the first terminal:
yarn chain
This command starts a local Ethereum network using Hardhat. The network runs on your local machine and can be used for testing and development. You can customize the network configuration in packages/hardhat/hardhat.config.ts.
- On a second terminal, deploy the test contract:
yarn deploy
This command deploys a test smart contract to the local network. The contract is located in packages/hardhat/contracts and can be modified to suit your needs. The yarn deploy command uses the deploy script located in packages/hardhat/deploy to deploy the contract to the network. You can also customize the deploy script.
- On a third terminal, start your NextJS app:
yarn start
Visit your app on: http://localhost:3000. You can interact with your smart contract using the Debug Contracts page. You can tweak the app config in packages/nextjs/scaffold.config.ts.
Run smart contract test with yarn hardhat:test
- Edit your smart contracts in
packages/hardhat/contracts - Edit your deployment scripts in
packages/hardhat/deploy