Apollo-exec

!Attention! Repository is under construction!

Apollo is being developed by the Apollo Foundation and supporting members of the community. This repository contains Apollo blockchain main executable and packager.

Main executable is executable fat jar that requires Java 11 to run.

Package is cross-platform zip file containing all required config files and scripts.

Attention! This build DOES NOT contain web-ui. Web-ui now is separate package that could be downloaded from Apollo-webui release page or build from sources.

Build instruction

If you have already installed jdk 11, you can skip "Preparation steps" section, but its recommended to review your software versions using instructions from "Preparation steps" section

Preparation steps

1. Download Java Development Kit (jdk), version 11
2. Setup JAVA_HOME variable to point on unpacked jdk if not set
3. Add to PATH variable path to java binaries -> JAVA_HOME/bin

   NOTE: if your computer has jdk 8, jdk 9 or jdk 10, you should remove it from PATH variable

4. Open command line and execute: java -version.

Output example: 

 java version "11.0.2" 2019-01-15 LTS

Java(TM) SE Runtime Environment 18.9 (build 11.0.2+9-LTS)

Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.2+9-LTS, mixed mode)

5. If version matches downloaded version, your java was installed successfully and you can proceed with next steps. If version does not match, delete old version, setup variables (JAVA_HOME, PATH) and try again. PATH should not contain few java bin directories!
6. Open command line, change your current directory to this project root and execute

• for Linux:

./mvnw -v

• for Windows cmd:

mvnw -v

Output example:

 Apache Maven 3.6.2 (40f52333136460af0dc0d7232c0dc0bcf0d9e117; 2019-08-27T18:06:16+03:00)

Maven home: /home/your_user_name/.m2/wrapper/dists/apache-maven-3.6.2-bin/795eh28tki48bv3l67maojf0ra/apache-maven-3.6.2

Java version: 11.0.2, vendor: Oracle Corporation, runtime: /usr/java/jdk-11.0.2

Default locale: en_US, platform encoding: UTF-8

OS name: "linux", version: "4.20.16-200.fc29.x86_64", arch: "amd64", family: "unix"

7. If maven version, javaHome and java_versionmatches your downloaded java then you are able to build and run wallet! Just choose your OS from the list below and perform specified steps.

Linux/MacOS

• Clone repository using git command git clone or download archive file of source code
• go to source directory
• run mvn install
• go to bin directory and run apl-run-desktop.sh
• application should start in desktop mode
• if you require command line mode -> use apl-run.sh instead of apl-run-desktop.sh

Windows

• Clone repository using git command git clone or download archive file of source code
• go to source directory
• run mvn install
• go to bin directory and run apl-run-desktop.bat
• application should start in desktop mode
• if you require command line mode -> use apl-run.bat instead of apl-run-desktop.bat

Command-line options

apl-exec.jar and all scripts accept command line options. To get list of available options, run with --help switch. Most important options:

 --net, -n index of network to run with. 0 is main net, 1 is 1st public test net with stable release,
2 is 2nd testnet with development/staging code and 3 is 3rd test net with experimental features
--testnet means run with 1st test net. Higher priority then --net switch
--debug, -d from 0 to 4. 0 is ERROR level of logs, 4 is TRACE

Example:

bin/apl-run.sh -d 4 -n 2

This command runs blockchain application with 2nd test net and debug level TRACE

IDE

Project is entirely on Maven v3 and could be loaded in any IDE that supports Maven.

DEX

Generate eth smart contract class.

$ web3j solidity generate --javaTypes -b dex.bin -a dex.abi -o $Path/Apollo/apl-core/src/main/java/com/apollocurrency/aplwallet/apl/eth/contracts/ -p com.apollocurrency.aplwallet.apl.eth.contracts