Welcome to syscoinj
The syscoinj library is a Java implementation of the Syscoin protocol, which allows it to maintain a wallet and send/receive transactions without needing a local copy of Syscoin Core. It comes with full documentation and some example apps showing how to use it.
- Java 6 for the core modules, Java 8 for everything else
- Maven 3+ - for building the project
- Orchid - for secure communications over TOR
- Google Protocol Buffers - for use with serialization and hardware communications
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. the
syscoin-port branch contains the syscoin port of the bitcoinj library. It will be reported from every major release of bitcoinj.
Building from the command line
To perform a full build use
mvn clean package
You can also run
to generate a website with useful information like JavaDocs.
The outputs are under the
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.
These are found in the
This will download the block chain and eventually print a Syscoin 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. Make sure you checkpoint up to the B2 fork since KGW diff algorithm was abondoned for the basic algorithm after B2. Syncing is very slow (2 blocks a second) with KGW enabled.
Now you are ready to follow the tutorial.