Skip to content

Getting started

There are two ways to get BlockchainBench, and which one you want depends on whether you intend to use the tool or work on it.

For users

Standalone build

A packaged executable that bundles the desktop application with the core engine, the shared models and their dependencies. Download it, start it, run simulations — no Eclipse, no update sites, no build path.

Coming soon

For developers

Build from source

Install the 3SIM features into Eclipse, add the standalone-initialisation libraries, and wire up JavaFX. This is the route if you want to extend the tool, change the simulator bridge, or work on the models.

Setup guide

The standalone build is meant to be the short path: it is the same application, but pre-assembled, so nothing has to be installed around it. It is not available yet — until then, the development setup is the only way to run BlockchainBench.

The development setup takes noticeably longer, because the simulator is an Eclipse plug-in platform rather than a standalone library. You install the Palladio blockchain systems features from the 3SIM update site, add the tools.mdsd standalone-initialisation libraries, and import the project. If you also want the graphical interface, JavaFX has to be registered as a user library and added to the project’s build path.

It is worth knowing that this effort buys you more than just running the tool: with the sources in your workspace you can change the metric registry, add simulation modes, or drive the engine yourself through the IBlockchainBench interface.

Once the environment is in place, the practical details live in two places:

  • Build and run — the data/ layout, the configuration file formats, how to launch the desktop and headless applications, and what the result documents contain.
  • Architecture — how the four bundles fit together, if you intend to change something.