Skip to content

Latest commit

 

History

History
227 lines (162 loc) · 6.62 KB

running_a_node.md

File metadata and controls

227 lines (162 loc) · 6.62 KB

Running a node

CLI reference

Clone mina repo

git clone https://github.com/MinaProtocol/mina

Set up the stable package repos

echo "deb [trusted=yes] http://packages.o1test.net $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/mina.list
sudo apt-get update

Get mina-mainnet

sudo apt-get install -y curl unzip mina-mainnet=1.3.1.2-25388a0

Check it works

mina version

Should get Commit 25388a0fed9695e8e9d04f75f50c2bae1c9c80db on branch master

Set up port forwarding and allow in firewall

If you are running a firewall (you really should), you will need to allow traffic on TCP port 8302 (the node connects to the network using this default port). Additionally, unless the -external-ip YOUR_IP flag is provided, the daemon will use 403/https and 80/http to try and determine its own IP address.

You may need to configure your router's port forwarding to allow inbound traffic to the following ports through your external IP address

  • 8302/tcp
  • Optionally to use the GraphQL service, expose 3085/tcp

See firewall commands for more details

Generate keypair

Install mina-generate-keypair

Assuming you've installed the latest stable package repos (see set up the stable package repos), do

sudo apt-get install mina-generate-keypair=1.3.0-9b0369c

Check it works

mina-generate-keypair -version

Should get Commit 9b0369c27bb85c8ab2f8725c6e977eb27b53b826 on branch master

Usage

This python script does 1 - 4. Do

cd utils/scripts
python
  1. Make keys dir
mkdir ~/.mina-keys
  1. Set owner read, write, execute permissions
chmod 700 ~/.mina-keys
  1. Generate a keypair
mina-generate-keypair --privkey-path ~/.mina-keys/<KEY_NAME>
  1. Revoke owner execute permissions
chmod 600 ~/.mina-keys

Ledger hardware wallet

Auro wallet

The Auro Firefox extension does not currently support Ledger

Clor.io wallet

Connecting to Mainnet

Assuming you've installed the stable package repos and mina-mainnet do

sudo apt-get install --yes apt-transport-https

Create .mina-env file

If you want your node to produce blocks do

# write the following to ~/.mina-env
MINA_PRIVKEY_PASS="<YOUR_WALLET_PRIVKEY_PASS>"
LOG_LEVEL=Info
FILE_LOG_LEVEL=Debug
EXTRA_FLAGS=" --block-producer-key <BLOCK_PRODUCER_KEY_PATH>"
PEER_LIST_URL=https://storage.googleapis.com/mina-seed-lists/mainnet_seeds.tx

Alternatively, you can supply the python script with --env or --only-env to generate this file

If you only want your node to connect to peers and produce no blocks do

# write the following to ~/.mina-env
PEER_LIST_URL=https://storage.googleapis.com/mina-seed-lists/mainnet_seeds.tx

Alternatively, you can supply the python script with --env or --only-env and --no-produce-blocks to generate this file

Note: make sure mina node is not already running

systemctl --user status mina
# if running do
systemctl --user stop mina

Then start mina node instance

systemctl --user daemon-reload
systemctl --user start mina
systemctl --user enable mina
sudo loginctl enable-linger
mina daemon --peer-list-url https://storage.googleapis.com/mina-seed-lists/mainnet_seeds.txt

Save mina pub key env var

export MINA_PUBLIC_KEY=<YOUR-PUBLIC-KEY>

Alternatively, you can supply the python script with --pubkey to save the env var

Confirm node is running and made connections (it may take a minute or so for the daemon to start and make connections)

mina client status

Should get something like

Mina daemon status
-----------------------------------

Global number of accounts:                     134011
Block height:                                  205369
Max observed block height:                     205369
Max observed unvalidated block height:         205369
Local uptime:                                  19m59s
Ledger Merkle root:                            jwgNo5DyGu2nPRLktG1d6L3vGqJeQJZoUNSaTzZ7vPnRa3WEwGD
Protocol state hash:                           3NLnBi3HVyXMe865Zrug5ZcbBeUMobCcaCywKMEbR8PQ1aSefNZP
Chain id:                                      5f704cc0c82e0ed70e873f0893d7e06f148524e3f0bdae2afb02e7819a0c24d1
Git SHA-1:                                     25388a0fed9695e8e9d04f75f50c2bae1c9c80db
Configuration directory:                       <PATH_TO_MINA_CONFIG>
Peers:                                         31
User_commands sent:                            0
SNARK worker:                                  None
SNARK work fee:                                100000000
Sync status:                                   Bootstrap
Catchup status:                                
	To build breadcrumb:           0
	To initial validate:           0
	Finished:                      15
	To download:                   0
	Waiting for parent to finish:  0
	To verify:                     0

Block producers running:                       0
Coinbase receiver:                             Block producer
Best tip consensus time:                       epoch=42, slot=3877
Best tip global slot (across all hard-forks):  303757
Consensus time now:                            epoch=42, slot=3877
Consensus mechanism:                           proof_of_stake
Consensus configuration:                       
	Delta:                     0
	k:                         290
	Slots per epoch:           7140
	Slot duration:             3m
	Epoch duration:            14d21h
	Chain start timestamp:     2021-03-17 00:00:00.000000Z
	Acceptable network delay:  3m

Addresses and ports:                           
	External IP:    <EXTERNAL_IP>
	Bind IP:        0.0.0.0
	Libp2p PeerID:  <LIBP2P_PEER_ID>
	Libp2p port:    8302
	Client port:    8301

🎉 Congratulations, you now have a live mina node! 🎉

Next steps