A2ALI/tag-chain-africa

# TagChain Africa 🌍🐄 **TagChain Africa** is a blockchain-powered livestock traceability and finance platform built on **Hedera Hashgraph**. It empowers farmers, veterinarians, regulators, and buyers with a transparent, immutable, and efficient system for managing livestock assets. ## 🚀 Key Features * **Role-Based Dashboards**: Tailored experiences for Farmers, Vets, Regulators, and Buyers. * **Digital Identity (NFTs)**: Each animal is minted as a unique Hedera Token Service (HTS) NFT. * **Immutable Audit Trail**: All critical events (birth, vaccination, movement) are logged to the Hedera Consensus Service (HCS) for unalterable proof. * **Marketplace with Atomic Swaps**: Secure, trustless trading of livestock assets using HBAR. * **Carbon Credits**: Integrated system for tracking and rewarding sustainable farming practices (HTS Fungible Tokens). * **Real-Time Data**: Integration with OpenWeatherMap for environmental monitoring. ## 🛠️ Tech Stack * **Frontend**: Next.js 14 (React), Tailwind CSS, Framer Motion, Lucide Icons. * **Backend**: Node.js, Express.js. * **Blockchain**: Hedera Hashgraph (Testnet) - HTS & HCS. * **Database**: Supabase (PostgreSQL). * **Authentication**: Custom Role-Based Auth (linked to Supabase Profiles). ## 📦 Installation & Setup ### Prerequisites * Node.js (v18+) * Supabase Account & Project * Hedera Testnet Account (Portal ID) ### 1. Clone the Repository ```bash git clone github.com cd tag-chain-africa ``` ### 2. Backend Setup ```bash cd backend npm install ``` Create a `.env` file in `backend/` with the following: ```env HEDERA_ACCOUNT_ID=0.0.xxxx HEDERA_PRIVATE_KEY=302e... SUPABASE_URL=your-project.supabase.co SUPABASE_SERVICE_ROLE_KEY=eyJ... ENCRYPTION_KEY=your-secret-key-32-chars ``` **Seed the Database**: ```bash node seed_db_full.js ``` *This will create unique Hedera accounts for the Farmer, Vet, Regulator, and Buyer roles and populate the database …