# Interactive Visualization of Proof-of-Work Consensus Protocol on Raspberry Pi

Crypto.world

> Blockchain consensus is a core concept, but it is abstract: forks, uncles, propagation delays and mining difficulty are hard to observe on a live public network and hard to teach without a tangible…

**arXiv**: 2511.20391

**Published**: 2025-11-25

**Authors**: Anton Ivashkevich, Matija Piškorec, Claudio J. Tessone

## AI summary

## Overview

**Research area:** Distributed systems and blockchain engineering, specifically proof-of-work consensus, with an emphasis on hardware-based education and demonstration tools.

**Technical level:** Intermediate. The paper is a system description rather than a theoretical or quantitative study, but it assumes some familiarity with Ethereum clients, peer-to-peer networking and consensus terminology.

**Scope (one sentence):** The paper describes a prototype private Ethereum Proof-of-Work network built from multiple Raspberry Pi single-board computers with LCD displays and a web-based control panel, designed to make consensus formation and degradation visible and configurable for teaching and demonstration.

## What This Paper Is About

Blockchain consensus is a core concept, but it is abstract: forks, uncles, propagation delays and mining difficulty are hard to observe on a live public network and hard to teach without a tangible example. The authors build a small, self-contained Ethereum Proof-of-Work network running on affordable Raspberry Pi computers, each with a screen showing its own view of the ledger, so that disagreements between nodes become directly visible. The goal is a portable, easy-to-deploy teaching and demonstration instrument whose network parameters (difficulty, latency, CPU core count, peer topology, experiment count and duration) can be changed from a central web interface.

## Key Contributions

1. **A complete standalone PoW Ethereum testbed on Raspberry Pi hardware.** The prototype runs a fully capable Ethereum Proof-of-Work network across multiple Raspberry Pi units, connected through a local WiFi router with no internet connection required, and provisioned by flashing a single system image (RaspbianOS with preconfigured dependencies) onto a μSD card.
2. **Per-node visual state display.** Each unit drives an LCD screen that renders that node's local view of the blockchain, using colour coding to link blocks to the node that mined them and an information panel showing block height, the leading mining node, that node's block contribution percentage, and the current node's own contribution. This makes propagation lag and forks observable at a glance.
3. **A central, touch-operated configuration interface.** A master Raspberry Pi runs a web-based control panel through which users adjust mining difficulty, per-node network latency, the number of CPU cores allocated to the miner, the number and duration of experiments, and fully customisable peer lists for each individual node, allowing arbitrary P2P topologies without physically rearranging the hardware.
4. **Decoupled, logged architecture built on a modified Geth client.** The system uses a modified version of the Go Ethereum client alongside Python scripts for communication and visualisation servers; the visualisation module talks to the node over JSON-RPC, so it can run on a separate device and is compatible with other Ethereum Virtual Machine-based blockchains. Every node logs detailed data from each run, preserving a historical record for later analysis. Source code and setup instructions are in a public GitHub repository.

## Main Findings

- **Feasibility confirmed on low-cost hardware:** the authors report that Raspberry Pi single-board computers provide sufficient computing power to run a full PoW Ethereum node together with the supporting network server and visualisation, and that the demo runs on 9 RPi SBCs as shown in the system photograph.
- **Consensus and its degradation are directly visible:** propagation in progress, partial synchronisation and consequent forks can be read off the LCD screens; the paper's architecture figure documents a moment when block propagation is still in progress, only several nodes are in sync, and others are creating forks.
- **Hardware constraints are stated, not benchmarked:** the software supports all Raspberry Pi models 4 or 5 with at least 4GB RAM, with 8GB RAM recommended. The paper reports no throughput, hashrate, power-consumption or latency measurements.
- **Display flexibility:** screens can be connected via DSI, SPI and HDMI interfaces; the demo setup itself uses 4.3" DSI LED screens chosen for smartphone-level response times, colour accuracy and viewing angles.
- **Uniform hardware yields fair-looking mining:** because all mining nodes use identical hardware, each has a similar hashrate, which the authors present as enabling clear demonstration of fair block distribution among participants.
- **Offline operation is possible:** the master device supplies the other units with all required data to run the Ethereum network, removing the need for an internet connection.

