robert-gabriel/aion

aion network

Aion

Mainstream adoption of blockchains has been limited because of scalability, privacy, and interoperability challenges. Aion is a multi-tier blockchain network designed to address these challenges.

Core to our hypothesis is the idea that many blockchains will be created to solve unique business challenges within unique industries. As such, the Aion network is designed to support custom blockchain architectures while providing a trustless mechanism for cross-chain interoperability.

The Aion White Papers provides more details regarding our design and project roadmap.

This repository contains the main kernel implementation and releases for the Aion network.

System Requirements

• Ubuntu 16.04 or a later version

Build the Aion network

Please see the details in this wiki page Build your Aion network.

Aion Installation

1. Download the latest Aion kernel release from the releases page.

2. Unarchive the downloaded file by right clicking on it and selecting Extract Here from the drop-down menu. The aion folder will be generated in the current folder.

Alternatively, to extract the file contents, run in a terminal:

tar xvjf aion-{@version}.tar.bz2

3. Navigate to the aion folder and continue by configuring the network:

cd aion

Aion Network Configuration

To receive tokens for mining blocks, you first need to create an account using:

./aion.sh -a create

The mining wiki illustrates how to set this account to be able to receive tokens for mining.

Now you are ready to start the kernel.

Optional:

Your kernel will have access to the seed nodes by default. Do not remove these nodes from the configuration. To include additional peers (e.g. friends that are also connected to the network) or get added by peers, update the config.xml by adding nodes using the permanent peer id (generated as shown below), IP and port of the computers you wish to connect to:

<net>
    <p2p>
        <ip>0.0.0.0</ip>
        <port>30303</port>
    </p2p>
    <nodes>
        <node>p2p://PEER_ID@IP:PORT</node>
    </nodes>
</net>

Note: To allow peers to connect to you, you must also change your configuration IP from 127.0.0.1 to a public IP on your machine. If you are unsure about having a public IP, set it to 0.0.0.0.

To get a permanent peer id create a new configuration:

./aion.sh -c

This newly made configuration will not have access to seed nodes by default. In order to connect to seed nodes, you will need to edit the config.xml file by adding nodes as listed from here:

<nodes>
  <node>p2p://[email protected]:30303</node>
  <node>p2p://[email protected]:30303</node>
  <node>p2p://[email protected]:30303</node>
  <node>p2p://[email protected]:30303</node>
  <node>p2p://[email protected]:30303</node>
</nodes>

You are welcome to add other seed nodes (not solely restricted to what is shown above).

Launch Kernel

In a terminal, from the aion directory, run:

./aion.sh

When the kernel starts up, you should see it trying to sync with the latest block.

Optional: To check which peers you are connected to, open another terminal and run the command below:

netstat -antp | grep java

Please check the owner's manual wiki for further instructions on working with the kernel.

Documentation

Please check the wiki pages for further documentation on mining, using the Web3 API, command line options, etc.

Contact

Aion Forum

Aion Gitter

Aion Reddit

License

Aion is released under the LGPL-V3 license