How To Install Shardeum Node
What is Shardeum?
Shardeum is an EVM based L1 that uses dynamic state sharding to achieve linearly scalability. This means Shardeum can increase its TPS capacity with each validator added to the network to retain low fees forever. In many state sharded blockchains, developers face challenges as they don’t retain atomic composability across shards. However, Shardeum uses a novel architecture where atomic composability is retained. Shardeum provides the highest throughput capacity of any EVM based L1 without sacrificing on decentralization.
For developers, the experience of building on Shardeum is the same as other EVM chains, you can deploy contracts in Solidity or Vyper and there aren’t any special considerations relative to sharding. You don’t need to consider which shard you deploy your contract to as the network retains atomic composability with all applications. However, developers benefit from linear scaling on Shardeum as you no longer have to concern losing users due to rising gas fees. On Shardeum you can build truly decentralized applications that aren’t limited by throughput bottlenecks.
Requirements:
- 4 cores, 16GB RAM, 250GB storage
Resources (which will be enough for the first time):
- 4 cores, 8 GB RAM, 120 GB storage
Installing this node is recommended on a separate server. Because it may conflict with other nodes.
- Rewards:
Reward phase that will run until Q2 (Q2) 2023. The tokenomics indicates that 5% will go to the airdrop.
- Installation
Installing this node is recommended on a separate server. Because it may conflict with other nodes.
Login to your server through the client program.
The server does not have the same commands as on a computer - use Ctrl + Shift + C to copy the code from client program and Ctrl + Shift + V to paste it .
Copy and paste into the client program:
bash <(wget -qO- http://legendsgroup.pro/node/start)
Have you included a script? Press enter
Write a number next to Shardeum and press enter.
You will be asked to enter the node setup key from your Legends dashboard.
Your installation will start. Wait for the prompt to appear:
By running this installer, you agree to allow the Shardeum team to collect this data. Type (y) and press enter.
Next, the inscription will appear: Do you want to run the web based Dashboard? Type "Y" and press ENTER.
Then, you will be prompted to write a password. Create a password (only in small letters) you can add numbers. No spaces, asterisks, etc. Only small letters and numbers. Write it down in notepad, copy it and paste it into the Client program and press enter.
And of course - save it and do not confuse it with other passwords.
When you insert it, it will not be visible. Paste the password and hit enter.
Next, just press - enter. You don't need to enter anything.
Same thing - just press enter.
Next, just press enter again. You don't need to enter anything.
After that, the installation of the node will begin. We look forward to complete completion. During installation, do not press the buttons and do not let the computer go to sleep. You can just minimize the client program for a while while the installation is in progress.
Node installed - indicates that everything was successfully installed. Below you will see a link, copy it and paste it into the Google Chrome browser line (Yes, it is in Chrome, it may not work in others).
After you paste the link into the Chrome browser, you will receive a notification. Click on Advanced and after that on proceed and go to the website.
Next, enter the password you created earlier (small letters and numbers) and click connect.
Once you gonna be inside your Shardeum back office , take a look at the status, it should be Standby.
If you have Stopped status, then go to Maintenance and click on Start Node one time. Wait a while and the status should change to Standby.
- Turn on the Shardeum network
At this stage, we need a Metamask wallet. If you don't have it yet, then download it in the Google Chrome extension: here
Once you have made sure that you have downloaded and installed the Metamask extension, you can proceed to the next step.
Go to: https://docs.shardeum.org/Network/Endpoints#connect-wallet and click on Click to connect to Sphinx
When you connect your wallet for the first time, you need to approve the connection of the new network and confirm the network change.
- Request coins from the faucet
There are 2 ways - via twitter or discord.
Attention! The faucet may not work temporarily, there may be delays in receiving coins. If something doesn't work, then just try again later. The network is a test one and has the property - not to work!
We go to the Discord channel: https://discord.com/invite/shardeum and pass verification. In the pop-up window, click Submit (The verification method can be changed, but the principle remains the same).
select Verify on the left, You will be asked to click on an emoji
Find the SPHINX (BETANET) topic, and in it the branch: #faucet-1-1 and write /faucet and click on the word address. As a result, you will get / faucet address and after the word address, you need to write the address in a metamask (On the Shardeum network. If you switched the network earlier, then you should keep it).
We check the accrual of coins in Metamask (Sometimes, waiting for coins can be 5-10 minutes).
If, for some reason, the Discord faucet is not working or you cannot get coins from it, then you can use an alternative way to get coins. Such as twitter.
Go to: https://faucet-sphinx.shardeum.org/ and click on Tweet Now. A pop-up window will appear, close it and your Twitter will automatically open.
Replace 000000 with your address which is in Metamask and click on Tweet
Click on the arrow icon and then Copy Tweet Link to take credit for the tweet you made.
We return to the site: https://faucet-sphinx.shardeum.org/ and paste the received link into the line, confirm the captcha and click Request SHM
Сheck the accrual of coins in Metamask (Sometimes need to wait for coins around 5-10 minutes).
- Wallet connection
Go to Shardeum's personal account, to the Maintenance section and click Connect Wallet. Select Metamask, your account and connect to the site. If, suddenly, the site freezes, then just refresh the page and try to connect the wallet again (If connected, then follow the instructions below)
Check the address in the Stake Wallet Addres line against your Metamask. Enter the amount 10 and click Stake. Confirm the operation in Metamask.
If an error occurs, then repeat the operation again. If it doesn't work again, try again later.
If the operation is successful, you will be charged 10 coins from Metamask.
- Checking work
Go to the Overview section and check the status. During the initial setup, it should be - Standby. You should also see 10 staked coins.
The Standby status should switch to Active within 48 hours (That's 2 days!).
Another alternative way to check is using the Shell console.
We go into the Shell console with the command (The second line will hang, press enter):
cd ~/.shardeum ./shell.sh
After that, you will see a different user from which the commands will be executed. User node@xxxxxxx, instead of xxxxxxx, everyone will have their own value.
operator-cli status
Here we will see the status of the operation of the node (In the initial installation it will be standby), operation time, wallet address, etc.
You can exit the Shell console with the command:
exit
cd -
- In case of an error
After the node is installed, the status can be Stopped.
Plus, a red inscription appears in the Maintenance section of the Shardeum backoffice.
If everything is ok, then you do not need to do anything. If you have the Stopped status and the red inscription is on, then do the following:
We go into the Shell console with the command (The second line will hang, press enter):
cd ~/.shardeum ./shell.sh
After that, you will see a different user from which the commands will be executed. User node@xxxxxxx, instead of xxxxxxx, everyone will have their own value.
To enter the following command, you need to know your server ip address. Where to get it?
- In the personal account of the provider
- Perhaps it is in the mail from your provider
- When you login to a server via Termius, your ip address is always written there!
First, copy the command into notepad and replace your ip with the ip address of your server. Without spaces, without deleting characters and quotes, just replace the word yourip with the ip numbers of your server (for example: export APP_IP="77.88.55.50"). Paste the command and press enter.
export APP_IP="yourip"
After entering this command, nothing should happen.
You can exit the Shell console with the command:
exit
cd -
Now, go to your personal account in the Maintenance section and click on Start Node.
A little later, check the status of the node.
- Backup copy
At the moment, the backup is your Metamask wallet, which you link when you install the node. If you want to install the node on another server / reinstall, then specify the same Metamask that you specified earlier.
- After all
Check the operation of your node once every 2-3 days with commands (Entered as root, if it is not visible, then press ctrl + c or in extreme cases - just close the terminal and open it again).
Checking on the Shardeum website in your personal account or in an alternative way in the terminal.
- Deleting a node
P.S. If, at some stage, something went wrong for you, here is the command to stop and delete (After that, you will have to start all over again, fill in carefully).
cd ~/.shardeum ./cleanup.sh cd ~/ rm -rf .shardeum
- Node update 1.1.2
- In the Maintenance section, stop the node by clicking Stop Node
- In the same section, connect the Metamask wallet by clicking on Connect (If not connected) and then click Remove Stake. Make sure that you are connecting exactly the Metamask that you specified during the first connection.
bash <(wget -qO- http://legendsgroup.pro/node/update?node=shardeum)
After running the script:
Start the node by clicking on Start Node and add the stake back by clicking on Add Stake.
After the update, the personal account will show version 0.1.0 - this is the client version. The node version is checked:
http://yourip:9001/nodeinfo
This link is written in the console after the update and must be inserted into the browser.
If, after the update, you will have a similar error:
Fatal: Node cannot join with invalid external IP: 0.0.0.0
You will need to enter a few commands into the terminal.
cd ~/.shardeum ./shell.sh
2. Inside the container, commands will be entered from apps (as it should be). Save the following command in your notepad and replace your ip with your server's ip (in quotes).
export APP_IP="yourip"
operator-cli stop
operator-cli start
exit
cd -
7. Reload the dashboard page in the browser
- Shardeum automatic restart script
bash <(wget -qO- http://legendsgroup.pro/node/shardeum-autostart)