1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
## Content
- [Overview](#Overview)
- [System Requirement](#System-requirement)
- [Software Instruction](#Software-Instruction)
- [Mining Mechanism](#Mining-Mechanism)
---
#### Objective
The document will contain essential instructions and knowledge for a node operator to successfully run a DEXON BP node.
#### Background
For node operator to easily establish a DEXON BP node and continuously run the node for mining rewards, DEXON foundation provides the well-designed software supporting the mining mechanism on DEXON blockchain.
---
## Overview
The guide has 3 sections, providing the required knowledge for a node operator to: Set up node, run software, and collect mining rewards.
### Environment Setup
How to set up AWS/GCP server?
For AWS, please follow https://docs.aws.amazon.com/quickstarts/latest/vmlaunch/welcome.html
For GCP, please follow https://cloud.google.com/compute/docs/quickstart-linux
## System Requirement
Running DEXON BP node has the following requirement:
### Hardware Requirement
| Tier | CPU | Memory | Bandwidth | Estimated Cost |
| --- | --- | --- | --- | --- |
| Minimum | 4 Cores 2.0+ GHz | 8 GB | 200Mbps | 200~400 USD/mth |
| Recommend| 8 Cores 2.0+ GHz | 16 GB| 200Mbps | 600~800 USD/mth |
### Software requirement
- OS: Linux 64 bit.
- Docker image: dexonfoundation/dexon
- Docker
- Go compiler
- C++ compiler
- Library: gmp, openssl, pkg-config
Follow the appropriate link below to find installation instructions for your platform.
- [Installation Instructions for Mac](https://github.com/dexon-foundation/wiki/wiki/Installation-Instructions-for-Mac)
- [Installation Instructions for Ubuntu](https://github.com/dexon-foundation/wiki/wiki/Installation-Instructions-for-Ubuntu)
## Software Instruction
#### Download DEXON fullnode implementation
git clone git@github.com:dexon-foundation/dexon.git
go into the dictionary
cd dexon
#### Generate Node Key
A node key is required to operate a BP node. Run the following command to generate a node key:
docker run -v $PWD:/mnt -it dexonfoundation/dexon-tools nodekey generate /mnt/node.key
This show output content similar to the following
Node Address: 0x93aA8C9C77De627E665F0b4015B7271B9Be89E83
Public Key:0x046272a157cbffa00677be00b08c9d47f295539b07e53360754579ad5e933a638ba58dcf850484e7d40b8bc163a920082b2500ee54968db7155c6231c7e4eed592
Please store the address and public key which will be used to register a fullnode.
A file node.key can be found under the current working directory. node.key is very important as it contains the node private key. Please save this file securely.
#### Register your node in DEXON public network
1. Sync DEXON blockchain. Use the following command to download all the blocks in DEXON blockchain.
`build/bin/gdex --network_type --bp --nodekey=node.key --datadir=Dexon.bp --syncmode=fast --gcmode=archive`
When you see `commit pivot`, press `control + c`.
2. Send some DXN to your node key address, 100 DXN should suffice. These DXN are required for the node to send transaction and interact with the consensus protocol. You need to replenish them if it ran out.
3. Goto the [Governance contract page on DEXSCAN](https://testnet.dexscan.org/address/0x63751838D6485578B23e8b051d40861eCC416794).
4. Navigate to the `Write` tab and select `register` from the dropdown menu.
5. Fill in the information like below; currently, you need 1M DXN to run a BP node. If you don't have enough testnet DXN, ask @wnhuang (telegram) for it.
- Node Public Key (the public key generated above)
- Name of the node
- Contact email
- Node Location
- Website URL
6. Hit send to register your node.
After this, you are successfully staked and the configuration will start to take effect after 2 epochs (2400 blocks).
Note that, the account of node.key and the account to send DXN coin to governance contract are not necessary to be the same.
Then, you can start a BP node
build/bin/gdex --network_type --bp --nodekey=node.key --datadir=Dexon.bp --syncmode=full --gcmode=archive
, or, you can run through container as explaining in the next section.
For more detail instruction about `gdex`, go to https://github.com/dexon-foundation/dexon or use
./gdex --help
#### Running a BP node through container
Use the following command to start the BP node:
docker run -v $PWD:/mnt -it dexonfoundation/dexon \
--bp \
--nodekey=/mnt/node.key \
--datadir=/mnt/datadir \
--syncmode=full \
--cache=1024 \
--gcmode=archive
Please make sure you have enough disk space in the current working directory
## Mining Mechanism
### [DEXON Mining Economy and Mining Rewards](https://github.com/dexon-foundation/wiki/wiki/DEXON-Cryptoeconomics)
Please read this document, https://github.com/dexon-foundation/wiki/wiki/DEXON-Cryptoeconomics
As an example, initially, each node can expectedly mine 1M * 18.75% = 187.5K DXN coin per year (before total minted tokens hit 1.5B DXN).
|
