DISCLAIMER: All assets traded on Energiswap are tokenized versions of the underlying asset that exist only on the Energi blockchain. The tokens cannot be directly sent to an Exchange. You have to transfer the tokens from the Energi network to the Ethereum network before sending them to an Exchange.
Energi Bridge is a decentralized application (dApp) that connects two blockchains so that users can securely transfer ERC-20 tokens between the two networks. At this time, Energi Bridge connects the Ethereum and Energi blockchains. This connection allows users to move their ERC-20 assets from the Ethereum network to Energi to be traded on Energiswap, and vice versa. The ERC-20 tokens can be also used in other dApps such as Farming, Synthetic Assets, etc.
During bridge transfers, the source tokens are stored and locked in a TokenSafe smart contract on the source network. At the same time, an identical amount of the same token is minted on the destination network. The user gives up their ownership of the token on the source network in exchange for the newly minted tokens, allowing them to use and trade their tokens on the new network.
To access Energi Bridge on testnet, go to https://bridge.test.energi.network.
This guide has detailed instructions on the following topics:
- Install and Set Up MetaMask
- Transfer ERC-20 Tokens from Energi to Ethereum blockchain
- Transfer ERC-20 Tokens from Ethereum to Energi Blockchain
1. Install and Set up MetaMask
You need to install and set up MetaMask to access your account address on the source and destination blockchains. For testing, we are using the Ethereum Rinkeby Test Network. You are required to have the same account address on both blockchains.
If you haven’t already, create the same address on the Energi network on MetaMask using the private key of the address from the Ethereum blockchain.
The following guides will help you set up the testnet network and address on the Energi blockchain.
- Set up MetaMask on Chrome for Energi Testnet
- Set up Crypto Wallets on Brave for Energi Testnet
- Set up MetaMask on Mobile for Energi Testnet
2. Transfer ERC-20 Tokens from Energi to the Ethereum blockchain
Energi Bridge also allows you to transfer native NRG or an ERC-20 token (example: WNRG, ETH) from Energi to the Ethereum blockchain. When you transfer NRG or WNRG, the coins are stored and locked in a TokenSafe smart contract on the Energi blockchain. The same amount of NRGE is then minted and credited to your address on the Ethereum blockchain.
When an ERC-20 token is transferred, it is burned on the Energi blockchain and the same amount is released from the TokenSafe smart contract to your account on the Ethereum blockchain. This operation maintains the total circulating supply across all blockchains.
Add the following Contract Addresses to the Energi Testnet in MetaMask:
Token | Contract Address |
BTC | 0x6eadb8ba9b1054fc7d82b4129ebbeff807852190 |
DAI | 0x3e798553502042088783b83e4b62e22152e8717e |
ETH | 0x01a5534f82ab54e1f37ee585f3049cf8b80f79a4 |
WNRG | 0x184F7b12f29d675f34ff816528ADBfd0E0501Ad4 |
2.1. Request Testnet NRG (tNRG)
You will need to set up the Energi Testnet on MetaMask. You will find guides in the DeFi Help Center on how to set it up.
If you need Testnet NRG (tNRG) on the Energi testnet blockchain, follow the instructions below:
First, go to this link:
https://defi.support.energi.world/
Then, click on the help icon on the bottom right of the screen.
Select the Testnet NRG (tNRG) Request Form and fill out the form with your information.
NOTE: If you do not see the selection, send an email to support@energi.team with the subject “tNRG request to test Energi Bridge”. In the body of the email, send us your test NRG address.
2.2. Open and connect your wallet to the Energi Bridge dApp
- Open https://bridge.test.energi.network
- Click “Connect Wallet” to connect your MetaMask wallet.
-
On MetaMask, select the “Energi Testnet” from the dropdown menu.
-
Enter your password and click “Unlock”.
- On MetaMask, select the account you want to transfer tokens from:
2.3. Click the double arrow to set Energi as the “FROM” blockchain on the left. Energi is now the source blockchain for the transfer.
2.4. From the dropdown, select the ERC-20 token you want to transfer from Energi to the Ethereum blockchain.
Note: In the example below we are using DAI. Use Energiswap to get some DAI.
2.5. Approve the amount of the source token that you want to transfer.
-
Enter the amount of the token that you want to transfer to the Ethereum blockchain.
-
Click “Approve”.
-
The MetaMask approval screen will pop up after a few seconds. “Confirm” the amount to transfer. You cannot change the amount approved for the transfer at this stage.
NOTE: NRG is a native token on the Energi blockchain. There is no approval required to transfer NRG.
2.6. Transfer the tokens
-
Once approved, read the disclaimer and check the box.
-
Click "Transfer <token> to Ethereum Blockchain". In the example below, we selected DAI as the token.
NOTE: The pop-up from MetaMask may take some time to appear. Once it appears, go to the next step.
2.7. Confirm the gas fee for the transaction in MetaMask.
A pop-up window will appear showing the status of the transaction and any other pending transactions.
The following notification will pop up if you have MetaMask notifications enabled.
After the transaction is confirmed on the Energi blockchain, your ERC-20 tokens will be stored and locked in the TokenSafe smart contract. You will not have custody of those tokens on the Energi blockchain after that. The same amount of the token will be issued to your account on the Ethereum blockchain.
On testnet, the minting will occur very quickly. On mainnet, there is a 5000 confirmation waiting period required before the token is issued on the Ethereum blockchain.
Congratulations! You just transferred tokens from Energi to the Ethereum blockchain.
2.8. Check the destination account on the Ethereum Blockchain
2.8.1. On MetaMask select “Rinkeby Test Network”.
2.8.2. Add the token to the wallet.
DAI Token address on Rinkeby: 0x2726Dd5efb3A209a54C512e9562A2045B8F45DBc
2.8.3. You will see the same amount of transferred tokens in your Rinkeby Test Network wallet.
2.8.4. You can also verify the transaction on Rinkeby Etherscan by searching your address.
Select the “Erc20 Token Txns” tab to see the transaction information.
3. Transfer ERC-20 Tokens from Ethereum to Energi Blockchain
Rinkeby is an Ethereum testnet. To transfer any ERC-20 tokens from the Ethereum Rinkeby Test Network to Energi Testnet, you will need some Rinkeby ETH (KETH) to pay the gas fee. Use the same address that you used for your tNRG, if you have one. For testing, we support a limited number of tokens.
3.1. Setup Rinkeby Test Network
Switch to the Rinkeby Test Network on MetaMask before collecting any test tokens.
Add the following Contract Addresses on the Rinkeby Test Network in MetaMask:
Token | Contract Address |
BTC | 0xa255461fF545d6ecE153283f421D67D2DE5D0E29 |
DAI | 0x2726Dd5efb3A209a54C512e9562A2045B8F45DBc |
ETH | 0x28cBB891400BD3cCF52c50F30FD24Ee503718054 |
NRGE | 0x7a7EbBDa6AE5c7EB5738FC8eFf675C0D71AA05A1 |
- Select “Add Token”:
- In “Custom Token”, paste the address of the token you want to add and click “Next”. Then follow the steps to complete adding the token.
3.2. Collect Rinkeby ETH Tokens
You need a Twitter or Facebook account to request Rinkeby ETH from the faucet.
3.2.1. Get Social Media URL
3.2.1.1. Twitter
To request funds via Twitter, make a tweet. Replace the address with your Rinkeby Test Network address. Click Tweet.
Copy the URL of the tweet.
3.2.1.2. Facebook
To request funds via Facebook, publish a new public post with your Ethereum address embedded into the content. Copy the URL of the message.
3.2.2. Faucet to Collect Test Funds
Go to the Rinkeby Faucet at https://www.rinkeby.io/#faucet
Paste the URL of Twitter or Facebook from the section above.
Select 18.75 Ether / 3 days from the dropdown. It will submit your request for Rinkeby ETH tokens.
Check your Rinkeby Test Network account. You should receive 18.75 ETH on the account.
3.3. Open and connect the wallet to the Energi Bridge dApp
- Open https://bridge.test.energi.network
- Click “Connect Wallet” to connect your MetaMask wallet.
- If no window pops up, select the Metamask icon manually
- Select the “Rinkeby Test Network” from the dropdown menu.
- Enter your password and click “Unlock”.
- On MetaMask, select the account you want to transfer tokens from:
- If you do not see the bridge dApp, press F5 to refresh the browser.
3.4. Click the double arrow to set Ethereum as the “FROM” blockchain on the left. Ethereum is now the source blockchain for the transfer.
3.5. From the dropdown, select the ERC-20 token you want to transfer from Ethereum to the Energi blockchain.
3.6. Approve the amount of the source token that you want to transfer
- Enter the amount of the token that you want to transfer from the Ethereum blockchain.
- Click “Approve”.
- The MetaMask approval screen will pop up after a few seconds. “Confirm” the amount to transfer. You cannot change the amount approved for transfer at this stage.
NOTE: ETH is a native token on the Ethereum blockchain. There is no approval required to transfer ETH from the Ethereum blockchain.
3.7. Transfer the tokens
- Once approved, read the disclaimer and check the box.
- Click "Transfer <token> to Energi Blockchain". In the example below, we selected DAI as the token.
3.8. Confirm the gas fee for the transaction in MetaMask.
A pop-up window will appear showing the status of the transaction and any other pending transactions.
The following notification will pop up if you have MetaMask notifications enabled.
After the transaction is confirmed on the Ethereum blockchain, your ERC-20 tokens will be stored and locked in the TokenSafe smart contract. You will not have custody of those tokens on the Ethereum blockchain after that. The same amount of the token will be issued to your account on the Energi blockchain.
Congratulations! You just transferred tokens from Ethereum to the Energi blockchain.
3.9. Check the destination account on Energi Blockchain
Switch to “Energi Testnet”
You will see the same amount of transferred tokens on your Energi Testnet account.
You can also verify the transaction on Block Explorer by going to the “Token Transfers” tab of your account.