An introduction to using the library
This document describes how to use the code in 0.14.4, git master may be slightly different
Note that these tutorials assume familiarity with the basics of the Bitcoin protocol. If you aren’t already familiar with the structure of the block chain and how transactions work, please read Satoshi’s white paper before this tutorial.
Before we start
This library is not like other libraries. A Bitcoin API allows you to directly handle money, possibly large sums of other people’s money. It is important to understand the following. After completing this tutorial you are NOT qualified to write production applications. You will have a flavor of how to write applications, but Bitcoin is a subtle and complex system.
FAILURE TO UNDERSTAND WHAT YOU ARE DOING CAN CAUSE MONEY TO BE STOLEN OR PERMANENTLY DESTROYED
These documents will help you learn how to use bitcoinj, but they are not yet completely comprehensive. If you are ever in any doubt at all, or just want some code review, please ask on our mailing list or on our forum for advice and a second opinion. Also, make sure you keep up with the latest versions of the software. Bug fixes happen all the time and any one of them could be required for the safety of your wallet. It’s important that you frequently rebase onto new versions of the library, even though bitcoinj does not have a stable API.