Aion

Advanced

How to run a Node on Aion Network?

Node Set-Up

The first step to mining or building on Aion is to run your own node (unless you will be connecting with a node virtually). This will allow you to sync and interact with the main Aion blockchain.

Aion Node

The steps below will take you through a basic set-up, account creation, and sync on the Aion mainnet. You can also configure your node to:

• run on the Aion Mastery Testnet (for development purposes)

• run a local, private blockchain

• debug and display additional kernel information

Get the Aion Node

Start by downloading the most recent Aion binary file aion-{version}.tar.bz2 here.

Once you have the binary file, you will need to unarchive the contents in your chosen destination using one of two methods:

• right click the binary file and select “Extract Here”

• or open a terminal in the same directory and run:

tar xvjf aion-{version}.tar.bz2

A folder named aion will be created in the chosen directory.

Create an Account

Account addresses are required for mining and sending transactions. An address is a hashed representation of your publicKey, prefixed with an identifier “0xa0”.

• Go to aion directory

• Open a terminal and run:

./aion.sh -a create

• Input your chosen password once prompted (note that your password will not appear on terminal as you are typing it)
• Copy and save the created account address shown

After account creation, an associated keystore file is generated and placed in the aion/keystore directory. Each keystore file name contains the account address and the file can be referred to in case of lost address.

Launch Node

Begin syncing your node with the Aion network.

• Navigate to the aion directory

• Open a terminal and run:

./aion.sh

Mastery Testnet

This testnet environment was released with the latest v0.3.0 Moldoveanu Peak mainnet. You may wish to to configure your Aion node here to deploy and test out smart contracts.

Suggest Edits

This is the guide for the Aion Mastery testnet.

If you don’t have an existing testnet you wish to migrate, you can:

• Download Mastery here

• Extract the files and navigate into the aion directory

• Launch the testnet kernel by running:

This will begin syncing your node from genesis. Note that any changes made to config.xml requires you to re-deploy the node.

Reset Configuration Settings

If your configuration settings are broken, or if you just want to start with a fresh configuration file with the default settings, you can reset the file:

• Remove the config.xml file

• In terminal, execute

./aion.sh -c

This will create a new config.xml file with the default config settings. Alternatively, you can copy and paste the contents of this file.

Make sure you have the seed nodes from the above linked file in your config.xml file before starting the kernel.

Local Blockchain Network

You may wish to run your own private Aion blockchain to build and test your dApp.

{
  "alloc": {
    "0x------------------your-account-address--------------------------": {
      "balance": "314159000000000000000000"
    },
    "0xa0353561f8b6b5a8b56d535647a4ddd7278e80c2494e3314d1f0605470f56925": {
      "balance": "314159000000000000000000"
    },
    "0xa0274c1858ca50576f4d4d18b719787b76bb454c33749172758a620555bf4586": {
      "balance": "314159000000000000000000"
    },
    ...
  },

<log>
        <!--Enable/Disable logback service; if disabled, output will not be logged -->
        <log-file>false</log-file>
        <!--Sets the physical location on disk where log files will be stored.-->
        <log-path>log</log-path>
        <GEN>INFO</GEN>
        <VM>ERROR</VM>
        <SYNC>INFO</SYNC>
        <CONS>INFO</CONS>
        <DB>ERROR</DB>
        <API>INFO</API>
        <P2P>INFO</P2P>
        <TX>INFO</TX>
        <TXPOOL>INFO</TXPOOL>
</log>