Skip to content

QF Token Migration Guide

This guide walks you through the complete migration flow using the QF Network Tokens Migration app on Ethereum and the Claim Tokens app on the QF Network. By following this guide, you will be able to convert your ERC-20 QF on Ethereum into QF tokens on the QF Network.


Open the QF Network Tokens Migration app at https://migrate-tokens.qfnetwork.xyz/ and connect your MetaMask wallet.

If MetaMask is not installed, you will see a warning - please install the extension first.

Migration step 1

When MetaMask is available and connected, your address is shown.

Migration step 2

You can choose the account you need in MetaMask.

Migration step 3

When you switch accounts in MetaMask, the app updates automatically.

Migration step 4

After connecting your wallet, the app checks your token balance and deposit status. If deposit is available for this Ethereum address, you can enter the amount to migrate.

⚠️ Please note: each Ethereum account can submit only one migration transaction. ⚠️ Deposit all tokens you want to migrate in a single transaction.

Migration step 7

Use MAX to auto-fill your full current token balance.


Approve ERC-20 QF token spending to the migration smart contract.

Migration step 8


Confirm the deposit to migration smart contract in MetaMask.

Migration step 9


Once the transaction is confirmed, you will see a success state, transaction details, and a portal link.

After a successful deposit, this Ethereum address is treated as already deposited and cannot be used for another migration transaction.

Click the portal.qfnetwork.xyz link. You will be redirected to the QF Portal claims page.

Migration step 10


6) Set up a wallet and create a QF Mainnet account

Section titled “6) Set up a wallet and create a QF Mainnet account”

Before continuing, you need a QF Mainnet account in a browser wallet extension.

We recommend FOSS Talisman extension - Download. Get started.

  1. Install the wallet extension in your browser.
  2. Create a new account or import an existing one (seed phrase / JSON).
  3. Make sure the account appears in your accounts list - you will select it in the next step (Select the QF Mainnet account).

After a successful step 5, click the “Get your QF Network mainnet tokens” link and you will be redirected to the correct page, or open portal.qfnetwork.xyz directly.

  1. As soon as you land on the portal, select the network by clicking the highlighted area.

    Migration step 17
  2. Expand the Main Networks section.

    Migration step 18
  3. Select QF Mainnet and click Switch.

    Migration step 19
  4. Then, open Accounts -> Claim Tokens.

Migration step 16

Select the QF Mainnet account where you want to receive the migrated tokens, then click Continue.

Migration step 11

Next, enter the Ethereum address from which you deposited in the QF Network Tokens Migration app, then click Continue.

Migration step 12

  1. Click the gray field, and it will be copied.

    Migration step 13
  2. Open MyCrypto and go to the Sign Message section. Unlock the same Ethereum account you used for the deposit, paste the copied claim message, and click Sign Message.

    Migration step 20
  3. Copy the generated JSON signature and paste it into the field below.

    Migration step 14
  4. Once the signature is accepted, the portal will show that your Ethereum account has a valid claim and the amount available for claiming. Click Claim to continue.

    Migration step 22
  5. After a successful claim, the migrated tokens will be credited to your selected QF Mainnet account.

  6. If, after clicking Claim, you see a message stating that your Ethereum address does not have a valid claim, it means the claim record on QF Mainnet has not been created yet or the message was signed with the wrong Ethereum account. Please wait and try again later - after the Ethereum deposit, this may take from a few minutes up to 24 hours.

    Migration step 15

11) Verify the claimed tokens on your account

Section titled “11) Verify the claimed tokens on your account”

If the claim is successful, the migrated tokens will be credited to the QF Mainnet account you selected earlier. You can verify this in the portal by checking the selected account and its current free balance.

Migration step 21

In the example below, the selected QF Mainnet account already contains the claimed QF tokens.