Meson App
This guide illustrates Meson swap process on desktop devices. Please refer to Swap on Mobile for mobile guide for Meson Swap.
Contents
Prepare Your Wallet
Meson App requires a valid wallet connection in order to perform swap transaction. If you do not have a wallet, refer to the following links to set up your wallet before you proceed.
Swap on Meson App
1. Select origin network
Access Meson App at meson.fi, click the network dropdown menu and select origin FROM network. According to the origin network you select, Meson App will automatically match the rightful wallet for you to connect and proceed.
Good to know: Meson App currently supports these high performance EVM chains:
Ethereum
BNB Chain (formerly BSC)
Polygon
Evmos Mainnet
Arbitrum
Optimism
Aurora (on NEAR)
Conflux eSpace
Avalanche C-chain
Fantom
Tron
Harmony
Moonriver
Moonbeam
2. Connect wallet
Click CONNECT WALLET in the upper right corner to establish a connection to your wallet. If you select Tron as FROM network, you will need to connect to TronLink to proceed; For all other networks, connect to MetaMask to proceed.
Good to know: If you’re swapping from Tron to other networks or the other way around, you’ll need to manually key in the destination wallet address.
Approve Meson App to add network to your wallet
In order to proceed, Meson App requires to add origin network in your wallet. By clicking APPROVE in MetaMask, the network will be added to your wallet automatically.
You may need to manually add the respective network to your MetaMask wallet if you don’t see the network added to your wallet right away.
Refer to below tutorials to add custom networks in MetaMask.
Don’t see your token in MetaMask?
Once you selected corresponding network in MetaMask, Meson App will show the token balance on the screen. You may also check the balance in your MetaMask. If you’re not able to see the token, you may need to add custom token to your MetaMask first in order to view the balance. Please refer to MetaMask official documentation here How to add custom token in MetaMask to add custom tokens to your wallet.
Good to know: You will be asked token contract address when adding tokens to MetaMask. Tokens are minted by a specific smart contract on each chain, therefore address of the contract is unique for any specified token on a chain. To figure out the correct contract address, only refers to the official explorer on each chain.
3. Enter Swap Information
Select the origin FROM network of Cross-chain Swap;
Select the token type that you want to Swap;
Enter the amount of Swap (the exchange on Meson will always remain 1:1);
Select the destination TO network of Cross-chain Swap;
Enter the wallet address that accepts Swap. By default, the wallet address is the same as the FROM address;
After information input and confirmation, click Swap to initiate the swap.
4. Approve your wallet
If you are swapping for the first time, you need to perform the Approve operation to grant the Meson smart contract access to the stablecoins in your wallet. Click the Approve button and sign with your wallet to complete this step.
Gas fee for Approve transaction
Meson utlizes meta-transaction mechanism in our project development. As a result, Meson bears the gas fee incurred on both origin and destination networks instead of the user during every swap.
However user are still required to pay for gas fee for approve transactions. Approve is required for wallet that is connected to Meson to swap for first time, allowing Meson's smart contract to access the funds in user's wallet in order to process swaps. This is a common practice for DeFi projects on the market as well. User will need to have sufficient native token to pay for the gas consumed on the origin network for the approve transaction, whose amount is subject to the origin network and its network conditions. Meson has no control on the gas fee levied on a particular network.
5. Sign your transaction
Meson utilize meta transactions so that it is the Liquidity Providers but not users who pays gas fees. That’s why you will see sign transaction instead of send transactions. You will be asked for two signatures during the swap process.
1st Signature: Request Swap
After confirming the transaction information, click the button to complete the signature through the wallet pop-up window. The first signing represents publishing a Swap request to the Meson network.
The Meson network will have LP to match Swap requests posted by users. In this process, LP will use the user’s signature, invoke the Meson contract for the user, and transfer the corresponding amount of stablecoin into the Meson contract for locking. At the same time, LP will be locked in Swap’s target chain for a specified number of stablecoin.
This process usually lasts 1-2 minutes.
2nd Signature: Release funds to destination
After the primary chain and target chain have locked the Swap amount, the Meson page will pop up a second signing window via your wallet. The second signature can synchronously unlock the funds of the two chains, which means that the user transfers the exchange amount to LP in the initial chain and gets the exchange funds in the target chain. This process usually takes 30 seconds to a minute.
After the Swap is successful, users will find that the number of stable coins in the two wallets involved in the Swap changes, indicating that the Swap is successfully completed.
Check Swap Status and History
Click the wallet button in the upper right corner, and you can see the current Swap and the historical Swap records in the popup page. If Swap needs to do something (such as signing a second time to release funds), it can do so through this page.
Users can also view swap status and history in Meson Explorer. Click here to learn more.
RPC Node
All dApps (decentralized applications) need a way to communicate with blockchains. The RPC Node status bar in the lower left corner of the Meson home page shows the connection status of the RPC Node between Meson and the target blockchain. The number after the dot represents the block number of the target blockchain. Green indicates that the connection is normal, and yellow indicates that the connection is faulty.
URL Parameters
Meson app supports URL paramerters which allows user to directly land on the desired network pair when accessing Meson app. To access Meson using URL parameters, append respective parameter(s) as follows:
https://meson.fi?from={origin_blockchain_name}&to={target_blockchain_name}
where origin_blockchain_name refers to the blockchain name of the origin network, target_blockchain_name refers to name of the target network. Please refer to Meson Developers Doc for the most accurate and updated set of blockchain names supported by Meson.
Looking for Help？
Having trouble with your transactions and looking for Meson support? Please click the question mark in the right lower corner, and contact us in discord #get-assists channel. We are more than happy to offer a one-on-one support to you.
Last updated
