Skip to content
Browse files

retirement notice

  • Loading branch information...
Danconnolly committed Mar 1, 2019
1 parent c3e90e2 commit aa7d7072cb406ff4fa62b1184a275b38245c8bdc
Showing with 2 additions and 76 deletions.
  1. +2 −76
@@ -1,80 +1,6 @@
[![Build Status](]( [![Coverage Status](]( [![Javadocs](](

The library will be following the Bitcoin SV chain. The following changes will take place:
The library has been retired, this repository will be put into archive mode soon.

* a minor update, including released jar, to update DNS seeds to point to Bitcoin SV DNS seeds
* rebranding to bitcoinj-sv version 0.9.0
* work will start on bitcoinj-sv version 1.0.0, which will make significant changes to the API
For the Bitcoin SV version of BitcoinJ, please see

### Welcome to

The library is a Java implementation of the Bitcoin cash protocol. This library is a fork of Mike Hearn's original bitcoinj library aimed at supporting the Bitcoin cash eco-system.

It allows maintaining a wallet and sending/receiving transactions without needing a full blockchain node. It comes with full documentation and some example apps showing how to use it.

For support and discussion please join us on the [mailing list](!forum/bitcoinj-cash).

Release notes are [here](docs/

### Technologies

* Java 7 for the core modules, Java 8 for everything else
* [Maven 3+]( - 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 Maven installed. The HEAD of the `master` branch contains the latest development code and various production releases are provided on feature branches.

#### Building from the command line

To perform a full build use
mvn clean package
You can also run
mvn site:site
to generate a website with useful information like JavaDocs.

The outputs are under the `target` directory.

#### Building from an IDE

Alternatively, just import the project using your IDE. [IntelliJ]( has Maven integration built-in and has a free Community Edition. Simply use `File | Import Project` and locate the `pom.xml` in the root of the cloned project source tree.

### Example applications

These are found in the `examples` module.

#### Forwarding service

This will download the block chain and eventually print a Bitcoin address that it has generated.

If you send coins to that address, it will forward them on to the address you specified.

cd examples
mvn exec:java -Dexec.mainClass=org.bitcoinj.examples.ForwardingService -Dexec.args="<insert a bitcoin address here>"

Note that this example app *does not use checkpointing*, so the initial chain sync will be pretty slow. You can make an app that starts up and does the initial sync much faster by including a checkpoints file; see the documentation for
more info on this technique.

### Where next?

Now you are ready to [follow the tutorial](

### Contributing to Bitcoinj Cash

Contributions to Bitcoinj Cash are welcome and encouraged.

* the development branch is `cash`
* release branches are named `cash-<version>`
* Travis-CI is [here](
* Coveralls test coverage report is [here](

The project's BCH donation address is: 1M6GwE9ddu8S6tvYE1qbAnqeG3CM1UaVvP
Do NOT send BTC to this address, only BCH! Any funds donated will be used for bug or feature bounties.

0 comments on commit aa7d707

Please sign in to comment.
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.