Introduction

MultiGroestl is a Simplified Payment Verification (SPV) Groestlcoin desktop client. It is ported from the MultiBit Bitcoin client. Huge thanks to the original devs for this awesome project!

<<<<<<< HEAD MultiGroestl relies on the following technologies:

MultiBit is now in maintenance mode as it has largely been replaced by MultiBit HD. To avoid confusion we refer to MultiBit Classic and MultiBit HD to keep them separate.

MultiBit Classic relies on the following technologies:

original_multibit/master

• Maven as the build system, so the usual Maven processes apply. If you're not familiar with Maven then download it first and follow their installation instructions.
• ZXing ("Zebra Crossing") for QR codes <<<<<<< HEAD
• Groestlcoinj for access to the Groestlcoin network
• IzPack for creating installers for Windows, Mac, Linux
• Bitcoinj Enforcer Rules to prevent dependency chain attacks
• XChange for access to several Bitcoin exchanges

A note on the Groestlcoinj dependency

MultiGroestl depends on a special fork of Groestlcoinj for its Bitcoin support. This is due to legacy wallet serialization issues and the MultiGroestl team are working towards a complete integration. To build MultiGroestl you will need to clone this fork from here:

• Bitcoinj for access to the Bitcoin network
• Install4j for creating installers for Windows, Mac, Linux
• Bitcoinj Enforcer Rules to prevent dependency chain attacks
• XChange for access to several Bitcoin exchanges

The Bitcoinj "Alice" dependency

MultiBit Classic depends on a special fork of Bitcoinj for its Bitcoin support. This is due to legacy wallet serialization issues and the MultiBit team are working towards a complete integration through the MultiBit HD project.

While it is possible to build MultiBit Classic using our staging repository you may want to review the modified Bitcoinj library for yourself. You can clone from this fork:

original_multibit/master

https://github.com/GroestlCoin/groestlcoinj-mb-alice

<<<<<<< HEAD Once cloned, you should then install the custom Groestlcoinj library using

The branch you should use for the MultiBit master code is: bcj-0.11.2-mb-alice The branch you should use for the MultiBit develop code is: bcj-0.11.2-mb-alice

Once cloned, you should then install the custom Bitcoinj library using

original_multibit/master

mvn clean install

Branching strategy

This loosely follows the "master-develop" or "Git flow" pattern.

There are 2 main branches: master and develop. The master branch is exclusively for releases, while the develop is exclusively for release candidates. The develop branch always has a Maven version of develop-SNAPSHOT.

Occasionally a feature branch will be made off develop to cover a long-running issue. This will then be merged back into develop

When develop is ready for release it is subjected to extensive testing (manual and automated). The final act is to update the pom.xml to remove the SNAPSHOT suffix and merge it into master.

The master branch is then tagged with the release number. Tags are in the format v1.2.3 to distinguish them from branch names.

<<<<<<< HEAD An announcement is made on the MultiGroestl website to alert everyone that a new version is available.

An announcement is made on the MultiBit website and social media (Twitter, Reddit, Bitcointalk etc) to alert everyone that a new version is available.

original_multibit/master

Maven build targets

The important targets are:

<<<<<<< HEAD
mvn clean package

which will package the MultiGroestl project into multigroestl-x.y.z.jar where x.y.z is the current version number. This is suitable for local development work.

If you want to generate a complete set of multi-platform installers (Windows, Mac and Linux) you use the following command

maven clean install
=======
mvn clean install
>>>>>>> original_multibit/master

After some processing, you will have the following artifacts in the target directory:

<<<<<<< HEAD

• an executable jar = multigroestl-exe.jar
• a Mac application bundle = MultiGroestl.app
• a Mac DMG file = multigroestl-x.y.z.dmg
• an installer for Windows = multigroestl-x.y.z-windows.exe
• an installer for Linux = multigroestl-x.y.z-linux.jar

To run MultiGroestl from these artifacts you can follow the instructions provided on the main MultiGroestl website

MultiGroestl contains cut down JREs so is a large clone

The MultiGroestl installers contain cut down JREs so the project clone is quite large. (100 to 200 MB).

Custom configuration

MultiGroestl is quite flexible and has several features only accessible to power users through the configuration file. This

• an executable jar: multibit-exe.jar

Bitcoin Solutions staff

Use the Install4j installer in the multibit-installers project to create your Mac/ Win/ Linux installers.

To run MultiBit from these artifacts you can follow the instructions provided on the main MultiBit website

Custom configuration

MultiBit Classic is quite flexible and has several features only accessible to power users through the configuration file. This

original_multibit/master is discussed in more detail in configuration.md

Contributing

<<<<<<< HEAD If you want to contribute, please contact me at: groestlcoin@gmail.com.

All contributors must be OK with releasing their work under the MIT license.

original_multibit/master