## Methodology in Plain English

The authors assembled a private Ethereum Proof-of-Work network from Raspberry Pi computers rather than simulating one in software. One unit acts as a master: it runs a web-based control panel on a touch interface, holds the data the other units need, and lets a user set the experiment's parameters. The remaining units each run a full Ethereum node based on a modified Go Ethereum (Geth) client, mine blocks, and validate them.

Because each unit is a real node with its own local ledger, differences between nodes are genuine rather than simulated. A Python visualisation server on each unit queries its node through the JSON-RPC interface and draws that node's chain on an attached screen, colouring blocks by the node that mined them. A network configuration script detects devices by predefined hostnames and connects them automatically, and peer lists can be rewritten per node so that the logical topology can be reshaped while the physical layout stays the same. To keep deployment simple, the whole stack is shipped as a preconfigured disk image that is flashed to a μSD card, and each node records detailed logs of every run for later analysis. The authors describe the design and its use cases; they do not report a controlled performance evaluation.

## Why This Matters

**Impact on research:** The system produces complete per-node logs of every run, giving researchers a reproducible way to generate datasets on fork behaviour, block propagation and consensus evolution under deliberately varied topology, latency and hashrate conditions — including scenarios that are impractical to stage on a public network.

**Real-world applications:**

- **Classroom and outreach teaching:** a portable, offline, no-specialist-knowledge-required demonstration of what a blockchain node actually does and why nodes disagree.
- **Attack demonstrations:** the adjustable parameters let instructors stage 51% attacks and eclipse attacks, and simulate specific peer-to-peer network configurations.
- **Protocol and client experimentation:** because the visualisation connects over JSON-RPC, it can be pointed at other Ethereum Virtual Machine-based blockchains, extending its use beyond the specific client shipped with the image.
- **Hands-on training for non-engineers:** audiences across fields with and without a technical background can observe consensus formation in a new network and its degradation over time.

**Industry relevance:** The work shows that a functional multi-node PoW network can be built from commodity single-board computers with a one-image deployment path, which lowers the cost and skill barrier for blockchain training, internal prototyping and client-behaviour demonstrations.

## Future Directions

- **Quantitative evaluation:** the paper reports no measurements of hashrate, block propagation time, fork rate or the effect of specific latency and topology settings; characterising consensus degradation as a function of these parameters is the obvious next step.
- **Comparative topology studies:** since peer lists are fully customisable per node, systematic experiments across many P2P topologies could establish which structures are most prone to forks.
- **Extension beyond proof-of-work:** the JSON-RPC decoupling is described as compatible with other Ethereum Virtual Machine-based blockchains, opening the question of how far the visualisation and control layer can be reused for other consensus mechanisms.
- **Scaling and reproducibility:** the demo is shown with 9 units; whether the architecture, the automatic hostname-based network configuration and the offline master-unit data supply model hold up at larger node counts is not reported and remains open.

## Target Audience

This paper is most useful to educators and outreach organisers who need a tangible blockchain demonstration, to university lab instructors and students building hands-on distributed-systems exercises, and to researchers who want a low-cost, fully logged testbed for studying PoW consensus, fork behaviour and network attacks. Engineers interested in deploying small private Ethereum networks with Geth on constrained hardware will also find the deployment model (single flashable image, hostname-based auto-configuration, JSON-RPC-based monitoring) directly applicable.

## Authors’ abstract

We describe a prototype of a fully capable Ethereum Proof-of-Work (PoW) blockchain network running on multiple Raspberry Pi (RPi) computers. The prototype is easy to set up and is intended to function as a completely standalone system, using a local WiFi router for connectivity. It features LCD screens for visualization of the local state of blockchain ledgers on each RPi, making it ideal for educational purposes and to demonstrate fundamental blockchain concepts to a wide…

[The full abstract on arXiv](https://arxiv.org/abs/2511.20391)

[Read the original paper](https://arxiv.org/abs/2511.20391)

---

Canonical: https://crypto.world/paper/interactive-visualization-of-proof-of-work-consensus-protocol-on-2511.20391
