We created this topic to provide support to anyone who is migrating their AE tokens to the æternity Mainnet in Phase 1, 2 and 3. Please post all questions you may have here and we will try to get back to you as soon as possible.
We prepared video guides to help you through the process of migration. Access them all in this YouTube playlist.
DO NOT SEND AE TOKENS TO THE MIGRATION CONTRACT DIRECTLY. Read the Q&A below.
CHECK YOUR DATA PAYLOAD before signing the transfer transaction.
- How are Phases 1, 2, 3 different from Phase 0??
Apart from Phase 0, all consecutive phases (the current phase included) will require a protocol upgrade (fork) in order for migrated AE tokens to become available on the Mainnet. All forks are subject to the willingness of miners and users to update their node software in order to follow the updated rules of the æternity network. The æternity Establishment and Foundation will support the forks, but it is up to the miner and user communities to determine if a fork will be successful or not. In addition to recently migrated AE tokens, the scheduled forks will also include protocol improvements which introduce new functionalities, features and optimizations. Here is the predicted AE token migration schedule:
- End of Phase 0 (pre-Mainnet): November 25, 2018 [FINISHED]
- End of Phase 1: February, 2019 [FINISHED]
- End of Phase 2: May, 2019 [RUNNING]
- End of Phase 3: After September 2, 2019 (Ethereum AE tokens become non-transferable)
Users will still be able to migrate their AE tokens after the end of Phase 3 as long as they don’t use a smart contract to manage them. More information to come.
How can I create an æternity account where my migrated AE tokens will be stored in Phase 1, 2 and 3?
There are two secure options to do this. You can either use the Ledger Nano S or AirGap Vault (and AirGap Wallet). To learn how to use the Ledger, you can read this guide or watch this community-prepared video guide. In addition, you can find video guides on migration in this YouTube playlist.
The other option is AirGap Vault (Version 1.6.0 is recommended). It requires Android 4.4 and up or iOS 10.0 or later. Compatible with iPhone, iPad, and iPod touch. AirGap will be integrated in the Base æpp in the future.
- Where should I store my AE in order to be able to migrate them successfully?
The token migration process includes two options - MetaMask or MyEtherWallet. Through MyEtherWallet you can use:
- Ledger (also possible to use with MetaMask)
- Trezor (also possible to use with MetaMask)
- Digital Bitbox
- Keystore / JSON File
- mnemonic phrase / seed
- private key
If your AE tokens are stored in one of the above forms, please select MEW when you reach the step where you need to select the wallet that stores your AE tokens. You can also use a Ledger Nano S with MetaMask.
Also, every other Ethereum Web3 browser and wallet is compatible. Note: the process is only optimized for desktop use.
The most reliable way to complete this task is by using a modern browser with MetaMask extension or MyEtherWallet in combination with a hardware wallet like Ledger Nano S.
- Where can I check if I have migrated my AE tokens successfully?
Go to this web page and enter your æternity account (wallet address).
- What if I currently store my AE tokens on an exchange? Can I still migrate them?
If your AE tokens are on an exchange you can either transfer them to a wallet that you own (such as Ledger, Trezor, or AirGap Vault) or ask your exchange to start supporting Mainnet AE and do the migration for you during the next migration Phase.
To avoid technical complications and delays, it is highly recommended that exchanges migrate any AE tokens before Phase 3 ends (September 2, 2019).
Here is an inexhaustive list of exchanges, including communication channels to get in touch with them, that support ERC20 and Mainnet AE tokens. You can use the provided information to ask them to start supporting Mainnet AE and migrate your tokens for you.
- Do I need to have ETH on the address where my AE tokens are in order to migrate them to the Mainnet?
Yes! You need a small amount of ETH on the same address where your AE is in order to pay for gas fees on the Ethereum network. We recommend having at least 5 USD of ETH there. You can check average gas fees before starting the migration here .
- Are there any other options to create an æternity account apart from Ledger Nano S and AirGap Vault?
You can create an æternity account with the æternity Base æpp (mobile only, for iOS - please use Safari). However, it is HIGHLY recommended to use AirGap Vault or a Ledger hardware wallet for security reasons.
- Do I have to use a second smartphone (that stays offline) to store my Mainnet AE tokens in AirGap Vault?
You can use AirGap Vault with only one phone by installing both the AirGap Vault and the AirGap Wallet on it. However, it is HIGHLY recommended to use two smart phones for security reasons. The second device will store your private keys and should never connect to the internet after AirGap Vault is downloaded on it. The installation and account creation should happen offline.
- When will the migrated AE tokens be tradable on exchanges?
We recommend asking your exchange to support AE token migration!
Here is a list of exchanges that currently support the AE token.
- Are we currently in a period in which both ERC20 AE tokens (on Ethereum) and Mainnet AE tokens exist simultaneously?
Yes. As long as not all AE tokens have been migrated to the Mainnet, both ERC-20 AE tokens and Mainnet AE tokens will exist.
- When will my AE tokens be on the Mainnet?
AE tokens tokens will not migrated immediately, but in phases. The Genesis Block, the first block of the æternity blockchain, will include all tokens migrated by users during Phase 0 (before Mainnet launch). Each of the subsequent three phases, with a timeframe of around 3 months, will end with a scheduled protocol upgrade (fork) of the æternity blockchain. The scheduled hard fork will introduce the migrated tokens in the current Phase to the Mainnet.
The time between the execution and activation of a hard fork on any network varies and depends on different factors. In the case of the Phase 1 fork (Minerva) the protocol upgrade will be first executed on the UAT Testnet (morning, February 21) and its performance will be observed for some time. The æternity core team will observe the performance of the UAT network and test for bugs before considering it good enough to be applied on the Mainnet. Once the fork software is deemed Mainnet-ready, the dev team will publish Release 2.0 (Minerva) in GitHub.
Node operators will have until March 6, 2019 to update their software to version 2.0. This will allow them to remain on the æternity Mainnet after March 6. Once the fork is activated successfully on the Mainnet, AE tokens migrated in the last Phase will become available on the Mainnet.
- What happens if I don’t migrate or forget to migrate?
After migration Phase 3 ends (September 2, 2019) all ERC20 AE tokens will become non-transferable on the Ethereum network. Users or exchanges will not be able to make transactions with them and they will effectively be “burnt”.
However, it will still be possible to receive Mainnet AE tokens, but the process will become more complex and will require that:
- the AE tokens are not managed by a smart contract (multi-signature address on Ethereum, for ex.),
- the user/exchange has access to the private key(s) / seed(s) / passphrase(s) of the ETH address(es) that stores the ERC20 AE tokens.
To avoid technical complications and delays, it is highly recommended to migrate any AE tokens before Phase 3 ends (September 2, 2019).
More information on the process will follow in time.
- What is a scheduled protocol upgrade (fork / hard fork)?
A protocol upgrade that break consensus rules (hard fork) is a permanent divergence from the previous version of the blockchain, and nodes running previous versions will no longer be accepted by the newest version. A hard fork is not backwards compatible. Each of æternity’s scheduled hard forks will migrate tokens and add or expand features of the æternity blockchain that can only be implemented via a hard fork such as the governance system or the new virtual machine.
- What happens if I make AE transfers on the Mainnet in the period between fork execution and fork activation?
Transactions will remain uninterrupted and will not be affected by the fork. If the upgrade is activated successfully (after a specific blockheight is reached), new balances (those migrated in the latest completed migration phase) will become available.
Only nodes which have updated to the latest Release will be able to see the migrated AE tokens.
- What is æternity Mainnet?
The æternity Mainnet is the open, public network where the AE tokens, smart contracts, oracles, state channels, naming system and all other technological features will be available for use. The Mainnet will be improved through scheduled hard forks, which will introduce newly migrated tokens and updated features and increased functionalities.
- What is the Genesis Block?
The Genesis Block is the first block mined on the æternity Mainnet. It will include all AE tokens migrated before Mainnet launch. It will also include the messages created by users during the first Phase of æternity’s original campaign in 2017. The date and time of the Genesis Block is generally considered to be the official launch of any public blockchain platform.
- I am getting this error message in MEW, when using a Ledger wallet: "Invalid status 6a80. Check to make sure contract data is on?"
To fix this, you need to enable “contract data” from the menu in the Ethereum Ledger app (on the device), Once you do that, you need to disconnect and re-connect your Ledger device.
- I am trying to initiate the AE token transfer using MEW. The data field is filled-in, but the amount field displays “0”. Is this a problem?
You don’t have to fill-in the amount field. Leave it as it is - “0”. The amount of tokens that you entered on the token migration web page will be migrated successfully.
- Are wallets generated with v0.25.0 765f9cc epoch via
./bin/epoch keys_gen SOME-PASSWDsafe?
No. Do not use this method for wallet generation.
- I have sent my AE directly to the token contract (0x5CA9a…). Is this a problem?
Yes! This is something you should never do as mentioned by the numerous warnings. AE tokens that go directly to that contract are effectively burned without being associated with an æternity account (wallet).
If you have sent AE tokens to that contract directly from an exchange, it will not be possible to recover them. If you have sent AE tokens from a wallet that you own - a recovery could be possible (we can not guarantee this), but it will require signing a message/transaction with the private key of the address that you sent your AE from (keep that safe!). We will have more information for those of you who sent AE to the contract from a wallet that they own after the end of Phase 3 of AE token migration.
For the time being all AE sent to the AE token contract derectly must be considered lost/irretrievable. Please read the FAQ, watch the video guide(s) and follow the steps on the migration page to transfer your AE successfully! Do NOT assume what the process is.
The AE team