Java library for adding altcoin support to bitcoinj

Open issuesOpen issues17
Last updateLast update2022-01-04

Welcome to libdohj

The libdohj library is a lightweight wrapper library around the bitcoinj Java library, enabling support for Dogecoin (pull requests for support for other altcoins would be welcomed).


  • Java 7 for the core modules, Java 8 for everything else
  • Gradle 3.4+ - for building the project
  • Google Protocol Buffers - for use with serialization and hardware communications

Getting started

To get started, it is best to have the latest JDK and Gradle installed. The HEAD of the main branch contains the latest development code and various production releases are provided on feature branches.

You should be familiar with bitcoinj first, as this library simply adds minor changes to extend bitcoinj. Generally using libdohj is equivalent to using bitcoinj, except with different network parameters (reflecting Dogecoin consensus in place of Bitcoin).

Be aware however that altcoin blocks have their own class, AltcoinBlock, which adds support for features such as AuxPoW.

Building from the command line

To perform a full build use

gradle clean build

You can also run

gradle javadoc

to generate the JavaDocs.

The outputs are under the build directory.

Building from an IDE

Alternatively, just import the project using your IDE. IntelliJ has Gradle integration built-in and has a free Community Edition. Simply use File | New | Project from Existing Sources and locate the build.gradle in the root of the cloned project source tree.