(image)

Programming Hotmoka
A tutorial on Hotmoka and smart contracts in Takamaka

1.5 Installing the source code of Hotmoka

You do not need to install to source code of Hotmoka to follow this book. Nevertheless, an important aspect of blockchain technology is that trust is based also on the public availability of the source code. Moreover, you will need to download the source code if you want to understand the inner details of Hotmoka, or contribute to the development of the project or fork the project.

Assuming that you have already downloaded the source code of Hotmoka, as shown in Sec. 1.4, you can cd to the hotmoka directory and compile, package, test and install the Hotmoka jars: 

mvn clean install

All tests should pass and all projects should be successfully compiled and packaged.

If you are not interested in running the tests, append -DskipTests at the end of the previous command.

If you want to edit the source code inside an IDE, you can import it in Eclipse, NetBeans or IntelliJ. In Eclipse, use the File\( \rightarrow \)Import\( \rightarrow \)Existing Maven Projects menu item and import the parent Maven project contained in the hotmoka directory that you cloned from GitHub. This should create, inside Eclipse, also its submodules. You will then be able to compile, package, test and install the Hotmoka jars inside Eclipse itself, by right-clicking on the parent project and selecting Run As and then the Maven install target. You will also be able to run the tests inside the Eclipse JUnit runner, by right-clicking on the io-hotmoka-tests subproject and selecting Run As and then the JUnit Test target.