TUTORIAL
How to Use the SCRT BSC Bridge
This tutorial will teach you how to bridge your BEP20 tokens to Secret Network, make them private, and start using Secret’s privacy-preserving dApps!
Here’s what we will cover in this piece:
- What to do before using the BSC bridge
- How to connect your wallets to the Secret BSC Bridge
- How to bridge your tokens from Binance Smart Chain to Secret Network
- How to bridge your tokens from Secret Network to Binance Smart Chain
- Frequently asked questions
GETTING STARTED
What to do before using the BSC bridge
Before porting over your assets, you need to have a few things in place: wallets to store your SCRT and crypto to pay transaction fees (“gas”).
STEP 1
Download a wallet
Before porting over your assets, you need to have a few things in place: wallets to store your SCRT and crypto to pay transaction fees (“gas”).
Get a wallet to store your SCRT, BNB, and Secret Tokens or wrapped SCRT.
We recommend:
- Keplr wallet, the interchain wallet for the Cosmos ecosystem, to hold your SCRT and Secret Tokens. Check out this walkthrough to help you install the app
- Metamask wallet (an open-source browser extension wallet) to hold your BNB and wrapped SCRT
STEP 2
Gather your gas fees
To use the Secret BSC Bridge, you’ll need to pay fees on Binance Smart Chain (BNB) and Secret Network (SCRT). But, don’t worry—these are usually just small amounts.
You can get SCRT via direct pay, CEXs and DEXs on Secret, or as a wrapped ERC-20 version from DEXes on Ethereum. Find all your options here.
STEP 3
Connect your wallets to the Secret BSC Bridge
Here are the steps to take to bridge over your BEP20 tokens to Secret Network, turn them into Secret Tokens, and start trading, investing, and more—all in privacy.
💡 Want to learn more about Secret Tokens and how they work? Check out our Secret Tokens page.
- Go to the Secret Bridge app
- Click on “Connect Keplr” and “Connect Metamask” to allow the app to access your wallet accounts
- Select the address of the account you want to use for your BEP20 tokens and confirm that you give the Bridge app permission to access your account
BRIDGING TO SECRET
How to bridge your assets from Binance Smart Chain to Secret Network
Here are the steps to bridge your BEP20 tokens to Secret Network, turn them into Secret Tokens, and start trading, investing, and more—all with the option to maintain privacy!
💡 Want to learn more about Secret Tokens and how they work? Check out our Secret Tokens page.
STEP 2
Select the funds you want to transfer, the amount, and the destination
- Click on the token dropdown and select the coin or token you’d like to bridge over
- Enter the amount you’d like to transfer
- Fill out the recipient’s wallet address in the “Destination Secret Address” box (click “Use my address” to fill out the wallet address of your connected Keplr account)
STEP 3
Confirm your transaction and wait for your funds to show up in the proper wallet
- Click “Bridge to Secret Network.” Metamask will ask you to confirm the source and destination addresses as well as the number of tokens you want to transfer
- Wait for the bridge to confirm your transaction was successful. If it was, your assets should appear as Secret Tokens in your wallet! (and are now entirely privacy-preserving!)
Is your transaction stuck? A SCRT BSC Bridge transaction should take about 5–15 minutes. You can check whether your transaction came through with the Secret Bridge explorer and the BSCScan.
If the bridge transaction does not complete within 1–2 hours, go to our Discord #🎟open-a-ticket (under “Support”) and open a ticket. Please mention the operation id, transaction hash, and the addresses of the sending and receiving wallet (do NOT post this in the #🌉bridge-support channel!).
STEP 4
Start using your Secret Tokens!
Now that you’ve converted your BEP20 tokens into Secret Tokens, you can use Keplr to send them to other Secret addresses, use Secret apps, and earn more tokens by providing liquidity to DEXs. Explore all the Secret apps you can use on our dApps page.
❓ Can’t see your Secret Tokens? You probably need to create a viewing key! See this article to find out how.
💡 Want to learn more about Secret Finance? Check out our Secret DeFi page.
BRIDGING TO BSC
How to bridge your tokens from Secret Network to Binance Smart Chain
Want to bridge your tokens back to Binance Smart Chain? Here are the steps you have to take to unwrap your Secret Tokens and port them over to Binance.
STEP 1
Head over to the Secret Bridge app
- Navigate to the Secret Bridge app
- Make sure that “Secret Network” is displayed on the left and “Binance Smart Chain” is on the right
STEP 2
Fill out your transaction details
- Click on the token dropdown and select the Secret BEP20 Tokens you’d like to bridge back to the BSC network
- Enter the amount you wish to transfer
- Fill out the wallet address you’d like to transfer your Secret BEP20 tokens to in the “Destination Secret Address” box (click “Use my address” to fill out the wallet address of your connected Metamask account)
STEP 3
Confirm your transaction and wait for your funds to show up
- Click “Bridge to Binance Smart Chain.” You’ll be asked by Keplr to “Confirm” the source and destination addresses and the number of tokens you want to transfer
- Wait for the bridge to confirm your transaction was successful. If so, your assets should show up in your Metamask wallet!
Is your transaction stuck? A SCRT BSC bridge transaction should take about 5–15 minutes. You can check whether your transaction came through with the Secret Bridge explorer and the BSCScan.
If the bridge transaction does not complete within 1–2 hours, go to our Discord #🎟open-a-ticket (under “Support”) and open a ticket. Please mention the operation id, transaction hash, and the addresses of the sending and receiving wallet (do NOT post this in the #🌉bridge-support channel!).
FAQ
What is the Secret BSC Bridge?
The bridge allows users to lock their BNB or BEP20 tokens in a smart contract on BSC and mint secretBNB or secretBEP20 tokens on Secret Network. These “Secret Tokens” are wrapped tokens based on the SNIP-20 standard and feature encrypted input, output, and state by default.
Something happened! Are my funds gone?
No worries—whatever happens, your BSC assets are safely stored in our multisig contract. Your funds are safe as long as you’ve entered a Secret Network address that you control.
However, our legal team requires us to say that the bridge operators will not take any responsibility for direct or indirect damages caused by using this software. Interacting with the Bridge is solely up to the user’s discretion.
How does the multisig bridge work?
The bridge uses a BSC multisig lock / release smart contract.
Unlocking BSC assets sent to the deposit contract is managed by a 3-of-5 multisig transaction on BSC. The contract receives BNB and BEP20 assets from the holder of these tokens. When the required threshold of signatures is passed, the smart contract releases these assets on the BSC blockchain from the bridge operators.
Minting on Secret Network requires the multisig committee to collect valid off-chain signatures and broadcast signed transactions to Secret Network. The difference is due to the implementation of multisig on BSC and Secret Network. However, they are both of equal levels of security. Two Secret Contracts manage each pair of assets (e.g., BNB <-> secretBNB): The first is the swap contract to mint and burn tokens, and the second is the SNIP-20 contract, which manages the token.
For more information on SNIP-20, please refer to the standard documentation.
Who operates the bridge?
The bridge operators are very reputable staking operators: Figment, Staked, B-Harvest, and Citadel.one.
Which tokens are supported?
Currently, the bridge supports BAKE, BCH, USDC, ETH, DOGE, BUNNY, LINK, CAKE, BNB, XVS, XRP, TRX, LINA, ADA, DOT, BUSD, LTC, SEFI, USDT, FINE, and SIENNA. Please fill out this form if you’d like to see support for other tokens.
What are the risks involved with SCRT BSC Bridge?
Smart contract risk
The multisig contract on Ethereum is an updated version of Gnosis MultiSigWallet, one of the most well-known and trusted multisig contracts used on Ethereum. The code itself is very simple, meaning that the contract’s attack surface is minimal and provides a high degree of trust that locked funds are secure.
Multisig-bridge risk
If the majority of the bridge operators, which are regulated and well-respected entities in the space, decide to collude, users are at risk of losing their funds. Similarly, suppose the professional validator service providers go offline. Users cannot move their funds before three of the five operators are online. We have chosen professional entities to minimize risk; requiring only 3-of-5 means occasional outages will not compromise service availability.
Why do I have to unlock Secret Tokens? What is a Viewing Key?
Tokens on the Secret Network, based on the SNIP-20 standard, are privacy tokens. Transactions and balances are encrypted. Even your wallet software can’t know your balance without express permission. Using this process is how you unlock a token.
Viewing keys are a tool that gives your wallet or site wallet viewing permissions. The viewing key is a string of data stored by the SNIP-20 contract and is used to grant access to read-only queries. The Keplr wallet has built-in support for these viewing keys, and you can create them using the native interface. In addition, it is important to know that each token requires a separate viewing key.
How can I get help?
Report any issues in the #🌉bridge-support channel on the Secret Network Discord server with the following relevant information:
-
Transaction id, e.g., 7fa14f19–219f8220–1f209e61–8911e539. Every bridge operation is associated with a unique transaction id that’s available in your web page URL. If you didn’t store the transaction id, that’s okay; skip ahead to steps 2 or 3 below.
-
Transaction hashes on BSC or Secret Network. You can find this information under the Transactions tab.
-
BNB or Secret account address you used for the bridge.
Please allow 24–48 hours for your issue to be resolved. Happy bridging!
What does it mean if Secret support tells you a stuck transaction has to be pushed again?
The pending, unsigned transfers are managed via a closed database. In that database, we can retry unprocessed swaps. So when a user has a problem, the database is checked for consistency, ensuring the funds are not released so that retrying your swap won’t cause a double-mint, also known as the duplication of coins.
The process fails in the first place when various network issues mess with the consensus process and cause transactions to get left behind.