Python Makefile R
Latest commit 651fc76 Jan 14, 2018 @simonmulser simonmulser Merge pull request #3 from simonmulser/fix-missing-docker-image
Fix missing docker image

Simcoin - A Blockchain Simulation Framework 🏗️

Simcoin facilitates realistic simulations of blockchain networks (currently Bitcoin only). The network is virtualised by the simulation software on one single Unix host machine. To be able to spawn multiple peers the CPU-heavy proof-of-work is deactivated. Blocks and transactions are created by sending respective commands over RPC to the nodes according to a pre-configured simulation scenario.

Getting started 🏁

Prerequisites: python3, pip3, docker, make and R. Check if you have them installed.

  • git clone
  • cd simcoin
  • make install (if fails check output, you may need to install other dependencies depending on your OS)
  • make build-image (consider to use multiple threads to build the image - check Dockerfile under code/docker)
  • make demo
  • checkout results under data/last_run and the generated report data/last_run/postprocessing/report.pdf

Stack 📚

Performance 🚀

When running a simulation, monitor the host machine closely. Check utilisation of RAM, CPU, Disk and Network. Further, control the log created by the host system (dmesg) as well as the log produced by the simulation framework (data/debug.log) and nodes (data/last_run/node-X/debug.log). To improve the performance consider the following:

  • Increase the ARP-cache if you encounter a neighbour table (ARP-cache) overflow in the kernel messages (dmesg).
  • Run the whole simulation in RAM by using tmpfs.
  • Use a better host machine! 😉

Outlook/Possible improvements 🔮

  • Improving performance and stability by using Unix domain sockets for host to peer communication.
  • Sustaining different blockchain projects such as Ethereum or Litecoin.
  • Using the ELK-Stack to parse, store and analyse the log files.

Credits 🙏

This whole section including the addresses will be removed at the 1. March since the project should transit to a community project.

Ground idea and initial development by Andreas Kern.


Image of SBA-Research logo

Developed in collaboration with Aljosha Judmayer and SBA-Research in the context of a thesis.


Image of netidee logo scholarship

Additional outcome of a thesis sponsored by Netidee Scholarship 12th Call, year 2017/2018.


If you want to award my (Simon Mulser) efforts:

BTC: 1JhcdkezyEWpYz9xit6YU9C4MMPYg8HujF
LTC: LYjmCsjVobaGg1p4ZDMDDcfKmn2dXz25r5
ETH: 0x00d40D0Cd0924282dedcb957cdaF32AC0038C5c1