34214533c9
This patch addresses two suboptimal behaviors in the `TorDiscovery` class: 1. Currently it uses the DNS-lookup timeout as the timeout for opening circuits as well as for actually looking up the IP numbers. It may be this timeout value, which is five seconds hard-coded into the `PeerGroup` class, was not intended for this purpose. Moreover, the `TorConfig` class has a value, circuitBuildTimeout, apparently for this purpose; at least its default of 60 seconds may be more appropriate for this purpose than the five-second lookup timeout. 2. Currently, the process of opening circuits for the DNS lookups will take exactly as long as the timeout value, no more, no less, which practically guarantees that the client will either wait longer than necessary, or else experience timeout errors that could have been avoided by waiting a bit longer. The changes herein use the return value of`TorConfig.getCircuitBuildTimeout()` as the timeout for opening circuits, rather than using the DNS lookup timeout value that is passed by `PeerGroup` as an argument to `PeerDiscovery.getPeers()`. Moreover, as soon as a circuit either has been opened or failed to be opened for each router, the DNS lookups then begin without waiting for the timeout time to elapse. Notes: 1. There are no tests with these changes. There don't seem to be any tests for the `TorDiscovery` class. There probably ought to be. 2. The `TorDiscovery` class's DNS lookup procedure has the same timeout characteristic as the one this patch removes from the circuit-opening procedure, namely it waits for as long as the timeout value, no more no less. If the changes proposed in this patch are acceptable, I would consider making the same change for the process of looking up the peer IP numbers.
Build status: 
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+
- Maven 3+ - for building the project
- Orchid - for secure communications over TOR
- 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=com.google.bitcoin.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.