Wrapped Hive Engine Tokens

![wHE-token.jpg](https://images.hive.blog/DQmeirr5tsPRBKeRMnkCLtQVR7VMr7wZa2FcyMk946x9qnZ/wHE-token.jpg) ^{[original image source](https://weth.io/)}

As some of you might be aware, I've been working on Wrapped tokens for the last 3 months. First Wrapped Hive, then modified oracle for wLEO and now I'm presenting an out-of-a-box solution for anyone to create their own Hive Engine Wrapped Token. It's meant mostly for "owners" of HE tribes, but anyone can start one if they want. I tried to make setup as easy as possible, but you will still need to follow some instructions. But it's as close to no-code as possible. I tried to create the same experience as the hive-in-a-box does for the witness setup. It's ***free*** for anyone, feel free to use & modify it. Donations are welcome ;)

First, why would you even want to wrap Hive Engine tokens to Ethereum when HE has free, almost instant transactions (compared to quite expensive fees on Ethereum). The answer is simple, users, and liquidity. Even most "liquid" tokens on Hive Engine such as LEO or DEC have under $50k in liquidity. There is less than $100k (1M) swap.hive wrapped on HE. Compared to $2.9B ($2,900,000,000) on Uniswap alone and $11B locked in entire DeFi, you can see there is a big difference.

Before starting with the actual setup, you should know how this works (don't worry, no technical details here) The setup (and app itself) is made of 3 parts: * ***Frontend***: The frontend is a nice website that will show information about your wrapped token and provide an interface for interacting with smart contracts to non-technical users. It's using generic [whive.network](https://whive.network) design, but you can modify header color in config ;) All other info such as token name, symbol, platforms... is updated directly from the config file, so no coding required. It does not have access to any private info such as private keys. Source code: https://github.com/fbslo/whe-frontend * ***Backend***: This is an actual app that will track events on both Hive & Ethereum blockchain and take care of wrapping and unwrapping tokens. It's completely separated from the frontend and should be run on a separate server for maximum security. Source code: https://github.com/fbslo/whe-backend * ***Smart Contract***: Smart contract for ERC20 Ethereum token. Source code: https://github.com/fbslo/wToken-contract

***Security*** As you might know, wLEO got hacked a few weeks ago and over $100k in liquidity was stolen. Here are some ways I implemented to prevent possible future disasters. This oracle app is centralized, and as such, there is no way to make it 100% secure. But we can do a lot to reduce the effect any hack/exit scam/bug can cause. While Hive Engine is (currently) centralized, this app has an option to prevent attacks from this. You can run your own Hive Engine node as a secondary node, and (if enabled), the app will check any incoming HE transaction in both the "official" server and your backup. Only if the transaction is valid on both nodes, ERC20 tokens will be issued. THIS FEATURE IS EXPERIMENTAL, PLEASE DON'T USE IN PRODUCTION YET. While the default method for creating tokens is `mint` (new tokens are later burned), the app has native support for `transfer` method, where tokens are not minted, but instead transferred from the hot wallet (while you keep most of the tokens in the cold wallet). You can select your method during the contract setup. If you use `transfer` method, all tokens will be minted during setup and no new tokens will be created later. You will need to keep them in cold wallet.

***What do you need?*** * Linux server (tested on Ubuntu 18.04) * API key from [EthGasStation](https://docs.ethgasstation.info/) * [Infura.io](https://infura.io/) API key / Ethereum node endpoint * Some ETH to pay for fees (0.15-0.25 should be enough, but it varies a lot) when deploying a new token * ~20-30 minutes Please be aware there might still be some bugs in the code. ***Use at your own risk!***

***ERC20 Token Smart Contract deployment*** Open Remix IDE: https://remix.ethereum.org Create a new file and copy/paste code: [Fixed supply token (convert by transferring back to a cold wallet)](https://gist.github.com/fbslo/be22daf9833bc2ad37df3088ea509772) [Mintable token (convert by burning tokens)](https://gist.github.com/fbslo/790063ac2366194677a72d773fe0863c) Edit last line: `contract wToken is WrappedToken, ERC20Detailed("tokenName", "TOKENSYMBOL", decimals) {}` and edit token name, symbol and decimals. Example: `contract wToken is WrappedToken, ERC20Detailed("tokenName", "TOKENSYMBOL", 3) {}` If you selected a fixed supply token, edit line 964 and replace `0x0000000000000000000000000000000000000000` with your cold wallet address. This cannot be changed later! Also, if you selected a fixed supply token, the last line will look like this: `contract wToken is WrappedToken, ERC20Capped(100000), ERC20Detailed("tokenName", "TOKENSYMBOL", 3) {}` Edit token name, symbol, and decimals. Now replace `100000` with a maximum supply of your token. Be aware that you can't use decimals and that if your token has, for example, 3 decimal places, 1000 is 1 token. At 5 decimal places, 100000 is 1 token... Once you have source code ready, compile it: Click ![slika.png](https://images.hive.blog/DQmRvsQNvKzpkzSrvNweGbhef4B17pb2CpSrfmJLQ6EnsJW/slika.png) icon, select compiler version `0.5.11` and click "Compile". If there are no errors, continue. Otherwise, something went wrong. Now click ![slika.png](https://images.hive.blog/DQmTK1jqQZYu6csMuSjexNSHgYZtf2K24mbmne5zkoTMWpk/slika.png) icon. ![slika.png](https://images.hive.blog/DQmX9i5AtLwEV2xiHKm5w7w3vbTxiVtaCdBfAJVYW1aPnGA/slika.png) Select `wToken` under `contract` and set the gas limit to at 3000000. Make sure `Environment` is injected Web3 (so it will use your metamask). Click deploy!

***Frontend*** As I mentioned earlier, it should be running on a separate server as backend, but if you want to use only one server, use [cloudflare](https://www.cloudflare.com/) to hide real IP and prevent DDoS attacks. Install NodeJS (if you didn't already do it for token deployment): ``` curl -sL https://deb.nodesource.com/setup_12.x -o nodesource_setup.sh` sudo bash nodesource_setup.sh sudo apt install nodejs ``` Now clone the project source code from GitHub: `git clone https://github.com/fbslo/whe-frontend` Move to the project directory and install dependencies: `cd whe-frontend && npm install && npm run install_cli && npm install pm2 -g && npm install pm2` Now you only need to edit config file. But first, let's rename it and then open it with your favorite text editor (I prefer nano): `mv .env.demo .env && nano .env` You will see the config file, I think it's self-explanatory, but [here](https://gist.github.com/fbslo/73e247e4b62a7f08d46f90bd9e9bb8db) you can see config file with comments. Once you are done, save & close it with `ctrl+x` Now customize "platforms":

Edit `platforms.json` file: `nano platforms.json` Add objects to the array, like seen in the example below. Font Awesome icon names can be found at https://fontawesome.com/. ``` { "platforms": [ { "url": "https://url.com", "name": "platform", "fa_icon": "fa-home" }, { "url": "https://url2.com", "name": "platform2", "fa_icon": "fa-home" } ] } ``` Now start the app with CLI: `frontend start` You might see the error `ReferenceError: document is not defined`, just ignore it. List of all available commands: `start`, `restart`, `logs`, `help`, `stop`, `status` Visit http://your_ip_or_localhost:8080 and you should see your website! It's recommended to use a reverse proxy (such as Nginx) to redirect requests from ports 80 (http) and 443 (https) to 8080. * [nginx setup tutorial](https://medium.com/@vishnuit18/setting-up-reverse-proxy-for-nodejs-with-nginx-on-ubuntu-18-04-server-1c629b81dae9) * [Free SSL cerificate](https://www.codementor.io/@marcoscasagrande/installing-express-nginx-app-on-ubuntu-18-04-with-ssl-using-certbot-pdt44g5gs#certbot)

***Backend*** As before, you need NodeJS installed, so if you don't have it yet, install it: ``` curl -sL https://deb.nodesource.com/setup_12.x -o nodesource_setup.sh` sudo bash nodesource_setup.sh sudo apt install nodejs ``` Now clone source code: `git clone https://github.com/fbslo/whe-backend && cd whe-backend` Install MongoDB: `sudo apt install -y mongodb` Install dependencies and CLI: `npm install && npm run install_cli && npm install pm2 -g && npm install pm2` Again, now you need to edit config file: `mv .env.demo .env && nano .env` You will see the config file, I think it's self-explanatory, but [here](https://gist.github.com/fbslo/73e247e4b62a7f08d46f90bd9e9bb8db) you can see the config file with comments. Now you can start the oracle using the command: `oracle start` List of all available commands: `start`, `restart`, `logs`, `help`, `stop`, `status` ^{CLI is just wrapper for PM2 with some extra stuff (e.g. database status...).}

I hope this tutorial was not too hard to understand. If you notice any errors or have any question send me a DM on discord: `fbslo [Hive witness]#8470` If you think it's still to hard, you can hire me to do this for you (I charge $100 fee), also send me a DM on discord: `fbslo [Hive witness]#8470`

@fbslo

*If you like my work, please support me by voting for my [Hive Witness](https://hivesigner.com/sign/account-witness-vote?witness=fbslo&approve=1)!
[Witness announcement](/@fbslo/witness-re-announcement)* --- This is a personal project and it's not affiliatted with official Hive Engine project! ***THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.***