You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Feb 21, 2024. It is now read-only.
You must must be connected to our OpenVPN network in order to join the Masa Testnet and access bootnodes and node IP's. Please reach out to an admin on Discord (https://discord.gg/SXwRKNMc) to get an OpenVPN file! Please download the OpenVPN Connect client to connect to the Masa Testnet cluster [here](https://openvpn.net/vpn-client/)
5
-
6
-
### Check you can access the node IP range througe OpenVPN
7
-
Check your routing table by running `netstat -rn` from the command line to ensure you can access the Masa Testnet. You will see `172.16.239/24 10.254.0.17 UGSc utun4` if you have OpenVPN setup correctly.
8
-
```sh
9
-
netstat -rn
10
-
11
-
Internet:
12
-
Destination Gateway Flags Netif Expire
13
-
default 192.168.1.1 UGScg en0
14
-
10.254.0.1/32 10.254.0.17 UGSc utun4
15
-
10.254.0.16/30 10.254.0.18 UGSc utun4
16
-
10.254.0.17 10.254.0.18 UH utun4
17
-
127 127.0.0.1 UCS lo0
18
-
127.0.0.1 127.0.0.1 UH lo0
19
-
169.254 link#6 UCS en0 !
20
-
172.16.239/24 10.254.0.17 UGSc utun4
21
-
```
22
-
1
+
# Masa Testnet Node V1.01
2
+
## Release Date
3
+
February 22nd, 2022
4
+
## Roadmap & Todo's
5
+
The Masa Node UI is in alpha and will get incremental releases, please report all bugs you find to [email protected] or submit an issue [here](https://github.com/masa-finance/masa-node-v1.0/issues)
6
+
# Run With Docker
7
+
This guide will get you up and running using docker. If you want to us the geth binary please navigate to the bottom section of the page [here](#run-with-geth).
1. Docker is frozen or containers crash and reboot
78
67
- Check if your Docker daemon is allocated enough memory (minimum 4G)
68
+
### Additional Bootnodes
69
+
Masa operates several bootnodes, one is already included in the Docker file by default. If you are having issues connecting to the bootnode please use an alternaitve from the list below.
70
+
71
+
We are also looking for community run bootnodes to add to our list. Please reach out to us on Discord or Submit a PR to this repo if you want to add a bootnode to the community list.
**`make all` must be run from within the src folder**
102
+
## Run the tests:
103
+
```
104
+
make test
105
+
```
106
+
## Add PATH
107
+
### Method 1
108
+
Binaries are placed in`$REPO_ROOT/build/bin`. You must add the `bin` folder to `PATH` to make `geth` and `bootnode` easily invokable from the command line. For example, if`Users/yourname/masa-node-v1.0` is the location you have cloned the masa-node repository to on your computer. In your terminal run
109
+
```
110
+
sudo nano /etc/paths
111
+
or
112
+
export PATH=$PATH:$REPO_ROOT/build/bin
113
+
```
114
+
Remember to source your $PATH or restart the terminal. Run `echo $PATH` from the command line to check that the `PATH` has been added correctly.
86
115
116
+
For example;
87
117
```
88
-
# Naively Simple Node Dockerfile
118
+
echo$PATH
89
119
90
-
FROM node:14.17-alpine
120
+
gives the following response
91
121
92
-
RUN mkdir -p /home/app/ && chown -R node:node /home/app
The second way to make geth and bootnode easily invokable is to copy the binaries located in`$REPO_ROOT/build/bin` to a folder already in your `PATH` file such as `/usr/local/bin`.
126
+
### Method 3
95
127
96
-
USER node
128
+
You can also supplement `PATH` by adding add `PATH=$PATH:$REPO_ROOT/build/bin` to your `~/.bashrc`, `~/.bash_aliases`, or `~/bash_profile` file.
129
+
## Testing PATH
130
+
When you run geth from the command line from an arbitrary folder you will get the following output on the terminal.
131
+
```
132
+
geth
133
+
134
+
returns
135
+
136
+
INFO [12-08|05:37:18.131] Starting Geth on Ethereum mainnet...
137
+
INFO [12-08|05:37:18.131] Bumping default cache on mainnet provided=1024 updated=4096
138
+
INFO [12-08|05:37:18.131] Running with private transaction manager disabled - quorum private transactions will not be supported
139
+
INFO [12-08|05:37:18.132] Maximum peer count ETH=50 LES=0 total=50
140
+
INFO [12-08|05:37:18.160] Set global gas cap cap=25000000
141
+
INFO [12-08|05:37:18.160] Running with private transaction manager disabled - quorum private transactions will not be supported
142
+
INFO [12-08|05:37:18.160] Allocated trie memory caches clean=1023.00MiB dirty=1024.00MiB
143
+
INFO [12-08|05:37:18.160] Allocated cache and file handles database=/Users/brendanplayford/Library/Ethereum/geth/chaindata cache=2.00GiB ...
144
+
...
145
+
INFO [12-08|05:37:18.751] Started P2P networking self=enode://162cfffb34b0c3e76abeb9f31541737fcd3b622e35fa3b0080a14dfb9d2a53168ac3abf10122b79d3b8d7d55516982e0f903d179916ccb51abe5cd00de1bdb07@127.0.0.1:30303
146
+
INFO [12-08|05:37:18.752] IPC endpoint opened url=/Users/brendanplayford/Library/Ethereum/geth.ipc isMultitenant=false
147
+
INFO [12-08|05:37:18.752] Security Plugin is not enabled
148
+
Fatal: Consensus not specified. Exiting!!
149
+
```
150
+
## Initialize the node
151
+
Navigate to the `node` directory and initialize the first node.
152
+
The repo directory includes the `genesis.json` file that is used to connect to the Masa protocol at the following path `../genesis.json`
97
153
98
-
RUN yarn install --frozen-lockfile
99
-
RUN yarn build
154
+
Run the following command
155
+
```
156
+
cd node
157
+
geth --datadir data init ../genesis.json
158
+
```
159
+
You will get the following output;
160
+
```
161
+
INFO [12-09|18:22:24.031] Running with private transaction manager disabled - quorum private transactions will not be supported
162
+
INFO [12-09|18:22:24.035] Maximum peer count ETH=50 LES=0 total=50
163
+
INFO [12-09|18:22:24.063] Set global gas cap cap=25000000
164
+
INFO [12-09|18:22:24.064] Allocated cache and file handles database=/Users/brendanplayford/masa/masa-node-v1.0/node/data/geth/chaindata cache=16.00MiB handles=16
165
+
INFO [12-09|18:22:24.135] Writing custom genesis block
166
+
INFO [12-09|18:22:24.140] Persisted trie from memory database nodes=7 size=1.02KiB time="280.583µs" gcnodes=0 gcsize=0.00B gctime=0s livenodes=1 livesize=0.00B
167
+
INFO [12-09|18:22:24.141] Successfully wrote genesis state database=chaindata hash="69b521…fb4c77"
168
+
INFO [12-09|18:22:24.141] Allocated cache and file handles database=/Users/brendanplayford/masa/masa-node-v1.0/node/data/geth/lightchaindata cache=16.00MiB handles=16
169
+
INFO [12-09|18:22:24.204] Writing custom genesis block
170
+
INFO [12-09|18:22:24.205] Persisted trie from memory database nodes=7 size=1.02KiB time="162.437µs" gcnodes=0 gcsize=0.00B gctime=0s livenodes=1 livesize=0.00B
171
+
INFO [12-09|18:22:24.205] Successfully wrote genesis state database=lightchaindata hash="69b521…fb4c77"
172
+
```
100
173
101
-
EXPOSE 3000
102
-
CMD [ "yarn", "start" ]
174
+
## Set your node identity
175
+
Set your own identity of your node on the Masa protocol to be easily identified in a list of peers.
176
+
177
+
For example; we name our node 'MasaMoonNode' by setting the flag `--identity MasaMoonNode` will set up an identity foryour node so it can be identified as MasaMoonNodein a list of peers.
178
+
**Update your flag `--identity MasaMoonNode` to be unique**
179
+
## Start the node
180
+
In the `node` directory, start the node by running the following command:
Masa operates several bootnodes, one is already included in the comnand above by default. If you are having issues connecting to the bootnode please use an alternaitve from the list below.
106
186
107
-
Build the image
108
-
`docker build -t masa-node-ui .`
187
+
We are also looking for community run bootnodes to add to our list. Please reach out to us on Discord or Submit a PR to this repo if you want to add a bootnode to the community list.
0 commit comments