vicinia

An open-source simulation for HACK4EARTH 2.0 that shares solar and generator power across a Lagos neighbourhood, so essential loads stay on through outages and less fuel is burned.

Category

Open Source

Industry

Energy and Climate

Role

Developer

Stack

Python, pvlib, pytest, Hypothesis

Neighbourhood of homes sharing solar power, with a hash-chained ledger of transfers
What I built

vicinia steps through the grid in 15-minute intervals for up to a year, using NERC supply bands. Its critical-first strategy serves essential loads before anything else, and every transfer is written to a SHA-256 hash-chained ledger priced in kobo, so the accounts can't be quietly changed.

Challenge and solution

Sharing only works if nobody loses out. I added pressure tests and property-based tests with Hypothesis to check fairness across many scenarios, not just the easy ones.

Results

In a 50-home Lagos scenario, critical-load coverage rose from 68.4% to 98.1% and generator fuel fell from 25,684 to 18,053 litres a year, about 30% less, with no household worse off. The inputs are synthetic.