Aion Guides

So you want to be a DApp developer?


Well you've come to the right place. You'll find comprehensive guides and documentation to help you start developing with Aion as quickly as possible, as well as support if you get stuck. Let's jump right in!

Let's DApp

Aion Desktop Wallet

Install the Wallet

The Aion Desktop Wallet is a local application that is stored and ran from your local machine. It is not a cloud application.

Linux Icon
Mac Icon
Windows Icon

Upgrading from a Previous Version

If you are upgrading to the latest Aion Desktop Wallet from a previous version, make sure to follow the steps outlined in the Upgrading the Wallet guide.

Linux

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

  1. Download the aion_ui.zip file from the Aion Wallet Repository
  2. Extract the folder to the desired directory and open a terminal.
Unzip the Package

Unzip the Package

  1. Run the .sh file to start the wallet:
./aion_ui.sh
Run the Aion App

Run the Aion App

The Aion Desktop Wallet is now open on your desktop. In order to run the application again, call the aion_ui.sh script from a terminal.

Aion Wallet in Ubuntu

Aion Wallet in Ubuntu


Mac

  1. Download the AionWallet.dmg application image from the Aion Wallet repository.
  2. Open the .dmg file and AionWallet.app into your applications folder.
Opening the Aion Wallet DMG file

Opening the Aion Wallet DMG file

  1. Go to your Applications folder, right click on AionWallet.app, and select Open.
  2. Click Open on the security window if one pops up.
  3. You can now open the wallet through the Applications folder.

Windows

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

  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 the .exe on your computer. Accept any security warnings that pop up.
  1. Follow through the installation and restart your computer.
  2. You can now open the wallet through the Applications folder.

Update the Wallet

A new update for the Aion Desktop Wallet is available. In order to keep your AION safe, follow this procedure when updating.

Linux

Since the Linux package runs from wherever you download it to, it is possible to have two version of the Aion Desktop Wallet available on your computer. If you want to avoid this, delete your current installation of the Aion Desktop Wallet before following these steps.

  1. First off, open a terminal and make a copy of your Aion data:
cp -r ~/.aion ~/.aion-old
  1. Download the latest Aion Desktop Wallet build from Github.
  2. Extract the folder to the desired directory and open a terminal.
  3. Run the .sh file to start the wallet:
./aion_ui.sh
  1. You should be able to see you old accounts. If they are there, feel free to delete the backup you made in step 1.

Mac

  1. First off, open a terminal and make a copy of your Aion data:
cp -r ~/.aion ~/.aion-old
  1. Download the latest Aion Desktop Wallet build from Github.
  2. Open the .dmg file.
  3. Copy the AionWallet.app application into your Applications folder.
  4. Select Replace when asked what you want to do with the current Aion Wallet application.
Replace the Current Application

Replace the Current Application

  1. Run your Aion Wallet from the Applications folder.
  2. You should be able to see you old accounts. If they are there, feel free to delete the backup you made in step 1.

Windows

  1. First off, make a copy of your .aion folder. It should be in your home directory (C:/Users/USERNAME/).
  2. Download the latest Aion Desktop Wallet build from Github.
  3. Open the .exe file.
  4. The application will install.
  5. You should be able to see you old accounts. If they are there, feel free to delete the backup you made in step 1.

Open the Wallet

The method for opening the Aion Desktop Wallet differs depending on which operating system you are using.

Linux

You need to run the aion_ui.sh file to open the wallet. You may want to add this command to your .bashrc file to make it easier to open in the future.

echo  'alias aion-wallet=~/aion_ui/aion_ui.sh' >> ~/.bashrc

This above command will allow you to open the Aion Desktop Wallet by running aion from a terminal, provided that you unpacked the aion_ui.zip to your home ~ directory.

Mac and Windows

On Mac and Windows, you can open your wallet simply by clicking on the AionWallet application.

Opening the Wallet on Mac

Opening the Wallet on Mac

Create a New Account

You can create a completely brand new account within the blockchain, or recover an account into this wallet using your Mnemonic and Password.

To create a completely brand new account:

  1. Click Add account.
  2. Create an Account name. This can be changed later if you want.
  3. Enter a strong Password.
  4. Confirm your Password.
  5. Save and backup the seed mnemonic that is shown. You will need this if you wish to recover your wallet later.

To recover a previously used account that is somewhere in the blockchain:

  1. Click Add account.
  2. Under Recover from seed, enter the Mnemonic and Password associated with your account.
  3. The recovered account is now shown under the Accounts tab.

Multiple Accounts

Once an account has been created or recovered, you can quickly add further accounts by clicking Add account. You do not have to enter a password or record another mnemonic, as all accounts are held within the one wallet.

Import an Account

There are three options to import an existing account:

