OpenSwap Bridge Tutorial (testnet)

Introduction

This tutorial will walk you through the steps on how to acquire tokens on the different testnet chains to be used for your trial and testing purposes. We appreciate your support during this exciting pre-alpha phase of the highly anticipated OpenSwap CrossChain Bridge as our team prepares for a release candidate for mainnet. Should you encounter any issues or bugs, please report them to us by filling out our issue reporting form below. Our team will review all reports and any issue reported that may lead us to securing the bridge even further may be eligible for rewards!

Key Features

The OpenSwap CrossChain Bridge is powered by a network of bridge trolls (validators) to provide the following:

Single Asset Bridge Vaults on each chain offering impermanent loss free returns to liquidity providers
Users receive native tokens instead of synthetic ones provided by other bridge offerings. You get the token you want without the hassle of figuring out how to convert a synthetic token into the native one.
True any-to-any cross chain swaps from one native token to another.
Enable projects to leverage our network of bridge trolls to manage bridging services for multichain projects.

Prerequisite

a. Add Testnet on MetaMask

The tesnet rollout will support Kovan, BSC Testnet and Avalanche Fuji C-Chain. Before testing on the bridge function, it is recommended to add the network to Metamask first. You may simply go to “https://testnet.openswap.xyz/#/” and click the network button on the top-right corner. Select the network and it will be added to your metamask automatically.

b. Get Native Tokens on Testnet from Faucet

ETH

https://faucets.chain.link/ https://gitter.im/kovan-testnet/faucet

AVAX

https://faucet.avax-test.network/

BNB

https://testnet.binance.org/faucet-smart

We recommend getting some BNB

c. Get Testnet USDT from OSWAP

Native token can be swapped into testnet USDT from our swap page. The Pegged Queue option will allow you to obtain testnet USDT with a small amount of native tokens.

Tutorial

1. Create Swap

You may create a order on “https://testnet.openswap.xyz/#/swap” by selecting the source chain, destination chain, input amount and the desired token on the destination chain.

After clicking “Create Order”, you may review the order details, such as the expected amount out on the destination chain and the transaction fee.

You may click the view record to check the order status.

2. View Record

Click the “Bridge” on the menu bar to access the record page.

Your record will be shown as “Pending” when it is still waiting for verification on our trolls and you could verify the creation transaction on explorer.

After the trolls have confirmed your transaction, the order status would be changed to “Executed” and you can verify it on the explorer to see how many tokens you receive.

3. Cancel Record

Some orders might be rejected by the Bridge Trolls due to different reasons, such as a high price change on the destination chain, or insufficient liquidity in the bridge vault. You May then cancel your order to receive the token back in stablecoins. (It might be slightly less than your original amount as the gas fee is deducted automatically.

You may first click the “Request Cancel” button

Confirm the request and you will see the order status changed to “Cancel Requested”

It will be changed to “Cancel Approved” after the trolls have confirmed it and you can withdraw the tokens from the source chain.

On-chain Verification

a. Creation Transaction

You may verify the order on-chain by the explorer.

The first thing you could notice is that 10 USDT has been sent to our bridge vault contract.

b. Executed Transaction

From the Execution transaction, you may notice that only 8.97 USDT.e is used to trade on the destination chain. It is because the bridge fee is deducted from the input amount 10 USDT. The 8.97 USDT.e is then further used to swap to OSWAP which is 30.09 in the end.

c. Canceled Transaction

From the Cancelation transaction, you may notice that only 1998.999996 USDT is returned to you given that your original amount is 2000 USDT. The difference is caused by the automatic deduction on gas fee when the trolls try to swap tokens on the destination chains.