Skip to content

AnnabelJoe/solar-chain

SolarChain

Renewable energy certification infrastructure on Stellar

Deployed on Vercel Stellar License Tests

SolarChain is a cooperative management dashboard + on-chain certification infrastructure for renewable energy on Stellar. Cooperatives use the dashboard to manage members, meters, readings, and statistics — and SolarChain tokenizes their production as proto-certificates sold to external buyers (companies, ESG funds, climate programs).


What it does

Two things:

  1. Cooperative management dashboard — Web panel where cooperatives manage members, meters, generation statistics, and certificates.
  2. On-chain certification — Tokenizes renewable production as proto-certificates on Stellar (1 token = 1 kWh), sold to external buyers.
Smart meter sends readings via API (POST /api/meters/readings)
        |
SolarChain mints proto-certificates on-chain (1 token = 1 kWh)
        |
External buyer purchases certificates
        |
Buyer retires certificate (burn on-chain)

Each token is a proto-certificate: a verifiable on-chain claim that 1 kWh of renewable energy was generated. It is not a financial instrument, not electricity for consumption, and not designed for trading between members.


Live Demo


Smart Contracts (Soroban)

Deployed on Stellar Testnet:

Contract Purpose
energy_token SEP-41 fungible token representing renewable generation certificates
energy_distribution Allocates certificates to cooperative members by participation
community_governance Cooperative governance (proposals + voting)

Built with OpenZeppelin Stellar v0.5.1 (Pausable + Upgradeable) and Soroban SDK 23.1.0.

65 tests passing. See docs/CONTRACTS.md for full reference.


Monorepo Structure

solarchain/
├── apps/
│   ├── contracts/           # Soroban smart contracts (Rust)
│   │   ├── energy_token/
│   │   ├── energy_distribution/
│   │   └── community_governance/
│   └── web/                 # Next.js application
├── packages/
│   └── stellar/             # Shared Stellar utilities
├── docs/                    # Documentation
└── .github/                 # Workflows + issue templates

Powered by Turborepo + pnpm workspaces.


Quick Start

Prerequisites

  • Node.js v22+
  • pnpm v10+ (corepack enable)
  • Rust + Cargo (for contracts)
  • Stellar CLI

Installation

git clone https://github.com/your-org/solarchain.git
cd solarchain
pnpm install

Run Development Server

pnpm dev

Frontend: http://localhost:3000

Build and Test Contracts

cd apps/contracts
stellar contract build
cargo test

Tech Stack

Layer Technology
Blockchain Stellar (Soroban smart contracts)
Smart Contracts Rust + OpenZeppelin Stellar v0.5.1
Frontend Next.js 15 + React 19 + TypeScript
Styling Tailwind CSS v4 + shadcn/ui
Wallet Freighter + Stellar Wallets Kit
Backend Next.js API Routes + Supabase
Deployment Vercel
Monorepo Turborepo + pnpm

Contributing

  1. Browse open issues
  2. Comment to claim an issue
  3. Fork, code, and submit a PR to develop

Branch Structure

  • main — Production (protected)
  • develop — Active development
git clone https://github.com/YOUR-USERNAME/solarchain.git
cd solarchain
git checkout develop
git checkout -b feat/your-feature
pnpm install && pnpm dev
# Submit PR to develop branch

Product Levels

Level What Status
1 — Internal registry Token = production record for cooperatives ✅ Current
2 — Verifiable certification Smart meters + oracles + independent verification 🔜 Next
3 — Recognized standard Integration with I-REC, Energy Web, TIGR 🔮 Future

License

Apache-2.0 — See LICENSE for details.


Built on Stellar · SolarChain Contributors 2026

About

Cooperative management dashboard + on-chain renewable energy certification infrastructure built on Stellar. Tokenizes solar production as proto-certificates (1 token = 1 kWh) using Soroban smart contracts. Built with Next.js, Supabase, and OpenZeppelin Stellar.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors