/bitcoinj forked from bitcoinj/bitcoinj

A library for working with Bitcoin
  1. Java 99.8%
  2. Other 0.2%
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

#81 Compare This branch is 196 commits ahead, 339 commits behind bitcoinj:master.
@Danconnolly
Danconnolly notice to follow Bitcoin SV
Latest commit c3e90e2 Dec 4, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
core remove testnet seeders that are not resolving Jul 19, 2018
docs separate integration tests and enable for travis-ci.org (#6) May 15, 2018
examples update version Jan 23, 2018
jenkins optimize jenkins tests, add sonarcloud (#16) May 15, 2018
misc Higher res logo PNG Jun 3, 2015
tools update copyright Jun 4, 2018
wallettemplate update version Jan 23, 2018
.gitattributes Add a logo. Mar 1, 2013
.gitignore Don't gitignore wallet files. Jun 17, 2015
.travis.yml separate integration tests and enable for travis-ci.org (#6) May 15, 2018
AUTHORS Update AUTHORS from git. Apr 2, 2016
COPYING Initial checkin of BitCoinJ Mar 7, 2011
README.md notice to follow Bitcoin SV Dec 3, 2018
pom.xml optimize jenkins tests, add sonarcloud (#16) May 15, 2018

README.md

Build Status Coverage Status Javadocs

NOTICE

The bitcoinj.cash library will be following the Bitcoin SV chain. The following changes will take place:

  • 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

Welcome to bitcoinj.cash

The bitcoinj.cash 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.

Release notes are here.

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.