Meter Docs
Search…
Overview of Meter
Wallet Setup
Meter Passport
Staking and Validation
Mining
NFT Collections
Running a Full Node on Meter Mainnet
Overview
Meter is a hybrid PoW and PoS blockchain system with dual chain structure. All the accounts and transactions are recorded on the PoS chain while PoW chain (currently a modified version of Bitcoin starting from the same genesis of Bitcoin) just maintains the crypto puzzles for mining. The PoW chain submits the solutions for the crypto puzzles to the PoS chain and the winning miners receive reward on their accounts on the PoS chain.
Epoch:
Meter operates on epochs, which are signaled by k-blocks (regular blocks are called m-blocks). At the end of epoch, the committee nodes vote on the longest PoW chain and distribute mining rewards to all the PoW miners, it also pass the information to the PoW chain and all the PoW miners will have to start mining for the stamped PoW block. To create a k-block, the PoW chain typically has to have more than 60 blocks. Since the average PoW block period is 1 minute, each epoch is therefore around 1 hour (currently the time for epoch is completely decided by PoW, but we will implement cross interactions for epoch adjustments in the future). All system financial related activities like reward distribution, entering and exiting the delegate node pool only happen at k-blocks.
It is also required to run both PoS and PoW processes on the same physical or virtual machine to ensure security.
In Meter, there are several types of full nodes in the network:
- 1.Regular full node: They sync for each block and can support interactions with wallets
- 2.Delegate nodes: These nodes are candidates for the committee nodes and have opportunity to propose and sign blocks. To become a delegate node, the top N (N is a protocol parameter) staked full nodes(including both self staking and votes from other stakers) are the delegate nodes.
- 3.Committee nodes: A random subset of the delegate nodes are selected for every epoch. These nodes form a committee quorum and perform consensus. The committee nodes take turns to propose blocks. If a proposed block receives endorsement signatures from 2/3 of nodes in the committee, the signatures form a QC (Quorum Certificate). Each newly proposed block carries QC for the previous block. Once the newly proposed block obtains a QC, the previous block is considered as confirmed and finalized.
In the initial launch of the main net. The number of Delegate Nodes will be the same as the number of the committee nodes, which are set at 300.
Requirements for running a delegate/committee node: To achieve the full performance of the Meter network, the recommended hardware configuration is more than 8 compute optimized vCPU, 16GB of memory and 200GB of SSD (AWS c5.2xlarge instance or better). The maximum block size in Meter is around 1.3MB. It is also recommended to have data center class 1Gbps to 10Gbps internet connection. However the Meter consensus protocol is capable of adapting to transaction load, network and node processing speed to some extent by varying the block period from 2 sec to up to 30 sec. The minimum requirement is 2 vCPU and 4GB of memory. When the network has minimum load, the average monthly block data is expected to be about 1.5GB.
Tutorials (Community Version)
This step by step tutorial on how to setup a full node and validator for Meter was created by a community member. The following guide is officially maintained.
This setup tool is created by the community for doing everything for you on a Ubuntu Linux machine. There is also a telegram group with automatic alerts and helps from the community.
Setting up Docker
Since Meter full node consists of multiple processes, we packaged the entire node to a docker container image. The following instructions assume Ubuntu Linux. If you are using Windows, you could install WSL2 with an Ubuntu image. Please refer to Ubuntu Docker Installation Guide for adding Docker support on Ubuntu.
On Ubuntu, you could use the following commands to install docker
1
sudo apt update
2
sudo apt install docker.io
Copied!
By default, if you installed docker through apt install, it requires root user privilege to run. However, this may introduce security concerns. It is actually pretty simple to run Docker as non-root user.
Setup Docker usergroup to run Docker as non-root user. We assumed the non-root user that will be running docker is "ubuntu", please change the commands accordingly if you are using a different user.
1
sudo groupadd docker
2
sudo usermod -aG docker ubuntu
Copied!
After this, please logout and log back in to refresh the user group setting and you will be ready to go.
Setting up a full node
- 1.
- 2.Prepare host working directory for Meter Docker container It is recommended to have a host working directory for the container to save important keys and block database, so we could retain them in future upgrades. We will create a directory called meter-data and set its path to and environment variable called METER_MAIN_DATA_PATH (you will have to modify accordingly if you have a different directory structure) and map it to the /pos directory inside the container.
- 3.Prepare a clean working directory
1
$ mkdir meter_main_data
2
$ cd meter_main_data/
3
$ echo export "METER_MAIN_DATA_PATH=$PWD" >> ~/.bashrc
4
$ source ~/.bashrc
Copied!
- 1.Launch the Meter container
The following instructions assumes the user operates in METER_MAIN_DATA_PATH. Please pay attention to the parameters in the commands and replace the path accordingly to your environment, especially the path after -v in docker run commands.
1
docker run --network host --name meter_main --restart always -e NETWORK="main" -v $METER_MAIN_DATA_PATH:/pos -d meterio/mainnet:latest
Copied!
- 1.Check that container is actually working
1
docker container ls -a
Copied!
The output will be like the following:
1
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
2
260bbd571d1a meterio/mainnet "/usr/bin/supervisord" 23 hours ago Up 23 hours meter_main
Copied!
1
docker container stop meter_main //stop the container
2
docker container start meter_main //start the container
3
docker container rm meter_main //remove the container
4
docker image ls
5
docker image rm [image ID] //remove the container image, will trigger redownloading the image at the next docker run, it is recommended to do this every time we upgrade the testnet
6
docker container exec -it meter_main bash //launch a bash in the container
Copied!
The log files can be located inside the container, under /var/log/supervisor directory. If you file any bugs, please remember to attach the logs for PoS (both the stderr and stdout) in the bug. You could either copy and paste the log or use
1
docker cp meter_main:/var/log/supervisor/[LogFileNameHere] //replace with the log file name
Copied!
After confirming the node is running properly through the log, you could then connect the desktop wallet to your own full node.
Track node sync status
- 1.Point Meter desktop wallet to your own full node In the settings of the wallet, under node, you could and connect add your own full node by adding http://IPaddrOfYourNode:8669 . The icon in the left of the address bar should turn green if everything is running properly. You could use the explorer inside the wallet to look at the status of the block productions.
Upgrade a full node automatically
Since the mainnet just launches, we expect there could be urgent upgrades from time to time. To ease node operator's work, we have provided an automatic upgrade service called watchtower. It periodically pulls the docker container image releases and upgrade accordingly. For non-professional validators who can not monitor the node 24/7, we highly recommend using watchtower service during the first year after the mainnet launch.
1
docker run -d --name watchtower --restart always -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --include-stopped --revive-stopped --enable-lifecycle-hooks --interval 10 --cleanup meter_main
Copied!
Upgrade a full node manually
Stop and remove the current CONTAINER
1
docker container rm -f meter_main
Copied!
Pull the latest container image
1
docker pull meterio/mainnet:latest
Copied!
Start the new image
1
docker run --network host --name meter_main --restart always -e NETWORK="main" -v $METER_MAIN_DATA_PATH:/pos -d meterio/mainnet:latest
Copied!