gitwtfhub

wtf is thesis-code?

gakonst/thesis-code — explained in plain English

Analysis updated 2026-08-04 · repo last pushed 2022-12-08

6PythonAudience · researcherComplexity · 4/5DormantSetup · hard

TL;DR

University thesis code that uses Ethereum smart contracts to record energy consumption and automate billing, making electricity metering transparent and tamper-proof without a central utility company.

Mindmap

mindmap
  root((repo))
    What it does
      Tracks energy on blockchain
      Automates billing via contracts
      Makes metering transparent
    Research threads
      Storage cost optimization
      Security scanning with Slither
      Gas cost comparison
    Use cases
      Peer-to-peer energy trading
      Solar panel surplus sales
      EV charging billing
    Audience
      Energy companies
      Grid operators
      P2P energy startups
    Tech stack
      Python
      Ethereum smart contracts
      Slither security tool

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build a peer-to-peer energy trading platform where neighbors sell excess solar power with automated blockchain billing.

REASON 2

Audit smart contracts for security vulnerabilities using the Slither testing approach before deploying them.

REASON 3

Compare gas costs of optimized smart contracts against a baseline to evaluate efficiency improvements.

REASON 4

Prototype a blockchain-based electricity metering system for a microgrid or campus environment.

What's in the stack?

PythonEthereumSoliditySlither

How it stacks up

gakonst/thesis-codeaa2246740/ultimate-designaclark4life/home-depot-crawl
Stars666
LanguagePythonPythonPython
Last pushed2022-12-082014-08-10
MaintenanceDormantDormant
Setup difficultyhardeasymoderate
Complexity4/52/52/5
Audienceresearchervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires an Ethereum development environment and understanding of smart contract deployment, gas mechanics, and the Slither auditing tool.

No license is mentioned in the repository, so default copyright restrictions apply and you should contact the author before using the code.

Wtf does this do

This repository holds the code and research from Georgios Konstantopoulos's university thesis on using Ethereum's blockchain to track energy consumption and handle billing automatically. The core idea is to make electricity metering and payments more transparent and secure by recording usage on a blockchain instead of relying on a central utility company or middleman. At a high level, the system uses "smart contracts", self-executing programs that live on the Ethereum blockchain, to record how much energy a household or business consumes and then calculate what they owe based on predefined rules. Because these contracts run on a public blockchain, the billing logic is auditable and tamper-resistant: no single party can secretly alter the rates or the meter readings after the fact. The repository is organized into a few research threads. One folder explores ways to make smart contracts cheaper to run by reducing the amount of data they store, since every operation on Ethereum costs a small fee (called "gas"). Another folder focuses on security, testing a tool called Slither that scans smart contracts for vulnerabilities before they go live. A third folder contains the actual meter-and-bill implementation, and a final section compares the gas costs of the proposed efficiency improvements against a baseline. The people who would care about this are energy companies, grid operators, or startups exploring peer-to-peer energy trading, for example, a neighborhood where homes with solar panels sell excess power directly to neighbors, with automated billing handled by a blockchain contract instead of a utility. Honda Research and Development Europe collaborated on the thesis, which signals interest from the automotive and mobility sector, possibly around electric vehicle charging scenarios. What's notable is the project's dual focus on both practicality and safety. Blockchain applications often struggle with high transaction costs and security bugs, and this work tackles both: it proposes a specific method to cut storage costs on Ethereum, and it validates an automated auditing tool against existing vulnerable contracts. The tradeoff, inherent to Ethereum itself, is that even with optimizations, running billing logic on a public blockchain still incurs per-transaction fees that centralized systems don't have.

Yoink these prompts

Prompt 1
Help me set up and run the smart contract energy metering system from this thesis repo. Walk me through deploying the contracts and simulating energy billing on a local Ethereum test network.
Prompt 2
I want to understand and reproduce the gas cost comparison from this repo. Guide me through running the baseline vs optimized contracts and interpreting the results.
Prompt 3
Show me how to use the Slither security scanning approach from this thesis to audit my own Ethereum smart contracts for common vulnerabilities before deployment.
Prompt 4
Help me adapt the energy billing smart contract from this repo into a peer-to-peer solar trading prototype where households sell excess power to neighbors automatically.

Frequently asked questions

wtf is thesis-code?

University thesis code that uses Ethereum smart contracts to record energy consumption and automate billing, making electricity metering transparent and tamper-proof without a central utility company.

What language is thesis-code written in?

Mainly Python. The stack also includes Python, Ethereum, Solidity.

Is thesis-code actively maintained?

Dormant — no commits in 2+ years (last push 2022-12-08).

What license does thesis-code use?

No license is mentioned in the repository, so default copyright restrictions apply and you should contact the author before using the code.

How hard is thesis-code to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is thesis-code for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.