This repository contains the main kernel implementation and releases for the Aion network.
( Full opensource publish is module based and will be available after open public testnet.) Current opensource modules:
- modP2p
- Ubuntu 16.04 or a later version
-
Download the latest Aion kernel release from the releases page.
For the Test-Net Beta group users, the binaries will be provided though a link after sign-up.
-
Unarchive the downloaded file by right clicking on it and selecting
Extract Here
from the drop-down menu. Theaion
folder will be generated in the current folder.
Alternatively, to extract the file contents, run in a terminal:
tar xvjf aion-{@version}.tar.bz2
- Navigate to the
aion
folder and continue by configuring the network:
cd aion
If you are using aion-v0.1.8 or if you want a permanent id (used by peers), to connect to the Aion test network you need to first modify your configuration file to have a new personalized id.
- Download the ID generation script generateId.sh here.
- Add executable permissions to the script.
chmod +x generateId.sh
- Run the script.
./generateId.sh
- Copy the output.
Navigate to the
config.xml
file in[aion_folder]/config/config.xml
:cd config gedit config.xml
Update the value between the id tags to the copied ID.
<id>my-new-id-value-is-set-here-12345678</id>
Versions aion-v0.1.9 and later do not require generating an id. A temporary unique id will be assigned to your kernel at runtime.
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), update the config.xml
by adding nodes using the permanent peer id (generated as shown above), 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.
In a terminal, from the aion directory, run:
./aion.sh
Optional: To check which peers you are connected to, open another terminal and run the command below:
netstat -antp | grep java
Please check the wiki pages for further documentation on mining, using the Web3 API, command line options, etc.