There is a Remember Me option when importing accounts. Selecting this will display your imported accounts even if you re-launch your wallet. If this option is not selected, you will have to reimport these accounts if you re-launch the Aion Desktop Wallet.

Keystore File

  1. Click Import account.
  2. Select Keystore file.
  3. Click Keystore UTC File, navigate to your keystore file, and click Open.
  4. Enter the associated Password.
  5. Click Import.
Import a Keystore

Import a Keystore

Importing a Keystore File

Private Key

  1. Click Import account.
  2. Select Private key.
  3. Enter your Private key and Password combination.
  4. Click Import.

Ledger

  1. Click Import account.
  2. Select Ledger.
  3. Click Connect to Ledger.
Import a Ledger Account

Import a Ledger Account

Importing a Ledger Account

Export an Account

You may wish to save your accounts created on the Aion Wallet elsewhere. In this case, you will need to export the wallet (using the icon right of the accounts listing) and save the keystore file in your desired location. The password you input here will be the new password to access the keystore file:

  1. Go to Accounts.
  2. Click the Export button on the account you wish to export.
  3. Click Keystore File Destination.
  4. Navigate to where you want to save the file to, and click Open.
  5. Enter a Password for this file.
  6. Click OK.
Export an Account

Export an Account

Manage your Aion

There are several ways you can interact and manage your AION tokens.

Send AION

You have the option to transact AION and send it to another wallet. The receiving wallet must accept native AION coins.

  1. Click the Lock icon to unlock the account you wish to send AION coin from.
  2. Go to the Send tab.
  3. Under New transaction input the Address you are sending AION coin to.
  4. Enter the Amount to send in AION coin. Your Account balance must be higher than value in the Amount to send field. Keep in mind that every transaction comes with an Energy payment. If you want to send the entire contents of an account to another account click Send all. The Aion Desktop Wallet will calculate how much Energy you need, and deduct it from your total.
  5. Click on Generate transaction to send the AION.
Sending Tokens from One Account to Another

Sending Tokens from One Account to Another

Sending Transactions Using a Ledger

When you send an Aion transaction using a Ledger, you need to accept the transaction on the Ledger itself.

Accept transaction on Ledger

Accept transaction on Ledger

Handling Errors

Sometimes things get hung-up when sending a transaction, so the wallet tries to display helpful error messages when possible.

Sending transaction...

If this message shows for more than a few seconds, make sure that your Aion node is fully synced. You transaction will not occur unless it is up to date.

Node not synced error

Node not synced error

You have transactions that require your attention!

This often means that the transaction failed. Click the notification to resubmit the transaction.

Failed to send Error

Failed to send Error

Receive AION

Under the Receive tab of the desktop wallet, you can send your public wallet address by:

  • Scanning the QR code to display the wallet address.
  • Sharing your Account address.

Sync to a Remote Node

If you are not running a local Aion node, you will need to specify the remote node you wish to connect to under the Settings tab.

  1. Open the Aion Desktop Wallet and go to the Settings tab.
  2. Under the Connection drop-down, select Add connection.
  3. Enter the Connection name, URL, Port, and Access key for your remote node.
  4. The Account lock timeout is the length of time the Aion Desktop Wallet will wait while inactive before disconnecting.

Validate your Download

In order to validate that your download and lower your chances of being caught in a man-in-the-middle attack, follow the instructions for your operating system.

Linux

In the directory when your aion_ui.zip file is, download the .sha1 file from the releases Github page. Then run the following in a terminal window:

sha1sum -c aion_ui.zip.sha1

If the output is aion_ui.zip: OK then the file successfully passed the check and is genuine.

macOS

In the directory when your AionWallet.dmg file is, download the .sha1 file from the releases Github page. Then run the following in a terminal window:

sha1sum -c AionWallet.dmg

If the output is AionWallet.dmg: OK then the file successfully passed the check and is genuine.

Windows

Since Windows does not come with a built in hash checking system, you need to install an application called Microsoft File Checksum Integrity Verifier. This tool is not officially sported by Microsoft or Aion.

Additional Wallet Configuration

Connect with a Remote Node

If you wish to sync your wallet to an Aion node that is not running on your local machine, you may do so after making two changes in:

Configure Aion Kernel

You will first have to ensure that the config.xml file found in the aion/config folder of your aion kernel repository is modified such that the Java API accepts remote access. This will allow your wallet to connect with the node.

  1. Navigate to the aion/config/config.xml file.
  2. Change the IP address of the Java API section to 0.0.0.0.
  3. Save the config file and re-launch the kernel and wallet for changes to take effect.
{
  "codes": [
    {
      "code": "<java active=\"true\" ip=\"0.0.0.0\" port=\"8547\">",
      "language": "xml"
    }
  ]
}

Configure Wallet

