2011-06-27 14:16:38 +00:00
|
|
|
To get started, ensure you have the latest JDK installed, and download Maven from:
|
2011-03-07 10:17:10 +00:00
|
|
|
|
2011-06-27 14:16:38 +00:00
|
|
|
http://maven.apache.org/
|
|
|
|
|
|
|
|
|
|
Then run "mvn clean package" to compile the software. You can also run "mvn site:site" to generate a website with
|
|
|
|
|
useful information like JavaDocs. The outputs are under the target/ directory.
|
2011-03-07 10:17:10 +00:00
|
|
|
|
2012-05-31 08:26:07 +00:00
|
|
|
Now try running one of the example apps:
|
2011-03-07 10:17:10 +00:00
|
|
|
|
2012-05-31 08:26:07 +00:00
|
|
|
cd examples
|
|
|
|
|
mvn exec:java -Dexec.mainClass=com.google.bitcoin.examples.PingService
|
2011-03-07 10:17:10 +00:00
|
|
|
|
2012-02-13 19:48:26 +00:00
|
|
|
It will download the block chain and eventually print a Bitcoin address. If you send coins to it,
|
2011-06-27 14:16:38 +00:00
|
|
|
you should get them back a few minutes later when a block is solved.
|
|
|
|
|
|
2012-02-13 19:48:26 +00:00
|
|
|
You can also use a command line tool that exposes basic Bitcoin operations
|
|
|
|
|
|
2012-05-31 09:08:27 +00:00
|
|
|
On UNIX:
|
|
|
|
|
cd tools
|
|
|
|
|
./wallet-tool
|
|
|
|
|
|
|
|
|
|
On other platforms, do what the shell script would do for you:
|
|
|
|
|
cd tools
|
|
|
|
|
mvn -q package -DskipTests
|
|
|
|
|
java -jar target/bitcoinj-tools-*.jar --help
|
|
|
|
|
|
2012-02-13 19:48:26 +00:00
|
|
|
|
2011-06-27 14:16:38 +00:00
|
|
|
Note that if you connect to a node that is itself downloading the block chain, you will see very slow progress (1
|
|
|
|
|
block per second or less). Find a node that isn't heavily loaded to connect to.
|
|
|
|
|
|
|
|
|
|
If you get a SocketDisconnectedException, the node you've connected to has its max send buffer set to low
|
|
|
|
|
(unfortunately the default is too low). Connect to a node that has a bigger send buffer,
|
2011-08-30 20:31:20 +00:00
|
|
|
settable by passing -maxsendbuffer=25600 to the Bitcoin C++ software.
|
|
|
|
|
|
2012-01-11 21:34:14 +00:00
|
|
|
To regenerate the protobuf Java sources from src/bitcoin.proto, install the protobuf compiler package version 2.4.x:
|
|
|
|
|
|
|
|
|
|
Debian/Ubuntu: apt-get install protobuf-compiler
|
|
|
|
|
|
|
|
|
|
Windows: http://code.google.com/p/protobuf/downloads/list
|
|
|
|
|
|
|
|
|
|
OSX: install from ports?
|
|
|
|
|
|
|
|
|
|
and regenerate:
|
|
|
|
|
|
|
|
|
|
mvn clean package -DupdateProtobuf
|
2011-08-30 20:31:20 +00:00
|
|
|
|
2012-01-12 00:04:14 +00:00
|
|
|
For eclipse use the maven plugin and run:
|
|
|
|
|
|
|
|
|
|
mvn eclipse:eclipse
|
