Stellar SolarGrid

Powering Africa with affordable, pay-as-you-go solar energy on blockchain.

Stellar SolarGrid is a decentralized PAYG solar energy platform built on Soroban, within the Stellar ecosystem. Households and small businesses in underserved regions access solar electricity through flexible micro-payments — no large upfront costs required.

Architecture

stellar-solar-grid/
├── contracts/        # Soroban smart contracts (Rust)
├── frontend/         # React + TypeScript user/provider dashboards
├── backend/          # Node.js API + IoT smart meter bridge
└── README.md

Core Features

• Smart Meter Integration — IoT meters with real-time usage monitoring and on/off control
• Flexible Payment Plans — Daily, weekly, or usage-based micro-payments in stablecoins
• Automated Access Control — Smart contracts enable/disable electricity based on payment status
• Energy Usage Tracking — Dashboards for users and providers

Getting Started

Prerequisites

• Rust + wasm32-unknown-unknown target
• Stellar CLI
• Node.js >= 18
• Freighter Wallet (browser extension)

Smart Contracts

cd contracts
cargo build --target wasm32-unknown-unknown --release
stellar contract deploy --wasm target/wasm32-unknown-unknown/release/solar_grid.wasm --network testnet

Frontend

cd frontend
npm install
npm run dev

Backend

cd backend
npm install
npm run dev

Smart Contract Overview

The SolarGrid contract manages:

Function	Description
register_meter(meter_id, owner)	Register a new smart meter
make_payment(meter_id, amount, plan)	Pay for energy access
check_access(meter_id)	Check if meter is currently active
get_usage(meter_id)	Retrieve usage data
update_usage(meter_id, units)	Called by IoT oracle to update consumption

Network

Deployed on Stellar Testnet. Switch to Mainnet for production.

License

MIT