🌱 Blockchain-Based Green Hydrogen Credit Registry

Transparent • Verifiable • Fraud-Resistant

---

🚀 Overview

This project implements an end-to-end registry for Green Hydrogen (H₂) credits.
It ensures that every kilogram of H₂ produced from renewable energy is:

• ✅ Measured by trusted IoT sensors
• ✅ Signed with cryptographic proofs
• ✅ Minted into digital credits
• ✅ Transferred / Retired with owner signatures
• ✅ Anchored into immutable blockchain blocks with Merkle roots
• ✅ Auditable via Sparse Merkle Tree proofs & optional on-chain anchoring

---

✨ Key Features

• 🔑 Ed25519 signatures for all events, transfers, and retirements
• ⏱️ Non-overlapping production windows (prevents double counting)
• 📎 Evidence uploads (CSV/logs tied to events via SHA-256)
• 📦 Block closing → Merkle root over all transactions
• 🌳 State root proofs (Sparse Merkle Tree for balances)
• 🛒 Marketplace to list/buy credits
• 📊 Reports: retirement feed for compliance & ESG audits

---

🛠️ Components

• app.py → Flask server exposing all API endpoints
• api_tester.py → Original E2E tester (phase 1/2/3)
• showcase_cli.py → Judge-friendly CLI (step-by-step with clear prints)
• api_tester_pretty.py → Optional verbose tester (compact JSON previews)

---

📦 Project Tree

├─ .env
├─ .env.example
├─ CreditAnchor.abi.json
├─ README.md
├─ anchor_block.py
├─ anchor_data.md
├─ anchor_deploy.py
├─ anchor_verifier.py
├─ api_tester.py
├─ app.py
├─ client_phase1.py
├─ evidence/
│  ├─ … evidence CSV files
├─ phase1_full_report.md
├─ phase2/
│  ├─ smt_state.py
│  ├─ proof_state_account.py
│  └─ tester_phase2_state.py
├─ phase3/
│  ├─ market_demo.py
│  └─ test_market.py
├─ showcase_cli.py
├─ transaction_verify.py
└─ utils.py

---

⚙️ Setup & Installation

# 1. Clone the repo
git clone https://github.com/realmCode/hackout.git
cd hackout

# 2. Install dependencies
pip install -r requirements.txt

# 3. Start the server
python app.py

Requirements

• Python 3.9+
• Libraries: flask, requests, cryptography, python-dotenv
• Optional: web3 (if anchoring to Ethereum)

---

▶️ Demo Instructions

1. Quick Judge Demo

python showcase_cli.py --base http://127.0.0.1:5000

• Produces step-by-step banners (easy to follow live)
• Preserves exact signature flow from api_tester.py

2. Developer Test

python api_tester.py --base http://127.0.0.1:5000

• Full verification including on-chain anchor (if RPC/contract provided)

---

🔑 Core API Endpoints

• GET /api/v1/health → Server health
• POST /api/v1/accounts → Create account (producer/buyer/verifier)
• POST /api/v1/sensors → Register sensor
• POST /api/v1/evidence/upload → Upload run evidence
• POST /api/v1/events → Submit signed event
• POST /api/v1/credits/mint → Mint credits
• POST /api/v1/credits/transfer → Owner-signed transfer
• POST /api/v1/credits/retire → Owner-signed retire
• POST /api/v1/blocks/close → Close block → Merkle root
• GET /api/v1/blocks/latest → Inspect latest block
• GET /api/v2/state/root → Global state root (SMT)
• GET /api/v2/state/proof/<id> → Account proof
• POST /api/v1/market/offers → List credits
• POST /api/v1/market/buy → Buy credits
• GET /api/v1/reports/retirements → Retirement report

---

🧩 How It All Ties Together

1. Sensor signs event → ensures tamper-proof production data
2. Evidence uploaded → hash bound to event
3. Server verifies signature + overlap window
4. Mint credits → digital units of Green H₂
5. Close block → credits activated under Merkle root
6. Transfers / Retires → owner-signed, immutable record
7. Sparse Merkle proofs → balances independently verifiable
8. Marketplace → trade credits fairly
9. Reports → regulators/auditors can confirm claims

---

🎯 Impact

• ⚡ Faster, more transparent distribution of public funds
• 🛡️ Reduces risk of fraud and misappropriation
• 🌍 Increases uptake of green hydrogen projects via clear value & traceability

---

📖 License

Copyright (c) 2025 Nandish Chauhan (realmCode)

All rights reserved.

Permission is hereby granted to view this repository and its source code 
for educational and reference purposes only.

Commercial use, redistribution, modification, or creation of derivative works 
is strictly prohibited without explicit written permission from the author.

For licensing inquiries, please contact: 202451040@iiitvadodara.ac.in.

---

🌐 Repository

👉 Front End It's buggy.