A library for working with Bitcoin
Go to file
Andreas Schildbach 850f219607 Basic support for version 2 transactions.
Rather than considering all version 2 transactions risky, we now look more closely if any of its
inputs has a relative lock time. We can't check the relative locks though, because we usually
don't have the spent outputs (to know when they were creted).
2017-08-31 00:04:01 +02:00
core Basic support for version 2 transactions. 2017-08-31 00:04:01 +02:00
designdocs Design doc for contexts 2015-03-21 17:23:21 +01:00
examples Move ScriptException from .core to .script package. 2017-08-14 09:24:18 +02:00
misc Higher res logo PNG 2015-06-03 12:19:43 +02:00
tools Move ScriptException from .core to .script package. 2017-08-14 09:24:18 +02:00
wallettemplate Update wallet-template to Guava 22.0-android too. 2017-06-23 11:49:55 +02:00
.gitattributes Add a logo. 2013-03-01 13:59:48 +01:00
.gitignore Don't gitignore wallet files. 2015-06-17 08:43:07 +02:00
.travis.yml Make Travis CI use Ubuntu Trusty image for building. 2017-07-29 21:45:31 +02:00
AUTHORS Update AUTHORS from git. 2016-04-02 17:56:39 +02:00
COPYING Initial checkin of BitCoinJ 2011-03-07 10:17:10 +00:00
pom.xml Add the generic license header to POMs, shell scripts and JavaScript/Python examples. 2016-06-06 21:32:02 +02:00
README.md Remove some remaining mentions of Tor and Orchid. 2017-08-12 10:14:12 +02:00

Build Status Coverage Status

Visit our IRC channel

Welcome to bitcoinj

The bitcoinj library is a Java implementation of the Bitcoin protocol, which allows it to maintain a wallet and send/receive transactions without needing a local copy of Bitcoin Core. It comes with full documentation and some example apps showing how to use it.

Technologies

  • Java 6 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.