MultiBit is a Simplified Payment Verification (SPV) Bitcoin desktop client.
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:
- 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
- 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:
The branch you should use for the MultiBit master code is:
The branch you should use for the MultiBit develop code is:
Once cloned, you should then install the custom Bitcoinj library using
mvn clean install
This loosely follows the "master-develop" or "Git flow" pattern.
There are 2 main branches:
master branch is exclusively for releases, while the
is exclusively for release candidates. The
develop branch always has a Maven version of
Occasionally a feature branch will be made off
develop to cover a long-running issue. This will then be merged back into
develop is ready for release it is subjected to extensive testing (manual and automated). The final act is to update the
to remove the SNAPSHOT suffix and merge it into
master branch is then tagged with the release number. Tags are in the format
v1.2.3 to distinguish them from branch names.
An announcement is made on the MultiBit website and social media (Twitter, Reddit, Bitcointalk etc) to alert everyone that a new version is available.
Maven build targets
The important targets are:
mvn clean install
After some processing, you will have the following artifacts in the target directory:
- an executable 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
MultiBit Classic is quite flexible and has several features only accessible to power users through the configuration file. This is discussed in more detail in configuration.md
All contributors must be OK with releasing their work under the MIT license.