Quick Start: Bridging Assets

This guide helps users quickly move GAS or any NEP-11 tokens from Neo N3 to Neo X, or vice versa, using the Neo X bridge.

We will walk you through the entire process, explaining each step in depth. If you get stuck at any point, feel free to reach out to us on Discord for assistance.

Prerequisites

  1. To get started quickly, you need to have:

    • A web3 wallet installed, such as Neoline or Metamask. If you don't have one, visit the link to download.

    • Some GAS on Neo N3. There are several ways to acquire GAS :

      • Use a supported centralized exchange like Binance or OKX, which allows you to buy GAS and withdraw it to your wallet. Most major centralized exchanges support direct withdrawal from your centralized exchange wallet to Neo N3

      • Request funds from a faucet for Testnet N3T5, if you are using a testnet

  2. Access the appropriate URL based on the network you are connecting to. These will be referenced in the following steps.

Depositing GAS (from Neo N3 to Neo X)

Step 1: Add the Neo X network to your Metamask

You'll also need to add the Neo X's RPC endpoint to your wallet. Here we provide two ways for doing this using MetaMask.

  • (Recommended) Click the button on the bottom-left of Neo X's Explorer to automatically add Neo X to MetaMask

  • On your browser, click on the MetaMask extension.

    1. Click the network selector drop-down on the top-left corner, and then click Add Network.

    2. Click Add a network manually and then provide the information corresponding to the chain you want to send your assets to.

The information about Neo X is listed as below:

Step 2: Initiate the deposit

  1. Go to the Neo X Bridge page.

  2. Log in to the bridge with your wallet. Check that you're connected to Neo N3 and Neo X on the page for asset deposits.

    Note: Neo X currently only supports the bridging of GAS .

  3. Enter the amount of GAS you want to bridge over in the From box and then press Deposit. Follow the prompts on your Neo N3 wallet. You can also click MAX to deposit all GAS to Neo X.

    ENSURE SUFFICIENT GAS BALANCE It is important to have enough GAS in your wallet to complete the transaction, or else the web3 wallet will not pop-up. When you click MAX, GAS for transaction fee will be remained.

It usually takes around 1-2 minutes (varying based on the chain congestion) for funds to transfer to Neo X after submitting the transaction from your Neo N3 wallet.

Withdrawing GAS (from Neo X to Neo N3)

  1. Log in to the Neo X Bridge page with your wallet. Check that you are connected to the source network (e.g., Neo X) and the destination network (e.g., Neo N3) shown at the top of the page.

  2. Enter the amount of GAS you want to bridge over in the From box and then press Withdraw. Follow the prompts on your web3 wallet.

    ENSURE SUFFICIENT GAS BALANCE It is important to have enough GAS in your wallet to complete the transaction, or else the web3 wallet will not pop-up.

It usually takes around 1-2 minutes (varying based on the chain congestion) for funds to transfer to Neo N3 after submitting the transaction from your Metamask.

Last updated