Android Full Node

From ArdorDocs
Jump to: navigation, search
This page contains changes which are not marked for translation.

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 "Full Node for Android". 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.


Start server screen

Before the server is started

  1. The "CONFIGURE" button opens the node Configuration Screen. 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 source. This button is available only if the server was never previously started and there is no blockchain database. 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
  3. "STOP" stops the server.
  4. Server status is shown here
  5. 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 screen

Ardor Android Configuration Screen.png

Storage

  1. "Ardor Home Directory" allows you to choose the storage device where the database, configuration, logs and other files will be stored.
  2. "Copy home directory to clipboard" is a utility for copying the home path to clipboard so that it can be easily pasted in an external file explorer.

Network

  1. Select the network in which the full node 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

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. "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.
  2. "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

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

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

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.