Android Full Node

From ArdorDocs
Jump to: navigation, search
Other languages:

The Ardor blockchain platform has released a software package to support full forging and validating nodes on devices running Android 8 or higher. The following page provides guidance on how to download, install and utilize this new package.

Please note an Android-specific user-interface has been developed for initializing new nodes on the Ardor network; however, all processes related to account creation and utilizing the broader features of the platform require navigating to the web wallet by clicking "Open Wallet." This Android specific interface is only for managing the forging and/or validating status of your device.

Downloading and installing the Android OS package

Go to https://www.jelurida.com/ardor/downloads and download "Android client". It is a combined Android client, containing both "Full Node" and "Light Client". Open the downloaded APK file. You will be warned that this is an "unknown app":

Android unknown app warning.png

Press "Continue" and then proceed with the installation. On completion you should see the "Ardor Server" launcher like any other app on the device:

Ardor server launcheer.png

Tapping on it opens the Start server screen


Note: if the device features a battery optimizer, the server process will be suspended when the screen is off. To run properly, you need to remove Ardor Server from optimized apps and allow it to run in background.


Jelurida License screen

In the first launch of the application, you will be greeted with the Jelurida Closed Source License screen. Please read it carefully, before agreeing and continuing further.

Before the server is started

  1. Press the 'I agree' button, when you have read the Jelurida Closed Source License text.

Node Configuration screen on first launch

Before the server is started

  1. Options to select between "Full Node" and "Light Client". Available only on the first launch of the application.
  2. Options to select between "MainNet" and "TestNet". Available only on the first launch of the application.
  3. Continue to next menu

Start server screen

Before the server is started

  1. "CONFIGURE" button opens the node Configuration Menu. It is recommended to review the configuration at first start.
  2. "DOWNLOAD BLOCKCHAIN ARCHIVE" is an optional tool for downloading an archive of the blockchain database from a trusted Jelurida source. This button is available only when operating on Full Node, if the server was never previously started or there is no blockchain database loaded. The current database can be stashed or deleted through the Blockchain database section in configuration.
  3. "START" starts the Ardor server.

Main control screen

After the server is started

  1. "OPEN WALLET" opens the Ardor user interface in your browser.
  2. "FORGING" opens the Forging utility interface. Available only on Full Node.
  3. "STOP" stops the server.
  4. Server status is shown here
  5. If the server is started over metered data network, a warning text will appear to inform the user, along with a button, giving the user option to enable connections over metered networks.
  6. Latest server log is displayed here. The text box is selectable, so the log can be copied. The log is auto-scrolled if the cursor is at the end of the text.

Configuration menu

Configuration Menu.jpg

Storage

  1. "Ardor Home Directory" allows you to choose the storage device where the database, configuration, logs and other files will be stored.
  2. "Move home directory to another storage device" allows you to move the home directory to another storage device (ex. sd card).

Network

  1. Select the network in which the client will operate - MainNet or TestNet.
  2. "Enable connections over metered network" - configures the node to disable all networking in case the device is currently connected over metered connection.

Blockchain Database (Full Node)

Utilities for managing the blockchain database files. These files are in the home directory (see Storage) and can also be moved/copied with an external file explorer.

  1. "Stash current database". The current database is in the directory <home>/files/nxt_db for MainNet or <home>/files/nxt_test_db for TestNet. With this button, the database will be moved to a special stash folder, so that a new database can be placed as "current".
  2. "Show stash" - lists the previously stashed databases and allows them to be restored as "current" or deleted to save space.

Advanced

  1. "Transform into "Light Client/Full Node" enables to switch the client between "Light Client" and "Full Node".
  2. "Edit configuration" opens an external text editor for editing the nxt.properties file. Full documentation of the properties is available on the Nxt-default_properties_configuration_file page.
  3. "Enable logging to file" - logging to file can be disabled to reduce the number of file system writes and save some space in case the node is going to run for long periods of time.

Forging utility (Full Node)

The forging utility allows the secret phrase(s) of the forging account(s) to be stored in a password-encrypted file in the internal file storage of the Android app. This allows it to be loaded from there on each start instead of manually entered.

Note: For security reasons, it is recommended to use the Ardor Balance Leasing and store the secret phrases of the account to which the balance is leased, and which doesn't contain significant amount of funds.

Save Forging Secrets Screen (Full Node)

This screen opens automatically if the forging utility wasn't used before.

Save forging screen.png

  1. Type a forging account secret phrase or use the barcode scanner button. Tap "Add passphrase" when ready.
  2. The account IDs of the previously entered forging secrets are displayed here with their effective balances. The secrets can be removed with the "X" button.
  3. Type and repeat the configuration password. This is the password with which the file will be encrypted. Do not use your account's secret passphrase - you should create your own unique password. This password must be entered every time forging is started.
  4. Press "Save".

Start Forging Dialog (Full Node)

This dialog appears if there is a file with forging secrets in the internal storage of the app.

Start forging dialog.png

  1. The password which was previously used to encrypt the file with secret phrase(s).
  2. Tap this to decrypt the file and start forging.
  3. Opens the Save Forging Secrets Screen in order to create a new encrypted file with forging secrets.