GreenFlow Protocol is a renewable-energy verification platform powered by Stellar. It provides cooperative operators with an admin interface for asset tracking and publishes proof-of-generation certificate tokens on-chain (1 token = 1 kWh).
- Cooperative operations console
- Cooperative managers can onboard members, register meters, record readings, and monitor generation KPIs.
- On-chain certificate minting
- Generates SEP-41 renewable certificates on Stellar and supports purchase + retirement workflows.
- Smart meter posts readings to
POST /api/meters/readings - GreenFlow Protocol mints proto-certificates on-chain (1 token = 1 kWh)
- External buyer purchases certificates
- Buyer retires certificate (burn on-chain)
Each token is a verifiable on-chain claim of renewable generation. It is not electricity, not a financial instrument, and not designed for speculative trading.
- Featured Project at Stellar Buenos Aires Hackathon 2025
- Innovation Certificate awarded by Stellar jury
- Frontend: https://greenflow-protocol.vercel.app
- Network: Stellar Testnet
greenflow-protocol/
├── apps/
│ ├── contracts/ # Soroban smart contracts (Rust)
│ │ ├── energy_token/
│ │ ├── energy_distribution/
│ │ └── community_governance/
│ └── web/ # Next.js application
├── packages/
│ └── stellar/ # Shared Stellar utilities
└── tooling/
└── issues/ # GitHub issue templates
Powered by Turborepo + pnpm workspaces.
- Node.js v22+
- pnpm v10+ (
corepack enable) - Rust + Cargo (for contracts)
git clone https://github.com/Mozez155/GreenFlow-Protocol.git
cd GreenFlow-Protocol
pnpm installpnpm devFrontend local: http://localhost:3000
cd apps/contracts
stellar contract build
cargo test| Contract | Address | Purpose |
|---|---|---|
| energy_token | CCYOVOFD...MRPBA6 | SEP-41 token for renewable certificates |
| energy_distribution | CBTDPLFN...NX2UDZ | Certificate allocation by participation |
| community_governance | CCH2EXXN...BJD6YI | Cooperative governance proposals |
Built with OpenZeppelin Stellar v0.5.1 (Pausable + Upgradeable) and Soroban SDK 23.1.0.
65 tests passing. See docs/5-CONTRACTS.md for details.
- Blockchain: Stellar (Soroban smart contracts)
- Smart Contracts: Rust + OpenZeppelin Stellar v0.5.1
- Frontend: Next.js 16 + React 19 + TypeScript
- Styling: Tailwind CSS v4 + shadcn/ui
- Wallets: Freighter + Stellar Wallets Kit
- Backend: Next.js API Routes + Supabase
- Deployment: Vercel
- Monorepo: Turborepo + pnpm
- Browse open issues
- Comment to claim issue
- Fork and implement feature
- Submit PR to
develop
Branch workflow:
git checkout develop
git checkout -b feat/your-feature
pnpm install && pnpm dev
# submit PR to develop| Level | Description | Status |
|---|---|---|
| 1 | Internal registry (token = production record) | Current |
| 2 | Verifiable certification (meters + oracles + verification) | Next |
| 3 | Recognized standard (I-REC, Energy Web, TIGR) | Future |
Apache-2.0 — See LICENSE.
Built on Stellar | GreenFlow Protocol 2026