After configuring the node you wish to connect to, you will need to change wallet settings so the IP address points to the machine running it.

  1. Launch the Aion Desktop Wallet and go to the Settings tab.
  2. Change the Connection tab to Add connection.
  3. Select a name for the connection, and input the URL, Port number, and access key.
  4. Click Save to create the new connection, then Apply to make the changes.
Desktop Wallet Settings Tab

Desktop Wallet Settings Tab

Delete or Switch Wallet

If you wish to no longer use the wallet stored on your machine, or switch to another one, you have the option to delete the current wallet database and restart a fresh wallet (or restore an existing Aion wallet from its seed mnemonic).

Keep in mind that deleting your wallet database is permanent. You will not be able to recover the accounts unless you have the mnemonic and password backed up.

Linux / Mac

  1. Open a terminal.
  2. Remove the hidden folder .aion:
rm -rf ~/.aion
  1. Relaunch the Aion Desktop Wallet. You can now click on Add an Account.

Windows

  1. Go to C:/Users/YOUR_USERNAME.
  2. Turn on Show hidden files and folders.
  3. Delete .aion.
  4. Relaunch the Aion Desktop Wallet. You can now click on Add an Account.

Recover from Seed

Follow these steps to recover your account using your seedphrase or passphrase.

  1. Click Add account.
  2. Under Recover from seed, enter the Mnemonic associated with your account.
  3. Enter a new password. This does not have to be the same as your old password.
  4. Click Recover.
  5. The recovered account is now shown under the Accounts tab.

Troubleshooting

I've Forgotten My Password

If you forget the password to your Aion wallet, follow these steps to attempt to recover your wallet. You need to have your mnemonic / seed phrase ready. If you do not have access to your mnemonic / seed phrase, or can't remember it, then unfortunately you cannot recover you wallet.

These instructions differ slightly between Mac/Linux and Windows.

Linux and Mac

  1. Open a terminal window.
  2. Run mv ~/.aion ~/.aion-old.
  3. Open the Aion wallet application.
  4. Click Add account.
  5. Under Recover from seed, enter your Mnemonic.
  6. Enter a new Password.
  7. Click Recover.
  8. If your account is now listed on the Accounts page, run the following command to delete your old wallet information: rm ~/.aion-old.

Windows

  1. Go to your Documents folder.
  2. Turn on Show hidden files and folders.
  3. Rename .aion to .aion-old.
  4. Open the Aion wallet application.
  5. Click Add account.
  6. Under Recover from seed, enter your Mnemonic.
  7. Enter a new Password.
  8. Click Recover.
  9. If your account is now listed on the Accounts page, go back to your Documents folder and delete the .aion-old folder.

Obtaining Logs

If our support team have requested logs off you, follow the process for the operating system to retrieve them.

Linux / macOS

The log file is stored at ~/.aion/logs. You can copy the contents of the folder to your Desktop by running cp -r ~/.aion/logs ~/Desktop. You may need to run this command as sudo. The log file is now on your Desktop.

You can now email this file to [email protected] when requested.

Running the copy command and then viewing the contents of a file in a terminal.

Running the copy command and then viewing the contents of a file in a terminal.

Windows

To view the Aion Desktop Wallet logs in Windows, navigate to c:\Users\YOUR_USERNAME\.aion\log replacing YOUR_USERNAME with your Windows username. In this example, my username is John so the address to my logs is C:\Users\John\.aion\log.

Finding the Aion Desktop Wallet logs in Windows 10.

Finding the Aion Desktop Wallet logs in Windows 10.

Viewing hidden files and folders in Windows 10. Copyright [Microsoft](https://support.microsoft.com/en-ca/help/4028316/windows-view-hidden-files-and-folders-in-windows-10)

Viewing hidden files and folders in Windows 10. Copyright Microsoft

You can now email this file to [email protected] when requested.

Problems with Ledger

If you're having problems connecting your Ledger wallet to your Aion wallet, take a look at the troubleshooting steps below.

  1. Make sure that the Aion app is installed on your Ledger wallet. Ledger have posted a guide on how to install the Aion app.
  2. You need to have the Aion app open on your Ledger wallet when you connect. Open the Aion app on the Ledger and then try to connect.
  3. Make sure that the contract data is set to on within the Aion app on your Ledger.

If you're still having issues after following these steps, please reach out to us at [email protected] or through any of our community groups. We have encountered a decent amount of issues with Ledger in the latest Aion Desktop Wallet build, are we're currently trying to find a solution.

Windows and Antivirus Software

Due to the nature and fast release of the Aion Desktop Wallet, the .exe is not signed. This can cause certain installations of Windows and / or antivirus software such as McAfee and AVG to flag the wallet as malicious.

You may also encounter the following error: CreateProcess failed code: 1450 insufficient system resources exist to complete the requested service.

We recommend validating your download, and then adding exception in your antivirus software for the Aion Desktop Wallet. The exception can be made temporarily until you have completed the swap process.

Aion Desktop Wallet


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.