An essential component of developing on Boson Protocol is to acquire some BOSON testnet tokens on Ethereum which you can bridge over to Polygon’s Mumbai network so you can test your application without having to part with mainnet assets.
The Protocol engineering team has built a convenient faucet which dispenses BOSON on Ethereum’s Goerli network. Boson’s smart contracts are currently deployed to Polygon, so once you have received the tokens from the faucet, you will need to bridge them to Polygon.
This tutorial will walk you through all steps in the process. Note that the screenshots show Metamask, but the process is the same for all browser wallets.
Also note that testnet BOSON has no exchange value!
First, visit the faucet at https://faucet.bosonprotocol.io.
Change the network in your wallet to Goerli, then click ‘Connect’. Select your wallet in the overlay. Remember always to check the url of any site or application before connecting any kind of crypto wallet!
Next, click the ‘Receive a Token’ CTA.
Be aware that you will need to have some Goerli ETH in your wallet in order to pay the gas fees. Once you are happy, hit Confirm in your wallet.
Depending on how busy the network is, you may see the loading spinner for a little while.
Then you will see the confirmation message on the faucet site informing you that the transaction has been mined, and you should see that the BOSON tokens are available in your wallet.
Next, you need to get the BOSON tokens to show up in your wallet (unless you have already added them as a custom option). Click ‘Add BOSON to your wallet’ and confirm.
Your wallet will ask you to confirm displaying BOSON in its assets tab.
You should then see a message on the faucet site confirming that your wallet has been successfully configured to display BOSON.
Next, visit the Polygon Bridge on the Mumbai testnet. Visit https://wallet-dev.polygon.technology/login
Choose your wallet from the options available and sign the transaction in your wallet. It is very important that you check you are connected to the Goerli network and switch to it if you are not already on it. Because the bridge works in either direction, it will not prompt you to switch if you are connected to Mumbai, but remember that you want to send the tokens from Goerli to Mumbai, so you need to be on the network you are sending from.
Choose Polygon Bridge from the list of options displayed on the site.
Select ‘Goerli’ in the ‘From’ dropdown and ‘Mumbai’ in the ‘To’ dropdown menu.
Choose BOSON from the list of tokens displayed in your wallet.
If for some reason BOSON is not shown, enter the Mumbai token address: 0x1f5431e8679630790e8eba3a9b41d1bb4d41aed0 and click ‘Add BOSON’.
Click ‘Continue’ in the pop-up below.
The Transfer Overview popup shows you what you are about to approve. Click ‘Continue’.
Confirm the transfer, including the amount you are transferring.
Click ‘Confirm’ when your wallet asks you for permission to access your BOSON.
You will see the loading spinner as your transaction is processed.
Confirm the deposit on the bridge site.
And now do the same in your wallet.
You will now see the transaction in the bridge interface. Be aware that none of these steps is likely to be instant. Both the confirmation and deposit can take some time and it can take up to 20 minutes before the deposit is finalized.
And the transaction will be confirmed in your wallet.
Congratulations! You now have testnet BOSON on Polygon’s Mumbai network!