majoradmiral/royaltyflux

Royalty infrastructure for African music creators. Blockchain-based royalty distribution platform with multi-token smart contracts, automated data pipelines, and M-Pesa integration for Kenyan artists and producers. # RoyaltyFlux **Royalty infrastructure for African music creators.** Blockchain-based royalty distribution platform purpose-built for the Kenyan music ecosystem. Automates royalty splits, provides transparent payout tracking, and integrates with mobile money (M-Pesa) for accessible withdrawals. ## Overview RoyaltyFlux solves the royalty opacity problem facing Kenyan artists and producers. Most creators have no visibility into who earns what from their music, and payment collection is fragmented across multiple collecting societies. RoyaltyFlux brings on-chain transparency to off-chain royalty data. ### Key Features - **Multi-token smart contracts** — Per-track split sheets with any ERC20 token or ETH, batch withdrawals, owner-managed share distribution - **Automated data pipelines** — MusicBrainz and Spotify collectors for catalog discovery and royalty claim matching - **M-Pesa integration** — Mobile money payouts for creators without bank accounts (Daraja API) - **Artist & producer-first** — Producers are first-class users with their own split tracking - **Dashboard & analytics** — Royalty claims, case studies on Kenyan music industry dynamics, platform metrics ## Architecture ``` contracts/ Solidity smart contracts (Hardhat) backend/ Express API + SQLite + data pipelines frontend/ React dashboard + wallet connect scripts/ Deployment scripts (Avalanche) test/ Hardhat test suite ``` ### Smart Contracts `RoyaltyFlux.sol` — The core v2 contract supporting: - Per-track split sheets with arbitrary recipient addresses - Multi-token support (any ERC20 + native ETH) - Batch withdraw for efficiency - Owner-managed splits with add/update/remove ### Data Pipeline - **MusicBrainz collector**: Free, no-key API for Kenyan artist/release metadata - **Spotify collector**: Track streaming data via Spotify Web API - **Seed data**: 20 Kenyan artists and producers, 4 case studies (Gengetone boom, producer underpayment, label deal fai …