Aion Docs

Aion Docs landing page

Welcome to the Aion community! This page is structured for you - whether you want to start mining, building dapps, or simply learn more about Aion. As a contributor to the network, you'll be helping us rebuild the internet, decentralized.

Get Started    

Swap Overview

The token swap is now ending. We are in the token swap recovery period.

The Token Swap has now Ended

The token swap has ended and we are now in the recovery period. The Changelly exchange will be available until 21st December 2018. All other exchanges are now unavailable. Swapping tokens via the Aion Token Swap Bridge is no longer available.


The Token Swap has ended. We are now in the recovery period. Given the nature of decentralized technology, it is imperative you exercise extreme caution when transacting with cryptocurrency. You, and only you, have custody over your tokens and coins, so it is critical you securely store your private keys. We recommended that you perform a test transaction of a small amount to verify that you are using the correct address and have access to your account.

Changelly is the only supported method to perform an Aion token swap.

Changelly is the only supported method to perform an Aion token swap.


If you encounter any issues during your swap process not covered in this guide, please reach out on any of our official channels below or

Aion Forum

We're here if you need us!

If you encounter any issues during your swap process not covered in this guide, please reach out on any of our official channels below or

Aion Forum

Install the Desktop Wallet

At this time the Aion Desktop wallet and Coinomi are the only supported wallets for receiving your AION coins. Ledger is also available. This guide walks you through using the Aion Desktop Wallet only.

Select Your Operating System

Linux / Ubuntu

Linux / Ubuntu Installation

Mac Installation

Windows Installation


Although it is possible to install the Aion Desktop Wallet on any Linux distribution, only Ubuntu is officially supported.

Updating from Version 1.0

To properly install the new Desktop Wallet release make sure that you have exported your keystore or written down your seed phrase. Once you have confirmed, execute the following command to remove release 1.0:

rm -rf ~/.aion

You can now install the latest version:

Standard Installation

  1. Download the file from the Aion Wallet Repository.
  2. Extract the folder to your root ~ directory.
  3. Open a terminal and run: ~/aion_ui/
  4. The Aion Desktop Wallet is now open on your desktop. Run the above command again if you want to re-open the wallet.

One-line Installation

What's Next?

Setup Your Wallet


  1. Download the AionWallet.dmg application image from the Aion Wallet Github repository.
  2. Extract and open the installer. A window containing should appear.
  3. Drag and drop into the Applications folder.

Installing the Aion Wallet

  1. You can now search for AionWallet using the normal tools (command + space and typing AionWallet) or by navigating to the Applications folder and double-clicking on AionWallet.

Encountering a Warning

You may encounter a warning that you cannot run the application. If this happens:

  1. Open Applications > System Preferences > Privacy & Settings.
  2. At the lower half of the window, you will see a request for the AionWallet App to run on your Mac.
  3. Select to Open Now, and if prompted again confirm your choice by pressing Open again.

What's Next?

Setup Your Wallet


The Aion Desktop Wallet is compatiable with Windows 7 and above.

  1. If you don't already have it, download and install the latest stable Java release.
  2. Download the AionWalletSetup.exe executable from the Aion Wallet repository.
  3. Run AionWalletSetup.exe on your computer. Accept any security warnings that pop up.
  4. Follow through the installation and restart your computer.
  5. You can now open the wallet through the Start Menu.

Unsigned Executables

The AionWalletSetup.exe currently isn't signed, which means you may run into some security warnings during the installation process. Just click OK through these warnings. We are in the processes of getting all the Aion executable signed and recognized by Microsoft.

What's Next?

Setup Your Wallet

Setup Your Wallet

This tutorial assumes that you want to create a new account within your wallet. If you already have an account setup in your wallet but you have forgotten your password, you can recover it by following the I've Forgotten My Password guide.

The Aion Desktop Wallet

Create an Account

  1. Open the Wallet.
  2. Click Add account.
  3. Enter an account name (this can be edited later).
  4. Enter a password.
  5. Confirm chosen password.
  6. Save and backup the seed mnemonic that appears. Please write down the mnemonic phrase on paper and store in a secure location. This phrase can be used to access your account without any additional passwords or verification. Handle with care!

Aion Wallet Showing an Account Mnemonic

Your Public Address

In the wallet there is a field called Public address. This is your Aion wallet address, and can be used to receive your AION coins in the token swap.

Aion Wallet with a Public Address

For additional information on using your Aion Desktop Wallet refer to the Aion Wallet user guide.

Congrats! You now have an Aion wallet address to use for the Aion Token Swap

Currently Supported Exchanges

Changelly is the only exchange available to do the token swap. Changelly will remain available until 21st December 2018. After that date you will not be able to perform the token swap.


For an up-to-date and detailed breakdown of Changelly's swap process please refer to their guide.

Check Aion Wallet

Once your transfer is complete, you can check your Aion coin balance using the Aion Desktop Wallet or Coinomi. Keep in mind that this whole process may take up to an hour to show up. We highly suggest attempting the swap using a small amount of AION before swapping your entire supply at once.

Congratulations! You have now completed the Aion Token Swap, and are now holding native AION coins. :+1+: