ViteBridge 0.1 Testnet Tutorial

Joel Yang
Vite Labs
Published in
5 min readDec 3, 2021

Summary

ViteBridge 0.1 has been deployed on the Testnet, and it currently allows bridging between the Vite chain (“Vite”) and Binance Smart Chain (“BSC”).

The following tutorial will show you how to move tokens between the Vite chain and BSC via ViteBridge. Note that both the Vite chain and BSC used here will be Testnets. You will be using the Vite web wallet.

The tutorial consists of three parts: Setting up wallets, getting test tokens, and making transfers.

(You won’t need to set up test wallets and get test tokens once ViteBridge gets deployed on Mainnet in the future)

Setting Up Wallets

You will need to set up a Vite testnet wallet and a BSC testnet wallet.

Create a new wallet account and switch to the test node

  • Log out of your current Vite account, and create a new account. If you don’t have a Vite wallet, please download it here.
  • You may be tempted to use an existing Vite wallet for this purpose. However, we strongly advise against it. The best practice is to use a new wallet solely used for testing
  • To add the test node, go to Settings page → Node Settings → VITE Node → Add Custom Node → Add URL: https://buidl.vite.net/gvite and confirm
  • Switch to the test node you just added and you are all set.

Create a Metamask wallet (To access BSC Testnet)

  • Download the Metamask Wallet browser plug-in: https://metamask.io/
  • Create a new Metamask account per instructions on the Metamask plug-in
  • There are many other ways to create a Metamask account. One other way is to obtain the seed phrase on this website again, and import it into Metamask: https://iancoleman.io/bip39/
  • You may be tempted to use an existing BSC wallet for this purpose. In general, it is safe practice to have a new wallet dedicated to testing
  • Enter the following parameters in your Metamask wallet to add BSC-Testnet

BSC-Testnet

RPC URL: https://data-seed-prebsc-1-s1.binance.org:8545/

ChainID: 97

Symbol: BNB

Block Explorer: https://testnet.bscscan.com

  • After you click “Save,” you should have successfully configured the BSC-Testnet wallet. See below.

Getting Test Tokens

You will need VITE (Vite network) and BNB (BSC network). Once again, all of these tokens are Testnet tokens.

Getting VITE (Vite network)

  • Visit Vite Labs’ faucet-testnet channel on Discord: https://discord.gg/vCyBnRFNdg
  • Enter the command: !send VITE_ADDRESS, and obtain your testnet $VITE. Example: !send vite_04d31e740dbca35a0e00db5fb1ef12fb4cedbd1e66e7895774
  • Lock VITE for Quota. The Quota is necessary for facilitating transactions in the current Testnet environment, both for bridging into BSC and for getting USDV (USDV is optional — see bonus section below)
Go to Quota Management Page
Choose “Me” as Quota Recipient Address and Lock 2000 VITE for Quota
  • Disable having to re-enter passwords for each user action
Go to Account Settings Page
Select “Open password-free mode”

Getting BNB (BSC network)

  • You need BNB for gas on the BSC chain when you bridge tokens from BSC to Vite
  • Add VITE (BSC) to be displayed on Metamask
  • Hit “import tokens” and enter VITE’s contract address on BSC: 0x84aeea373ef0acd04f94b15aa36f4475a0ac6457
  • Get your BNB test tokens from this faucet: https://testnet.binance.org/faucet-smart

Bonus section: Getting USDV (Vite network)

This section is a not essential for this tutorial. USDV is a Testnet token created to demonstrate how a user can trade VITE for USDV on ViteX, and then bridge USDV to BSC.

  • Transfer the test VITE to the trading wallet (still https://buidl.vite.net)
  • Purchase USDV with your test VITE on the DEX, using trading pair USDV/VITE
  • Transfer the USDV from the trading wallet to the main wallet (this is because only assets on the main wallet can use ViteBridge)
  • Add USDV (BSC) to be displayed on Metamask
  • Hit “import tokens” and enter USDV’s contract address on BSC: 0xa86f10a4742270466ea9a62c95adfa1273df1faa

Using ViteBridge

Bridging from Vite Testnet to BSC Testnet

  • Visit the ViteBridge page: https://bridge-buidl.vite.net/
  • Select an asset: VITE or USDV (see bonus section above about USDV)
  • Select cross-chain direction: from Vite Testnet to BSC Testnet
  • Key in the total amount. Watch for the maximum and minimum amounts
  • Key in the BSC Testnet recipient address (on your Metamask wallet)
  • Submit transaction
  • Once there is one confirmation on either transaction (one on each chain), you will see a status confirmation window. The window will display confirmation figures on both chains. At this point, your transaction has been signed and there’s no need to re-submit. Closing the webpage won’t affect the transaction.
  • As soon as one confirmation has occurred, the bridging transaction status will appear in a window. When hashes of both chains are visible, that means the bridging transaction has been completed.

Bridging from BSC Testnet to Vite Testnet

  • Visit the ViteBridge page: https://bridge-buidl.vite.net/
  • Select an asset: VITE or USDV (see bonus section above about USDV)
  • Select cross-chain direction: from BSC Testnet to Vite Testnet
  • Connect Metamask
  • Key in the total amount. Watch for the maximum and minimum amounts
  • Key in the Vite Testnet recipient address
  • Submit transaction
  • Confirm via Metamask browser pop-up
  • Once there is one confirmation on either transaction (one on each chain), you will see a status confirmation window. The window will display confirmation figures on both chains. At this point, your transaction has been signed and there’s no need to re-submit. Closing the webpage won’t affect the transaction.

Misc

The following explorers can be used to check ViteBridge transactions:

--

--